MQTT spraudnis

Pārskats

Konfigurācijas parametri ļauj pielāgot MQTT spraudņa darbību.

Ieteicams tos norādīt atsevišķā konfigurācijas failā (piem., mqtt.conf), nevis aģenta 2 konfigurācijas failā. Pēc tam izmantojiet direktīvu Include, lai iekļautu šo failu Zabbix aģenta 2 konfigurācijā.

Visi parametri ir neobligāti, ja vien nav skaidri norādīts, ka parametrs ir obligāts.

Ņemiet vērā:

  • Noklusējuma vērtības atspoguļo procesa noklusējumus, nevis vērtības piegādātajos konfigurācijas failos;
  • Vērtības atbalsta vides mainīgos;
  • Zabbix atbalsta konfigurācijas failus tikai UTF-8 kodējumā bez BOM;
  • Komentāri, kas sākas ar "#", tiek atbalstīti tikai rindas sākumā.

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.

Parametri

Parameter Mandatory Range Default Description
Plugins.MQTT.Default.Password no Noklusējuma parole savienojumam ar MQTT; tiek izmantota, ja nav norādīta vērtība vienuma atslēgā vai nosauktā sesijā.
Plugins.MQTT.Default.TLSCAFile no Pilns faila ceļš uz failu, kurā ir augstākā līmeņa CA sertifikāti savstarpējai sertifikātu verifikācijai šifrētai saziņai starp Zabbix aģents 2 un MQTT brokeri; tiek izmantots, ja nav norādīta vērtība nosauktā sesijā.
Plugins.MQTT.Default.TLSCertFile no Pilns faila ceļš uz failu, kurā ir aģenta sertifikāts vai sertifikātu ķēde šifrētai saziņai starp Zabbix aģents 2 un MQTT brokeri; tiek izmantots, ja nav norādīta vērtība nosauktā sesijā.
Plugins.MQTT.Default.TLSKeyFile no Pilns faila ceļš uz failu, kurā ir MQTT privātā atslēga šifrētai saziņai starp Zabbix aģents 2 un MQTT brokeri; tiek izmantots, ja nav norādīta vērtība nosauktā sesijā.
Plugins.MQTT.Default.Topic no Noklusējuma tēma MQTT abonēšanai; tiek izmantota, ja nav norādīta vērtība vienuma atslēgā vai nosauktā sesijā.

Tēma var saturēt aizstājējzīmes ("+","#")
Piemēri: path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Default.Url no tcp://localhost:1883 Noklusējuma MQTT brokera savienojuma virkne; tiek izmantota, ja nav norādīta vērtība vienuma atslēgā vai nosauktā sesijā.

Nejāiekļauj vaicājuma parametrus.
Jāatbilst URL formātam.
Atbalstītās shēmas: tcp (noklusējums), ws, tls; shēmu var neuzrādīt.
Portu var neuzrādīt (noklusējums=1883).
Piemēri: tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Default.User no Noklusējuma lietotājvārds savienojumam ar MQTT; tiek izmantots, ja nav norādīta vērtība vienuma atslēgā vai nosauktā sesijā.
Plugins.MQTT.Sessions.<SessionName>.Password no Nosauktās sesijas parole.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.
Plugins.MQTT.Sessions.<SessionName>.TLSCAFile no Pilns faila ceļš uz failu, kurā ir augstākā līmeņa CA sertifikāti savstarpējai sertifikātu verifikācijai, ko izmanto šifrētai saziņai starp Zabbix aģents 2 un MQTT brokeri.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.
Plugins.MQTT.Sessions.<SessionName>.TLSCertFile no Pilns faila ceļš uz failu, kurā ir aģenta sertifikāts vai sertifikātu ķēde, ko izmanto šifrētai saziņai starp Zabbix aģents 2 un MQTT brokeri.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.
Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile no Pilns faila ceļš uz failu, kurā ir MQTT privātā atslēga, ko izmanto šifrētai saziņai starp Zabbix aģents 2 un MQTT brokeri.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.
Plugins.MQTT.Sessions.<SessionName>.Topic no Nosauktās sesijas tēma MQTT abonēšanai.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.

Tēma var saturēt aizstājējzīmes ("+","#")
Piemēri: path/to/file
path/to/#
path/+/topic
Plugins.MQTT.Sessions.<SessionName>.Url no Nosauktās sesijas savienojuma virkne.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.

Nejāiekļauj vaicājuma parametrus.
Jāatbilst URL formātam.
Atbalstītās shēmas: tcp (noklusējums), ws, tls; shēmu var neuzrādīt.
Portu var neuzrādīt (noklusējums=1883).
Piemēri: tcp://host:1883
localhost
ws://host:8080
Plugins.MQTT.Sessions.<SessionName>.User no Nosauktās sesijas lietotājvārds.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienumu atslēgās.

Ja nepieciešams iestatīt pieprasījuma izpildes noildzi (cik ilgi gaidīt, līdz pieprasījums tiek pabeigts, pirms to aptur), izmantojiet vienuma konfigurācijas formu.

Skatiet arī: