Zabbix агент 2 је нова генерација Zabbix агента и може се користити уместо Zabbix агента.
Параметри које подржава конфигурациона датотека Windows Zabbix агента 2 (zabbix_agent2.conf) наведени су у овом одељку.
Параметри су наведени без додатних информација. Кликните на параметар да бисте видели све детаље.
Параметар | Опис |
---|---|
Alias | Поставља алиас за кључ ставке. |
AllowKey | Дозвољава извршавање оних кључева ставке који одговарају шаблону. |
BufferSend | Не чувајте податке дуже од N секунди у баферу. |
BufferSize | Максималан број вредности у меморијском баферу. |
ControlSocket | Контролни сокет, који се користи за слање команди током извршавања са опцијом '-R'. |
DebugLevel | Ниво дебаговања. |
DenyKey | Забрањује извршавање оних кључева ставки који одговарају шаблону. |
EnablePersistentBuffer | Омогућава коришћење локалне трајне меморије за активне ставке. |
ForceActiveChecksOnStart | Извршава активне провере одмах након поновног покретања за прву примљену конфигурацију. |
HeartbeatFrequency | Учесталост порука откуцаја срца у секундама. |
HostInterface | Опциони параметар који дефинише интерфејс хоста. |
HostInterfaceItem | Опциони параметар који дефинише ставку која се користи за добијање интерфејса хоста. |
HostMetadata | Опциони параметар који дефинише метаподатке хоста. |
HostMetadataItem | Опциони параметар који дефинише ставку Zabbix агента која се користи за добијање метаподатака хоста. |
Hostname | Опциони параметар који дефинише име хоста. |
HostnameItem | Опциони параметар који дефинише ставку Zabbix агента која се користи за добијање имена хоста. |
Include | Можете укључити појединачне датотеке или све датотеке у директоријуму у конфигурационој датотеци. |
ListenIP | Листа IP адреса раздвојених зарезима на којима агент треба да слуша. |
ListenPort | Агент ће слушати на овом порту за везе са сервера. |
LogFile | Назив датотеке дневника. |
LogFileSize | Максимална величина датотеке дневника. |
LogType | Тип излаза дневника. |
PersistentBufferFile | Датотека у којој Zabbix агент 2 треба да чува SQLite базу података. |
PersistentBufferPeriod | Временски период за који подаци треба да се чувају када нема везе са сервером или проксијем. |
Plugins.<PluginName>.System.Capacity | Ограничење провера по додатку које се могу извршити истовремено. |
Plugins.Log.MaxLinesPerSecond | Максималан број нових линија које ће агент слати у секунди Zabbix серверу или проксију приликом обраде активних провера '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 | Одређује време чекања за комуникацију (у секундама). |
TLSAccept | Које долазне везе треба прихватити. |
TLSCAFile | Пуна путања датотеке која садржи сертификате CA највишег нивоа за верификацију сертификата вршњака, која се користи за шифровану комуникацију између Zabbix компоненти. |
TLSCertFile | Пуна путања датотеке која садржи сертификат агента или ланац сертификата, који се користи за шифровану комуникацију између Zabbix компоненти. |
TLSConnect | Како агент треба да се повеже са Zabbix сервером или проксијем. |
TLSCRLFile | Пуна путања датотеке која садржи опозване сертификате. Овај параметар се користи за шифровану комуникацију између Zabbix компоненти. |
TLSKeyFile | Пуна путања датотеке која садржи приватни кључ агента, који се користи за шифровану комуникацију између Zabbix компоненти. |
TLSPSKFile | Пуна путања датотеке која садржи унапред дељени кључ агента, који се користи за шифровану комуникацију са Zabbix сервером. |
TLSPSKIdentity | Низ идентитета унапред дељеног кључа, који се користи за шифровану комуникацију са Zabbix сервером. |
TLSServerCertIssuer | Дозвољени издавалац сертификата сервера (проксија). |
TLSServerCertSubject | Дозвољени субјект сертификата сервера (проксија). |
UnsafeUserParameters | Дозвољава прослеђивање свих знакова у аргументима кориснички дефинисаним параметрима. |
UserParameter | Кориснички дефинисан параметар за праћење. |
UserParameterDir | Подразумевана путања претраге за команде UserParameter. |
Сви параметри нису обавезни осим ако није експлицитно наведено да је параметар обавезан.
Имајте на уму да:
Поставља алијас за кључ ставке. Може се користити за замену дугог и сложеног кључа ставке краћим и једноставнијим.
Може бити присутно више параметара Алијас. Вишеструки параметри са истим Alias кључем нису дозвољени.
Различити Alias кључеви могу да референцирају исти кључ ставке.
Алијаси се могу користити у HostMetadataItem, али не и у параметру HostnameItem.
Пример 1: Преузимање коришћења датотеке страничне меморије у процентима са сервера.
Alias=pg_usage:perf_counter[File(_Total)% Usage]
Сада се скраћени кључ pg_usage може користити за преузимање података.
Пример 2: Добијање оптерећења процесора са подразумеваним и прилагођеним параметрима.
Alias=cpu.load:system.cpu.load Alias=cpu.load[*]:system.cpu.load[*]
Ово омогућава коришћење кључа cpu.load за добијање оптерећења процесора са подразумеваним параметрима, као и коришћење cpu.load[percpu,avg15] за добијање специфичних података о оптерећењу процесора.
Пример 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 .
Током захтева за аутоматску регистрацију агент ће евидентирати поруку упозорења ако је вредност враћена од стране наведене ставке преко границе од 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 адреса се шаље 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).
Подразумевано: 1h
Опсег: 1m-365d
Ограничење провера по додатку <PluginName>
које се могу извршити у исто време.
Подразумевано: 1000
Опсег: 1-1000
Максималан број нових линија које ће агент послати у секунди Zabbix серверу или проксију приликом обраде активних провера 'log', 'logrt' и 'eventlog'. Наведена вредност ће бити замењена параметром 'maxlines', наведеним у кључу ставке 'log', 'logrt' или 'eventlog'.
Напомена: Zabbix ће обрадити 10 пута више нових линија него што је подешено у MaxLinesPerSecond за тражење захтеваног стринга у ставкама дневника.
Подразумевано: 20
Опсег: 1-1000
Омогућите евидентирање извршених команди љуске као упозорења. Команде ће бити евидентиране само ако се изврше на даљину. Уноси дневника неће бити креирани ако се system.run[] покрене локално помоћу параметара HostMetadataItem, HostInterfaceItem или HostnameItem.
Подразумевано: 0
Вредности: 0 - онемогућено, 1 - омогућено
Путања до UNIX утичнице за комуникацију додатака који се могу учитати.
Подразумевано: \\.\pipe\agent.plugin.sock
Временско ограничење за везе са додацима који се могу учитати, у секундама.
Подразумевано: Timeout
Опсег: 1-30
Дефинише нови параметар <parameter_name> који је просечна вредност за бројач перформанси система <perf_counter_path> за наведени временски период <period> (у секундама).
Синтакса: <parameter_name>,"<perf_counter_path>",<period>
На пример, ако желите да примите просечан број процесорских прекида у секунди у последњем тренутку, можете дефинисати нови параметар "interrupts" као следеће:
PerfCounter = interrupts,"(0)/sec",60
Обратите пажњу на двоструке наводнике око путање бројача перформанси. Назив параметра (прекиди) треба да се користи као кључ ставке приликом креирања ставке. Узорци за израчунавање просечне вредности ће се узимати сваке секунде.
Можете да покренете "typeperf -qx" да бисте добили листу свих бројача перформанси доступних у Windows-у.
Дефинише нови параметар <parameter_name> који је просечна вредност за бројач перформанси система <perf_counter_path> за наведени временски период <period> (у секундама). У поређењу са PerfCounter-ом, путање перфцоунтер-а морају бити на енглеском. Подржано само на Windows Server 2008/Vista и новијим верзијама.
Синтакса: <parameter_name>,"<perf_counter_path>",<period>
На пример, ако желите да примите просечан број процесорских прекида у секунди у последњем минуту, можете дефинисати нови параметар „прекиди“ на следећи начин:
Обратите пажњу на двоструке наводнике око путање бројача перформанси. Назив параметра (прекиди) треба да се користи као кључ ставке приликом креирања ставке. Узорци за израчунавање просечне вредности ће се узимати сваке секунде.
Листу енглеских стрингова можете пронаћи тако што ћете погледати следећи кључ регистратора: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009
.
Колико често се листа активних провера освежава, у секундама. Имајте на уму да ће након неуспеха освежавања активних провера следеће освежавање бити покушано за 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 адресе. Размаци су дозвољени.
Пример:
Zabbix сервер/прокси адреса или конфигурација кластера за добијање активних провера. Адреса сервера/проксија је IP адреса или DNS име и опциони порт одвојени двотачком.
Конфигурација кластера је једна или више адреса сервера одвојених тачком и зарезом. Може се навести више Zabbix сервера/кластера и Zabbix проксија, одвојених зарезом. Са сваког Zabbix сервера/кластера не треба навести више од једног Zabbix прокси сервера. Ако је наведен Zabbix прокси, онда Zabbix сервер/кластер за тај прокси не би требало да се наводи.
Може се обезбедити више адреса раздвојених зарезима за паралелно коришћење неколико независних Zabbix сервера. Размаци су дозвољени.
Ако порт није наведен, користи се подразумевани порт.
IPv6 адресе морају бити затворене у угластим заградама ако је наведен порт за тог домаћина. Ако порт није наведен, угласте заграде за IPv6 адресе су опционе.
Ако овај параметар није наведен, активне провере су онемогућене.
Пример за Zabbix прокси:
Пример за више сервера:
Пример високе доступности:
Пример високе доступности са два кластера и једним сервером:
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain
Изворна IP адреса за:
- одлазне везе са Zabbix сервером или Zabbix прокси;
- успостављање конекција током извршавања неких ставки (web.page.get, net.tcp.port, etc.).
Ако је подешено, агент ће на овом порту слушати HTTP статусне захтеве (http://localhost:<port>/status).
Опсег: 1024-32767
Одређује колико дуго треба чекати (у секундама) за успостављање везе и размену података са Zabbix проксијем или сервером.
Овај параметар дефинише трајање различитих операција, укључујући:
- чека одговор од Zabbix сервера;
- слање захтева Zabbix серверу, укључујући активне провере конфигурационе захтеве и податке о ставки;
- преузимање података евиденције путем датотеке дневника или праћења евиденције Windows догађаја;
- слање срчаних порука;
- максимално трајање за vfs.*
провере;
- служи као резервни случај у сценаријима где сервер или прокси старији од верзије 7.0 шаље провере без истека времена.
Подразумевано: 3
Опсег: 1-30
Долазне везе за прихватање. Користи се за пасивне провере. Може се навести више вредности, одвојених зарезом:
* unencrypted* - прихвати везе без шифровања (подразумевано)
* psk* - прихвати везе са TLS-ом и унапред дељеним кључем (PSK)
cert - прихвати везе са TLS-ом и сертификатом
Обавезно: да, ако су дефинисани TLS сертификат или PSK параметри (чак и за * unencrypted* везу); иначе не
Пуна путања датотеке која садржи CA(е) сертификате највишег нивоа за верификацију равноправних сертификата, који се користи за шифровану комуникацију између Zabbix компоненти.
Пуна путања датотеке која садржи сертификат агента или ланац сертификата, који се користи за шифровану комуникацију са Zabbix компонентама.
OpenSSL низ шифре (TLS 1.3). Заобиђите подразумеване критеријуме за избор шифрованог пакета за шифровање засновано на сертификатима и PSK-у.
Пример:
OpenSSL низ шифре (TLS 1.3). Заобиђите подразумеване критеријуме за избор шифрованог пакета за шифровање засновано на сертификатима.
Имајте на уму да се овај параметар не може користити заједно са TLSAccept=cert,psk
; за везу са сертификатом (TLSConnect=cert
) уместо тога користите TLSCipherAll13.
OpenSSL низ шифре (TLS 1.3). Заобиђите подразумеване критеријуме за избор шифрованог пакета за шифровање засновано на PSK-у.
Пример:
Како агент треба да се повеже са Zabbix сервером или прокси сервером. Користи се за активне провере. Може се навести само једна вредност:
* unencrypted* - повезивање без шифровања (подразумевано)
psk - повезивање помоћу TLS-а и унапред дељеног кључа (PSK)
cert - повезивање помоћу TLS-а и сертификат
Обавезно: да, ако су дефинисани TLS сертификат или PSK параметри (чак и за нешифровану везу); иначе не
Пуна путања датотеке која садржи опозване сертификате. Овај параметар се користи за шифровану комуникацију између Zabbix компоненти.
Пуна путања датотеке која садржи приватни кључ агента, који се користи за шифровану комуникацију између Zabbix компоненти.
Пуна путања датотеке која садржи претходно дељени кључ агента, који се користи за шифровану комуникацију са Zabbix сервером.
Низ идентитета унапред дељеног кључа, који се користи за шифровану комуникацију са Zabbix сервером.
Издавач сертификата дозвољеног сервера (прокси).
Предмет сертификата дозвољеног сервера (прокси).
Дозволите да се сви знакови прослеђују у аргументима кориснички дефинисаним параметрима. Следећи знакови нису дозвољени: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @
Поред тога, знакови новог реда нису дозвољени.
Подразумевано: 0
Вредности: 0 - не дозвољава, 1 - дозвољава
Кориснички дефинисан параметар за праћење. Може постојати неколико кориснички дефинисаних параметара.
Формат: UserParameter=<key>,<shell command>
Имајте на уму да команда љуске не сме да враћа празан стринг или само EOL. Команде љуске могу имати релативне путање, ако је наведен параметар UserParameterDir.
Пример:
Подразумевана путања за претрагу команди UserParameter. Ако се користи, агент ће променити свој радни директоријум у онај који је овде наведен пре извршавања команде. Стога команде UserParameter могу имати релативни префикс .\
уместо пуне путање.
Дозвољен је само један унос.
Пример: