[comment]: # translation:outdated

[comment]: # ({0f9ecee9-0f9ecee9})
# 2 Agente

[comment]: # ({/0f9ecee9-0f9ecee9})

[comment]: # ({f5143fcc-f5143fcc})
#### Visión general

El agente Zabbix se implementa en un objetivo de monitoreo para monitorear activamente
recursos locales y aplicaciones (estadísticas de discos duros, memoria, procesador, etc.).

El agente reúne información operativa localmente y reporta datos al
Servidor Zabbix para su posterior procesamiento. En caso de fallas (como un
disco duro que se está llenando o un proceso de servicio colapsado), el servidor Zabbix puede
alertar activamente a los administradores de la máquina en particular que
informó el fracaso.

Los agentes de Zabbix son extremadamente eficientes debido al uso de llamadas nativas
para la recopilación de información estadística.

[comment]: # ({/f5143fcc-f5143fcc})

[comment]: # ({41e6af7c-41e6af7c})
##### Controles pasivos y activos

Los agentes de Zabbix pueden realizar controles pasivos y activos.

En un [comprobación pasiva
](/manual/appendix/items/activepassive#passive_checks) el agente
responde a una solicitud de datos. El servidor Zabbix (o proxy) solicita datos, por
ejemplo, la carga de la CPU y el agente Zabbix devuelve el resultado.

[Comprobaciones activas](/manual/apendix/items/activepassive#active_checks)
requieren un procesamiento más complejo. El agente primero debe recuperar una lista de
elementos del servidor Zabbix para procesamiento independiente. Luego
envía periódicamente nuevos valores al servidor.

La realización de comprobaciones pasivas o activas se configura seleccionando
el seguimiento respectivo [tipo de elemento
](/manual/config/items/itemtypes/zabbix_agent). El agente de Zabbix
procesa elementos de tipo 'Agente Zabbix' o 'Agente Zabbix (activo)'.

[comment]: # ({/41e6af7c-41e6af7c})

[comment]: # ({bc5aeb6e-b05a4949})
#### Plataformas soportadas

El agente Zabbix es [compatible](https://www.zabbix.com/download_agents?version=6.0+LTS&release=6.0.12&os=Windows&os_version=Any&hardware=amd64&encryption=OpenSSL&packaging=MSI&show_legacy=0) con las siguientes plataformas:

-   Windows (todas las versiones de escritorio y servidor desde XP)
-   Linux (también disponible en [paquetes de distribución](https://www.zabbix.com/download?zabbix=6.0&os_distribution=alma_linux&os_version=9&components=agent&db=&ws=))
-   Mac OS
-   IBM AIX
-   FreeBSD
-   OpenBSD
-   Solaris

También es posible descargar archivos binarios del agente Zabbix heredado para [NetBSD](https://www.zabbix.com/download_agents?version=3.2&release=3.2.0&os=NetBSD&os_version=5.0&hardware=i386&encryption=No+encryption&packaging=Archive&show_legacy=1 ) y [HP-UX](https://www.zabbix.com/download_agents?version=2.4&release=2.4.4&os=HPUX&os_version=11.31&hardware=amd64&encryption=No+encryption&packaging=Archive&show_legacy=1), y son compatibles con la versión actual del servidor/proxy de Zabbix.

[comment]: # ({/bc5aeb6e-b05a4949})

[comment]: # ({5bbb67d9-5bbb67d9})
#### Agente en sistemas tipo UNIX

El agente Zabbix en sistemas similares a UNIX se ejecuta en el host que se está monitoreando.

[comment]: # ({/5bbb67d9-5bbb67d9})

[comment]: # ({32937b35-32937b35})
##### Instalación

Ver la sección [instalación de paquete
](/manual/instalación/instalar_desde_paquetes) para las
instrucciones sobre cómo instalar el agente Zabbix como paquete.

Alternativamente, vea las instrucciones para [instalación manual
](/manual/installation/install#installing_zabbix_daemons) si
no desea utilizar paquetes.

::: notaimportante
En general, los agentes Zabbix de 32 bits funcionarán en sistemas 64 bits
, pero puede fallar en algunos casos.
:::

[comment]: # ({/32937b35-32937b35})

[comment]: # ({7fcbcf5a-99f37c64})
##### Si se instala como paquete

El agente Zabbix se ejecuta como un proceso daemon. El agente puede ser iniciado
ejecutando:

    systemctl start zabbix-agent

Esto funcionará en la mayoría de los sistemas GNU/Linux. En otros sistemas, puede que
necesite ejecutar:

    /etc/init.d/zabbix-agent start

Del mismo modo, para detener/reiniciar/ver el estado del agente Zabbix, use
los siguientes comandos:

    systemctl stop zabbix-agent
    systemctl restart zabbix-agent
    systemctl status zabbix-agent

[comment]: # ({/7fcbcf5a-99f37c64})

[comment]: # ({10786837-5e83177d})
##### Iniciar manualmente

Si lo anterior no funciona, debe iniciarlo manualmente. encuentre el camino
al binario zabbix\_agentd y ejecute:

    zabbix_agentd

[comment]: # ({/10786837-5e83177d})

[comment]: # ({f276f35a-f276f35a})
#### Agente en sistemas Windows

El agente de Zabbix en Windows se ejecuta como un servicio de Windows.

[comment]: # ({/f276f35a-f276f35a})

[comment]: # ({23b0be18-23b0be18})
##### Preparación

El agente Zabbix se distribuye como un archivo zip. Después de descargar el
archivo que necesita para descomprimirlo. Elija cualquier carpeta para almacenar el agente Zabbix
y el archivo de configuración, es decir.

    C:\zabbix

Copie los archivos bin\\zabbix\_agentd.exe y conf\\zabbix\_agentd.conf en
c:\\zabbix.

Edite el archivo c:\\zabbix\\zabbix\_agentd.conf según sus necesidades, asegurándose de
para especificar un parámetro "Hostname" correcto.

[comment]: # ({/23b0be18-23b0be18})

[comment]: # ({c7c6daac-c7c6daac})
##### Instalación

Una vez hecho esto, use el siguiente comando para instalar el agente Zabbix como
Servicio de Windows:

    C:\> c:\zabbix\zabbix_agentd.exe -c c:\zabbix\zabbix_agentd.conf -i

Ahora debería poder configurar el servicio "Agente Zabbix" normalmente como
cualquier otro servicio de Windows.

Ver más
detalles](/manual/appendix/install/windows_agent#installing_agent_as_windows_service)
sobre la instalación y ejecución del agente Zabbix en Windows.

[comment]: # ({/c7c6daac-c7c6daac})

[comment]: # ({8729e024-fa025a89})
#### Otras opciones del agente

Es posible ejecutar varias instancias del agente en un equipo. 
Una única instancia puede usar el archivo de configuración predeterminado o un
archivo de configuración especificado en la línea de comando. En caso de múltiples
instancias cada instancia de agente debe tener su propio archivo de configuración (una
de las instancias pueden utilizar el archivo de configuración predeterminado).

Los siguientes parámetros de línea de comando se pueden usar con el agente Zabbix:

|Parámetro|Descripción|
|--|--------|
|**Agente UNIX y Windows**|<|
|-c --config <archivo-config>|Ruta al archivo de configuración.<br>Puede usar esta opción para especificar un archivo de configuración que no sea el predeterminado.<br>En UNIX, el valor predeterminado es /usr/local /etc/zabbix\_agentd.conf o según lo establecido por las variables [tiempo de compilación](/manual/installation/install#installing_zabbix_daemons) *--sysconfdir* o *--prefix*<br>En Windows, el valor predeterminado es c:\ \zabbix\_agentd.conf|
|-p --print|Imprime elementos conocidos y sale.<br>*Nota*: Para devolver también los resultados de [parámetro de usuario](/manual/config/items/userparameters), debe especificar el archivo de configuración (si es no en la ubicación predeterminada).|
|-t --test <clave de métrica>|Pruebe la métrica especificada y salga.<br>*Nota*: Para devolver también los resultados de [parámetro de usuario](/manual/config/items/userparameters), debe especificar el archivo de configuración (si no está en la ubicación predeterminada).|
|-h --help|Mostrar información de ayuda|
|-V --version|Mostrar número de versión|
|**Sólo agente UNIX**|<|
|-R --runtime-control <opción>|Realizar funciones administrativas. Consulte [control de tiempo de ejecución](/manual/concepts/agent#runtime_control).|
|**Sólo agente de Windows**|<|
|-m --multiple-agents|Utilice múltiples instancias de agente (con funciones -i,-d,-s,-x).<br>Para distinguir los nombres de servicio de las instancias, cada nombre de servicio incluirá el valor de Nombre de host del especificado archivo de configuración.|
|**Solo agente de Windows (funciones)**|<|
|-i --install|Instalar el agente Zabbix para Windows como servicio|
|-d --uninstall|Desinstalar el servicio de agente de Windows Zabbix|
|-s --start|Iniciar el servicio del agente de Windows Zabbix|
|-x --stop|Detener el servicio del agente de Windows Zabbix|

**Ejemplos** específicos del uso de parámetros de línea de comando:

- imprimir todos los elementos del agente integrados con valores
- probar un parámetro de usuario con la clave "mysql.ping" definida en el
    archivo de configuración especificado
- instalar un servicio "Zabbix Agent" para Windows usando el valor predeterminado
    ruta al archivo de configuración c:\\zabbix\_agentd.conf
- instalar un servicio "Zabbix Agent \[Hostname\]" para Windows usando
    el archivo de configuración zabbix\_agentd.conf ubicado en el mismo
    carpeta como agente ejecutable y hacer que el nombre del servicio sea único
    extendiéndolo por el valor del nombre de host del archivo de configuración

```{=html}
<!-- -->
```
    zabbix_agentd --print
    zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
    zabbix_agentd.exe -i
    zabbix_agentd.exe -i -m -c zabbix_agentd.conf

[comment]: # ({/8729e024-fa025a89})

[comment]: # ({93600c51-6ad4cc3c})
##### Control en tiempo de ejecución

Con las opciones de control en tiempo de ejecución, puede cambiar el nivel de registro del agente.

|Opción|Descripción|Objetivo|
|--|------|------|
|log\_level\_increase\[=<destino>\]|Aumentar el nivel de registro.<br>Si no se especifica el objetivo, todos los procesos se ven afectados.|El objetivo se puede especificar como:<br>**tipo de proceso** - todos los procesos del tipo especificado (por ejemplo, oyente)<br>Ver todos los [tipos de procesos de agente](#agent_process_types).<br>**tipo de proceso,N** - tipo y número de proceso (por ejemplo, oyente,3)<br >**pid** - identificador de proceso (1 a 65535). Para valores mayores, especifique el destino como 'tipo de proceso,N'.|
|log\_level\_decrease\[=<target>\]|Disminuye el nivel de registro.<br>Si no se especifica el objetivo, todos los procesos se ven afectados.|^|
|userparameter\_reload|Recargar los valores de las opciones *UserParameter* e *Include* del archivo de configuración actual.| |

Ejemplos:

- aumentar el nivel de registro de todos los procesos
- aumentar el nivel de registro del proceso del tercer oyente
- aumento del nivel de registro del proceso con PID 1234
- disminución del nivel de registro de todos los procesos de verificación activos.

```{=html}
<!-- -->
```
    zabbix_agentd -R log_level_increase
    zabbix_agentd -R log_level_increase=listener,3
    zabbix_agentd -R log_level_increase=1234
    zabbix_agentd -R log_level_decrease="active checks"

::: noteclassic
El control en tiempo de ejecución no es compatible con OpenBSD, NetBSD y
Windows.
:::

[comment]: # ({/93600c51-6ad4cc3c})

[comment]: # ({929667fd-929667fd})
#### Tipos de procesos de agentes

- `controles activos` - proceso para realizar controles activos
- `collector` - proceso para la recopilación de datos
- `listener` - proceso para escuchar cheques pasivos

El archivo de registro del agente se puede utilizar para observar estos tipos de procesos.

[comment]: # ({/929667fd-929667fd})

[comment]: # ({18ab16f1-18ab16f1})
#### Procesos de usuario

El agente Zabbix en UNIX está diseñado para ejecutarse como usuario no root. se ejecutará
como cualquier usuario no root con el que se inicie. Para que pueda ejecutar el agente como cualquier
usuario no root sin ningún problema.

Si intenta ejecutarlo como 'root', cambiará a un codificado
usuario 'zabbix', que debe estar presente en su sistema. solo puedes correr
agente como 'root' si modifica el parámetro 'AllowRoot' en el archivo de configuración del agente
.

[comment]: # ({/18ab16f1-18ab16f1})

[comment]: # ({fc6b2c61-fc6b2c61})
#### Archivo de configuración

Para obtener detalles sobre la configuración del agente Zabbix, consulte las opciones del archivo de configuración
[zabbix\_agentd](/manual/appendix/config/zabbix_agentd) o
[Agente de Windows](/manual/appendix/config/zabbix_agentd_win).

[comment]: # ({/fc6b2c61-fc6b2c61})

[comment]: # ({7c3bd34c-7c3bd34c})
#### Configuración regional

Tenga en cuenta que el agente requiere una configuración regional UTF-8 para que algún agente textual
los elementos pueden devolver el contenido esperado. La mayoría de los sistemas similares a Unix modernos
tener una configuración regional UTF-8 por defecto, sin embargo, hay algunos sistemas donde
puede ser necesario establecer específicamente.

[comment]: # ({/7c3bd34c-7c3bd34c})

[comment]: # ({5581c546-5581c546})
#### Código de salida

Antes de la versión 2.2, el agente Zabbix devolvía 0 en caso de salida exitosa
y 255 en caso de falla. A partir de la versión 2.2 y superior Zabbix
agent devuelve 0 en caso de salida exitosa y 1 en caso de falla.

[comment]: # ({/5581c546-5581c546})
