2 Agent de Windows Zabbix

Vista general

Els elements de l'agent de Windows Zabbix es presenten en dues llistes:

• Elements compartits - claus d'elements que es comparteixen amb l'agent Zabbix d'UNIX;
• Elements específics de Windows - claus d'element que s'admeten només a Windows.

Tingueu en compte que totes les claus d'element admeses per l'agent Zabbix a Windows també són compatibles amb l'agent Zabbix 2. Veieu les claus d'element addicionals que només podeu emprar amb l'agent 2.

Veieu també: Permisos mínims per a elements de Windows

Elements compartits

La taula següent llista els elements de l'agent Zabbix compatibles amb Windows i es comparteixen amb l'agent UNIX Zabbix:

• La clau d'element és un enllaç a tots els detalls de l'element de l'agent Zabbix d'UNIX
• S'inclouen comentaris d'elements rellevants per a Windows

Elements específics de Windows

La taula proporciona detalls sobre les claus d'element que només admet l'agent Zabbix de Windows.

Els elements específics de Windows de vegades són una contrapartida aproximada d'un element d'agent similar, per exemple proc_info, compatible amb Windows, correspon aproximadament a l'element proc.mem, no compatible amb Windows.

La clau d'element és un enllaç als detalls complets de la clau d'element.

Detalls clau de l'article

Els paràmetres sense claudàtors angulars són obligatoris. Els paràmetres marcats amb claudàtors angulars < > són opcionals.

eventlog[name,<regexp>,<severity>,<source>,<eventid>,<maxlines>,<mode>]

Seguiment del registre d'esdeveniments.
Valor de retorn: Log.

Paràmetres:

• nom - nom del canal del registre d'esdeveniments (Nom de registre al visor d'esdeveniments);
  
• regexp - [expressió] regular (/manual/regular_expressions#overview) que descriu el patró necessari (distingeix entre majúscules i minúscules);
  
• gravetat - expressió regular que descriu la gravetat (no distingeix entre majúscules i minúscules). Aquest paràmetre accepta una expressió regular basada en els valors següents: "Informació", "Avís", "Error", "Crític", "Descripció" (s'executa a Windows Vista o posterior).
  
• font - expressió regular que descriu l'identificador de la font (no distingeix entre majúscules i minúscules);
  
• eventid - una expressió regular que descriu els identificadors d'esdeveniments (distingeix entre majúscules i minúscules);
  
• maxlines - nombre màxim de línies noves per segon que l'agent enviarà al servidor o proxy Zabbix. Aquest paràmetre anul·la el valor de 'MaxLinesPerSecond' a zabbix_agentd.conf.
  
• mode - valors possibles: all (per defecte) o skip - saltar el processat de dades més antigues (afecta només els elements de nova creació).

Comentaris:

• L'element s'ha de configurar com a comprovació activa;
• L'agent no pot enviar esdeveniments des del registre "Esdeveniments reenviats";
• S'admet Windows Eventing 6.0;
• La selecció d'un tipus d'informació que no sigui de registre per a aquest element comportarà la pèrdua de la marca de temps local, així com la gravetat del registre i la informació d'origen;
• Veieu també informació addicional sobre control de registre.

Exemples:

    eventlog[Application]
    eventlog[Microsoft-Windows-Application-Experience/Program-Compatibility-Assistant]
    eventlog[Security,,"Failure Audit",,^(529|680)$]
    eventlog[System,,"Warning|Error"]
    eventlog[System,,,,^1$]
    eventlog[Windows PowerShell,,,,,,skip]
    eventlog[System,,,,@TWOSHORT] #here a custom regular expression named `TWOSHORT` is referenced (defined as a *Result is TRUE* type, the expression itself being `^1$|^70$`).

eventlog.count[nom,<regexp>,<severity>,<font>,<eventid>,<maxproclines>,<mode>]

El recompte de línies al registre d'esdeveniments de Windows.
Valor de retorn: Enter.

Paràmetres:

• nom - nom del canal del registre d'esdeveniments (Nom de registre al visor d'esdeveniments);
  
• regexp - una expressió que descriu el patró necessari (distingeix entre majúscules i minúscules);
  
• gravetat - una expressió regular que descriu la gravetat (insensible a majúscules i minúscules). Aquest paràmetre accepta una expressió regular basada en els valors següents: "Informació", "Avís", "Error", "Crític", "Descripció" (s'executa amb Windows Vista o posterior).
  
• font - una expressió regular que descriu l'identificador de la font (no distingeix entre majúscules i minúscules);
  
• eventid - una expressió regular que descriu els identificadors d'esdeveniments (distingeix entre majúscules i minúscules);
  
• maxproclines - el nombre màxim de línies noves per segon que analitzarà l'agent (no pot superar les 10.000). El valor predeterminat és 10*'MaxLinesPerSecond' a zabbix_agentd.conf.
  
• mode - valors possibles: all (per defecte) o skip - saltar el processament de dades més antigues (afecta només els elements de nova creació).

Comentaris:

• L'element s'ha de configurar com a comprovació activa;
• L'agent no pot enviar esdeveniments des del registre "Esdeveniments reenviats";
• S'admet Windows Eventing 6.0;
• La selecció d'un [tipus d'informació] que no és de registre (/manual/config/items/item#configuration) per a aquest element comportarà la pèrdua de la marca de temps local, així com la gravetat del registre i la informació d'origen;
• Vegeu també informació addicional sobre control de registre.

Exemple:

    eventlog.count[System,,"Warning|Error"]
    eventlog.count[Windows PowerShell,,,,,,skip]

net.if.list

Llistat d'interfícies de xarxa (inclou el tipus d'interfície, l'estat, l'adreça IPv4, la descripció).
Valor de retorn: Text.

Comentaris:

• Admet noms d'interfície de diversos octets;
• Les interfícies desactivades no apareixen a la llista;
• L'activació/desactivació d'alguns components pot canviar el seu ordre al nom de la interfície de Windows;
• Algunes versions de Windows (per exemple, Server 2008) poden requerir les darreres actualitzacions instal·lades per admetre caràcters no ASCII als noms d'interfície.

perf_counter[counter,<interval>]

Valor de qualsevol comptador de rendiment de Windows.
Valor de retorn: Enter, float, cadena o text (segons la petició).

Paràmetres:

• comptador - camí cap al comptador;
  
• interval - darrers N segons per emmagatzemar el valor mitjà. L'interval ha de ser entre 1 i 900 segons (inclosos) i el valor per defecte és 1.

Comentaris:

• interval s'empra per als comptadors que requereixen més d'una mostra (com la utilització de la CPU), de manera que la comprovació retorna un valor mitjà dels darrers "intervals" cada vegada;
• El Monitor de rendiment es pot emprar per obtindre la llista de comptadors disponibles.
• Veieu també: Comptadors de rendiment de Windows.

perf_counter_en[counter,<interval>]

Valor de qualsevol comptador de rendiment de Windows, en anglès.
Valor de retorn: Enter, float, cadena o text (segons la petició).

Paràmetres:

• comptador - camí cap al comptador, en anglès;
  
• interval - darrers N segons per emmagatzemar el valor mitjà. L'interval ha de ser entre 1 i 900 segons (inclosos) i el valor per defecte és 1.

Comentaris:

• interval s'empra per als comptadors que requereixen més d'una mostra (com la utilització de la CPU), de manera que la comprovació retorna un valor mitjà dels darrers "intervals" cada vegada;
• Aquest element només s'admet a Windows Server 2008/Vista i superiors;
• Podeu trobar la llista de cadenes en anglès revisant la clau de registre següent: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009.

perf_instance.discovery[object]

Llistat d'instàncies d'objecte dels comptadors de rendiment de Windows. S'empra per a descoberta de baix nivell.
Valor de retorn: objecte JSON.

Paràmetre:

• objecte - el nom de l'objecte (localitzat).

perf_instance_en.discovery[object]

Llistat d'instàncies d'objecte dels comptadors de rendiment de Windows, trobats emprant els noms d'objectes en anglès . S'empra per a descoberta de baix nivell.
Valor de retorn: objecte JSON.

Paràmetre:

• objecte - el nom de l'objecte (en anglès).

proc_info[procés,<atribut>,<tipus>]

Diversa informació sobre processos específics.
Valor de retorn: Flotant.

Paràmetres:

• procés - el nom del procés;
  
• atribut - l'atribut de procés sol·licitat;
  
• tipus - el tipus de representació (significatiu quan existeix més d'un procés amb el mateix nom)

Comentaris:

• S'admeten els següents atributs:
  vmsize (per defecte) - mida de la memòria virtual del procés en kbytes
  wkset - mida del conjunt de treball del procés (cantitat de memòria física utilitzada pel procés) en kbytes< br>pf - nombre d'errors de pàgina
  ktime - temps de processament del nucli en mil·lisegons
  utime - temps de processament de l'usuari en mil·lisegons
  io_read_b - nombre d'octets llegits per procés durant les operacions d'E/S
  io_read_op - nombre d'operacions de lectura realitzades pel procés
  io_write_b - nombre d'octets escrits pel procés durant les operacions d'E/S
  io_write_op - nombre d'operacions d'escriptura realitzades pel procés
  io_other_b - nombre d'octets transferits pel procés durant operacions diferents de les operacions de lectura i escriptura
  io_other_op - nombre d'operacions d'E/S realitzades pel procés, a part de les operacions de lectura i escriptura
  gdiobj - nombre d'objectes GDI emprats pel procés
  userobj - nombre d'objectes USER emprats pel procés;
  
• Els tipus vàlids són:
  mitjana (per defecte) - valor mitjà per a tots els processos anomenats
  procés>
  min - valor mínim entre tots els processos anomenats
  procés>
  max - màxim valor entre tots els processos anomenats <procés>
  sum - suma de valors per a tots els processos anomenats <procés>;
• En un sistema de 64 bits, cal l'agent Zabbix de 64 bits perquè aquest element funcioni correctament.
  

Exemples:

    proc_info[iexplore.exe,wkset,sum] #recuperar la quantitat de memòria física ocupada per tots els processos d'Internet Explorer
    proc_info[iexplore.exe,pf,avg] #recuperar el nombre mig d'errors de pàgina per als processos d'Internet Explorer

registry.data[key,<nom del valor>]

Retorna les dades del nom del valor especificat a la clau del registre de Windows.
Valor de retorn: Enter, cadena o text (segons el tipus de valor)

Paràmetres:

• clau - la clau del registre inclosa la clau arrel; es permeten les abreviatures arrel (per exemple, HKLM);
• nom del valor - el nom del valor del registre a la clau (cadena buida "" per defecte). El valor predeterminat es retorna si no es proporciona el nom del valor.

Comentaris:

• Abreujatures d'arrel admeses:
  HKCR - HKEY_CLASSES_ROOT
  HKCC - HKEY_CURRENT_CONFIG
  HKCU - HKEY_CURRENT_USER
  HKCULS - HKEY_CURRENT_USER_LOCAL_SETTINGS
  HKLM - HKEY_MPDACH -
  HKEY_HKEY HKPN - HKEY_PERFORMANCE_NLSTEXT
  HKPT - HKEY_PERFORMANCE_TEXT
  HKU - HKEY_USERS
  
• Les claus amb espais han d'ésser entre cometes.

Exemples:

    registry.data["HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting"] #retorna les dades del valor predeterminat d'aquesta clau
    registry.data["HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting","EnableZip"] #retorna les dades del valor anomenat "Enable Zip" en aquesta clau

registry.get[clau,<mode>,<nom regexp>]

La llista de valors o claus del Registre de Windows que es troben a la clau determinada.
Valor de retorn: objecte JSON.

Paràmetres:

• clau - la clau del registre inclosa la clau arrel; Les abreviatures arrel (p. ex. HKLM) es permeten (vegeu els comentaris de registry.data[] per veure la llista completa d'abreviatures);
  
• mode - valors possibles:
  valors (per defecte) o claus;
  
• name regexp - només descobreix valors amb noms que coincideixen amb l'expressió regular (per defecte: descobreix tots els valors). Només es permet amb valors com a mode.

Les claus amb espais han d'ésser entre cometes.

Exemples:

    registry.get[HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall,values,"^DisplayName|DisplayVersion$"] #retorna les dades dels valors anomenats "DisplayName" o "DisplayValue" en aquesta clau. El JSON inclourà detalls de la clau, la darrera subclau, el nom del valor, el tipus de valor i les dades del valor.
    registry.get[HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall,values] #retorna les dades de tots els valors d'aquesta clau. El JSON inclourà detalls de la clau, l'última subclau, el nom del valor, el tipus de valor i les dades del valor.
    registry.get[HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall,keys] #retorna totes les subclaus d'aquesta clau. El JSON inclourà detalls de la clau i la darrera subclau.

service.discovery

Llistat de serveis de Windows. S'empra amb descobertes de baix nivell.
Valor de retorn: objecte JSON.

service.info[servei,<param>]

Informació sobre un servei.
Valor de retorn: Enter - amb param com a estat, inici; String - amb param com a displayname, path, user; Text - amb param com a descripció
Específicament per a estat: 0 - en execució, 1 - en pausa, 2 - començar pendent, 3 - pausa pendent, 4 - continuar pendent, 5 - deixar pendent, 6 - aturat, 7 - desconegut, 255 - no hi ha aquest servei
Específicament per a engegada: 0 - automàtic, 1 - automàtic retardat, 2 - manual, 3 - desactivat, 4 - desconegut, 5 - engegada automàtica, 6 - engegada automàtica retardada, 7 - arrencada manual

Paràmetres:

• servei - un nom de servei real o el seu nom de visualització tal com es veu al complement MMC Services;
• param - estat (per defecte), nom de visualització, camí, usuari, inici o descripció.

Comentaris:

• Elements com service.info[servei,estat] i service.info[servei] retornaran la mateixa informació;
• Només amb param com a estat aquest element retorna un valor per a serveis inexistents (255).

Exemples:

    service.info[SNMPTRAP] - estat del servei SNMPTRAP;
    service.info[SNMP Trap] - estat del mateix servei, però amb el nom de visualització especificat;
    service.info[EventLog,startup]: el tipus d'inici del servei EventLog
``

[comment]: # ({/20b3ba6b-f01b9c46})

[comment]: # ({831913ad-2d4eec00})

##### services[<type>,<state>,<exclude>] {#services}

<br>
Llistat de serveis.<br>
Valor de retorn: *0* - si és buit; *Text*: llistat de serveis separats per una nova línia.

Paràmetres:

- **tipus** - *tot* (per defecte), *automàtic*, *manual* o *desactivat*;
- **estat** - *tot* (per defecte), *aturat*, *iniciat*, *inici_pendent*, *aturada_pendent*, *executant*, *continuar_pendent*, *pausa_pendent* o *pausat*;
- **excloure** - serveis que cal excloure del resultat. Els serveis exclosos s'han de llistar entre cometes dobles, separats per comes, sense espais.

Exemples:

```default
     serveis[,iniciat] #retorna la llista de serveis iniciats;
     serveis[automàtic, aturat] #retorna la llista de serveis aturats que haurien de ser en execució;
     serveis[automàtic, aturat, "servei1, servei2, servei3"] #retorna la llista de serveis aturats que s'han d'executar, excloent els serveis anomenats "servei1", "servei2" i "servei3"

vm.vmemory.size[<type>]

Mida de la memòria virtual en octets o percentatge del total.
Valor de retorn: Enter - per a octets; flotant - per percentatge.

Paràmetre:

• tipus - valors possibles: disponible (memòria virtual disponible), pavailable (memòria virtual disponible, en percentatge), pused (memòria virtual emprada, en percentatge), total (memòria virtual total, per defecte), o usat (memòria virtual emprada)

Comentaris:

• El seguiment de les estadístiques de memòria virtual es basa en:
  
  • Memòria virtual total a Windows (total física + mida del fitxer de pàgina);
    
  • La quantitat màxima de memòria que l'agent Zabbix pot comprometre;
    
  • El límit de memòria actual compromès per al sistema o l'agent Zabbix, el que sigui més petit.

Exemple:

     vm.vmemory.size[pavailable] #retorna la memòria virtual disponible, en percentatge

wmi.get[<namespace>,<query>]

Executa una consulta WMI i retorna el primer objecte seleccionat.
Valor de retorn: Enter, flotant, cadena o text (segons la petició).

Paràmetres:

• espai de noms - espai de noms WMI;
  
• consulta - consulta WMI que retorna un únic objecte.

Les consultes WMI es realitzen amb WQL.

Exemple:

     wmi.get[root\cimv2,seleccioneu l'estat de Win32_DiskDrive on Nom com '%PHYSICALDRIVE0%'] #retorna l'estat del primer disc físic

wmi.getall[<namespace>,<query>]

Executa una consulta WMI i retorna tota la resposta. Es pot emprar per a descoberta de baix nivell.
Valor de retorn: objecte JSON

Paràmetres:

• espai de noms - espai de noms WMI;
  
• consulta - consulta WMI.

Comentaris:

• Les consultes WMI es fan amb WQL.
• JSONPath preprocessament es pot emprar per apuntar a valors més específics al JSON retornat.

Exemple:

     wmi.getall[root\cimv2,seleccioneu * de Win32_DiskDrive on Nom com '%PHYSICALDRIVE%'] #retorna informació d'estat dels discs físics

Monitoratge dels serveis Windows

Aquest tutorial ofereix instruccions passa per passa per configurar el monitoratge dels serveis de Windows. Se suposa que el servidor i l'agent Zabbix són configurats i operatius.

Passa 1

Recupereu el nom del servei.

Podeu obtindre aquest nom accedint al complement MMC i visualitzant les propietats del servei. A la pestanya General, hauríeu de veure un camp anomenat "Nom del servei". El valor que segueix és el nom que emprareu quan configureu un element per monitorar. Per exemple, si voleu monitorar el servei "estació de treball", el vostre servei podria ésser: lanmanworkstation.

Passa 2

Configurar un element per monitorar el servei.

L'element service.info\[service,<param>\] recupera informació sobre un servei concret. En funció de la informació que us calgui, especifiqueu l'opció param, que admet els valors següents: displayname, state, path, user, startup o description. El valor predeterminat és estat si no s'especifica param (service.info\[servei\]).

El tipus de valor a retornar depèn del paràmetre param escollit: enter per a estat i inici; cadena de caràcters per a displayname, path i user; text per a descripció.

Exemple:

• Clau: service.info[lanmanworkstation]
• Tipus d'informació: Numèrica (sense signe)

L'element service.info[lanmanworkstation] recuperarà informació sobre l'estat del servei com a valor numèric. Per assignar un valor numèric a una representació de text a la interfície ("0" com a "En execució", "1" com a "En pausa", etc.), podeu configurar [mapa de valors](/manual/config/items/mapping# configuració) a l'equip on és configurat l'element. Per fer-ho, o bé enllaçar la plantilla Serveis de Windows de l'agent Zabbix o Serveis de Windows de l'agent Zabbix actiu a l'equip, o configureu a l'equip un mapa de valors nou basat en el mapa de valors estat del servei de Windows configurat a les plantilles esmentades.

Tingueu en compte que les dues plantilles esmentades tenen configurada una regla de descoberta que descobrirà els serveis automàticament. Si no voleu això, podeu desactivar la regla de descoberta a nivell d'equip un cop la plantilla s'hagi enllaçat a l'equip.

Descoberta dels serveis de Windows Windows

La descoberta de baix nivell ofereix una manera de crear automàticament elements, triggers i gràfics per a diferents entitats en un ordinador. Zabbix pot començar automàticament a monitorar els serveis de Windows a la vostra màquina, sense necessitat de sabre el nom exacte d'un servei ni de crear elements per a cada servei manualment. Es pot emprar un filtre per generar elements reals, triggers i gràfics només per als serveis que us interessen.