L'agent Áú»¢¶Ä²© 2 ¨¦s una nova generaci¨® d'agent de Áú»¢¶Ä²© i es pot emprar en lloc de l'agent Áú»¢¶Ä²©.
Aquesta secci¨® llista els par¨¤metres suportats al fitxer de configuraci¨® de l'agent Áú»¢¶Ä²© 2 (zabbix_agent2.conf).
Veieu que:
|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 llarga i complexa 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.
< br>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[*]< br>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.< br>
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, com ara 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 d'aparici¨®.
Aquest par¨¤metre ¨¦s compatible des de Áú»¢¶Ä²© 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 Áú»¢¶Ä²©.
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 Áú»¢¶Ä²© 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| |/tmp/agent.sock|El s¨°col de control, emprat per enviar ordres 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 Áú»¢¶Ä²©
1 - informaci¨® cr¨ªtica
2 - informaci¨® d'error
3 - avisos
4 - per a la depuraci¨® (produeix molta informaci¨®)
5 - depuraci¨® ampliada (produeix 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¨® de comod¨ª 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'aparici¨®.
Aquest par¨¤metre ¨¦s compatible des de Áú»¢¶Ä²© 5.0.0.
Veieu 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 |Fer 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 Áú»¢¶Ä²© 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 al proc¨¦s d'autoregistre de l'equip.
Un agent emetr¨¤ un error i no s'iniciar¨¤ si el valor supera el l¨ªmit de 255 car¨¤cters.
Si no ¨¦s definit, el valor s'agafar¨¤ de HostInterfaceItem.
Adm¨¨s des de Áú»¢¶Ä²© 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'advertiment 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.
Suportat des de Áú»¢¶Ä²© 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 al 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'agafar¨¤ de HostMetadataItem.| |HostMetadataItem|<|no| | |Par¨¤metre opcional que defineix un element emprat per obtindre les metadades d'un equip. 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, l'agent registrar¨¤ un missatge d'advertiment 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 ¨¦s pas definit.
Admet par¨¤metres d'usuari i ¨¤lies. Admet system.run[] independentment dels valors AllowKey/DenyKey.
El valor retornat per l'element ha d'¨¦sser una cadena UTF-8; en cas contrari, s'ignorar¨¤.| |HostName|<|no| |Set by HostnameItem|Llista de noms d'equip ¨²nics i que distingeix entre maj¨²scules i min¨²scules, delimitats per comes.
Requerit per a les comprovacions actives i han de coincidir amb els noms d'equip configurats al servidor. Si no ¨¦s definit, el valor s'agafa de HostnameItem.
Car¨¤cters admesos: alfanum¨¨rics, '.', ' ', '_' i '-'.
Llargada 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 definit. S'ignora si el nom d'equip ¨¦s definit.
No admet UserParameters ni ¨¤lies, per¨° admet system.run[] independentment dels valors AllowKey/DenyKey.
La longitud de sortida ¨¦s limitada a 512 KB.| |Include| |no| | |Podeu incloure fitxers individuals o tots els fitxers d'un directori al fitxer de configuraci¨®.
Durant la instal¡¤laci¨® Áú»¢¶Ä²© 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: /absolute/path/to/config/files/*.conf
.
Des de Áú»¢¶Ä²© 6.0.0, un cam¨ª pot ser relatiu a la ubicaci¨® del fitxer zabbix_agent2.conf.
Veieu les notes especials sobre les limitacions.| |ListenIP|<|no| |0.0.0.0|Llista d'adreces IP delimitades per comes que l'agent hauria d'escoltar.
La primera adre?a IP s'envia al servidor Áú»¢¶Ä²©, 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| |/tmp/zabbix_agent2.log|Nom del fitxer de registre si LogType ¨¦s "file".| |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 a:
system - syslog,
file - fitxer especificat pel par¨¤metre LogFile,
consola - sortida est¨¤ndard.| |PersistentBufferFile|<|no| | |El fitxer, on l'Agent 2 de Áú»¢¶Ä²© hauria de mantindre la base de dades SQLite.
Ha d'¨¦sser un nom de fitxer complet.
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).| |PidFile|<|no| |/tmp/zabbix_agent2.pid|Nom del fitxer PID.| |Plugin|<|no| | |Des de Áú»¢¶Ä²© 6.0.0 la majoria dels connectors tenen els seus propis fitxers de configuraci¨®. El fitxer de configuraci¨® de l'agent cont¨¦ els par¨¤metres del connector que es llisten 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 Áú»¢¶Ä²© quan processi les comprovacions actives 'log' i 'logrt' o 'log.count'.
El valor proporcionat ser¨¤ substitu?t pel par¨¤metre 'maxlines',
proporcionat a la clau d'element 'log' i 'logrt' o 'log.count'.
Nota: Áú»¢¶Ä²© 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 advertiments.
0 - desactivat
1 - activat
Les ordres nom¨¦s es registraran si s'executen de forma remota. Les entrades de registre no es crearan si els par¨¤metres HostMetadataItem, HostInterfaceItem o HostnameItem inicien localment system.run[].
Aquest par¨¤metre ¨¦s compatible des de la 4.4.2 i substitueix LogRemoteCommands.| |PluginSocket|<|no| |/tmp/agent.plugin.sock |Cam¨ª al s¨°col Unix per a comunicacions de connectors carregables.| |PluginTimeout|<|no|1-30 |Global timeout|Temps d'espera per a connexions amb connectors carregables.| |RefreshActiveChecks|<|no|60-3600|120|La freq¨¹¨¨ncia amb qu¨¨ s'actualitza la llista de comprovacions actives, en segons.
Tingueu en compte que despr¨¦s de no poder actualitzar les comprovacions actives, la seg¨¹ent actualitzaci¨® es provar¨¤ despr¨¦s de 60 segons.| |Server|<|yes| | |Llista d'adreces IP delimitades per comes, opcionalment en notaci¨® CIDR, o noms DNS de servidors Áú»¢¶Ä²© i proxys Áú»¢¶Ä²©.
Nom¨¦s s'acceptaran connexions entrants dels equips que s'indiquen aqu¨ª.
Si el suport d'IPv6 ¨¦s actiu, llavors '127.0 .0.1', '::ffff:127.0.0.1' es tracten per igual i '::/0' permetr¨¤ qualsevol adre?a IPv4 o IPv6.
'0.0.0.0/0' es pot 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 Áú»¢¶Ä²© 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 Áú»¢¶Ä²© i proxys Áú»¢¶Ä²©, separats per comes.
No s'hauria d'especificar m¨¦s d'un proxy Áú»¢¶Ä²© de cada servidor/cl¨²ster Áú»¢¶Ä²©.
Si s'especifica el proxy Áú»¢¶Ä²©, aleshores el servidor/cluster Áú»¢¶Ä²© no cal que s'especifiqui.
Es poden proporcionar diverses adreces delimitades per comes per emprar diversos servidors Áú»¢¶Ä²© 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 Áú»¢¶Ä²©:
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 Áú»¢¶Ä²© o al proxy Áú»¢¶Ä²©;
- fer connexions 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 gasteu m¨¦s de Timeout segons durant el processament.| |TLSAccept|<|s¨ª, si el certificat TLS o els par¨¤metres PSK estan definits (fins i tot per a connexions 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 xifrat (per defecte)
psk: admet connexions amb TLS i una clau pr¨¨viament compartida (PSK)
cert - 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 Áú»¢¶Ä²©.| |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 Áú»¢¶Ä²©.| |TLSConnect|<|s¨ª, si el certificat TLS o els par¨¤metres PSK estan definits (fins i tot per a connexi¨® unencrypted), en cas contrari no| | |Com s'ha de connectar l'agent al servidor o proxy Áú»¢¶Ä²©. 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)
cert: connectar-se mitjan?ant 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 Áú»¢¶Ä²©.| |TLSKeyFile|<|no| | |Cam¨ª complet d'un fitxer que cont¨¦ la clau privada de l'agent emprada per a comunicacions xifrades amb components Áú»¢¶Ä²©.| |TLSPSKFile|<|no| | |Cam¨ª complet d'un fitxer que cont¨¦ la clau pr¨¨viament compartida de l'agent emprada per a comunicacions xifrades amb components Áú»¢¶Ä²©.| |TLSPSKIdentity|<|no| | |Cadena d'identitat de clau pr¨¨viament compartida, emprada per a comunicacions xifrades amb el servidor Áú»¢¶Ä²©.| |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 supervisar. 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 comptes d'un cam¨ª complet.
Nom¨¦s es permet una entrada.
Exemple: UserParameterDir=/opt/myscripts|