Wtyczka MQTT

Omówienie

Parametry konfiguracyjne umożliwiają dostosowanie zachowania 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.

Ta strona jest podzielona na:

  • Omówienie parametrów (aby zobaczyć pełne szczegóły parametru, kliknij jego nazwę)
  • Szczegóły parametrów
Parameter Description
Plugins.MQTT.Default.Password Określa domyślne hasło do łączenia z MQTT.
Plugins.MQTT.Default.TLSCAFile Określa pełną ścieżkę do pliku zawierającego certyfikaty głównych urzędów CA do weryfikacji certyfikatu peer.
Plugins.MQTT.Default.TLSCertFile Określa pełną ścieżkę do pliku zawierającego certyfikat agenta lub łańcuch certyfikatów.
Plugins.MQTT.Default.TLSKeyFile Określa pełną ścieżkę do pliku zawierającego prywatny klucz MQTT.
Plugins.MQTT.Default.Topic Określa domyślny temat dla subskrypcji MQTT.
Plugins.MQTT.Default.Url Określa domyślny ciąg połączenia z brokerem MQTT.
Plugins.MQTT.Default.User Określa domyślną nazwę użytkownika do łączenia z MQTT.
Plugins.MQTT.Sessions.<SessionName>.Password Określa hasło dla nazwanej sesji do łączenia z MQTT.
Plugins.MQTT.Sessions.<SessionName>.TLSCAFile Określa pełną ścieżkę do pliku zawierającego certyfikaty głównych urzędów CA do weryfikacji certyfikatu peer dla nazwanej sesji.
Plugins.MQTT.Sessions.<SessionName>.TLSCertFile Określa pełną ścieżkę do pliku zawierającego certyfikat agenta lub łańcuch certyfikatów dla nazwanej sesji.
Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile Określa pełną ścieżkę do pliku zawierającego prywatny klucz MQTT dla nazwanej sesji.
Plugins.MQTT.Sessions.<SessionName>.Topic Określa temat dla nazwanej sesji subskrypcji MQTT.
Plugins.MQTT.Sessions.<SessionName>.Url Określa ciąg połączenia z brokerem MQTT dla nazwanej sesji.
Plugins.MQTT.Sessions.<SessionName>.User Określa nazwę użytkownika dla nazwanej sesji do łączenia z MQTT.

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.

Szczegóły parametru

Plugins.MQTT.Default.Password

Określ domyślne hasło do połączenia z MQTT.
Używane, jeśli nie podano wartości w kluczu pozycji lub nazwanej sesji.

Plugins.MQTT.Default.TLSCAFile

Określ pełną ścieżkę do pliku zawierającego certyfikaty głównych urzędów CA do weryfikacji certyfikatu peer dla szyfrowanej komunikacji między agent 2 Zabbix a brokerem MQTT.
Używane, jeśli w nazwanej sesji nie określono żadnej wartości.

Plugins.MQTT.Default.TLSCertFile

Określ pełną ścieżkę do pliku zawierającego certyfikat agenta lub łańcuch certyfikatów do szyfrowanej komunikacji między agentem Zabbix 2 a brokerem MQTT.
Używane, jeśli w nazwanej sesji nie określono żadnej wartości.

Plugins.MQTT.Default.TLSKeyFile

Określ pełną ścieżkę do pliku zawierającego prywatny klucz MQTT do szyfrowanej komunikacji między agentem Zabbix agent 2 a brokerem MQTT.
Używane, jeśli w nazwanej sesji nie określono żadnej wartości.

Plugins.MQTT.Default.Topic

Określa domyślny temat dla subskrypcji MQTT.
Używany, jeśli w kluczu pozycji lub nazwanej sesji nie zostanie określona żadna wartość.
Temat może zawierać symbole wieloznaczne ("+","#").

Przykłady:

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

Określa domyślny ciąg połączenia z brokerem MQTT.
Używany, jeśli w kluczu pozycja 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)

Domyślnie: tcp://localhost:1883

Przykłady:

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

Określa domyślną nazwę użytkownika do łączenia z MQTT.
Używana, jeśli nie określono wartości w kluczu pozycji lub nazwanej sesji.

Plugins.MQTT.Sessions.<SessionName>.Password

Określ hasło dla nazwanej sesji używane do połączenia z MQTT.
<SessionName> - określa nazwę sesji do użycia w kluczach pozycji.

Plugins.MQTT.Sessions.<SessionName>.TLSCAFile

Określ pełną ścieżkę do pliku zawierającego certyfikaty głównych urzędów CA do weryfikacji certyfikatu peer dla nazwanej sesji, używanej do szyfrowanej komunikacji między agentem Zabbix 2 a brokerem MQTT.
<SessionName> - określa nazwę sesji do użycia w kluczach pozycji.

Plugins.MQTT.Sessions.<SessionName>.TLSCertFile

Określ pełną ścieżkę do pliku zawierającego certyfikat agenta lub łańcuch certyfikatów dla nazwanego sesji, używanego do szyfrowanej komunikacji między Zabbix agent 2 a brokerem MQTT.
<SessionName> - określa nazwę sesji do użycia w kluczach pozycji.

Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile

Określ pełną ścieżkę do pliku zawierającego prywatny klucz MQTT dla nazwanego sesji, używanego do szyfrowanej komunikacji między agentem Zabbix 2 a brokerem MQTT.
<SessionName> - określa nazwę sesji do użycia w kluczach pozycji.

Plugins.MQTT.Sessions.<SessionName>.Topic

Określa nazwany temat sesji dla subskrypcji MQTT.
<SessionName> - określa 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

Określa ciąg połączenia z brokerem MQTT dla nazwanej sesji.
<SessionName> - określa nazwę sesji do użycia w kluczach pozycji.
Nie powinien zawierać parametrów zapytania.
Musi odpowiadać formatowi URL.
Obsługiwane schematy: tcp (domyślnie), ws, tls
Schemat może zostać pominięty.
Port może zostać pominięty (domyślnie=1883)

Domyślnie: tcp://localhost:1883

Przykłady:

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

Określa nazwę użytkownika dla nazwanej sesji używanej do łączenia z MQTT.
<SessionName> - określa nazwę sesji do użycia w kluczach pozycji.

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

Zobacz także