5 Zabbix agent (Windows)

Преглед

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

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

|ListenBacklog|Максималан број чекајућих веза у TCP реду.| |ListenIP|Листа IP адреса раздвојених зарезима на којима агент треба да слуша.| |ListenPort|Агент ће слушати на овом порту за везе са сервера.| |LogFile|Назив датотеке дневника.| |LogFileSize|Максимална величина датотеке дневника.| |LogRemoteCommands|Омогући евидентирање извршених команди шелла као упозорења.| |LogType|Тип излаза дневника.| |MaxLinesPerSecond|Максималан број нових линија које ће агент послати у секунди на Zabbix сервер или прокси приликом обраде активних провера 'log' и 'logrt'.| |PerfCounter|Дефинише нови параметар <parameter_name> који је просечна вредност за бројач перформанси система <perf_counter_path> за наведени временски период <period> (у секундама).| |PerfCounterEn|Дефинише нови параметар <parameter_name> који је просечна вредност за бројач перформанси система <perf_counter_path> за наведени временски период <period> (у секундама). У поређењу са PerfCounter-ом, путање perfcounter-а морају бити на енглеском језику.| |RefreshActiveChecks|Колико често се освежава листа активних провера.| |Server|Листа IP адреса раздвојених зарезима, опционо у CIDR нотацији, или DNS имена Zabbix сервера и Zabbix проксија.| |ServerActive|Адреса Zabbix сервера/проксија или конфигурација кластера за добијање активних провера.| |SourceIP|Изворна IP адреса.| |StartAgents|Број претходно форкованих инстанци zabbix_agentd које обрађују пасивне провере.| |Timeout|Одређује време чекања за комуникацију (у секундама).| |TLSAccept|Које долазне везе треба прихватити.| |TLSCAFile|Пуна путања датотеке која садржи сертификате CA највишег нивоа за верификацију сертификата вршњака, која се користи за шифровану комуникацију између Zabbix компоненти.| |TLSCertFile|Пуна путања датотеке која садржи сертификат агента или ланац сертификата, који се користи за шифровану комуникацију између Zabbix компоненти.| |TLSConnect|Како агент треба да се повеже са Zabbix сервером или проксијем.| |TLSCRLFile|Пуна путања датотеке која садржи опозване сертификате. Овај параметар се користи за шифровану комуникацију између Zabbix компоненти.| |TLSKeyFile|Пуна путања датотеке која садржи приватни кључ агента, који се користи за шифровану комуникацију између Zabbix компоненти.| |TLSPSKFile|Пуна путања датотеке која садржи унапред дељени кључ агента, који се користи за шифровану комуникацију са Zabbix сервером.| |TLSPSKIdentity|Низ идентитета унапред дељеног кључа, који се користи за шифровану комуникацију са Zabbix сервером.| |TLSServerCertIssuer|Издавалац дозвољеног сертификата сервера (прокси).| |TLSServerCertSubject|Наслов дозвољеног сертификата сервера (прокси).| |UnsafeUserParameters|Дозвољава да се сви знакови прослеђују у аргументима кориснички дефинисаним параметрима.| |UserParameter|Кориснички дефинисан параметар за праћење.| |UserParameterDir|Подразумевана путања претраге за команде UserParameter.|

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

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

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

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

Alias

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

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

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], итд.

AllowKey

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

BufferSend

Не чувајте податке дуже од N секунди у баферу.

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

BufferSize

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

Подразумевано: 100
Опсег: 2-65535

DebugLevel

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

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

DenyKey

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

EnableRemoteCommands

Да ли су удаљене команде са Zabbix сервера дозвољене. Овај параметар је ** deprecated**, уместо тога користите AllowKey=system.run[*] или DenyKey=system.run[*].
То је интерни псеудоним за AllowKey/DenyKey параметре у зависности од вредност:
0 - DenyKey=system.run[*]
1 - AllowKey=system.run[*]

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

HeartbeatFrequency

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

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

HostInterface

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

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

HostInterfaceItem

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

HostMetadata

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

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

HostMetadataItem

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

Hostname

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

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

HostnameItem

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

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

Include

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

Пример:

Include=C:FilesAgent_agentd.d*.conf

ListenBacklog

Максималан број веза на чекању у TCP реду.
Подразумевана вредност је чврсто кодирана константа, која зависи од система.
Максимална подржана вредност зависи од система, превисоке вредности могу бити тихо скраћене на 'implementation-specified maximum'.

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

ListenIP

Листа IP адреса раздвојених зарезима које агент треба да слуша.

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

ListenPort

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

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

LogFile

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

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

LogFileSize

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

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

LogRemoteCommands

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

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

LogType

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

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

MaxLinesPerSecond

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

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

PerfCounter

Дефинише нови параметар <parameter_name> који је просечна вредност за бројач перформанси система <perf_counter_path> за наведени временски период <period> (у секундама).
Синтакса: <parameter_name>,"<perf_counter_path>",<period>

На пример, ако желите да примите просечан број процесорских прекида у секунди у последњем тренутку, можете дефинисати нови параметар "interrupts" као следеће:

PerfCounter = interrupts,"(0)/sec",60

Обратите пажњу на двоструке наводнике око путање бројача перформанси. Назив параметра (прекиди) треба да се користи као кључ ставке приликом креирања ставке. Узорци за израчунавање просечне вредности ће се узимати сваке секунде.
Можете да покренете "typeperf -qx" да бисте добили листу свих бројача перформанси доступних у Windows-у.

PerfCounterEn

Дефинише нови параметар <parameter_name> који је просечна вредност за бројач перформанси система <perf_counter_path> за наведени временски период <period> (у секундама). У поређењу са PerfCounter-ом, путање перфцоунтер-а морају бити на енглеском. Подржано само на Windows Server 2008/Vista и новијим верзијама.
Синтакса: <parameter_name>,"<perf_counter_path>",<period>

На пример, ако желите да примите просечан број процесорских прекида у секунди у последњем минуту, можете дефинисати нови параметар "interrupts" на следећи начин:

PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60

Обратите пажњу на двоструке наводнике око путање бројача перформанси. Назив параметра (прекиди) треба да се користи као кључ ставке приликом креирања ставке. Узорци за израчунавање просечне вредности ће се узимати сваке секунде.
Листу енглеских стрингова можете пронаћи тако што ћете погледати следећи кључ регистратора: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009.

RefreshActiveChecks

Колико често се листа активних провера освежава, у секундама. Имајте на уму да ће након неуспеха освежавања активних провера следеће освежавање бити покушано за 60.

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

Server

Листа 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 адресе. Имајте на уму да RFC4291 подржава "IPv4-компатибилне IPv6 адресе" (0000::/96 prefix). Размаци су дозвољени.

Пример:

Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

Обавезно: да, ако StartAgents није експлицитно подешен на 0

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.).

StartAgents

Број унапред раздвојених инстанци zabbix_agentd који обрађују пасивне провере. Ако је подешено на 0, пасивне провере су онемогућене и агент неће слушати ниједан TCP порт.

Подразумевано: 10
Опсег: 0-63 (*)

Timeout

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

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

TLSAccept

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

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

TLSCAFile

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

TLSCertFile

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

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>
Имајте на уму да shell команда не сме да враћа празан стринг или само EOL. Shell команде могу имати релативне путање, ако је наведен параметар UserParameterDir.

Пример:

 UserParameter=system.test,dir /b | find /c /v ""
        UserParameter=check_cpu,.\custom\_script.bat

UserParameterDir

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

Пример:

UserParameterDir=C: