[comment]: # translation:outdated [comment]: # ({9884b1d2-9884b1d2}) # 10 Agent Zabbix per a Microsoft Windows [comment]: # ({/9884b1d2-9884b1d2}) [comment]: # ({9134e90f-bc82b50c}) #### Configuració de l'agent Les dues generacions d'agents Zabbix s'executen com a servei de Windows. Per l'agent Zabbix 2, canvieu *agentd* per *agent2* a les instruccions de sota. Podeu executar una sola instància de l'agent Zabbix o més d'una en un equip Microsoft Windows. Una sola instància pot emprar: - l'arxiu de configuració per defecte, ubicat al mateix directori on s'hi troba el binari de l'agent; - un arxiu de configuració especificat a la línia de comandes. En cas d'instàncies múltiples, cadascuna de les instàncies de l'agent ha de tindre el seu propi fitxer de configuració (una de les instàncies sí que pot emprar l'arxiu de configuració per defecte). Un exemple d'arxiu de configuració es pot trobar a l'arxiu font de Zabbix com a: - `conf/zabbix_agentd.conf` per l'agent de Zabbix; - `conf/zabbix_agent2.conf` per l'agent2 de Zabbix. Si voleu instal·lar l'agent o agent 2 de Zabbix per a Windows com a servei des d'un [arxiu](https://www.zabbix.com/download_agents) sense especificar explícitament l'arxiu de configuració, llavors abans d'instal·lar l'agent: - s'ha de copiar manualment `conf/zabbix_agentd.conf` al directori on s'instal·li zabbix_agentd.exe; - s'han de copiar manualment els directoris `conf/zabbix_agent2.conf` and the `conf/zabbix_agent2.d` al directori on s'instal·li zabbix_agent2.exe. Veieu les opcions de l'[arxiu de configuració](/manual/appendix/config/zabbix_agentd_win) per tindre més detalls de la configuració de l'agent Windows de Zabbix. [comment]: # ({/9134e90f-bc82b50c}) [comment]: # ({5116a3f6-011f29f0}) ##### Paràmetre Hostname Per fer [verificacions actives](/manual/appendix/items/activepassive#active_checks) d'un equip, l'agent Zabbix ha de definir el nom de l'equip. A més, el valor del nom d'equip definit ha de ser el mateix que el "[Nom d'equip](/manual/config/hosts/host)" configurar per l'equip a la interfície. El valor del nom d'equip de la banda de l'agent es pot definir amb el paràmetre **Hostname** o **HostnameItem**, a l'[arxiu de configuració](/manual/appendix/config/zabbix_agentd_win) de l'agent - o els valors per defecte s'empren si cap paràmetre és especificat. El valor per defecte del paràmetre **HostnameItem** és el valor reenviat per la clau de l'agent "system.hostname". Per Windows, reenvia el resultat de la funció gethostname(), qui demana els proveïdors d'espais de noms per determinar el nom d'equip local. si cap proveïdor de noms respon, enviarà el nom NetBIOS. El valor per defecte de **Hostname** és el valor reenviat per el paràmetre **HostnameItem**. Per tant, si aquests dos paràmetres no s'especifiquen, el nom d'equip real serà el nom NetBIOS de l'equip; i l'agent Zabbix emprarà el nom d'equip NetBIOS per recuperar la llista de verificacions actives del servidor Zabbix i enviar-li els resultats. La clau "system.hostname" suporta dos paràmtres opcionals - *type* i *transform*. El paràmetre *Type* determina el tipus de nom que l'element ha d'enviar. Valors admesos: - *netbios* (per defecte) - retorna el nom d'equip NetBIOS, limitat a 15 símbols i només en MAJÚSCULES; - *host* - sensible a majúscules i minúscules, retorna el nom real d'equip Windows sencer (sense domini); - *shorthost* (suportat des de Zabbix 5.4.7) - retorna una part del nom d'equip abans del primer punt. Retornarà una cadena sencera si el nom no té cap punt. El paràmetre *transform* es suporta des de Zabbix 5.4.7 i permet especificar una regla de transformació addicional per al nom d'equip. Valors admesos: - *none* (per defecte) - empra el text original, em majúscules o minúscules; - *lower* - converteix el text a minúscules. Per tant, per simplificar la configuració de l'arxiu zabbix\_agentd.conf i unificar, es poden emprar dues maneres diferents. 1. deixar els paràmetres **Hostname** o **HostnameItem** sense definir i l'agent Zabbix emprarà el nom d'equip NetBIOS com a nom d'equip; 2. deixar el paràmetre **Hostname** sense definir i definir **HostnameItem** així:\ **HostnameItem=system.hostname\[host\]** - perquè l'agent Zabbix empri el nom d'equip Windows sencer i real (sensible a majúscules i minúscules) com a nom d'equip\ **HostnameItem=system.hostname\[shorthost,lower\]** - perquè l'agent Zabbix només empri una part del nom d'equip abans del primer punt, convertit a minúscules. El nom d'equip s'empra igualment al quadre del nom de servei Windows que s'empra per instal·lar, aturar, engegar i desinstal·lar el servei Windows. Per exemple, si l'arxiu de configuració de l'agent Zabbix especifica `Hostname=Windows_db_server`, llavors l'agent s'instal·larà com a servei Windows "`Zabbix Agent [Windows_db_server]`". Per tant, per tindre un nom de servei Windows diferent per cada instància d'agent Zabbix, cada instància ha d'emprar un nom d'equip diferent. [comment]: # ({/5116a3f6-011f29f0}) [comment]: # ({0c3a3ff4-1c178c2a}) #### Instal·lant l'agent com un servei de Windows Abans d'instal·lar l'agent, copieu manualment `conf/zabbix_agentd.conf` al directori on instal·leu zabbix_agentd.exe. Per instal·lar una instància sola de l'agent de Zabbix amb l'arxiu de configuració per defecte `c:\zabbix_agentd.conf`: zabbix_agentd.exe --install ::: noteimportant A un sistema de 64-bits, empreu la versió de 64-bits de l'agent de Zabbix, per tal que totes les verificacions relatives al sistema de 64-bits funcionin correctament. ::: Si voleu emprar un fitxer de configuració diferent de `c:\zabbix_agentd.conf`, hauríeu d'emprar l'ordre següent per instal·lar del servei: zabbix_agentd.exe --config --install S'ha d'especificar un camí complet al fitxer de configuració. Es poden instal·lar diverses instàncies de l'agent Zabbix com a serveis, així: zabbix_agentd.exe --config --install --multiple-agents zabbix_agentd.exe --config --install --multiple-agents ... zabbix_agentd.exe --config --install --multiple-agents El servei instal·lat ara hauria d'esser visible al tauler de control. [comment]: # ({/0c3a3ff4-1c178c2a}) [comment]: # ({635edc59-635edc59}) #### Iniciant l'agent Per iniciar el servei de l'agent, podeu emprar el Tauler de control o fer-ho des de la línia de comandes. Per iniciar una única instància de l'agent Zabbix amb el valor predeterminat fitxer de configuració: zabbix_agentd.exe --start Per iniciar una única instància de l'agent Zabbix amb un altre arxiu de configuració: zabbix_agentd.exe --config --start Per iniciar una de les múltiples instàncies de l'agent Zabbix: zabbix_agentd.exe --config --start --multiple-agents [comment]: # ({/635edc59-635edc59}) [comment]: # ({f3f0d3db-f3f0d3db}) #### Aturant l'agent Per aturar el servei de l'agent, podeu emprar el Tauler de control o fer-ho des de la línia de comandes. Per aturar una única instància de l'agent Zabbix que corre amb el valor predeterminat fitxer de configuració: zabbix_agentd.exe --stop Per aturar una única instància de l'agent Zabbix que rutlla amb un altre arxiu de configuració: zabbix_agentd.exe --config --stop Per aturar una de les múltiples instàncies de l'agent Zabbix: zabbix_agentd.exe --config --stop --multiple-agents [comment]: # ({/f3f0d3db-f3f0d3db}) [comment]: # ({db2e6708-db2e6708}) #### Desinstal·lant el servei d'agent de Windows Per desinstal·lar una única instància de l'agent Zabbix mitjançant el fitxer de configuració predeterminat: zabbix_agentd.exe --uninstall Per desinstal·lar una única instància de l'agent Zabbix mitjançant un fitxer de configuració no predeterminat: zabbix_agentd.exe --config --uninstall Per desinstal·lar diverses instàncies de l'agent Zabbix dels serveis de Windows: zabbix_agentd.exe --config --uninstall --multiple-agents zabbix_agentd.exe --config --uninstall --multiple-agents ... zabbix_agentd.exe --config --uninstall --multiple-agents [comment]: # ({/db2e6708-db2e6708}) [comment]: # ({dec5f8ea-b7b226d1}) #### Limitacions L'agent Zabbix per a Windows no admet configuracions de Windows no estàndard on les CPU es distribueixen de manera no uniforme entre els nodes NUMA. Si les CPU lògiques es distribueixen de manera no uniforme, és possible que les mètriques de rendiment de la CPU no siguin disponibles per a algunes CPU. Per exemple, si hi ha 72 CPU lògiques amb 2 nodes NUMA, tots dos nodes han de tindre 36 CPU cadascun. [comment]: # ({/dec5f8ea-b7b226d1})