Áú»¢¶Ä²©

5 Áú»¢¶Ä²© agent (Windows)

Vista general

Aquesta secci¨® llista els par¨¤metres admesos a l'arxiu de configuraci¨® de Windows del Áú»¢¶Ä²© agent 2 (zabbix_agent.conf).

Els par¨¤metres es llisten sense informaci¨® addicional. Feu clic al par¨¤metre per veure'n tots els detalls.

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 del dimoni, i no pas els valors dels arxius de configuraci¨® lliurats;
• Áú»¢¶Ä²© suporta els fitxers de configuraci¨® codificats en UTF-8, sense ;
• Els comentaris que comencen amb "#" nom¨¦s s¨®n admesos a principi de l¨ªnia.

Detalls del par¨¤metre

?lies

Estableix 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 curta i senzilla. ?s possible que hi hagi diversos par¨¤metres ?lies amb la mateixa clau ?lies.
Les claus ?lies diferents poden fer refer¨¨ncia a la mateixa clau d'element.
Es poden emprar ¨¤lies a HostMetadataItem per¨° no a HostnameItem o * ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ðs PerfCounter*.

Exemple 1: recuperaci¨® de l'¨²s del fitxer de paginaci¨® en percentatge del servidor.

 Alias=pg_usage:perf_counter[\Fitxer de paginaci¨®(_Total)\% ¨²²õ±Õ

Ara es pot emprar la clau abreujada pg_usage per recuperar dades.

Exemple 2: obtindre la c¨¤rrega de la CPU amb par¨¤metres predeterminats i personalitzats.

 Alias=cpu.load:system.cpu.load
        Alias=cpu.load[*]:system.cpu.load[*]

Aix¨° permet emprar la clau cpu.load per obtindre la c¨¤rrega de la CPU amb els par¨¤metres predeterminats, aix¨ª com emprar cpu.load[percpu,avg15] per obtindre dades espec¨ªfiques sobre la c¨¤rrega de la CPU.

Exemple 3: execuci¨® de diverses regles descoberta de baix nivell que processen els mateixos elements de descoberta.

 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.

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.

BufferSend

No deseu les dades m¨¦s de N segons a la mem¨°ria interm¨¨dia.

Per defecte: 5
Rang: 1-3600

BufferSize

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

Per defecte: 100
Rang: 2-65535

DebugLevel

Especifiqueu 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¨®).

Per defecte: 3
Interval: 0-5

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.

EnableRemoteCommands

Si es permeten les comandes remotes del servidor Áú»¢¶Ä²©. Aquest par¨¤metre ¨¦s obsolet, empreu AllowKey=system.run[*] o DenyKey=system.run[*].
?s un ¨¤lies intern per als par¨¤metres AllowKey/DenyKey en funci¨® de valor:
0 - DenyKey=system.run[*]
1 - AllowKey=system.run[*]

Per defecte: 0
Valors: 0 - no perm¨¨s, 1 - perm¨¨s

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

HostInterface

Un par¨¤metre opcional que defineix la interf¨ªcie de l'equip. La interf¨ªcie de l'equip s'empra en el proc¨¦s autoregistre de l'equip. Si no es defineix, el valor s'agafar¨¤ de HostInterfaceItem.
L'agent donar¨¤ error i no comen?ar¨¤ si el valor supera el l¨ªmit de 255 car¨¤cters.

Interval: 0-255 car¨¤cters

HostInterfaceItem

Un par¨¤metre opcional que defineix un element emprat per obtindre la interf¨ªcie de l'equip.
La interf¨ªcie de l'equip s'empra al proc¨¦s autoregistration de l'equip.
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[] s'admet independentment dels valors AllowKey/DenyKey.
Aquesta opci¨® nom¨¦s s'empra quan HostInterface ¨¦s sense definir.

HostMetadata

Un par¨¤metre opcional que defineix les metadades de l'equip. Les metadades de l'equip nom¨¦s s'empren en el proc¨¦s d'autoregistre de l'equip (agent actiu). Si no es defineix, el valor s'adquirir¨¤ de HostMetadataItem.
L'agent emetr¨¤ un error i no comen?ar¨¤ si el valor especificat supera el l¨ªmit de 2034 octets o una cadena que no sigui UTF-8.

Rang: 0-2034 octets

HostMetadataItem

Un par¨¤metre opcional que defineix un element d'agent Áú»¢¶Ä²© emprat per obtindre metadades de l'equip. Aquesta opci¨® nom¨¦s s'empra quan HostMetadata no ¨¦s definit. S'admeten els par¨¤metres d'usuari, comptadors de rendiment i els ¨¤lies. L'element system.run[] s'accepta independentment dels valors AllowKey/DenyKey.
El valor HostMetadataItem es recupera a cada intent d'autoregistre i nom¨¦s s'empra en el proc¨¦s de registre autom¨¤tic de l'equip (agent actiu).
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 que retorna l'element ha de ser una cadena UTF-8, en cas contrari, s'ignorar¨¤.

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 per HostnameItem

HostnameItem

Un par¨¤metre opcional que defineix un element d'agent Áú»¢¶Ä²© utilitzat per obtenir el nom d'equip. Aquesta opci¨® nom¨¦s s'empra quan el nom d'equip no ¨¦sdefinit. Els par¨¤metres d'usuari, els comptadors de rendiment o els ¨¤lies no s'admeten, per¨° l'element system.run[] s'accepta independentment dels valors d'AllowKey/DenyKey.
La longitud de sortida ¨¦s limitada a 512 Ko.
Veieu tamb¨¦ una descripci¨® m¨¦s en detall.

Per defecte: system.hostname

Include

Podeu incloure fitxers individuals o tots els fitxers d'un directori al fitxer de configuraci¨® (ubicat a C:\Program Files\Áú»¢¶Ä²© Agent 2 per defecte si l'agent de Áú»¢¶Ä²© 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). Tots els arxius inclosos han de tindre una sintaxi correcta; altrament, l'agent no engegar¨¤ pas. La ruta pot ¨¦sser relativa a zabbix_agent2.conf (per exemple, Include=.\zabbix_agent2.d\plugins.d\*.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 les [notes especials] (special_notes_include) sobre les limitacions.

Exemple:

Include=C:FilesAgent_agentd.d*.conf

ListenBacklog

El nombre m¨¤xim de connexions pendents a la cua de TCP.
El valor predeterminat ¨¦s una constant codificada, que dep¨¨n del sistema.
El valor m¨¤xim adm¨¨s dep¨¨n del sistema; els valors massa alts es poden truncar silenciosament a el "m¨¤xim especificat per la implementaci¨®".

Per defecte: SOMAXCONN
Rang: 0 - INT_MAX

ListenIP

Un llistat d'adreces IP delimitades per comes que l'agent hauria d'escoltar.

Per defecte: 0.0.0.0

ListenPort

L'agent escoltar¨¤ en aquest port les connexions des del servidor.

Per defecte: 10050
Rang: 1024-32767

LogFile

El nom del fitxer de registre de l'agent.

Per defecte: C:\\zabbix_agentd.log
Obligatori: S¨ª, si LogType s'estableix a fitxer; en cas contrari no

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

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

LogType

El tipus de sortida del registre:
fitxer - escriu el registre al fitxer especificat pel par¨¤metre LogFile;
system - escriu el registre al Windows Event Log;
consola - escriu el registre a la sortida est¨¤ndard.

Per defecte: file

MaxLinesPerSecond

El nombre m¨¤xim de l¨ªnies noves que l'agent enviar¨¤ per segon al servidor o al proxy Áú»¢¶Ä²© quan processi les comprovacions actives 'log', 'logrt' i 'eventlog'. El valor proporcionat ser¨¤ substitu?t pel par¨¤metre 'maxlines', proporcionat a la clau d'element 'log', 'logrt' o 'eventlog'.
Nota: Áú»¢¶Ä²© 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

PerfCounter

Defineix un nou par¨¤metre <parameter_name> que ¨¦s el valor mitj¨¤ del comptador de rendiment del sistema <perf_counter_path> durant el per¨ªode de temps especificat <per¨ªode> (en segons).
Sintaxi: <parameter_name>," <perf_counter_path>",<per¨ªode>

Per exemple, si voleu rebre el nombre mitj¨¤ d'interrupcions del processador per segon durant el darrer minut, podeu definir un nou par¨¤metre "interrupcions" com el seg¨¹ent:

 PerfCounter = interrupcions,"\Processador(0)\Interrupcions/s",60

Tingueu en compte les cometes dobles al voltant del cam¨ª del comptador de rendiment. El nom del par¨¤metre (interrupcions) s'ha d'emprar com a clau d'element quan es crea un element. Es prendran mostres per calcular el valor mitj¨¤ cada segon.
Podeu executar "typeperf -qx" per obtindre el llistat de tots els comptadors de rendiment disponibles a Windows.

PerfCounterEn

Defineix un nou par¨¤metre <parameter_name> que ¨¦s el valor mitj¨¤ del comptador de rendiment del sistema <perf_counter_path> durant el per¨ªode de temps especificat <per¨ªode> (en segons). En comparaci¨® amb PerfCounter, els camins de perfcounter han d'¨¦sser en angl¨¨s. Nom¨¦s s'admet a Windows Server 2008/Vista i posterior.
Sintaxi: <parameter_name>,"<perf_counter_path>",<per¨ªode>

Per exemple, si voleu rebre el nombre mitj¨¤ d'interrupcions del processador per segon durant el darrer minut, podeu definir un nou par¨¤metre "interrupcions" com el seg¨¹ent:

 PerfCounterEn = interrupcions,"\Processador(0)\Interruptes/s",60

Tingueu en compte les cometes dobles al voltant del cam¨ª del comptador de rendiment. El nom del par¨¤metre (interrupcions) s'ha d'emprar com a clau d'element quan es crea un element. Es prendran mostres per calcular el valor mitj¨¤ cada segon.
Podeu trobar la llista de cadenes en angl¨¨s si visualitzeu la clau de registre seg¨¹ent: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009.

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

Server

Un llistat d'adreces IP delimitades per comes, opcionalment en notaci¨® CIDR, o noms DNS de servidors Áú»¢¶Ä²© o proxys Áú»¢¶Ä²©. Nom¨¦s s'admetran connexions entrants dels equip indicats aqu¨ª. 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. Tingueu en compte que admet les "adreces IPv6 compatibles amb IPv4" (prefix 0000::/96). S'admeten espais.

Exemple:

 Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.exemple.cat

Obligatori: s¨ª, si StartAgents no s'ha establert expl¨ªcitament a 0

ServerActive

L'adre?a del servidor/proxy Áú»¢¶Ä²© 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 Áú»¢¶Ä²© i proxys Áú»¢¶Ä²©, separats per comes. No s'ha d'especificar m¨¦s d'un proxy Áú»¢¶Ä²© des de cada servidor/cl¨²ster Áú»¢¶Ä²©. Si s'especifica el proxy Áú»¢¶Ä²©, no s'hauria d'especificar el servidor/cl¨²ster Áú»¢¶Ä²© per a aquest proxy.
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 les adreces IPv6 s¨®n opcionals.
Si no s'especifica aquest par¨¤metre, les comprovacions actives s¨®n desactivades.

Exemple de 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

Rang: (*)

SourceIP

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

StartAgents

El nombre d'inst¨¤ncies pr¨¨viament bifurcades de zabbix_agentd que processen comprovacions passives. Si s'estableix a 0, les comprovacions passives s¨®n desactivades i l'agent no escoltar¨¤ cap port TCP.

Per defecte: 10
Rang: 0-63 (*)

Timeout

Especifica el temps d'espera (en segons) per establir connexi¨® i bescanviar informaci¨® amb el servidor o proxy Áú»¢¶Ä²©.
Aquest par¨¤metre s'empra per definir la durada de diverses operacions, com ara:
- esperant una resposta del servidor Áú»¢¶Ä²©;
- enviament de peticions al servidor Áú»¢¶Ä²©, incloses les peticions de configuraci¨® de comprovacions actives i dades d'elements;
- Recuperaci¨® de dades de registre mitjan?ant un fitxer de registre o un seguiment del registre d'esdeveniments de Windows;
- enviament de missatges de heartbeat;
- durada m¨¤xima de les validacions vfs.;
- emprat per els m¨°duls de l'agent Áú»¢¶Ä²©;
- tamb¨¦ s'empra com a alternativa en escenaris el servidor/proxy anterior a la versi¨® 7.0 envia comprovacions sense temps d'espera.

Per defecte: 3
Interval: 1-30

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

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 Áú»¢¶Ä²©.

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 Áú»¢¶Ä²©.

TLSConnect

Com s'ha de connectar l'agent al servidor o al proxy Áú»¢¶Ä²©. 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

TLSCRLFile

El cam¨ª complet del fitxer que cont¨¦ certificats revocats. Aquest par¨¤metre s'empra per a comunicacions xifrades entre components Áú»¢¶Ä²©.

TLSKeyFile

La ruta completa del fitxer que cont¨¦ la clau privada de l'agent, emprada per a les comunicacions xifrades entre els components del Áú»¢¶Ä²©.

TLSPSKFile

La ruta completa del fitxer que cont¨¦ la clau pr¨¨viament compartida de l'agent, emprada per a comunicacions xifrades amb el servidor Áú»¢¶Ä²©.

TLSPSKIdentity

La cadena d'identitat de clau pr¨¨viament compartida, emprada per a comunicacions xifrades amb el servidor Áú»¢¶Ä²©.

TLSServerCertIssuer

L'emissor del certificat del servidor (proxy) perm¨¨s.

TLSServerCertSubject

L'assumpte del certificat del servidor (proxy) perm¨¨s.

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

UserParameter

Un par¨¤metre definit per l'usuari per monitorar. Hi pot haver diversos par¨¤metres definits per l'usuari.
Format: UserParameter=<key>,<shell command>
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:

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

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 ordre. Per tant, les ordres UserParameter poden tindre un prefix relatiu ./ en lloc d'un cam¨ª complet. Nom¨¦s es permet una entrada.

Exemple:

UserParameterDir=C:\opt\myscripts