2 Agent

Vista general

L'agent Zabbix es desplega a un destí per supervisar els recursos i aplicacions locals (discs durs, memòria, estadístiques de processador, etc.).

L'agent recull detalls operacionals localment i transmet les dades al servidor Zabbix per tractar-les posteriorment. En cas d'errades (per exemple, disc dur ple o servei fallit), el servidor Zabbix pot alertar els administradors de la màquina on s'ha aturat el servei.

Els agents Zabbix són altament eficients perquè empren sistemes nadius per recollir dades estadístiques.

És possible executar múltiples instàncies de l'agent en un equip.

Verificacions passives i actives

Els agents Zabbix poden fer verificacions passives i actives.

  • Verificacions passives - l'agent respon a una petició de dades del servidor Zabbix (o el proxy). Per exemple, demana informació de la càrrega de processador, i l'agent Zabbix retorna el resultat.

  • Verificacions actives - L'agent ha de recuperar i enviar informació sense esperar una petició del servidor Zabbix (o proxy). Primer, recupera una llista d'elements monitorats del servidor (càrrega de CPU, memòria disponible, etc...). Després, recull la informació necessària i envia periòdicament nous valors al servidor.

El tipus de verificació es configura escollint un tipus d'element. L'agent Zabbix tracta els elements de tipus Agent Zabbix o Agent Zabbix (actiu).

Plataformes compatibles

Per obtindre les plataformes compatibles, consulteu la pàgina Requisits.

Agent a sistemes Unix

L’agent de Zabbix a sistemes Unix s'executa a un equip monitorat.

Instal·lació

L'agent Zabbix es pot instal·lar en sistemes basats en Linux mitjançant un dels mètodes següents:

  • Paquets Zabbix: seleccioneu el component Agent (després de seleccionar la vostra versió Zabbix, distribució del sistema operatiu i versió del sistema operatiu) i seguiu les instruccions proporcionades.
  • Fonts Zabbix - descarregueu els fitxers font i compileu l'agent Zabbix configurant les fonts amb l'opció --enable-agent.

En general, els agents Zabbix de 32 bits funcionaran en 64 bits sistemes, però pot fallar en alguns casos.

Els binaris d'agent Zabbix precompilats estan disponibles per a descàrrega per a macOS, IBM AIX, FreeBSD, OpenBSD i Solaris. Els binaris heretats, compatibles amb la versió actual del servidor/proxy de Zabbix, estan disponibles per a NetBSD i HP-UX.

Si s'instal·la com a paquet

L’agent Zabbix s'executa com un procés dimoni. L'agent es pot engegar executant:

    systemctl start zabbix-agent

Això funcionarà a la majoria de sisetmes GNU/Linux. Sota altres sistemes haureu d'executar aquesta comanda:

    /etc/init.d/zabbix-agent start
```bash

Per aturar/reiniciar/veure l'estat de l'agent Zabbix, empreu aquestes comandes:

```bash
    systemctl stop zabbix-agent
    systemctl restart zabbix-agent
    systemctl status zabbix-agent
Engegar manualment

Podeu engegar l'agent Zabbix buscant el binari zabbix_agentd i executant-lo directament; per exemple:

    zabbix_agentd
```bash

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

[comment]: # ({f276f35a-f276f35a})
#### Agent als sistemes Windows

L'agent Zabbix sota Windows s'executa com a servei de Windows.

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

[comment]: # ({95a2a2c5-af2aa3a5})
##### Instal·lació

L'agent Zabbix es pot instal·lar a Windows mitjançant un dels mètodes següents:

- [Binaris de l'agent Zabbix precompilats](https://www.zabbix.com/download_agents?version=7.0+LTS) - descarregueu el paquet d'instal·lació MSI de l'agent Zabbix i seguiu les instruccions de la pàgina [Instal·lació de l'agent de Windows des de MSI](/manual/installation/install_from_packages/win_msi).
- [Fonts Zabbix](https://www.zabbix.com/download_sources#70+LTS) - descarregueu els fitxers font i seguiu les instruccions de la pàgina [Creació de l'agent Zabbix a Windows](/manual/installation/install/win_agent).

Consulteu la pàgina [Agent Zabbix a Microsoft Windows](/manual/appendix/install/windows_agent#installing-agent-as-windows-service) per obtindre informació addicional sobre la instal·lació de l'agent Zabbix (des d'un arxiu ZIP) com a servei de Windows.

[comment]: # ({/95a2a2c5-af2aa3a5})

[comment]: # ({c2144b71-fa025a89})
#### Opcions

Els paràmetres de línia de comanda següents poden emprar-se amb l'agent Zabbix :

|Paràmetre|Descripció|
|--|--------|
|**Agent UNIX i Windows**|<|
|`-c --config <config-file>`|Ruta del fitxer de configuració.<br>Haureu d'emprar aquesta opció per especificar l'arxiu de configuració que no sigui el que hi ha per defecte.<br>Sota UNIX, l'arxiu per defecte és /usr/local/etc/zabbix\_agentd.conf o com s'especifiqui a les variables [compile-time](/manual/installation/install#installing-zabbix-daemons) *--sysconfdir* o *--prefix*<br>Sota Windows, l'arxiu per defecte és c:\\zabbix\_agentd.conf|
|`-f --foreground`|Executa l'agent de Zabbix en primer pla (per defecte: cert).|
|`-p --print`|Imprimir els elements coneguts i tancar.<br>*Note*: Per retornar igualment els resultats dels [paràmetres d'usuari](/manual/config/items/userparameters), haureu d'especificar l'arxiu de configuració (si no és a la ruta per defecte).|
|`-t --test <item key>`|Proveu l'element especificat i tanqueu.<br>Tingueu en compte que per retornar [paràmetre d'usuari](/manual/config/items/userparameters) també, heu d'especificar el fitxer de configuració (si no és ala ubicació per defecte).|
|`-T --test-config`|Validar l'arxiu de configuració i sortir|
|`-h --help`|Mostra la informació d'ajuda.|
|`-V --version`|Mostra el nombre de versió.|
|**Només agent UNIX**|<|
|`-R --runtime-control <option>`|Gestiona funcions administratives. Veieu [runtime control](/manual/concepts/agent#runtime-control).|

|**Només agent Windows**|<|
|`-m --multiple-agents`|Empra diverses instàncies de l'agent (amb les funcions `-i`,`-d`,`-s`,`-x`).<br>Per distingir els noms dels serveis dels de les instàncies, cada nom de servei inclourà el valor Hostname de l'arxiu de configuració especificat.|
|`-S --startup-type <value>`|Configurar el tipus d'inici del servei d'agent Zabbix Windows. Valors permesos:<br>`automatic` - *(per defecte) * iniciar el servei automàticament a l'inici de Windows;<br>`endarrerir` - retardar l'inici del servei després que els serveis d'inici automàticament han completat l'arrencada (disponible en Windows Server 2008/Vista i versions posteriors);<br>`manual` - iniciar el servei manualment (per un usuari o aplicació);<br>`desactivat` el servei, de manera que no pot ser iniciat per un usuari o aplicació. |
|`-i --install`|Instal·la l'agent Windows Zabbix com a servei.|
|`-d --uninstal`|Desinstal·la el servei de l'agent Windows Zabbix.|
|`-s --start`|Engega el servei de l'agent Windows Zabbix.|
|`-x --stop`|Atura el servei de l'agent Windows Zabbix.|

Exemples específics d'ús dels paràmetres de línia de comandes:

-   Imprimir tots els elements d'agent integrats amb valors.
-   Prova d'un paràmetre d'usuari amb la clau `mysql.ping` definida a l'arxiu de configuració especificat.
-   Instal·lació d'un servei Agent Zabbix per Windows emprant el camí per defecte de l'arxiu de configuració `C:\\Program Files\\Zabbix Agent\\zabbix_agentd.conf`.
-   Instal·lació d'un servei Agent Zabbix \[Hostname\] per Windows emprant l'arxiu de configuració `zabbix_agentd.conf` ubicat a la mateixa carpeta que l'executable de l'agent i fer el nom de servei únic estenguent-lo per al valor Hostname de l'arxiu config.
-   Modificar el tipus d'inici d'un servei "Zabbix Agent" instal·lat a windows, emprant l'arxiu de configuració `zabbix_agentd.conf` ubicat al mateix lloc que l'agent executable.

```bash
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
zabbix_agentd.exe -c zabbix_agentd.conf -S delayed
Control d'execució

Amb les opcions de control d'execució, podreu canviar el nivell de registre dels processos de l’agent.

Opció Descripció Objectiu
log\_level\_increase\[=<target>\] Augmentar el nivell de registre.
Si no s'especifica l'objectiu, tots els processos es veuran afectats.		 Es pot especificar l'objectiu de la manera següent:
process type - tots els processos de tipus especificats (ex : listener)
Veieu tots els tipus de processos de l'agent.
process type,N - tipus de processos i nombre (ex : listener,3)
pid - identificador de processos (1 a 65535). Per valors més grans, especifiqueu l'objectiu com a 'process-type,N'.
log\_level\_decrease\[=<target>\] Disminuir el nivell de registre.
Si l'objectiu no s'especifica, es veuen afectats tots els processos.
userparameter\_reload Recarregar els valors de les opcions UserParameter i Include.

Exemples :

  • Augmentar el nivell de registre de tots els processos
  • Augmentar el nivell de registre del tercer procés que escolta
  • Augmentar el nivell de registre dels processos amb el PID 1234
  • Disminuir el nivell de registre de tots els processos de validació actius
    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"

el control d'execució no s'admet pas sota OpenBSD, NetBSD i Windows.

Tipus de processos Agent

Els tipus de processos d'agent són els següents:

  • ​active checks​ - processos que fan verificacions actives;
  • ​collector​ - processos per recollir dades;
  • ​listener​ - processos que escolten les verificacions passives.

L'arxiu de registre de l'agent es pot emprar per observar aquests tipus de processos.

Des de Zabbix 7.0.22, el fitxer d'exportació es crea amb permisos de lectura i escriptura només per al propietari del fitxer. A més, el fitxer és llegible pel grup propietari. Tots els altres permisos es deneguen.

Processos d'usuari

L'agent Zabbix sota UNIX s'ha pensat per executar com a usuari i no pas com a root. Funcionarà amb l'usuari no-root hagi iniciat. Podeu doncs executar l'agent com un usuari no-root sense problemes.

Si proveu d'executar-lo com a 'root', aquest passarà a un usuari 'zabbix' codi en brut, que ha d'ésser present al vostre sistema. Podeu executar només l'agent com a 'root' si modifiqueu el paràmetre AllowRoot a l'arxiu de configuració de l'agent associat.

Fitxer de configuració

La ruta per defecte al fitxer de configuració és:

  • A UNIX, el valor per defecte és /usr/local/etc/zabbix_agentd.conf o com s'estableix per compile-time variables --sysconfdir o --prefix.
  • A Windows, per defecte és C:\\Fitxers de programa\\Zabbix Agent\\zabbix_agentd.conf.

Si una sola instància de l'agent s'està executant en un host, pot utilitzar el fitxer de configuració predeterminat o un fitxer de configuració especificat a la línia d'ordres. En el cas de múltiples instàncies, cada instància de l'agent ha de tenir el seu propi fitxer de configuració (una de les instàncies pot utilitzar el fitxer de configuració per defecte).

Per obtenir més informació sobre la configuració de l'agent Zabbix, vegeu les opcions de fitxer de configuració de Unix Zabbix agent o Agent de Windows Zabbix.

Entorn Local

Veieu que a l'agent li cal un entorn local UTF-8 per tal que determinats elements d'agent textuals retornar el contingut esperat. La majoria dels sistemes moderns de tipus Unix tenen un paràmetre regional UTF-8 per defecte; de tota manera, alguns sistemes poden haver d'ésser definits específicament.

Codi de sortida

L'agent Zabbix retorna 0 en cas de sortida correcta i 1 en cas de fallida.