[comment]: # ({50c00f1f-9884b1d2})
# 11 Agente Zabbix en Microsoft Windows
[comment]: # ({/50c00f1f-9884b1d2})
[comment]: # ({9134e90f-bc82b50c})
#### Configuración del agente
Ambas generaciones de agentes Zabbix se ejecutan como un servicio de Windows. Para el agente Zabbix 2, reemplace *agentd* por *agent2* en las instrucciones a continuación.
Puede ejecutar una sola instancia del agente Zabbix o múltiples instancias del agente en un equipo Microsoft Windows. Una sola instancia puede usar:
- el archivo de configuración por defecto, ubicado en el mismo
directorio que el binario del agente;
- un archivo de configuración especificado en la línea de comandos.
En caso de múltiples instancias, cada instancia del agente debe tener su propio
archivo de configuración (una de las instancias puede usar el archivo de configuración por defecto).
Un archivo de configuración de ejemplo está disponible en el archivo fuente de Zabbix como:
- `conf/zabbix_agentd.conf` para el agente Zabbix;
- `conf/zabbix_agent2.conf` para el agente Zabbix 2.
Si desea instalar el agente Zabbix/agente 2 para Windows como un servicio desde un
[archivo comprimido](https://www.zabbix.com/download_agents) sin especificar el
archivo de configuración explícitamente, entonces, antes de instalar el agente:
- `conf/zabbix_agentd.conf` debe copiarse manualmente al directorio donde
se instalará zabbix_agentd.exe;
- `conf/zabbix_agent2.conf` y el directorio `conf/zabbix_agent2.d` deben
copiarse manualmente al directorio donde se instalará zabbix_agent2.exe.
Consulte las opciones del [archivo de configuración](/manual/appendix/config/zabbix_agentd_win) para obtener más detalles sobre la configuración del agente Zabbix para Windows.
[comment]: # ({/9134e90f-bc82b50c})
[comment]: # ({5f456a33-011f29f0})
##### Parámetro Hostname
Para realizar [comprobaciones
activas](/manual/appendix/items/activepassive#active-checks) en un host,
Zabbix agent necesita tener definido el nombre del host. Además, el
valor del nombre del host configurado en el lado del agent debe coincidir exactamente con el "[Host
name](/manual/config/hosts/host)" configurado para el host en el
frontend.
El valor del nombre del host en el lado del agent puede definirse mediante el
parámetro **Hostname** o **HostnameItem** en el [archivo de
configuración](/manual/appendix/config/zabbix_agentd_win) del agent, o se usarán los valores predeterminados si alguno de estos parámetros no está especificado.
El valor predeterminado del parámetro **HostnameItem** es el valor devuelto
por la clave de agent "system.hostname". En Windows, devuelve el resultado
de la función gethostname(), que consulta a los proveedores de espacio de nombres para determinar el nombre del host local. Si ningún proveedor de espacio de nombres responde, se devuelve el nombre NetBIOS.
El valor predeterminado de **Hostname** es el valor devuelto por el
parámetro HostnameItem. Por lo tanto, en la práctica, si ambos parámetros no están
especificados, el nombre real del host será el nombre NetBIOS del host; Zabbix
agent usará el nombre NetBIOS del host para recuperar la lista de comprobaciones
activas desde Zabbix server y enviarle los resultados.
La clave "system.hostname" admite dos parámetros opcionales: *type* y
*transform*.
*Type* determina el tipo de nombre que debe devolver el item:
- *netbios* (predeterminado): devuelve el nombre NetBIOS del host, que está limitado a 15 caracteres y solo en MAYÚSCULAS;
- *host*: distingue entre mayúsculas y minúsculas, devuelve el nombre completo y real del host de Windows (sin dominio);
- *shorthost*: devuelve la parte del nombre del host anterior al primer punto.
Devolverá la cadena completa si el nombre no contiene ningún punto.
- *fqdn*: devuelve el nombre de dominio completo (Fully Qualified Domain Name) sin el punto final.
*Transform* permite especificar una regla de transformación adicional para el nombre del host:
- *none* (predeterminado): usa el uso original de mayúsculas y minúsculas;
- *lower*: convierte el texto a minúsculas.
Por lo tanto, para simplificar la configuración del archivo zabbix\_agentd.conf y unificarla,
se pueden utilizar tres enfoques diferentes:
1. Deje sin definir los parámetros **Hostname** o **HostnameItem** y
Zabbix agent usará el nombre NetBIOS del host como nombre del host.
2. Deje sin definir el parámetro **Hostname** y defina **HostnameItem**
de esta manera:
**HostnameItem=system.hostname\[host\]**: para que Zabbix agent use
el nombre completo y real del host de Windows (distinguiendo entre mayúsculas y minúsculas) como nombre del host.
**HostnameItem=system.hostname\[shorthost,lower\]**: para que Zabbix
agent use solo la parte del nombre del host anterior al primer punto,
convertida a minúsculas.
**HostnameItem=system.hostname\[fqdn\]**: para que Zabbix agent use el nombre de dominio completo como nombre del host.
El nombre del host también se usa como parte del nombre del servicio de Windows, que se utiliza para
instalar, iniciar, detener y desinstalar el servicio de Windows. Por
ejemplo, si el archivo de configuración de Zabbix agent especifica
`Hostname=Windows_db_server`, entonces el agent se instalará como un
servicio de Windows llamado "`Zabbix Agent [Windows_db_server]`". Por lo tanto, para tener
un nombre de servicio de Windows diferente para cada instancia de Zabbix agent, cada
instancia debe usar un nombre de host diferente.
[comment]: # ({/5f456a33-011f29f0})
[comment]: # ({0c3a3ff4-1c178c2a})
#### Instalación del agente como servicio de Windows
Antes de instalar el agente, copie manualmente `conf/zabbix_agentd.conf` al
directorio donde se instalará zabbix_agentd.exe.
Para instalar una única instancia del agente Zabbix con el archivo de configuración por defecto:
zabbix_agentd.exe --install
::: noteimportant
En un sistema de 64 bits, se requiere una versión de agente Zabbix de 64 bits
para que todas las comprobaciones relacionadas con la ejecución de procesos de 64 bits funcionen
correctamente.
:::
Si desea utilizar un archivo de configuración diferente al predeterminado,
debe utilizar el siguiente comando para la instalación del servicio:
zabbix_agentd.exe --config --install
Debe especificarse la ruta completa al archivo de configuración.
Se pueden instalar múltiples instancias del agente Zabbix como servicios de la siguiente manera:
zabbix_agentd.exe --config --install --multiple-agents
zabbix_agentd.exe --config --install --multiple-agents
...
zabbix_agentd.exe --config --install --multiple-agents
El servicio instalado ahora debería ser visible en el Panel de control.
[comment]: # ({/0c3a3ff4-1c178c2a})
[comment]: # ({635edc59-635edc59})
#### Iniciando el agente
Para iniciar el servicio del agente, puede usar el Panel de control o hacerlo desde la línea de comandos.
Para iniciar una única instancia del agente Zabbix con el archivo de configuración por defecto:
zabbix_agentd.exe --start
Para iniciar una única instancia del agente Zabbix con otro archivo de configuración:
zabbix_agentd.exe --config --start
Para iniciar una de varias instancias del agente Zabbix:
zabbix_agentd.exe --config --start --multiple-agents
[comment]: # ({/635edc59-635edc59})
[comment]: # ({f3f0d3db-f3f0d3db})
#### Detener el agente
Para detener el servicio del agente, puede usar el Panel de control o hacerlo desde la línea de comandos.
Para detener una única instancia del agente Zabbix iniciada con el archivo de configuración por defecto:
zabbix_agentd.exe --stop
Para detener una única instancia del agente Zabbix iniciada con otro archivo de configuración:
zabbix_agentd.exe --config --stop
Para detener una de varias instancias del agente Zabbix:
zabbix_agentd.exe --config --stop --multiple-agents
[comment]: # ({/f3f0d3db-f3f0d3db})
[comment]: # ({db2e6708-db2e6708})
#### Desinstalación del servicio del agente de Windows
Para desinstalar una única instancia del agente de Zabbix utilizando el archivo de configuración por defecto:
zabbix_agentd.exe --uninstall
Para desinstalar una única instancia del agente de Zabbix utilizando un archivo de configuración no predeterminado:
zabbix_agentd.exe --config --uninstall
Para desinstalar múltiples instancias del agente de Zabbix de los servicios 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})
#### Limitaciones
El agente Zabbix para Windows no es compatible con configuraciones de Windows no estándar donde las CPU se distribuyen de manera no uniforme entre los nodos NUMA. Si las CPU lógicas se distribuyen de manera no uniforme, es posible que las métricas de rendimiento de la CPU no estén disponibles para algunas CPU. Por ejemplo, si hay 72 CPU lógicas con 2 nodos NUMA, ambos nodos deben tener 36 CPU cada uno.
[comment]: # ({/dec5f8ea-b7b226d1})