6 Zabbix agent 2 (Windows)

Vista general

L'agent Zabbix 2 és una nova generació d'agent de Zabbix i es pot emprar en lloc de l'agent Zabbix.

Aquesta secció llista els paràmetres suportats al fitxer de configuració de l'agent Zabbix 2 (zabbix_agent2.conf).

Veieu que:

• Els valors per defecte reflecteixen els valors per defecte dels processos, i no pas els valors dels fitxers de configuració lliurats;
• Zabbix suporta els fitxers de configuració codificats només en UTF-8, sense BOM ;
• Els comentaris que comencen per "#" només es suporten a principi de línia.

Paràmetres

|Paràmetre|<|Obligatori|Rang|Predeterminat|Descripció| |-|----------|-----------|-----------|----------|--- -----------------------------------------------| |Alias|<|no| | |Defineix un àlies per a una clau d'element. Es pot emprar per substituir una clau d'element llarg i complex per una de més petita i senzilla.
És possible que hi hagi diversos paràmetres Alias. Es permeten diversos paràmetres amb la mateixa clau Alias.
És possible que diferents claus Alias facin referència a la mateixa clau d'element.
Es poden emprar àlies a HostMetadataItem però no als paràmetres HostnameItem.

Exemples:

1. S'està recuperant l'ID de l'usuari 'zabbix'.
Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",, ,,\1]
Ara es pot emprar la clau d'abreujatura zabbix.userid per recuperar dades.

2. Aconseguint l'ús de la CPU amb paràmetres predeterminats i personalitzats.
Alias=cpu.util:system.cpu.util
Alias=cpu.util[*]:system.cpu.util[*]
Això permet emprar la clau cpu.util per obtindre el percentatge d'ús de la CPU amb els paràmetres predeterminats, així com emprar cpu.util[all, idle, avg15] per obtindre dades específiques sobre l'ús de la CPU.

3. Executant diverses regles de descoberta de baix nivell que processen els mateixos elements de descoberta.
Alias=vfs.fs.discovery[*]:vfs.fs.discovery
Ara és és possible configurar diverses regles de descoberta mitjançant vfs.fs.discovery amb diferents paràmetres per a cada regla, per exemple, vfs.fs.discovery[foo], vfs.fs.discovery [barra], etc.| |AllowKey|<|no| | |Permet l'execució d'aquelles claus d'element que coincideixen amb un patró. El patró de clau és una expressió que admet el caràcter "*" perquè coincideixi amb qualsevol nombre de caràcters.
Es poden definir diverses regles de concordança de claus en combinació amb DenyKey. Els paràmetres es processen un per un segons el seu ordre.
Aquest paràmetre és compatible des de Zabbix 5.0.0.
Veieu també: Comprovacions d'agent de restricció.| |BufferSend|<|no|1-3600|5|L'interval de temps en segons que determina la freqüència amb què s'envien els valors des de la memòria intermèdia al servidor Zabbix.
Tingueu en compte que si la memòria intermèdia és plena, les dades s'enviaran abans.| |BufferSize|<|no|2-65535|100|Nombre màxim de valors a la memòria intermèdia. L'agent enviarà totes les dades recollides al servidor o al proxy Zabbix si la memòria intermèdia és plena.
Aquest paràmetre només s'ha d'emprar si la memòria intermèdia persistent és desactivada (EnablePersistentBuffer=0).| |ControlSocket|<|no| |\\.\pipe\agent.sock|El sòcol de control, emprat per enviar ordres en temps d'execució amb l'opció '-R'.| |DebugLevel|<|no|0-5|3|Especifica el nivell de depuració:
0 - informació bàsica sobre l'inici i l'aturada dels processos Zabbix
1 - informació crítica
2 - informació d'error
3 - advertències
4 - depuració (genera molta informació)
5 - depuració ampliada (genera encara més informació)| |DenyKey|<|no| | |Denegueu l'execució d'aquelles claus d'element que coincideixen amb un patró. El patró de clau és una expressió que admet el caràcter "*" perquè coincideixi amb qualsevol nombre de caràcters.
Es poden definir diverses regles de concordança de claus en combinació amb AllowKey. Els paràmetres es processen un per un segons el seu ordre d'arribada.
Aquest paràmetre és compatible des de Zabbix 5.0.0.
Vegeu també: Comprovacions d'agent de restricció.| |EnablePersistentBuffer|<|no|0-1|0|Activa l'ús de l'emmagatzematge persistent local per als elements actius.
0 - desactivat
1 - activat
Si l'emmagatzematge persistent és desactivat, s'emprarà la memòria intermèdia.| |ForceActiveChecksOnStart|<|no|0-1|0 |Fa comprovacions actives immediatament després de reiniciar la primera configuració rebuda.
0 - desactivat
1 - activat
També disponible segons el paràmetre de configuració del connector, per exemple: Plugins.Uptime.System.ForceActiveChecksOnStart=1
Suportat des de Zabbix 6.0.2. | |HostInterface|<|no|0-255 caràcters| |Paràmetre opcional que defineix la interfície de l'equip.
La interfície de l'equip s'empra en el procés d'autoregistre de l'equip.
Un agent emetrà un error i no s'iniciarà pas si el valor supera el límit de 255 caràcters.
Si no està definit, el valor es prendrà de HostInterfaceItem.
Support des de Zabbix 4.4.0.| |HostInterfaceItem|<|no| | |Paràmetre opcional que defineix un element emprat per obtindre la interfície de l'equip.
La interfície de l'equip s'empra en el procés d'autoregistre de l'equip.
Durant una petició d'autoregistre, un agent registrarà un missatge d'avís si el valor retornat per l'element especificat supera el límit de 255 caràcters.
L'element system.run[] s'admet independentment dels valors AllowKey/DenyKey.
Aquesta opció només s'empra quan HostInterface no és definida.
Suportada des de Zabbix 4.4.0.| |HostMetadata|<|no|0-255 caràcters| |Paràmetre opcional que defineix les metadades de l'equip. Les metadades de l'equip s'empren en el procés d'autoregistre de l'equip.
Un agent emetrà un error i no s'iniciarà si el valor especificat supera el límit o una cadena no UTF-8.
Si no es defineix, el valor s'adquireix de HostMetadataItem.| |HostMetadataItem|<|no| | |Paràmetre opcional que defineix un element emprat per obtindre metadades d'equips. El valor de l'element de metadades de l'equip es recupera a cada intent d'autoregistre per al procés d'autoregistre de l'equip.
Durant una petició d'autoregistre, un agent registrarà un missatge d'avís si el valor que retorna l'element especificat supera el límit de 255 caràcters.
Aquesta opció només s'empra quan HostMetadata no sigui definida.
Admet paràmetres d'usuari i àlies. Admet system.run[] independentment del valor EnableRemoteCommands.
El valor retornat per l'element ha de ser una cadena UTF-8; en cas contrari, s'ignorarà.| |Hostname|<|no| |Definit per HostnameItem|Llista de noms d'equip únics i que distingeixen entre majúscules i minúscules, delimitats per comes.
Obligatori per a les comprovacions actives. i han de coincidir amb els noms d'equip configurats al servidor. El valor s'agafen de HostnameItem si no s'han definit pas.
Caràcters permesos: alfanumèrics, '.', ' ', '_' i '-'.
Llargària màxima: 128 caràcters per nom d'equip, 2048 caràcters per a tota la línia. | |HostnameItem|<|no| |system.hostname|Element emprat per generar el nom d'equip, si no s'ha definit pas (s'ignora si no s'ha definit el nom d'equip).
No suporta UserParameters ni àlies, però admet system.run[] independentment del valor EnableRemoteCommands.
La longitud de sortida és limitada a 512 KB.| |Include|<|no| | |S'hi poden incloure fitxers individuals o tots els fitxers d'un directori al fitxer de configuració (ubicat a C:\Program Files\Zabbix Agent 2 per defecte si l'agent de Zabbix s'instal·la amb l'MSI de Windows; o al directori específic durant la instal·lació si l'agent s'ha instal·lat des d'un arxiu zip).
Durant la instal·lació Zabbix crearà el directori d'inclusió a /usr/local/etc, tret que es modifiqui durant la compilació.
Per incloure només fitxers rellevants al directori especificat, el caràcter comodí d'asterisc és compatible per a la concordança de patrons. Per exemple: C:\Program Files\Zabbix Agent\zabbix_agentd.d\*.conf.
Des de Zabbix 6.0.0, un camí pot ser relatiu a la ubicació del fitxer zabbix_agent2.win.conf.
Veieu les notes especials sobre les limitacions.| |ListenIP|<|no| |0.0.0.0|Llistat d'adreces IP delimitades per comes que l'agent hauria d'escoltar.
La primera adreça IP s'envia al servidor Zabbix, si s'hi connecta, per recuperar la llista de comprovacions actives.| |ListenPort|<|no|1024-32767|10050|L'agent escoltarà en aquest port les connexions des del servidor.| |LogFile|<|sí, si LogType s'estableix a file, en cas contrari
no| |c:\zabbix_agent2.log|Nom del fitxer de registre si LogType és "fitxer".| |LogFileSize|<|no|0-1024|1|Mida màxima del fitxer de registre en MB.
0 - desactiva la rotació automàtica del registre.
Nota: Si s'arriba al límit de mida del fitxer de registre i la rotació del fitxer falla, per qualsevol motiu, el fitxer de registre existent es trunca i es torna a iniciar.| |LogType|<|no| |file|Especifica on s'escriuen els missatges de registre:
fitxer - fitxer especificat pel paràmetre LogFile,
consola - sortida estàndard.| |PersistentBufferFile|<|no| | |El fitxer, on l'Agent 2 de Zabbix hauria de mantindre la base de dades SQLite.
Ha d'ésser un nom sencer de fitxer.
Aquest paràmetre només s'empra si la memòria intermèdia persistent és habilitada (EnablePersistentBuffer=1).| |PersistentBufferPeriod|<|no|1m-365d|1h|Període de temps durant el qual s'han d'emmagatzemar les dades, quan no hi ha connexió amb el servidor o proxy. Les dades més antigues es perdran. Les dades de registre es conservaran.
Aquest paràmetre només s'empra si la memòria intermèdia persistent és habilitada (EnablePersistentBuffer=1).| |Plugins|<|no| | |Des de Zabbix 6.0.0 la majoria dels connectors tenen els seus propis arxius de configuració. El fitxer de configuració de l'agent conté els paràmetres del connector que s'enumeren a continuació.| | |Plugins.Log.MaxLinesPerSecond|no|1-1000|20|Nombre màxim de línies noves que l'agent enviarà per segon al servidor o al proxy Zabbix quan processi les comprovacions actives "registre" i "registre d'esdeveniments".
El valor proporcionat serà substituït pel paràmetre 'maxlines',
proporcionat a la clau d'element 'log' o 'eventlog'.
Nota: El Zabbix processarà 10 vegades més línies noves que les establertes a MaxLinesPerSecond per cercar la cadena requerida als elements del registre.
Aquest paràmetre és compatible des de la 4.4.2 i substitueix MaxLinesPerSecond.| |^|Plugins.SystemRun.LogRemoteCommands|no| |0|Activa el registre de les ordres de l'intèrpret d'ordres executades com a avisos.
0 - desactivat
1 - activat
Les ordres només es registraran si s'executen de forma remota. Les entrades de registre no es crearan si system.run[] s'inicia localment pels paràmetres HostMetadataItem, HostInterfaceItem o HostnameItem.
Aquest paràmetre és compatible des de la 4.4.2 i substitueix LogRemoteCommands.| |PluginSocket|<|no| |\\..plugin.sock|Camí al sòcol Unix per a comunicacions de connectors carregables.| |PluginTimeout|<|no|1-30 |timeout global |Temps d'espera per a connexions amb connectors carregables.| |RefreshActiveChecks|<|no|60-3600|120|La freqüència amb què s'actualitza el llistat de comprovacions actives, en segons.
Tingueu en compte que després de no poder actualitzar les comprovacions actives, la següent actualització s'intentarà després de 60 segons.| |Server|<|yes| | |Llista d'adreces IP delimitades per comes, opcionalment en notació CIDR, o noms DNS de servidors Zabbix i proxys Zabbix.
Només s'acceptaran connexions entrants dels equips que s'indiquen aquí.
Si el suport IPv6 és habilitat, llavors '127.0.0.1' i '::ffff:127.0.0.1' es tracten de la mateixa manera; i '::/0' permetrà qualsevol adreça IPv4 o IPv6.
'0.0.0.0/0' s'emprarà per permetre qualsevol adreça IPv4.
Exemple: Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com
S'admeten espais.| |ServerActive|<|no| | |L'adreça del proxy Zabbix o la configuració del clúster per obtindre comprovacions actives.
L'adreça del servidor/proxy és l'adreça IP o el nom DNS i el port opcional separats per dos punts.
La configuració del clúster és una o més adreces del servidor separades per punt i coma.
Es poden especificar diversos servidors/clústers Zabbix i proxys Zabbix, separats per comes.
No s'hauria d'especificar més d'un proxy Zabbix de cada servidor/clúster Zabbix.
Si s'especifica el proxy Zabbix, aleshores servidor Zabbix no s'ha d'especificar pas al clúster per a aquest proxy.
Es poden proporcionar diverses adreces per emprar diversos servidors Zabbix independents en paral·lel. Es permeten espais.
Si no s'especifica el port, s'empra el port predeterminat.
Les adreces IPv6 s'han de lliurar entre claudàtors si s'especifica el port per a aquest equip.
Si no s'especifica el port, els claudàtors per a IPv6 les adreces són opcionals.
Si no s'especifica aquest paràmetre, les comprovacions actives són desactivades.
Exemple per al proxy Zabbix:
ServerActive=127.0.0.1:10051
Exemple per a diversos servidors:
ServerActive= 127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]
Exemple d'alta disponibilitat:
ServerActive=zabbix.cluster.node1 ;zabbix.cluster.node2:20051;zabbix.cluster.node3
Exemple d'alta disponibilitat amb dos clústers i un servidor:
ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2 .node1;zabbix.cluster2.node2,zabbix.domain| |SourceIP|<|no| | |Adreça IP d'origen per a:
- connexions sortints al servidor Zabbix o al proxy Zabbix;
- connectar mentre s'executen alguns elements (web.page.get, net.tcp.port, etc.)| |StatusPort|<|no|1024-32767| |Si s'estableix, l'agent escoltarà en aquest port les peticions d'estat HTTP (http://localhost:<port>/status).| |Timeout|<|no|1-30|3|No invertiu més de Timeout-segons durant el processament.| |TLSAccept|<|sí, si el certificat TLS o els paràmetres PSK són definits (fins i tot per a connexió unencrypted), en cas contrari no| | |Quines connexions entrants acceptar. S'empra per a comprovacions passives. Es poden especificar diversos valors, separats per comes:
unencrypted - admet connexions sense xifrar (per defecte)
psk - admet connexions amb TLS i una clau prèviament compartida (PSK)
true - admet connexions amb TLS i un certificat.| |TLSCAFile|<|no| | |Camí complet d'un fitxer que conté els certificats de CA(s) de nivell superior per a la verificació de certificats entre iguals, emprat per a comunicacions xifrades entre components Zabbix.| |TLSCertFile|<|no| | |Camí complet d'un fitxer que conté el certificat de l'agent o la cadena de certificats, emprat per a comunicacions xifrades amb components Zabbix.| |TLSConnect|<|sí, si el certificat TLS o els paràmetres PSK són definits (fins i tot per a connexió unencrypted), en cas contrari no| | |Com s'ha de connectar l'agent al servidor o proxy Zabbix. S'empra per a controls actius. Només es pot especificar un valor:
unencrypted - connectar-se sense xifrat (predeterminat)
psk - connectar-se mitjançant TLS i una clau prèviament compartida (PSK)
true - connectar-se emprant TLS i un certificat| |TLSCRLFile|<|no| | |Camí complet d'un fitxer que conté certificats revocats. Aquest paràmetre s'empra per a comunicacions xifrades amb components Zabbix.| |TLSKeyFile|<|no| | |Camí complet d'un fitxer que conté la clau privada de l'agent emprada per a comunicacions xifrades amb components Zabbix.| |TLSPSKFile|<|no| | |Camí complet d'un fitxer que conté la clau prèviament compartida de l'agent emprada per a comunicacions xifrades amb components Zabbix.| |TLSPSKIdentity|<|no| | |Cadena d'identitat de clau prèviament compartida, emprada per a comunicacions xifrades amb el servidor Zabbix.| |TLSServerCertIssuer|<|no| | |Emissor de certificat de servidor (proxy) permès.| |TLSServerCertSubject|<|no| | |Assumpte del certificat del servidor (proxy) permès.| |UnsafeUserParameters|<|no|0,1|0|Permet que tots els caràcters es passin en arguments als paràmetres definits per l'usuari.
No es permeten els caràcters següents:
\ ' " ` * ?  [ ] { } ~ $ ! & ; ( ) < > | # @
A més, no es permeten caràcters de nova línia.| |UserParameter|<|no| | |Paràmetre definit per l'usuari a monitorar. Hi pot haver diversos paràmetres definits per l'usuari.
Format: UserParameter=<clau>,<ordre de l'intèrpret d'ordres>
Tingueu en compte que l'ordre de l'intèrpret d'ordres no ha de retornar només una cadena buida o EOL.
Les ordres de l'intèrpret d'ordres poden tindre camins relatius, si s'especifica el paràmetre UserParameterDir.
Exemples:
UserParameter=system.test,who|wc -l
UserParameter=check_cpu,./custom_script.sh| |UserParameterDir|<|no| | |Camí de cerca per defecte per a les ordres UserParameter. Si s'empra, l'agent canviarà el seu directori de treball a l'especificat aquí abans d'executar una ordre. Per tant, les ordres de UserParameter poden tindre un prefix relatiu ./ en lloc d'un camí complet.
Només es permet una entrada.
Exemple: UserParameterDir=/opt/myscripts|