[comment]: # attributes: notoc [comment]: # ({7f44ce82-7f44ce82}) # 4 Zabbix agent 2 (UNIX) [comment]: # ({/7f44ce82-7f44ce82}) [comment]: # ({ea15c697-d5608d34}) #### 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). Els paràmetres es llisten sense informació addicional. Feu clic al paràmetre per veure'n tots els detalls. |Paràmetre|Descripció| |--|---------| |[Alias](#alias)|Defineix un àlies per a una clau d'element.| |[AllowKey](#allowkey)|Permetre l'execució d'aquelles claus d'element que coincideixen amb un patró.| |[BufferSend](#buffersend)|No deseu les dades més d' N segons a la memòria intermèdia.| |[BufferSize](#buffersize)|El nombre màxim de valors a la memòria intermèdia.| |[ControlSocket](#controlsocket)|El sòcol de control, emprat per enviar ordres en temps d'execució amb l'opció '-R'.| |[DebugLevel](#debuglevel)|El nivell de depuració.| |[DenyKey](#denykey)|Denega l'execució d'aquelles claus d'element que coincideixen amb un patró.| |[EnablePersistentBuffer](#enablepersistentbuffer)|Activa l'ús de l'emmagatzematge local persistent per als elements actius.| |[ForceActiveChecksOnStart](#forceactivechecksonstart)|Fer comprovacions actives tot just després del reinici de la primera configuració rebuda.| |[HeartbeatFrequency](#heartbeatfrequency)|La freqüència dels missatges dels heartbeat en segons.| |[HostInterface](#hostinterface)|Un paràmetre opcional que defineix la interfície de l'equip.| |[HostInterfaceItem](#hostinterfaceitem)|Un paràmetre opcional que defineix un element emprat per obtindre la interfície de l'equip.| |[HostMetadata](#hostmetadata)|Un paràmetre opcional que defineix les metadades de l'equip.| |[HostMetadataItem](#hostmetadataitem)|Un paràmetre opcional que defineix un element d'agent Zabbix emprat per obtindre les metadades de l'equip.| |[Hostname](#hostname)|Un paràmetre opcional que defineix el nom de l'equip.| |[HostnameItem](#hostnameitem)|Un paràmetre opcional que defineix un element d'agent Zabbix emprat per obtindre el nom d'equip.| |[Include](#include)|Podeu incloure fitxers individuals o tots els fitxers d'un directori al fitxer de configuració.| |[ListenIP](#listenip)|Una llista d'adreces IP delimitades per comes que l'agent hauria d'escoltar.| |[ListenPort](#listenport)|L'agent escoltarà en aquest port les connexions des del servidor.| |[LogFile](#logfile)|El nom del fitxer de registre.| |[LogFileSize](#logfilesize)|La mida màxima del fitxer de registre.| |[LogType](#logtype)|El tipus de sortida del registre.| |[PersistentBufferFile](#persistentbufferfile)|El fitxer on l'agent Zabbix 2 hauria de mantindre la base de dades SQLite.| |[PersistentBufferPeriod](#persistentbufferperiod)|Període de temps durant el qual s'han d'emmagatzemar les dades quan no hi ha connexió amb el servidor o proxy.| |[PidFile](#pidfile)|El nom del fitxer PID.| |[Plugins..System.Capacity](#plugins.systemcapacity)|El límit de validacions per plugin ue es poden executar alhora.| |[Plugins.Log.MaxLinesPerSecond](#plugins.log.maxlinespersecond)|El nombre màxim de línies noves que l'agent enviarà per segon al servidor o al proxy Zabbix quan processi les comprovacions actives 'log' i 'logrt'.| |[Plugins.SystemRun.LogRemoteCommands](#plugins.systemrun.logremotecommands)|Activeu el registre de les ordres de l'intèrpret d'ordres executades com a advertències.| |[PluginSocket](#pluginsocket)|La ruta al sòcol UNIX per a les comunicacions de connectors carregables.| |[PluginTimeout](#plugintimeout)|El temps d'espera de les connexions amb connectors carregables, en segons.| |[RefreshActiveChecks](#refreshactivechecks)|Amb quina freqüència s'actualitza la llista de comprovacions actives.| |[Server](#server)|Una llista d'adreces IP delimitades per comes, opcionalment en notació CIDR, o noms DNS de servidors Zabbix i proxys Zabbix.| |[ServerActive](#serveractive)|L'adreça del servidor/proxy de Zabbix o la configuració del clúster per obtindre comprovacions actives.| |[SourceIP](#sourceip)|L'adreça IP d'origen.| |[StatusPort](#statusport)|Si s'estableix, l'agent escoltarà en aquest port les peticions d'estat HTTP (http://localhost:/status).| |[Timeout](#timeout)|No dediqueu més de segons de temps d'espera al processament.| |[TLSAccept](#tlsaccept)|Quines connexions entrants acceptar.| |[TLSCAFile](#tlscafile)|La ruta completa 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](#tlscertfile)|La ruta completa d'un fitxer que conté el certificat de l'agent o la cadena de certificats, emprat per a comunicacions xifrades entre components Zabbix.| |[TLSCipherAll](#tlscipherall)|La cadena de xifrat d'OpenSSL (TLS 1.2). Sobreescriu el criteri triat de suite de xifrat per defecte per l'encriptació de certificat - i basada en PSK.| |[TLSCipherAll13](#tlscipherall13)|La cadena de xifrat d'OpenSSL (TLS 1.3) per OpenSSL 1.1.1 o posterior. Sobreescriu el criteri triat de suite de xifrat per defecte per l'encriptació de certificat - i basada en PSK.| |[TLSCipherCert](#tlsciphercert)|La cadena de xifrat d'OpenSSL (TLS 1.2). Sobreescriu el criteri triat de suite de xifrat per defecte per l'encriptació basada en certificat.| |[TLSCipherCert13](#tlsciphercert13)|La cadena de xifrat d'OpenSSL (TLS 1.3) per OpenSSL 1.1.1 o posterior. Sobreescriu el criteri triat de suite de xifrat per defecte per l'encriptació basada en certificat.| |[TLSCipherPSK](#tlscipherpsk)|La cadena de xifrat d'OpenSSL (TLS 1.2). Sobreescriu el criteri triat de suite de xifrat per defecte per l'encriptació basada en PSK.| |[TLSCipherPSK13](#tlscipherpsk13)|La cadena de xifrat d'OpenSSL (TLS 1.3) per OpenSSL 1.1.1 o posterior. Sobreescriu el criteri triat de suite de xifrat per defecte per l'encriptació basada en PSK.| |[TLSConnect](#tlsconnect)|Com s'ha de connectar l'agent al servidor o proxy Zabbix.| |[TLSCRLFile](#tlscrlfile)|La ruta completa d'un fitxer que conté certificats revocats. Aquest paràmetre s'empra per a comunicacions xifrades entre components Zabbix.| |[TLSKeyFile](#tlskeyfile)|La ruta completa d'un fitxer que conté la clau privada de l'agent, emprada per a comunicacions xifrades entre components Zabbix.| |[TLSPSKFile](#tlspskfile)|La ruta completa d'un fitxer que conté la clau prèviament compartida de l'agent, emprada per a comunicacions xifrades amb el servidor Zabbix.| |[TLSPSKIdentity](#tlspskiidentity)|La cadena d'identitat de clau prèviament compartida, emprada per a comunicacions xifrades amb el servidor Zabbix.| |[TLSServerCertIssuer](#tlsservercertissuer)|L'emissor del certificat del servidor (proxy) permès.| |[TLSServerCertSubject](#tlsservercertsubject)|El subjecte del certificat del servidor (proxy) permès.| |[UnsafeUserParameters](#unsafeuserparameters)|Permet que tots els caràcters es passin en arguments als paràmetres definits per l'usuari.| |[UserParameter](#userparameter)|Un paràmetre definit per l'usuari per monitorar.| |[UserParameterDir](#userparameterdir)|El camí de cerca predeterminat per a les ordres de UserParameter.| Cap paràmetre és obligatori tret que s'indiqui explícitament que ho és. Veieu que: - Els valors per defecte reflecteixen els valors per defecte dels processos, i no pas els valors dels fitxers de configuració lliurats; - Els valors admeten [variables d'entorn](/manual/appendix/config/environment_variables). - Zabbix suporta els fitxers de configuració codificats només en UTF-8, sense [BOM](https://en.wikipedia.org/wiki/Byte_order_mark) ; - Els comentaris que comencen per "\#" només es suporten a principi de línia. [comment]: # ({/ea15c697-d5608d34}) [comment]: # ({8085875f-1de2b54e}) ### Detalls del paràmetre [comment]: # ({/8085875f-1de2b54e}) [comment]: # ({f3842378-29f73be6}) ##### Àlies Estableix 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 curta i senzilla. És possible que hi hagi diversos paràmetres *Àlies* amb la mateixa clau *Àlies*.
És possible que diferents claus *Àlies* facin referència a la mateixa clau d'element.
Es poden emprar àlies a *HostMetadataItem* però no als paràmetres *HostnameItem*. Exemple 1: recuperant l'ID de l'usuari "zabbix". ```default 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. Exemple 2: obtenció de la utilització de la CPU amb paràmetres predeterminats i personalitzats. ```default 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 la utilització de la CPU. Exemple 3: execució de diverses regles [descoberta de baix nivell](/manual/discovery/low_level_discovery) que processen els mateixos elements de descoberta. ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` Ara és possible configurar diverses regles de descoberta emprant **vfs.fs.discovery** amb diferents paràmetres per a cada regla, per exemple, **vfs.fs.discovery[foo]**, **vfs.fs.discovery[bar]**, etc. [comment]: # ({/f3842378-29f73be6}) [comment]: # ({3ed0c834-2ef10025}) ##### AllowKey Permet l'execució d'aquelles claus d'element que coincideixen amb un patró. El patró de clau és una expressió 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 DenyKey. Els paràmetres es processen un per un segons el seu ordre d'aparició. Veieu també: [Restricció de comprovacions d'agents](/manual/config/items/restrict_checks). [comment]: # ({/3ed0c834-2ef10025}) [comment]: # ({b6e171ac-9a03d2b3}) ##### BufferSend 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. Per defecte: `5`
Interval: 1-3600 [comment]: # ({/b6e171ac-9a03d2b3}) [comment]: # ({94a46063-2df09503}) ##### BufferSize El nombre màxim de valors a la memòria intermèdia. L'agent enviarà totes les dades recopilades 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*). Per defecte: `1000`
Interval: 2-65535 [comment]: # ({/94a46063-2df09503}) [comment]: # ({566ec225-17ac979b}) ##### ControlSocket El sòcol de control, emprat per enviar ordres d'execució amb l'opció '-R'. Per defecte: `/tmp/agent.sock` [comment]: # ({/566ec225-17ac979b}) [comment]: # ({9c071f70-3b3005f3}) ##### DebugLevel Especifiqueu 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* - avisos;
*4* - per a la depuració (produeix molta informació);
*5* - depuració ampliada (produeix encara més informació). Per defecte: `3`
Interval: 0-5 [comment]: # ({/9c071f70-3b3005f3}) [comment]: # ({26eddabd-df723533}) ##### DenyKey Denega l'execució d'aquelles claus d'element que coincideixen amb un patró. El patró de clau és una expressió 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ó. Veieu també: [Restricció de comprovacions d'agents](/manual/config/items/restrict_checks). [comment]: # ({/26eddabd-df723533}) [comment]: # ({ae3ff74a-c92bd455}) ##### EnablePersistentBuffer Habiliteu l'ús de l'emmagatzematge local persistent per als elements actius. Si l'emmagatzematge persistent és desactivat, s'emprarà el buffer de memòria. Per defecte: `0`
Valors: 0 - desactivat, 1 - activat [comment]: # ({/ae3ff74a-c92bd455}) [comment]: # ({da2ce1bd-23af4c3e}) ##### ForceActiveChecksOnStart Feu comprovacions actives tot just després del reinici de la primera configuració rebuda. També disponible com a paràmetre de configuració per connector, per exemple: `Plugins.Uptime.System.ForceActiveChecksOnStart=1` Per defecte: `0`
Valors: 0 - desactivat, 1 - activat [comment]: # ({/da2ce1bd-23af4c3e}) [comment]: # ({70ff69c8-5609258c}) ##### HeartbeatFrequency La freqüència dels missatges de heartbeat en segons. S'empra per monitorar la disponibilitat de comprovacions actives.
0: missatges de heartbeat desactivats. Per defecte: `60`
Interval: 0-3600 [comment]: # ({/70ff69c8-5609258c}) [comment]: # ({1d584bf3-e228570b}) ##### HostInterface Un paràmetre opcional que defineix la interfície de l'equip (adreça IP o nom DNS) emprada durant el procés [d'autoregistre](/manual/discovery/auto_registration) de l'equip. Aquest valor s'utilitzarà per omplir la interfície a l'equip recentment creat i permet configurar explícitament l'adreça IP o DNS. Per a més detalls, consulteu [Ús de DNS com a interfície predeterminada](/manual/discovery/auto_registration#using_dns_as_default_interface). Si no es defineix, el valor s'obtindrà de HostInterfaceItem. L'agent emetrà un error i no s'iniciarà si el valor supera el límit de 255 caràcters. Interval: 0-255 caràcters [comment]: # ({/1d584bf3-e228570b}) [comment]: # ({46385051-34145839}) ##### HostInterfaceItem Un paràmetre opcional que defineix un element utilitzat per determinar la interfície de l'equip (adreça IP o nom DNS) durant el procés d'[autoregistre](/manual/discovery/auto_registration) de l'equip. Aquest valor només s'utilitza si HostInterface no és pas definit. Per a més detalls, consulteu [Utilització de DNS com a interfície predeterminada](/manual/discovery/auto_registration#using_dns_as_default_interface). Durant una petició d'autoregistre, l'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[]](/manual/config/items/itemtypes/zabbix_agent#system.run) és compatible independentment de la configuració d'AllowKey/DenyKey. [comment]: # ({/46385051-34145839}) [comment]: # ({130bb2a7-0351f0ec}) ##### HostMetadata Un paràmetre opcional que defineix les [metadades](/manual/discovery/auto_registration#using-host-metadata) que s'utilitzen per identificar o distingir l'equip durant el procés d'[autoregistre](/manual/discovery/auto_registration) de l'equip. HostMetadata permet distingir entre equip més enllà del nom de l'equip. Si no es defineix, el valor s'obtindrà de HostMetadataItem. L'agent emetrà un error i no s'iniciarà si el valor especificat supera el límit de 2034 octets o una cadena que no sigui UTF-8. Quan un paràmetre espera una adreça IP o un nom DNS, els valors que siguin UTF-8 vàlids però que no siguin IP o noms DNS vàlids també es rebutjaran i es notificaran com a no vàlids. Rang: 0-2034 octets [comment]: # ({/130bb2a7-0351f0ec}) [comment]: # ({4f85713e-62d441b2}) ##### HostMetadataItem Un paràmetre opcional que defineix un element d'agent Zabbix utilitzat per obtindre [metadades de l'amfitrió](/manual/discovery/auto_registration#using-host-metadata). Aquesta opció només s'utilitza quan HostMetadata no és pas definit. El valor HostMetadataItem es recupera en cada intent d'[autoregistre](/manual/discovery/auto_registration) i només s'utilitza en el procés d'autoregistre de l'equip (agent actiu). HostMetadataItem permet distingir entre equips més enllà del nom de l'equip. Els paràmetres d'usuari i els àlies són compatibles. L'element [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) és compatible independentment de la configuració d'AllowKey/DenyKey. Durant una petició d'autoregistre, l'agent registrarà un missatge d'avís si el valor retornat per l'element especificat supera el límit de 65535 punts de codi UTF-8. El valor retornat per l'element ha de ser una cadena UTF-8; altrament, s'ignorarà. Quan un paràmetre espera una adreça IP o un nom DNS, els valors que són UTF-8 vàlids però que no són IP o noms DNS vàlids també es rebutjaran i es notificaran com a no vàlids. No s'admeten metadades de diverses línies: la sortida es truncarà al primer salt de línia. [comment]: # ({/4f85713e-62d441b2}) [comment]: # ({39406dda-14a36542}) ##### Hostname Una llista de noms d'equip únics, delimitats per comes i que distingeixen entre majúscules i minúscules. Necessari per a les comprovacions actives i ha de coincidir amb els noms d'equip configurats al servidor. El valor s'adquireix de HostnameItem si no és definit.
Caràcters permesos: alfanumèrics, '.', ' ', '\_' i '-'. Longitud màxima: 128 caràcters per nom d'equip, 2048 caràcters per a tota la línia. Per defecte: Definit a HostnameItem [comment]: # ({/39406dda-14a36542}) [comment]: # ({77a62307-cbe03ed0}) ##### HostnameItem Un paràmetre opcional que defineix un element emprat per obtenir el nom d'equip. Aquesta opció només s'empra quan el nom d'equip no ésdefinit. Els paràmetres d'usuari o els àlies no s'admeten, però l'element [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) s'accepta independentment dels valors d'AllowKey/DenyKey. Per defecte: `system.hostname` [comment]: # ({/77a62307-cbe03ed0}) [comment]: # ({1f402df9-ba2f3511}) ##### Include Podeu incloure fitxers individuals o tots els fitxers d'un directori al fitxer de configuració. Durant la instal·lació, Zabbix crearà el directori d'inclusió a /usr/local/etc, tret que es modifiqui durant el temps de compilació. El camí pot ser relatiu a la ubicació del fitxer *zabbix\_agent2.conf*.
Per incloure només fitxers rellevants al directori especificat, el caràcter comodí d'asterisc és compatible per a la concordança de patrons.
Veieu també el [comportament del paràmetre](special_notes_include) `Include`. Exemple: ```default Include=/absolute/path/to/config/files/*.conf ``` [comment]: # ({/1f402df9-ba2f3511}) [comment]: # ({43e741ee-f99953c8}) ##### ListenIP Una llista 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. Per defecte: `0.0.0.0` [comment]: # ({/43e741ee-f99953c8}) [comment]: # ({5f95bc53-f0fb838a}) ##### ListenPort L'agent escoltarà en aquest port les connexions des del servidor. Per defecte: `10050`
Rang: 1024-32767 [comment]: # ({/5f95bc53-f0fb838a}) [comment]: # ({493335d8-b6d7fb90}) ##### LogFile El nom del fitxer de registre. Per defecte: `/tmp/zabbix_agent2.log`
Obligatori: Sí, si LogType s'estableix a *fitxer*; en cas contrari no [comment]: # ({/493335d8-b6d7fb90}) [comment]: # ({f7604f8f-3428c3ce}) ##### LogFileSize La mida màxima d'un fitxer de registre en Mo.
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 comença de nou. Per defecte: `1`
Rang: 0-1024 [comment]: # ({/f7604f8f-3428c3ce}) [comment]: # ({ae46be35-51e38b5f}) ##### LogType El tipus de sortida del registre:
*fitxer* - escriu el registre al fitxer especificat pel paràmetre LogFile;
*system* - escriu el registre al syslog;
*consola* - escriu el registre a la sortida estàndard. Per defecte: `file` [comment]: # ({/ae46be35-51e38b5f}) [comment]: # ({357a4f09-5b3e2c7e}) ##### PersistentBufferFile El fitxer on l'agent Zabbix 2 hauria de mantindre la base de dades SQLite. Ha de ser un nom de fitxer complet. Aquest paràmetre només s'empra si la memòria intermèdia persistent és habilitada (*EnablePersistentBuffer=1*). [comment]: # ({/357a4f09-5b3e2c7e}) [comment]: # ({2937cc76-148a8da3}) ##### PersistentBufferPeriod El 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 del registre es conservaran. Aquest paràmetre només s'empra si la memòria intermèdia persistent és habilitada (*EnablePersistentBuffer=1*). Per defecte: `1h`
Rang: 1m-365d [comment]: # ({/2937cc76-148a8da3}) [comment]: # ({27678307-8cadd2c5}) ##### PidFile Nom de l'arxiu PID. Per defecte: `/tmp/zabbix_agent2.pid` [comment]: # ({/27678307-8cadd2c5}) [comment]: # ({9b0fb2d6-184426b4}) ##### Plugins..System.Capacity {#plugins.systemcapacity} El límit de comprovacions per plugin `` que es poden executar al mateix temps. Per defecte: `1000`. Interval: 1-1000 [comment]: # ({/9b0fb2d6-184426b4}) [comment]: # ({21943486-c391a1f7}) ##### Plugins.Log.MaxLinesPerSecond El nombre màxim de línies noves que l'agent enviarà per segon al servidor o al proxy Zabbix quan processi les comprovacions actives 'log' i 'logrt'. El valor proporcionat serà substituït pel paràmetre 'maxlines', proporcionat a la clau d'element 'log' i 'logrt'.
*Nota*: Zabbix processarà 10 vegades més línies noves que les establertes a *MaxLinesPerSecond * per cercar la cadena necessària als elements de registre. Per defecte: `20`
Rang: 1-1000 [comment]: # ({/21943486-c391a1f7}) [comment]: # ({487e5b60-5e488d60}) ##### Plugins.SystemRun.LogRemoteCommands Habiliteu el registre de les ordres de l'intèrpret d'ordres executades com a avisos. 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 mitjançant els paràmetres HostMetadataItem, HostInterfaceItem o HostnameItem. Per defecte: `0`
Valors: 0 - desactivat, 1 - activat [comment]: # ({/487e5b60-5e488d60}) [comment]: # ({ab2236de-60653974}) ##### PluginSocket El camí al sòcol UNIX per a les comunicacions de plugins carregables. Per defecte: `/tmp/agent.plugin.sock` [comment]: # ({/ab2236de-60653974}) [comment]: # ({14afe8ce-1bc7efe1}) ##### PluginTimeout El temps d'espera de les connexions amb plugins carregables, en segons. Per defecte: `Timeout`
Rang: 1-30 [comment]: # ({/14afe8ce-1bc7efe1}) [comment]: # ({3d47a4c2-cc91d3f3}) ##### RefreshActiveChecks Amb quina freqüència 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à en 60 segons. Per defecte: `5`
Rang: 1-86400 [comment]: # ({/3d47a4c2-cc91d3f3}) [comment]: # ({bb2bfe8d-26a8e7e8}) ##### Server Un llistat d'adreces IP delimitades per comes, opcionalment en notació CIDR, o noms DNS de servidors Zabbix o proxys Zabbix. Només s'acceptaran connexions entrants dels equips especificats. Si el suport IPv6 és habilitat, '127.0.0.1', '::127.0.0.1', '::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' es pot emprar per permetre qualsevol adreça IPv4. S'admeten espais. Si no s'especifica aquest paràmetre, desactiva les comprovacions passives i l'agent no escoltarà cap port TCP. Exemple: ```default Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.exemple.cat ``` [comment]: # ({/bb2bfe8d-26a8e7e8}) [comment]: # ({1f645469-c466b0b1}) ##### ServerActive L'adreça del servidor/proxy Zabbix o la configuració del clúster per obtindre comprovacions actives. L'adreça del servidor/proxy és una adreça IP o un nom DNS i un port opcional separats per dos punts.
La configuració del clúster és una o més adreces de servidor separades per punt i coma. Es poden especificar diversos servidors/clústers Zabbix i proxys Zabbix, separats per comes. No s'ha d'especificar més d'un proxy Zabbix des de cada servidor/clúster Zabbix. Si s'especifica un proxy Zabbix, no s'hauria d'especificar el servidor/clúster Zabbix per a aquest proxy.
Es poden proporcionar diverses adreces delimitades per comes 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 les adreces IPv6 són opcionals.
Si no s'especifica aquest paràmetre, les comprovacions actives no són pas actives. Exemple de proxy Zabbix: ```default ServerActive=127.0.0.1:10051 ``` Exemple per a diversos servidors: ```default ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1] ``` Exemple d'alta disponibilitat: ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3 ``` Exemple d'alta disponibilitat amb dos clústers i un servidor: ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain ``` [comment]: # ({/1f645469-c466b0b1}) [comment]: # ({76194937-5212a055}) ##### SourceIP L'adreça IP d'origen per a: - connexions sortints al servidor Zabbix o al proxy Zabbix; - fer connexions mentre s'executen alguns elements (web.page.get, net.tcp.port, etc.). [comment]: # ({/76194937-5212a055}) [comment]: # ({7d3f343b-14a0e16c}) ##### StatusPort Si s'estableix, l'agent escoltarà en aquest port les peticions d'estat HTTP (http://localhost:/status). Range: 1024-32767 [comment]: # ({/7d3f343b-14a0e16c}) [comment]: # ({4f69df7d-c0cd090f}) ##### Timeout Especifica el temps d'espera (en segons) per establir connexió i bescanviar informació amb el servidor o proxy Zabbix.
Aquest paràmetre defineix la durada de diverses operacions de comunicació, com ara: - esperant una resposta del servidor Zabbix; - enviament de peticions al servidor Zabbix, incloses les [comprovacions actives](/manual/appendix/items/activepassive#active-checks) de peticions de configuració d'elements i informació d'elements; - Recuperació de dades de registre mitjançant un fitxer de registre;
- enviament de missatges de heartbeat; - durada màxima de les validacions `vfs.*`; - com a alternativa en escenaris on el servidor o /proxy anterior a la versió 7.0 envia comprovacions sense temps d'espera. Aquest temps d'espera **no** s'utilitzarà per a aquelles comprovacions d'agents que tinguin paràmetres de temps d'espera configurables a la interfície (a nivell global, de proxy o per element). Per defecte: `3`
Interval: 1-30 [comment]: # ({/4f69df7d-c0cd090f}) [comment]: # ({2200adc7-50f15389}) ##### TLSAccept Les connexions entrants a acceptar. S'utilitza per a controls passius. Es poden especificar diversos valors, separats per comes:
*sense xifrar* - accepta connexions sense xifratge (per defecte)
*psk* - accepta connexions amb TLS i una clau prèviament compartida (PSK)
*cert* - accepta connexions amb TLS i un certificat Obligatori: sí, si el certificat TLS o els paràmetres PSK estan definits (fins i tot per a connexió *no xifrada*); en cas contrari no [comment]: # ({/2200adc7-50f15389}) [comment]: # ({65d07bda-7014d327}) ##### TLSCAFile La ruta completa del fitxer que conté els certificats de CA(s) de nivell superior per a la verificació de certificats entre iguals, emprats per a comunicacions xifrades entre components Zabbix. [comment]: # ({/65d07bda-7014d327}) [comment]: # ({005f60f1-76da8f86}) ##### TLSCertFile El camí complet del fitxer que conté el certificat de l'agent o la cadena de certificats, emprat per a comunicacions xifrades amb components Zabbix. [comment]: # ({/005f60f1-76da8f86}) [comment]: # ({8f81e3ca-f06fce3e}) ##### TLSCipherAll La cadena de xifrat OpenSSL (TLS 1.2). Substituïu els criteris de selecció de la suite de xifrat per defecte per al xifrat basat en certificats i PSK. Exemple: ```default EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128 ``` [comment]: # ({/8f81e3ca-f06fce3e}) [comment]: # ({834af6c4-78547ea1}) ##### TLSCipherAll13 La cadena de xifrat per a OpenSSL (TLS 1.3) per a OpenSSL 1.1.1 o superior. Substituïu els criteris de selecció de la suite de xifrat per defecte per al xifrat basat en certificats i PSK. Exemple: ```default TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` [comment]: # ({/834af6c4-78547ea1}) [comment]: # ({902617f7-02de1fc7}) ##### TLSCipherCert La cadena de xifrat OpenSSL (TLS 1.2). Substituïu els criteris de selecció de la suite de xifrat predeterminats per al xifrat basat en certificats. Exemple: ```default EECDH+aRSA+AES128:RSA+aRSA+AES128 ``` Tingueu en compte que aquest paràmetre no es pot emprar juntament amb `TLSAccept=cert,psk`; per a la connexió del certificat (`TLSConnect=cert`), empreu LSCipherAll. [comment]: # ({/902617f7-02de1fc7}) [comment]: # ({1ec853eb-1bd16790}) ##### TLSCipherCert13 La cadena de xifrat d'OpenSSL (TLS 1.3) per a OpenSSL 1.1.1 o posterior. Substituïu els criteris de selecció de la suite de xifrat predeterminats per al xifrat basat en certificats. Tingueu en compte que aquest paràmetre no es pot emprar juntament amb `TLSAccept=cert,psk`; per a la connexió del certificat (`TLSConnect=cert`), empreu LSCipherAll13. [comment]: # ({/1ec853eb-1bd16790}) [comment]: # ({a7c9008e-b6a97164}) ##### TLSCipherPSK La cadena de xifrat per a OpenSSL (TLS 1.2). Substituïu els criteris de selecció de la suite de xifrat predeterminats per al xifrat basat en PSK. Exemple: ```default kECDHEPSK+AES128:kPSK+AES128 ``` [comment]: # ({/a7c9008e-b6a97164}) [comment]: # ({d37c55b4-d4a7f685}) ##### TLSCipherPSK13 La cadena de xifrat d'OpenSSL (TLS 1.3) per a OpenSSL 1.1.1 o posterior. Substituïu els criteris de selecció de la suite de xifrat predeterminats per al xifrat basat en PSK. Exemple: ```default TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` [comment]: # ({/d37c55b4-d4a7f685}) [comment]: # ({e2ebc18f-48c650d6}) ##### TLSConnect Com s'ha de connectar l'agent al servidor o al proxy Zabbix. S'empra per a controls actius. Només es pot especificar un valor:
*sense xifrar* - connectar sense xifrat (per defecte)
*psk* - connectar mitjançant TLS i una clau prèviament compartida (PSK)
*cert* - connectar mitjançant TLS i un certificat Obligatori: sí, si el certificat TLS o els paràmetres PSK són definits (fins i tot per a connexió *no xifrada*); en cas contrari no [comment]: # ({/e2ebc18f-48c650d6}) [comment]: # ({ad4dc889-9039238d}) ##### TLSCRLFile El camí complet del fitxer que conté certificats revocats. Aquest paràmetre s'empra per a comunicacions xifrades entre components Zabbix. [comment]: # ({/ad4dc889-9039238d}) [comment]: # ({c2aa4315-27bba150}) ##### TLSKeyFile La ruta completa del fitxer que conté la clau privada de l'agent, emprada per a les comunicacions xifrades entre els components del Zabbix. [comment]: # ({/c2aa4315-27bba150}) [comment]: # ({11defa44-e05527e5}) ##### TLSPSKFile La ruta completa del fitxer que conté la clau prèviament compartida de l'agent, emprada per a comunicacions xifrades amb el servidor Zabbix. [comment]: # ({/11defa44-e05527e5}) [comment]: # ({92d3eff0-4365ff43}) ##### TLSPSKIdentity La cadena d'identitat de clau prèviament compartida, emprada per a comunicacions xifrades amb el servidor Zabbix. [comment]: # ({/92d3eff0-4365ff43}) [comment]: # ({ae5c568f-8a75a0d0}) ##### TLSServerCertIssuer L'emissor del certificat del servidor (proxy) permès. [comment]: # ({/ae5c568f-8a75a0d0}) [comment]: # ({fb69617f-f59b720f}) ##### TLSServerCertSubject L'assumpte del certificat del servidor (proxy) permès. [comment]: # ({/fb69617f-f59b720f}) [comment]: # ({8fffe818-29d4cb8b}) ##### UnsafeUserParameters Permet que tots els caràcters es passin en arguments a 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. Per defecte: `0`
Valors: 0 - no permet, 1 - permet [comment]: # ({/8fffe818-29d4cb8b}) [comment]: # ({1a5d86ec-d6a6fd16}) ##### UserParameter Un paràmetre definit per l'usuari per monitorar. Hi pot haver diversos paràmetres definits per l'usuari.
Format: UserParameter=,
Tingueu en compte que l'ordre shell no ha de retornar només una cadena buida o EOL. Les ordres de Shell poden tindre camins relatius, si s'especifica el paràmetre UserParameterDir. Exemple: ```default UserParameter=system.test,who|wc -l UserParameter=check_cpu,./custom_script.sh ``` [comment]: # ({/1a5d86ec-d6a6fd16}) [comment]: # ({0a46abda-7246224d}) ##### UserParameterDir El camí de cerca predeterminat per a les ordres UserParameter. Si s'empra, l'agent canviarà el seu directori de treball a l'especificat aquí abans d'executar una comanda. Per tant, les ordres UserParameter poden tindre un prefix relatiu `./` en lloc d'un camí complet.
Només es permet una entrada. Exemple: ```default UserParameterDir=/opt/myscripts ``` [comment]: # ({/0a46abda-7246224d})