Wtyczka MQTT

Omówienie

Parametry konfiguracyjne umożliwiają dostosowanie działania wtyczki MQTT.

Zaleca się określanie ich w osobnym pliku konfiguracyjnym (np. mqtt.conf), a nie w pliku konfiguracyjnym agenta 2. Następnie należy użyć dyrektywy Include, aby dołączyć ten plik do konfiguracji Zabbix agent 2.

Wszystkie parametry są opcjonalne, chyba że wyraźnie zaznaczono, że dany parametr jest obowiązkowy.

Należy pamiętać, że:

  • Wartości domyślne odzwierciedlają domyślne ustawienia procesu, a nie wartości w dostarczonych plikach konfiguracyjnych;
  • Wartości obsługują zmienne środowiskowe;
  • Zabbix obsługuje pliki konfiguracyjne wyłącznie w kodowaniu UTF-8 bez BOM;
  • Komentarze rozpoczynające się od "#" są obsługiwane tylko na początku wiersza.

Parameter details

Plugins.MQTT.Default.Password

Specify the default password for connecting to MQTT.
Used if no value is specified in an item key or named session.

Plugins.MQTT.Default.TLSCAFile

Specify full pathname of the file containing top-level CA(s) certificates for peer certificate verification for encrypted communications between Zabbix agent 2 and MQTT broker.
Used if no value is specified in a named session.

Plugins.MQTT.Default.TLSCertFile

Specify full pathname of the file containing the agent certificate or certificate chain for encrypted communications between Zabbix agent 2 and MQTT broker.
Used if no value is specified in a named session.

Plugins.MQTT.Default.TLSKeyFile

Specify full pathname of the file containing the MQTT private key for encrypted communications between Zabbix agent 2 and MQTT broker.
Used if no value is specified in a named session.

Plugins.MQTT.Default.Topic

Specify the default topic for MQTT subscription.
Used if no value is specified in an item key or named session.
The topic may contain wildcards ("+","#").

Examples: 

path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Default.Url

Specify the default MQTT broker connection string.
Used if no value is specified in an item key or named session.
Should not include query parameters.
Must match the URL format.
Supported schemes: tcp (default), ws, tls
A scheme can be omitted.
A port can be omitted (default=1883)

Default: tcp://localhost:1883

Examples:

tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Default.User

Specify the default username for connecting to MQTT.
Used if no value is specified in an item key or named session.

Plugins.MQTT.Sessions.<SessionName>.Password

Specify the named session password for connecting to MQTT.
<SessionName> - define name of a session for using in item keys.

Plugins.MQTT.Sessions.<SessionName>.TLSCAFile

Specify full pathname of the file containing top-level CA(s) certificates for peer certificate verification for named session, used for encrypted communications between Zabbix agent 2 and MQTT broker.
<SessionName> - define name of a session for using in item keys.

Plugins.MQTT.Sessions.<SessionName>.TLSCertFile

Specify full pathname of the file containing the agent certificate or certificate chain for named session, used for encrypted communications between Zabbix agent 2 and MQTT broker.
<SessionName> - define name of a session for using in item keys.

Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile

Specify full pathname of the file containing the MQTT private key for named session, used for encrypted communications between Zabbix agent 2 and MQTT broker.
<SessionName> - define name of a session for using in item keys.

Plugins.MQTT.Sessions.<SessionName>.Topic

Specify the named session topic for MQTT subscription.
<SessionName> - define name of a session for using in item keys.
The topic may contain wildcards ("+","#").

Examples: 

path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Sessions.<SessionName>.Url

Specify the named session MQTT broker connection string.
<SessionName> - define name of a session for using in item keys.
Should not include query parameters.
Must match the URL format.
Supported schemes: tcp (default), ws, tls
A scheme can be omitted.
A port can be omitted (default=1883)

Default: tcp://localhost:1883

Examples:

tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Sessions.<SessionName>.User

Specify the named session username for connecting to MQTT.
<SessionName> - define name of a session for using in item keys.

Parametry

Parameter Mandatory Range Default Description
Plugins.MQTT.Default.Password no Domyślne hasło do łączenia z MQTT; używane, jeśli w kluczu pozycji lub nazwanej sesji nie określono żadnej wartości.
Plugins.MQTT.Default.TLSCAFile no Pełna ścieżka do pliku zawierającego certyfikaty głównego urzędu CA do weryfikacji certyfikatu peer dla szyfrowanej komunikacji między Zabbix agent 2 a brokerem MQTT; używane, jeśli w nazwanej sesji nie określono żadnej wartości.
Plugins.MQTT.Default.TLSCertFile no Pełna ścieżka do pliku zawierającego certyfikat agenta lub łańcuch certyfikatów do szyfrowanej komunikacji między Zabbix agent 2 a brokerem MQTT; używane, jeśli w nazwanej sesji nie określono żadnej wartości.
Plugins.MQTT.Default.TLSKeyFile no Pełna ścieżka do pliku zawierającego prywatny klucz MQTT do szyfrowanej komunikacji między Zabbix agent 2 a brokerem MQTT; używane, jeśli w nazwanej sesji nie określono żadnej wartości.
Plugins.MQTT.Default.Topic no Domyślny temat subskrypcji MQTT; używany, jeśli w kluczu pozycji lub nazwanej sesji nie określono żadnej wartości.

Temat może zawierać symbole wieloznaczne ("+","#")
Przykłady: path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Default.Url no tcp://localhost:1883 Domyślny ciąg połączenia z brokerem MQTT; używany, jeśli w kluczu pozycji lub nazwanej sesji nie określono żadnej wartości.

Nie powinien zawierać parametrów zapytania.
Musi odpowiadać formatowi URL.
Obsługiwane schematy: tcp (domyślny), ws, tls; schemat można pominąć.
Port można pominąć (domyślnie=1883).
Przykłady: tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Default.User no Domyślna nazwa użytkownika do łączenia z MQTT; używana, jeśli w kluczu pozycji lub nazwanej sesji nie określono żadnej wartości.
Plugins.MQTT.Sessions.<SessionName>.Password no Hasło nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MQTT.Sessions.<SessionName>.TLSCAFile no Pełna ścieżka do pliku zawierającego certyfikaty głównego urzędu CA do weryfikacji certyfikatu peer, używana do szyfrowanej komunikacji między Zabbix agent 2 a brokerem MQTT.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MQTT.Sessions.<SessionName>.TLSCertFile no Pełna ścieżka do pliku zawierającego certyfikat agenta lub łańcuch certyfikatów, używana do szyfrowanej komunikacji między Zabbix agent 2 a brokerem MQTT.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile no Pełna ścieżka do pliku zawierającego prywatny klucz MQTT, używana do szyfrowanej komunikacji między Zabbix agent 2 a brokerem MQTT.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.
Plugins.MQTT.Sessions.<SessionName>.Topic no Temat subskrypcji MQTT dla nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.

Temat może zawierać symbole wieloznaczne ("+","#")
Przykłady: path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Sessions.<SessionName>.Url no Ciąg połączenia nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.

Nie powinien zawierać parametrów zapytania.
Musi odpowiadać formatowi URL.
Obsługiwane schematy: tcp (domyślny), ws, tls; schemat można pominąć.
Port można pominąć (domyślnie=1883).
Przykłady: tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Sessions.<SessionName>.User no Nazwa użytkownika nazwanej sesji.
<SessionName> - zdefiniuj nazwę sesji do użycia w kluczach pozycji.

Jeśli chcesz ustawić limit czasu wykonania żądania (jak długo czekać na zakończenie żądania przed jego przerwaniem), użyj formularza konfiguracji pozycji.

Zobacz także: