6 Zabbix agent 2 (Windows)

Преглед

Zabbix агент 2 је нова генерација Zabbix агента и може се користити уместо Zabbix агента.

Параметри које подржава Windows Zabbix агент 2 конфигурациона датотека (zabbix_agent2.conf) су наведени у овом одељку.

Параметри су наведени без додатних информација. Кликните на параметар да видите све детаље.

Parameter Description
Alias Поставља псеудоним за кључ ставке.
AllowKey Дозволи извршавање оних кључева ставки који одговарају шаблону.
BufferSend Не чувајте податке дуже од N секунди за бафер.
BufferSize Максимални број вредности у меморијском баферу.
ControlSocket Контролна утичница, која се користи за слање команди времена извршавања са опцијом '-R'.
DebugLevel Ниво за отклањање грешака.
DenyKey Одбиј извршавање оних кључева ставки који се подударају са шаблоном.
EnablePersistentBuffer Омогућите коришћење локалног трајног складишта за активне ставке.
ForceActiveChecksOnStart Извршите активне провере одмах након поновног покретања за први пут примљен конфигурација.
HeartbeatFrequency Учесталост порука откуцаја срца у секундама.
HostInterface Опционални параметар који дефинише интерфејс домачина.
HostInterfaceItem Опциони параметар који дефинише ставку која се користи за добијање интерфејса домаћина.
HostMetadata Опционални параметар који дефинише метаподатке домаћина.
HostMetadataItem Опционални параметар који дефинише ставку Zabbix агента која се користи за добијање метаподатака домачина.
Hostname Опционални параметар који дефинише име домаћина.
HostnameItem
Include Можете укључити појединачне датотеке или све датотеке у директоријуму у конфигурациона датотека.
ListenIP Листа IP адреса раздвојених зарезима које агент треба да слуша он.
ListenPort Агент ће слушати на овом порту за везе са сервера.
LogFile Име датотеке евиденције.
LogFileSize Максимална величина датотеке евиденције.
LogType Тип излаза дневника.
PersistentBufferFile Датотека у којој Zabbix агент 2 треба да чува SQLite базу података.
PersistentBufferPeriod Временски период за који подаци треба да се чувају када нема везе са сервером или проксијем.
Plugins.<PluginName>.System.Capacity Ограничење провера по додатку које се могу извршити истовремено.
Plugins.Log.MaxLinesPerSecond Максимални број нових линија на које ће агент послати у секунди Zabbix серверa или проксија приликом обраде активних провера 'log' и 'logrt'.
Plugins.SystemRun.LogRemoteCommands Омогућите евидентирање извршених команди љуске као упозорења.
PluginSocket Путања до UNIX-а утичница за комуникацију додатака који се могу учитати.
PluginTimeout Временско ограничење за везе са додацима који се могу учитати, у секундама.
RefreshActiveChecks Колико често се листа активних провера освежава.
Server Листа IP адреса раздвојених зарезима, опционо у CIDR нотацији, или DNS имена Zabbix сервера и Zabbix проксија.
ServerActive Zabbix сервер/прокси адреса или конфигурација кластера за добијање активних провера.
SourceIP Изворна IP адреса.
StatusPort Ако је подешено, агент ће на овом порту слушати HTTP статусне захтеве (http://localhost:<port>/status).
Timeout Одређује колико дуго треба чекати (у секундама) за успостављање везе и размену података са Zabbix проки-јем или сервером.
TLSAccept Које долазне везе прихватити.
TLSCAFile Пуна путања датотеке која садржи CA сертификате највишег нивоа за верификацију сертификата равноправних корисника, који се користи за шифровану комуникацију између Zabbix компоненти.
TLSCertFile Пуна путања датотеке која садржи сертификат агента или ланац сертификата, који се користи за шифровану комуникацију између Zabbix компоненти.
TLSCipherAll13 OpenSSL низ шифре (TLS 1.3). Заобиђите подразумеване критеријуме за избор комплета шифровања за шифровање засновано на сертификатима и PSK-у.
TLSCipherCert13 Стринг шифровања OpenSSL (TLS 1.3). Заобиђите подразумеване критеријуме за избор комплета шифровања за шифровање засновано на сертификатима.
TLSCipherPSK13 OpenSSL низ шифровања (TLS 1.3). Замени подразумеване критеријуме за избор шифрованог пакета за шифровање засновано на PSK-у.
TLSConnect
TLSCRLFile Пуна путања датотеке која садржи опозване сертификате. Овај параметар се користи за шифровану комуникацију између Zabbix компоненти.
TLSKeyFile Пуна путања датотеке која садржи приватни кључ агента, који се користи за шифровану комуникацију између Zabbix компоненти.
TLSPSKFile Пуна путања датотеке која садржи претходно дељени кључ агента, који се користи за шифровану комуникацију са Zabbix-ом сервер.
TLSPSKIdentity Стринг идентитета унапред дељеног кључа, који се користи за шифровану комуникацију са Zabbix сервером.
TLSServerCertIssuer
TLSServerCertSubject Дозвољени сервер (прокси) предмет сертификата.
UnsafeUserParameters Дозволи да се сви знакови прослеђују у аргументима кориснички дефинисаним параметрима.
UserParameter Кориснички дефинисан параметар за надгледање.
UserParameterDir Подразумевана путања за претрагу команди UserParameter.

Сви параметри су није обавезан осим ако је изричито наведено да је параметар обавезан.

Имајте на уму да:

  • Подразумеване вредности одражавају подразумеване вредности процеса, а не вредности у испорученим конфигурационим датотекама;
  • Zabbix подржава конфигурационе датотеке само у UTF-8 кодирању без BOM;
  • Коментари који почињу са "#" су подржани само на почетку реда.

Детаљи параметра

Алиас

Поставља псеудоним за кључ ставке. Може да се користи за замену дугачког и сложеног кључа ставке краћим и једноставнијим.
Може бити присутно више параметара * Alias. Више параметара са истим кључем Alias* није дозвољено.
Различити кључеви * Alias* могу упућивати на исти кључ ставке.
Псеудоними се могу користити у HostMetadataItem, али не и у параметру HostnameItem.

Пример 1 : Преузимање фајла страничне меморије у процентима из серверa.

 Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]

Сада се скраћени кључ ** pg_usage** може користити за преузимање података.

Пример 2: Добијање оптерећења CPU-а са подразумеваним и прилагођеним параметрима.

 Alias=cpu.load:system.cpu.load
        Alias=cpu.load[*]:system.cpu.load[*]

Ово омогућава коришћење cpu.load кључ да бисте добили оптерећење CPU-а са подразумеваним параметрима, као и користите cpu.load[percpu,avg15] да бисте добили специфичне податке о оптерећењу CPU-а.

Пример 3: Покретање вишеструких откриће ниског нивоа правила која обрађују исто откриће ставке.

 Alias=vfs.fs.discovery[*]:vfs.fs.discovery

Сада је могуће подесити неколико правила откривања користећи vfs.fs.discovery са различитим параметрима за свако правило, нпр. vfs.fs.discovery[foo], vfs.fs.discovery[bar], итд.

Дозволи кључ

Дозволите извршавање оних кључева ставки који одговарају шаблону. Образац кључа је џокерски израз који подржава знак „*“ за подударање са било којим бројем било ког карактера.
Правила за подударање више кључева могу бити дефинисана у комбинацији са DenyKey-ом. Параметри се обрађују један по један према редоследу њиховог појављивања. Такође погледајте: Ограничавање провера агента.

Слање бафера

Временски интервал у секундама који одређује колико често се вредности шаљу из бафера на Zabbix сервер.
Имајте на уму да ако је бафер пун, подаци ће бити послати раније.

Подразумевано: 5
Опсег: 1-3600

Величина бафера

Максималан број вредности у меморијском баферу. Агент ће послати све прикупљене податке Zabbix серверу или проксију ако је бафер пун.
Овај параметар би требало да се користи само ако је трајни бафер онемогућен (EnablePersistentBuffer=0).

Подразумевано: 1000
Распон : 2-65535

Контролна утичница

Контролна утичница, која се користи за слање команди за време извршавања са опцијом '##### Контролна утичница

Контролна утичница, која се користи за слање команди за време извршавања са опцијом '-R'.

Подразумевано: \\.\pipe\agent.sock

Ниво отклањања грешака

Наведите ниво отклањања грешака:
0 - основне информације о покретању и заустављању Zabbix процеса
1 - критичне информације;
2 - информације о грешци;<бр>3 - упозорења;
4 - за отклањање грешака (производи пуно информација);
5 - проширено отклањање грешака (производи још више информација).

Подразумевано: 3
Опсег: 0-5

Одбијање кључа

Одбијте извршење оних кључева ставки који одговарају шаблону. Образац кључа је џокер израз који подржава знак „*“ за подударање са било којим бројем било ког карактера.<бр>Правила за подударање више кључева могу да се дефинишу у комбинацији са AllowKey. Параметри се обрађују један по један према редоследу њиховог појављивања. Такође погледајте: Ограничавање провера агента.

Омогући трајни бафер

Омогућите коришћење локалног трајног складишта за активне ставке. Ако је трајно складиштење онемогућено, користиће се меморијски бафер. Подразумевано: 0<бр>Вредности: 0 - онемогућено, 1 - омогућено

Форсирај Активне Провере При Покретању

Извршите активне провере одмах након поновног покретања за прву примљену конфигурацију. Такође доступан као конфигурациони параметар по додатку, на пример: Plugins.Uptime.System.ForceActiveChecksOnStart=1

Подразумевано: 0
Вредности: 0 - онемогућено, 1 - омогућено

Фреквенција откуцаја срца

Учесталост порука откуцаја срца у секундама. Користи се за праћење доступности активних провера.
0 - поруке откуцаја срца су онемогућене.

Подразумевано: 60
Опсег: 0-3600

Интерфејс домаћина

Опциони параметар који дефинише интерфејс домаћина. Интерфејс домаћина се користи у процесу аутоматска регистрација. Ако није дефинисана, вредност ће бити добијена од HostInterfaceItem.<бр>Агент ће издати грешку и неће покренути ако вредност прелази ограничење од 255 знакова.

Опсег: 0-255 знакова

Ставка интерфејса домаћина

Опциони параметар који дефинише ставку која се користи за добијање интерфејса домаћина.<бр>Интерфејс домаћина се користи у процесу домаћина ауторегистрација. Ова опција се користи само када HostInterface није дефинисан.
Ставка system.run[] је подржана без обзира на вредности AllowKey/DenyKey .<br >Током захтева за аутоматску регистрацију агент ће евидентирати поруку упозорења ако је вредност враћена од стране наведене ставке преко границе од 255 ликова.

Метаподаци домаћина

Опциони параметар који дефинише метаподатке домаћина. Метаподаци домаћина се користе само у процесу аутоматске регистрације домаћинаHostMetadataItem (активни агент). Ако није дефинисана, вредност ће бити преузета од HostMetadataItem.
Агент ће издати грешку и неће покренути ако је наведена вредност преко границе од 2034 бајта или низа који није UTF-8.

Опсег: 0-2034 бајта

Ставка метаподатака домаћина

Опциони параметар који дефинише ставку која се користи за добијање метаподатака домаћина. Ова опција се користи само када HostMetadata није дефинисан. Подржани су кориснички параметри и алиаси. Ставка system.run[] је подржана без обзира на вредности AllowKey/DenyKey .
Вредност HostMetadataItem се преузима при сваком покушају аутоматске регистрације и користи се само у процесу аутоматске регистрације домаћина.
Током захтева за аутоматску регистрацију агент ће евидентирати поруку упозорења ако вредност коју враћа наведена ставка прелази ограничење од 65535 UTF-8 кодних тачака. Вредност коју враћа ставка мора бити UTF-8 стринг у супротном ће бити занемарена.

Име домаћина

Листа јединствених имена домаћина раздвојених зарезима, која разликују велика и мала слова. Обавезно за активне провере и мора да одговара именима домаћина како су конфигурисани на серверу. Вредност се добија из HostnameItem ако је недефинисана.<бр>Дозвољени знакови: алфанумерички, '.', ' ', '_' и '-'. Максимална дужина: 128 знакова по имену домаћина, 2048 знакова за цео ред.

Подразумевано: Подешава ставку HostnameItem

Ставка назива домаћина

Опциони параметар који дефинише ставку која се користи за добијање имена домаћина. Ова опција се користи само када име домаћина није дефинисано. Кориснички параметри или алиаси нису подржани, али system.run[] ставка је подржана без обзира на вредности AllowKey/DenyKey.

Подразумевано: system.hostname

Укључује

Можете укључити појединачне датотеке или све датотеке у директоријуму у конфигурационој датотеци (која се подразумевано налази у C:\Program Files\Zabbix Agent 2 ако је Zabbix агент инсталиран помоћу Windows MSI инсталационих пакета; налази се у фасцикли наведеној током инсталације ако Zabbix агент је инсталиран као зип архива). Све укључене датотеке морају имати тачну синтаксу, иначе се агент неће покренути. Путања може бити релативна у односу на локацију датотеке zabbix_agent2.conf (нпр. Include=.\zabbix_agent2.d\plugins.d\*.conf).
Да бисте укључили само релевантне датотеке у наведени директоријум, џокер знак звездице је подржан за подударање шаблона.
Погледајте посебне напомене о ограничења.

Пример:

Инцлуде=Include=C:FilesAgent2_agent2.d*.conf

Слушање IP

Листа IP адреса раздвојених зарезима које агент треба да слуша. Прва IP адреса се шаље Zabbix серверу, ако се повезује на њега, ради преузимања листе активних провера.

Подразумевано: 0.0.0.0

Слушање Порта

Агент ће слушати на овом порту за везе са сервера.

Подразумевано: 10050
Опсег: 1024-32767

Дневник

Име датотеке дневника агента.

Подразумевано: c:\\zabbix_agent2.log
Обавезно: Да, ако је LogType подешен на * file*; иначе не

Величина датотеке дневника

Максимална величина датотеке евиденције у MB.
0 - онемогући аутоматску ротацију евиденције.
Напомена: Ако је достигнуто ограничење величине датотеке евиденције и ротација датотеке не успе, из било ког разлога, постојећа датотека евиденције се скраћује и почео изнова.

Подразумевано: 1
Распон: 0-1024

Тип дневника

Тип излаза дневника:
* file* - упишите дневник у датотеку коју је навео параметар LogFile;
* console* - упишите дневник у стандардни излаз.

Подразумевано: file

Трајна датотека бафера

Датотека у којој Zabbix агент 2 треба да чува SQLite базу података. Мора бити пуно име датотеке. Овај параметар се користи само ако је трајни бафер омогућен (EnablePersistentBuffer=1).

Период постојаног бафера

Временски период за који подаци треба да се чувају када нема везе са сервером или проксијем. Старији подаци ће бити изгубљени. Подаци дневника ће бити сачувани. Овај параметар се користи само ако је трајни бафер омогућен (EnablePersistentBuffer=1).

Подразумевано:
Опсег: 1м-365д

Plugins.<PluginName>.System.Capacity

Ограничење провера по додатку <PluginName> које се могу извршити у исто време.

Подразумевано: 1000 Опсег: 1-1000

Plugins.Log.MaxLinesPerSecond

Максималан број нових линија које ће агент послати у секунди Zabbix серверу или проксију приликом обраде активних провера 'log', 'logrt' и 'eventlog'. Наведена вредност ће бити замењена параметром 'maxlines', наведеним у кључу ставке 'log', 'logrt' или 'eventlog'.
Напомена: Zabbix ће обрадити 10 пута више нових линија него што је подешено у MaxLinesPerSecond за тражење захтеваног стринга у ставкама дневника.

Подразумевано: 20
Опсег: 1-1000

Plugins.SystemRun.LogRemoteCommands

Омогућите евидентирање извршених команди љуске као упозорења. Команде ће бити евидентиране само ако се изврше на даљину. Уноси дневника неће бити креирани ако се system.run[] покрене локално помоћу параметара HostMetadataItem, HostInterfaceItem или HostnameItem.

Подразумевано: 0
Вредности: 0 - онемогућено, 1 - омогућено

Прикључни Сокет

Путања до UNIX утичнице за комуникацију додатака који се могу учитати.

Подразумевано: \\.\pipe\agent.plugin.sock

Време истека за прикључак

Временско ограничење за везе са додацима који се могу учитати, у секундама.

Подразумевано: Timeout
Опсег: 1-30

Освежи активне провере

Колико често се листа активних провера освежава, у секундама. Имајте на уму да ће након неуспеха освежавања активних провера следеће освежавање бити покушано за 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 адресе. Размаци су дозвољени.

Пример:

 Сервер=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

Обавезно: да

Сервер активан

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

Изворна IP адреса

Изворна IP адреса за:
- одлазне везе са Zabbix сервером или Zabbix прокси;
- успостављање конекција током извршавања неких ставки (web.page.get, net.tcp.port, etc.).

Статус Портa

Ако је подешено, агент ће на овом порту слушати HTTP статусне захтеве (http://localhost:<port>/status).

Опсег: 1024-32767

Време истека

Одређује колико дуго треба чекати (у секундама) за успостављање везе и размену података са Zabbix проксијем или сервером.
Овај параметар дефинише трајање различитих операција, укључујући:
- чекање на одговор од Zabbix сервера;
- слање захтева на Zabbix сервер, укључујући активне провере конфигурационе захтеве и ставке подаци;
- преузимање података евиденције путем датотеке евиденције или надгледања Windows евиденције догађаја;
- слање порука откуцаја срца;
- максимално трајање за vfs.* провере;
- служе као резервни случај у сценаријима где сервер или прокси старији од верзије 7.0 шаље чекове без истека времена.

Подразумевано: 3
Опсег: 1-30

TLS прихвата

Долазне везе за прихватање. Користи се за пасивне провере. Може се навести више вредности, одвојених зарезом:
* unencrypted* - прихвати везе без шифровања (подразумевано)
* psk* - прихвати везе са TLS-ом и унапред дељеним кључем (PSK)
cert - прихвати везе са TLS-ом и сертификатом

Обавезно: да, ако су дефинисани TLS сертификат или PSK параметри (чак и за * unencrypted* везу); иначе не

TLS CA датотека

Пуна путања датотеке која садржи CA(е) сертификате највишег нивоа за верификацију равноправних сертификата, који се користи за шифровану комуникацију између Zabbix компоненти.

TLS датотека сертификата

Пуна путања датотеке која садржи сертификат агента или ланац сертификата, који се користи за шифровану комуникацију са Zabbix компонентама.

TLS шифра све 13

OpenSSL низ шифре (TLS 1.3). Заобиђите подразумеване критеријуме за избор комплета шифровања за шифровање засновано на сертификатима и PSK-у.

Пример:

 TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

Овај параметар је подржан од Zabbix 7.0.4.

TLS сертификат шифре 13

OpenSSL низ шифре (TLS 1.3). Заобиђите подразумеване критеријуме за избор шифровања за шифровање засновано на сертификатима.

Имајте на уму да се овај параметар не може користити заједно са TLSAccept=cert,psk``; за везу са сертификатом (TLSConnect=cert`) уместо тога користите TLSCipherAll13.

Овај параметар је подржан од Zabbix-а 7.0.4.

TLS шифра PSK 13

OpenSSL низ шифре (TLS 1.3). Заобиђите подразумеване критеријуме за избор шифрованог пакета за шифровање засновано на PSK-у.

Пример:

 TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

Овај параметар је подржан од Zabbix-а 7.0.4.

TLS повезивање

Како агент треба да се повеже са Zabbix сервером или проки сервером. Користи се за активне провере. Може се навести само једна вредност:
* unencrypted* - повезивање без шифровања (подразумевано)
psk - повезивање помоћу TLS-а и унапред дељеног кључа (PSK)<бр>cert - повезивање помоћу TLS-а и сертификат

Обавезно: да, ако су дефинисани TLS сертификат или PSK параметри (чак и за нешифровану везу); иначе не

TLS CRL датотека

Пуна путања датотеке која садржи опозване сертификате. Овај параметар се користи за шифровану комуникацију између Zabbix компоненти.

TLS кључна датотека

Пуна путања датотеке која садржи приватни кључ агента, који се користи за шифровану комуникацију између Zabbix компоненти.

TLS PSK датотека

Пуна путања датотеке која садржи претходно дељени кључ агента, који се користи за шифровану комуникацију са Zabbix сервером.

TLS PSK идентитет

Низ идентитета унапред дељеног кључа, који се користи за шифровану комуникацију са Zabbix сервером.

Издавач сертификата TLS сервера

Издавач сертификата дозвољеног сервера (прокси).

Предмет сертификата TLS сервера

Предмет сертификата дозвољеног сервера (прокси).

Небезбедни кориснички параметри

Дозволите да се сви знакови прослеђују у аргументима кориснички дефинисаним параметрима. Следећи знакови нису дозвољени: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @
Поред тога, знакови новог реда нису дозвољени.

Подразумевано: 0
Вредности: 0 - не дозвољава, 1 - дозвољава

Кориснички параметар

Кориснички дефинисан параметар за праћење. Може постојати неколико кориснички дефинисаних параметара.
Формат: UserParameter=<key>,<shell command>
Имајте на уму да команда љуске не сме да враћа празан стринг или само EOL. Команде љуске могу имати релативне путање ако је наведен параметар UserParameterDir.

Пример:

 UserParameter=system.test,who|wc -l
        UserParameter=check_cpu,./custom_script.sh
Директоријум корисничког параметра

Подразумевана путања за претрагу за команде UserParameter. Ако се користи, агент ће променити свој радни директоријум у онај који је овде наведен пре извршавања команде. Стога команде UserParameter могу имати релативни префикс ./ уместо пуне путање.
Дозвољен је само један унос.

Пример:

 UserParameterDir=/opt/myscripts