Documentation
4 Zabbix агент 2 (UNIX)
Overview
Zabbix agent 2 is a new generation of Zabbix agent and may be used in place of Zabbix agent.
The parameters supported by the Zabbix agent 2 configuration file (zabbix_agent2.conf) are listed in this section.
The parameters are listed without additional information. Click on the parameter to see the full details.
| Parameter | Description |
|---|---|
| Alias | Sets an alias for an item key. |
| AllowKey | Allow the execution of those item keys that match a pattern. |
| BufferSend | Do not keep data longer than N seconds in buffer. |
| BufferSize | The maximum number of values in the memory buffer. |
| ControlSocket | The control socket, used to send runtime commands with the '-R' option. |
| DebugLevel | The debug level. |
| DenyKey | Deny the execution of those item keys that match a pattern. |
| EnablePersistentBuffer | Enable the usage of local persistent storage for active items. |
| ForceActiveChecksOnStart | Perform active checks immediately after the restart for the first received configuration. |
| HeartbeatFrequency | The frequency of heartbeat messages in seconds. |
| HostInterface | An optional parameter that defines the host interface. |
| HostInterfaceItem | An optional parameter that defines an item used for getting the host interface. |
| HostMetadata | An optional parameter that defines the host metadata. |
| HostMetadataItem | An optional parameter that defines a Zabbix agent item used for getting the host metadata. |
| Hostname | An optional parameter that defines the hostname. |
| HostnameItem | An optional parameter that defines a Zabbix agent item used for getting the hostname. |
| Include | You may include individual files or all files in a directory in the configuration file. |
| ListenIP | A list of comma-delimited IP addresses that the agent should listen on. |
| ListenPort | The agent will listen on this port for connections from the server. |
| LogFile | The name of the log file. |
| LogFileSize | The maximum size of the log file. |
| LogType | The type of the log output. |
| PersistentBufferFile | The file where Zabbix agent 2 should keep the SQLite database. |
| PersistentBufferPeriod | The time period for which data should be stored when there is no connection to the server or proxy. |
| PidFile | The name of the PID file. |
| Plugins.<PluginName>.System.Capacity | The limit of checks per plugin that can be executed at the same time. |
| Plugins.Log.MaxLinesPerSecond | The maximum number of new lines the agent will send per second to Zabbix server or proxy when processing 'log' and 'logrt' active checks. |
| Plugins.SystemRun.LogRemoteCommands | Enable the logging of the executed shell commands as warnings. |
| PluginSocket | The path to the UNIX socket for loadable plugin communications. |
| PluginTimeout | The timeout for connections with loadable plugins, in seconds. |
| RefreshActiveChecks | How often the list of active checks is refreshed. |
| Server | A list of comma-delimited IP addresses, optionally in CIDR notation, or DNS names of Zabbix servers and Zabbix proxies. |
| ServerActive | The Zabbix server/proxy address or cluster configuration to get active checks from. |
| SourceIP | The source IP address. |
| StatusPort | If set, the agent will listen on this port for HTTP status requests (http://localhost:<port>/status). |
| Timeout | Specifies timeout for communications (in seconds). |
| TLSAccept | What incoming connections to accept. |
| TLSCAFile | The full pathname of a file containing the top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix components. |
| TLSCertFile | The full pathname of a file containing the agent certificate or certificate chain, used for encrypted communications between Zabbix components. |
| TLSConnect | How the agent should connect to Zabbix server or proxy. |
| TLSCRLFile | The full pathname of a file containing revoked certificates. This parameter is used for encrypted communications between Zabbix components. |
| TLSKeyFile | The full pathname of a file containing the agent private key, used for encrypted communications between Zabbix components. |
| TLSPSKFile | The full pathname of a file containing the agent pre-shared key, used for encrypted communications with Zabbix server. |
| TLSPSKIdentity | The pre-shared key identity string, used for encrypted communications with Zabbix server. |
| TLSServerCertIssuer | The allowed server (proxy) certificate issuer. |
| TLSServerCertSubject | The allowed server (proxy) certificate subject. |
| UnsafeUserParameters | Allow all characters to be passed in arguments to user-defined parameters. |
| UserParameter | A user-defined parameter to monitor. |
| UserParameterDir | The default search path for UserParameter commands. |
All parameters are non-mandatory unless explicitly stated that the parameter is mandatory.
Note that:
- The default values reflect process defaults, not the values in the shipped configuration files;
- Zabbix supports configuration files only in UTF-8 encoding without BOM;
- Comments starting with "#" are only supported in the beginning of the line.
Детаљи параметра
Алиас
Поставља алиас за кључ ставке. Може се користити за замену дугог и сложеног кључа ставке краћим и једноставнијим.
Може бити присутно више параметара Алиас. Више параметара са истим кључем Алиас нису дозвољени.
Различити кључеви Алиас могу референцирати исти кључ ставке.
Алиас се може користити у HostMetadataItem, али не и у параметру HostnameItem.
Пример 1: Преузимање ИД-а корисника 'zabbix'.
Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]
Сада се скраћени кључ zabbix.userid може користити за преузимање података.
Пример 2: Добијање искоришћења процесора са подразумеваним и прилагођеним параметрима.
Alias=cpu.util:system.cpu.util Alias=cpu.util[*]:system.cpu.util[*]
Ово омогућава коришћење кључа cpu.util за добијање процента искоришћења процесора са подразумеваним параметрима, као и коришћење cpu.util[all, idle, avg15] за добијање специфичних података о искоришћењу процесора.
Пример 3: Покретање више правила ниског нивоа откривања која обрађују исте ставке откривања.
Alias=vfs.fs.discovery[*]:vfs.fs.discovery
Сада је могуће подесити неколико правила откривања користећи vfs.fs.discovery са различитим параметрима за свако правило, нпр., vfs.fs.discovery[foo], vfs.fs.discovery[bar], итд.
AllowKey
Дозволите извршавање оних кључева ставки који одговарају шаблону. Образац кључа је џокерски израз који подржава знак "*" за подударање са било којим бројем било ког карактера.
Правила за подударање више кључева могу бити дефинисана у комбинацији са DenyKey-ом. Параметри се обрађују један по један према редоследу њиховог појављивања. Такође погледајте: Ограничавање провера агента.
BufferSend
Временски интервал у секундама који одређује колико често се вредности шаљу из бафера на Zabbix сервер. Имајте на уму да ако је бафер пун, подаци ће бити послати раније.
Подразумевано: 5
Опсег: 1-3600
BufferSize
Максималан број вредности у меморијском баферу. Агент ће послати све прикупљене податке на Заббик сервер или прокси ако је бафер пун. Овај параметар треба користити само ако је упорни бафер онемогућен (EnablePersistentBuffer=0).
Подразумевано: 1000
Опсег: 2-65535
ControlSocket
Контролна утичница, која се користи за слање команди за време извршавања са опцијом '-R'.
Подразумевано: /tmp/agent.sock
DebugLevel
Наведите ниво отклањања грешака:
0 - основне информације о покретању и заустављању Zabbix процеса
1 - критичне информације;
2 - информације о грешци;<бр>3 - упозорења;
4 - за отклањање грешака (производи пуно информација);
5 - проширено отклањање грешака (производи још више информација).
Подразумевано: 3
Опсег: 0-5
DenyKey
Одбијте извршење оних кључева ставки који одговарају шаблону. Образац кључа је џокер израз који подржава знак "*" за подударање са било којим бројем било ког карактера.
Правила за подударање више кључева могу да се дефинишу у комбинацији са AllowKey. Параметри се обрађују један по један према редоследу њиховог појављивања. Такође погледајте: Ограничавање провера агента.
EnablePersistentBuffer
Омогућите коришћење локалног трајног складишта за активне ставке. Ако је трајно складиштење онемогућено, користиће се меморијски бафер.
Подразумевано: 0<бр> Вредности: 0 - онемогућено, 1 - омогућено
ForceActiveChecksOnStart
Извршите активне провере одмах након поновног покретања за прву примљену конфигурацију. Такође доступан као конфигурациони параметар по додатку, на пример: Plugins.Uptime.System.ForceActiveChecksOnStart=1
Подразумевано: 0
Вредности: 0 - онемогућено, 1 - омогућено
HeartbeatFrequency
Учесталост порука откуцаја срца у секундама. Користи се за праћење доступности активних провера.
0 - поруке откуцаја срца су онемогућене.
Подразумевано: 60
Опсег: 0-3600
HostInterface
Опциони параметар који дефинише интерфејс домаћина. Интерфејс домаћина се користи у процесу аутоматска регистрација. Ако није дефинисана, вредност ће бити добијена од HostInterfaceItem.
Агент ће издати грешку и неће покренути ако вредност прелази ограничење од 255 знакова.
Опсег: 0-255 знакова
HostInterfaceItem
Опциони параметар који дефинише ставку која се користи за добијање интерфејса домаћина.
Интерфејс домаћина се користи у процесу ауторегистрације домаћина. Ова опција се користи само када HostInterface није дефинисан.
Ставка system.run[] је подржана без обзира на вредности AllowKey/DenyKey.
Током захтева за аутоматску регистрацију, агент ће евидентирати поруку упозорења ако вредност коју враћа наведена ставка прелази ограничење од 255 знакова.
HostMetadata
Опциони параметар који дефинише метаподатке домаћина. Метаподаци домаћина се користе само у процесу аутоматске регистрације домаћина. Ако није дефинисана, вредност ће бити преузета од HostMetadataItem.
Агент ће издати грешку и неће покренути ако је наведена вредност преко границе од 2034 бајта или низа који није UTF-8.
Опсег: 0-2034 бајта
HostMetadataItem
Опциони параметар који дефинише ставку која се користи за добијање метаподатака домаћина. Ова опција се користи само када HostMetadata није дефинисан. Подржани су кориснички параметри и алиаси. Ставка system.run[] је подржана без обзира на вредности AllowKey/DenyKey.
Вредност HostMetadataItem се преузима при сваком покушају аутоматске регистрације и користи се само у процесу аутоматске регистрације домаћина.
Током захтева за аутоматску регистрацију агент ће евидентирати поруку упозорења ако вредност коју враћа наведена ставка прелази ограничење од 65535 UTF-8 кодних тачака. Вредност коју враћа ставка мора бити UTF-8 стринг у супротном ће бити занемарена.
Hostname
Листа јединствених имена домаћина раздвојених зарезима, која разликују велика и мала слова. Обавезно за активне провере и мора да одговара именима домаћина како су конфигурисани на серверу. Вредност се добија из HostnameItem ако је недефинисана.
Дозвољени знакови: алфанумерички, '.', ' ', '_' и '-'. Максимална дужина: 128 знакова по имену домаћина, 2048 знакова за цео ред.
Подразумевано: Подешава ставку HostnameItem
HostnameItem
Опциони параметар који дефинише ставку која се користи за добијање имена домаћина. Ова опција се користи само када име домаћина није дефинисано. Кориснички параметри или алиаси нису подржани, али system.run[] ставка је подржана без обзира на вредности AllowKey/DenyKey.
Подразумевано: system.hostname
Include
Можете укључити појединачне датотеке или све датотеке у директоријуму у конфигурационој датотеци. Током инсталације Zabbix ће креирати директоријум укључивања у /usr/local/etc, осим ако се не промени током времена компајлирања. Путања може бити релативна у односу на локацију датотеке zabbix_agent2.conf.
Да бисте укључили само релевантне датотеке у наведени директоријум, џокер знак звездице је подржан за подударање шаблона.
Погледајте посебне напомене о ограничењима.
Пример:
ListenIP
Листа IP адреса раздвојених зарезима које агент треба да слуша. Прва IP адреса се шаље Zabbix серверу, ако се повезује на њега, ради преузимања листе активних провера.
Подразумевано: 0.0.0.0
ListenPort
Агент ће слушати на овом порту за везе са сервера.
Подразумевано: 10050
Опсег: 1024-32767
LogFile
Име датотеке евиденције.
Подразумевано: /tmp/zabbix_agent2.log
Обавезно: Да, ако је LogType подешен на * file*; иначе не
LogFileSize
Максимална величина датотеке евиденције у MB.
0 - онемогући аутоматску ротацију евиденције.
Напомена: Ако је достигнуто ограничење величине датотеке евиденције и ротација датотеке не успе, из било ког разлога, постојећа датотека евиденције се скраћује и почео изнова.
Подразумевано: 1
Распон: 0-1024
LogType
Тип излаза дневника:
* file* - упиши евиденцију у датотеку коју је навео параметар LogFile;
* system* - упиши дневник у сислог;
* console* - упиши дневник у стандардни излаз
Подразумевано: file
PersistentBufferFile
Датотека у којој Zabbix агент 2 треба да чува SQLite базу података. Мора бити пуно име датотеке. Овај параметар се користи само ако је трајни бафер омогућен (EnablePersistentBuffer=1).
PersistentBufferPeriod
Временски период за који подаци треба да се чувају када нема везе са сервером или проксијем. Старији подаци ће бити изгубљени. Подаци дневника ће бити сачувани. Овај параметар се користи само ако је трајни бафер омогућен (EnablePersistentBuffer=1).
Подразумевано: 1h
Опсег: 1m-365d
PidFile
Име PID датотеке.
Подразумевано: /tmp/zabbix_agent2.pid
Plugins.<PluginName>.System.Capacity
Ограничење провера по додатку <PluginName> које се могу извршити у исто време.
Подразумевано: 1000 Опсег: 1-1000
Plugins.Log.MaxLinesPerSecond
Максималан број нових линија које ће агент послати у секунди Zabbix серверу или проксију приликом обраде активних провера 'log' и 'logrt'. Наведена вредност ће бити замењена параметром 'maxlines', наведеним у кључу ставке 'log' и 'logrt'.
Напомена: Zabbix ће обрадити 10 пута више нових линија него што је подешено у MaxLinesPerSecond да би тражио обавезан низ у ставкама дневника.
Подразумевано: 20
Опсег: 1-1000
Plugins.SystemRun.LogRemoteCommands
Омогућите евидентирање извршених команди љуске као упозорења. Команде ће бити евидентиране само ако се изврше на даљину. Уноси дневника неће бити креирани ако се system.run[] покрене локално помоћу параметара HostMetadataItem, HostInterfaceItem или HostnameItem.
Подразумевано: 0
Вредности: 0 - онемогућено, 1 - омогућено
PluginSocket
Путања до UNIX утичнице за комуникацију са додацима који се могу учитати.
Подразумевано: /tmp/agent.plugin.sock
PluginTimeout
Временско ограничење за везе са додацима који се могу учитати, у секундама.
Подразумевано: Timeout
Опсег: 1-30
RefreshActiveChecks
Колико често се листа активних провера освежава, у секундама. Имајте на уму да ће након неуспеха освежавања активних провера следеће освежавање бити покушано за 60.
Подразумевано: 5
Опсег: 1-86400
Сервер
Листа IP адреса раздвојених зарезима, опционо у CIDR нотацији, или DNS имена Zabbix сервера или Zabbix проксија. Долазне везе ће бити прихваћене само од домаћина наведених овде. Ако је подршка за IPv6 омогућена, онда се '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' третирају једнако и '::/0' ће дозволити било коју IPv4 или IPv6 адресу. '0.0.0.0/0' се може користити за омогућавање било које IPv4 адресе. Размаци су дозвољени. Ако овај параметар није наведен, онемогућава пасивне провере и агент неће слушати ниједан TCP порт.
Пример:
ServerActive
Адреса Zabbix сервера/проксија или конфигурација кластера за добијање активних провера. Адреса сервера/проксија је IP адреса или DNS име и опционо порт одвојени двотачком.
Конфигурација кластера је једна или више адреса сервера одвојених тачком-зарезом. Може се навести више Zabbix сервера/кластера и Zabbix проксија, одвојених зарезом. Не треба наводити више од једног Zabbix проксија са сваког Zabbix сервера/кластера. Ако је наведен Zabbix прокси, онда не треба наводити Zabbix сервер/кластер за тај прокси.
Може се навести више адреса раздвојених зарезима да би се паралелно користило неколико независних Zabbix сервера. Размаци су дозвољени.
Ако порт није наведен, користи се подразумевани порт.
IPv6 адресе морају бити у угластим заградама ако је наведен порт за тог домаћина. Ако порт није наведен, угласте заграде за IPv6 адресе су опционе.
Ако овај параметар није наведен, активне провере су онемогућене.
Пример за Zabbix прокси:
ServerActive=127.0.0.1:10051
Пример за више сервера:
ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]
Пример за високу доступност:
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3
Пример за високу доступност са два кластера и једним сервером:
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain
SourceIP
Изворна IP адреса за:
- одлазне везе са Zabbix сервером или Zabbix прокси;
- успостављање конекција током извршавања неких ставки (web.page.get, net.tcp.port, etc.).
StatusPort
Ако је подешено, агент ће на овом порту слушати HTTP статусне захтеве (http://localhost:<port>/status).
Опсег: 1024-32767
Timeout
Одређује колико дуго треба чекати (у секундама) за успостављање везе и размену података са Zabbix проксијем или сервером.
Овај параметар дефинише трајање различитих операција, укључујући:
- чекање одговора од Zabbix сервера;
- слање захтева Zabbix серверу, укључујући active checks захтеве за конфигурацију и податке о ставкама;
- преузимање података дневника путем лог датотеке или праћења дневника догађаја у систему Windows;
- слање порука о откуцају срца;
- максимално трајање за vfs.* провере;
- служење као резервна опција у сценаријима где сервер или прокси старији од верзије 7.0 шаље провере без временских ограничења.
Подразумевано: 3
Опсег: 1-30
TLSAccept
Долазне везе за прихватање. Користи се за пасивне провере. Може се навести више вредности, одвојених зарезом:
* unencrypted* - прихвати везе без шифровања (подразумевано)
* psk* - прихвати везе са TLS-ом и унапред дељеним кључем (PSK)
cert - прихвати везе са TLS-ом и сертификатом
Обавезно: да, ако су дефинисани TLS сертификат или PSK параметри (чак и за * unencrypted* везу); иначе не
TLSCAFile
Пуна путања датотеке која садржи CA(е) сертификате највишег нивоа за верификацију равноправних сертификата, који се користи за шифровану комуникацију између Zabbix компоненти.
TLSCertFile
Пуна путања датотеке која садржи сертификат агента или ланац сертификата, који се користи за шифровану комуникацију са Zabbix компонентама.
TLSCipherAll
OpenSSL низ шифре (TLS 1.2). Заобиђите подразумеване критеријуме за избор комплета шифровања за шифровање засновано на сертификатима и ПСК-у.
Пример:
EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128
TLSCipherAll13
OpenSSL низ за шифровање (TLS 1.3) за OpenSSL 1.1.1 или новији. Замените подразумеване критеријуме за избор пакета шифровања за шифровање засновано на сертификату и PSK-у.
Пример:
TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSCipherCert
OpenSSL низ шифре (TLS 1.2). Замени подразумеване критеријуме за избор шифровања за шифровање засновано на сертификатима.
Пример:
EECDH+aRSA+AES128:RSA+aRSA+AES128
Имајте на уму да се овај параметар не може користити заједно са TLSAccept=cert,psk; за везу са сертификатом (TLSConnect=cert) уместо тога користите TLSCipherAll.
TLSCipherCert13
Шифра OpenSSL-а (TLS 1.3) за OpenSSL 1.1.1 или новији. Замените подразумеване критеријуме за избор шифре за шифровање засновано на сертификату.
Имајте на уму да се овај параметар не може користити заједно са TLSAccept=cert,psk; за повезивање сертификата (TLSConnect=cert) уместо тога користите TLSCipherAll13.
TLSCipherPSK
Шифра OpenSSL низа (TLS 1.2). Замените подразумеване критеријуме за избор шифре за шифровање засновано на PSK-у.
Пример:
kECDHEPSK+AES128:kPSK+AES128
TLSCipherPSK13
Шифра OpenSSL (TLS 1.3) за OpenSSL 1.1.1 или новији. Замените подразумеване критеријуме за избор шифре за шифровање засновано на PSK-у.
Пример:
TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256
TLSConnect
Како агент треба да се повеже са Zabbix сервером или проки сервером. Користи се за активне провере. Може се навести само једна вредност:
* unencrypted* - повезивање без шифровања (подразумевано)
psk - повезивање помоћу TLS-а и унапред дељеног кључа (PSK)<бр>cert - повезивање помоћу TLS-а и сертификат
Обавезно: да, ако су дефинисани TLS сертификат или PSK параметри (чак и за нешифровану везу); иначе не
TLSCRLFile
Пуна путања датотеке која садржи опозване сертификате. Овај параметар се користи за шифровану комуникацију између Zabbix компоненти.
TLSKeyFile
Пуна путања датотеке која садржи приватни кључ агента, који се користи за шифровану комуникацију између Zabbix компоненти.
TLSPSKFile
Пуна путања датотеке која садржи претходно дељени кључ агента, који се користи за шифровану комуникацију са Zabbix сервером.
TLSPSKIdentity
Низ идентитета унапред дељеног кључа, који се користи за шифровану комуникацију са Zabbix сервером.
TLSServerCertIssuer
Издавач сертификата дозвољеног сервера (прокси).
TLSServerCertSubject
Предмет сертификата дозвољеног сервера (прокси).
UnsafeUserParameters
Дозволите да се сви знакови прослеђују у аргументима кориснички дефинисаним параметрима. Следећи знакови нису дозвољени: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @
Поред тога, знакови новог реда нису дозвољени.
Подразумевано: 0
Вредности: 0 - не дозвољава, 1 - дозвољава
UserParameter
Кориснички дефинисан параметар за праћење. Може постојати неколико кориснички дефинисаних параметара.
Формат: UserParameter=<key>,<shell command>
Имајте на уму да команда љуске не сме да враћа празан стринг или само EOL. Команде љуске могу имати релативне путање ако је наведен параметар UserParameterDir.
Пример:
UserParameterDir
Подразумевана путања за претрагу за команде UserParameter. Ако се користи, агент ће променити свој радни директоријум у онај који је овде наведен пре извршавања команде. Стога команде UserParameter могу имати релативни префикс ./ уместо пуне путање.
Дозвољен је само један унос.
Пример: