12 Elements trapper

Vista general

Els elements Trapper accepten dades entrants en lloc de fer-ne una consulta. Això és útil per a qualsevol dada que vulgueu enviar a Zabbix.

Configuració de l'element

Per configurar un element trapper:

• Aneu a: Recull de dades → Equips.
• Feu clic a Elements al rang de l'equip.
• Cliqueu Crear un element.
• Poseu els paràmetres de l'element al formulari.

Tots els camps obligatoris són marcats amb un asterisc vermell.

Els camps que necessiten informació específica per els elements Trapper són:

Enviament de dades

L'enviament de dades al servidor o al proxy Zabbix és possible mitjançant la utilitat Zabbix sender o el protocol de Zabbix sender. També és possible enviar dades al servidor Zabbix mitjançant el mètode API history.push.

Zabbix sender

En el cas més simple, podem emprar l'eina zabbix_sender per enviar un "valor de prova":

zabbix_sender -z <server IP address> -p 10051 -s "Nou equip" -k trap -o "valor de prova"

Per enviar el "valor de prova", emprem les claus:

• -z - per especificar l'adreça IP del servidor Zabbix
• -p - per especificar el nombre de port del servidor Zabbix (10051 per defecte)
• -s - per especificar l'equip (assegureu-vos d'emprar el nom d'equip tècnic aquí, en lloc del nom visible)
• -k - per especificar la clau de l'article que acabem de definir
• -o - per especificar el valor real a enviar

Per tindre més informació sobre la comunicació entre el Zabbix sender i el servidor o proxy Zabbix, veieu el protocol Zabbix sender.

history.push

Per enviar dades al servidor Zabbix mitjançant el mètode API history.push, podeu fer la següent petició HTTP POST que contingui alguns valors de prova:

curl --request POST \
         --url 'https://example.com/zabbix/api_jsonrpc.php' \
         --header 'Authorization: Bearer 0424bd59b807674191e7d77572075f33' \
         --header 'Content-Type: application/json-rpc' \
         --data '{"jsonrpc":"2.0","method":"history.push","params":[{"itemid":10600,"value":"test value 1"},{"itemid":10601,"value":"test value 2"},{"itemid":99999,"value":"test value 3"}],"id":1}'

Si la petició és correcta, la resposta que retorna l'API podria ser la següent:

{
           "jsonrpc": "2.0",
           "result": {
               "response": "success",
               "data": [
                   {
                       "itemid": "10600"
                   },
                   {
                       "itemid": "10601",
                       "error": "Item is disabled."
                   },
                   {
                       "error": "No permissions to referred object or it does not exist."
                   }
               ]
           },
           "id": 1
       }

Els errors a les dades de resposta indiquen que l'enviament de dades d'elements específics ha fallat en la validació del servidor Zabbix. Això pot passar pels motius següents:

• l'usuari que envia les dades no té permís de lectura a l'equip de l'element;
• l'equip és desactivat o en manteniment sense recollida de dades;
• l'element no existeix o encara no és pas inclòs a la memòria cau de configuració del servidor;
• l'element és desactivat o el seu tipus és diferent de Zabbix trapper o agent HTTP (amb la captura activada);
• l'IP o el DNS de l'usuari no s'estableixen al llistat d'Equips permesos de l'element;
• un altre element té un valor amb una marca de temps duplicada a nivell de nanosegons.

L'absència d'errors indica que els valors enviats s'han acceptat per al processament, que inclou el preprocessament (si n'hi ha), el processament del trigger i l'emmagatzematge a la base de dades. Tingueu en compte que el processament d'un valor acceptat també pot fallar (per exemple, durant el preprocessament), provocant que el valor es descarti.

Per obtindre més informació sobre com treballar amb l'API Zabbix, veieu API.

Vista de la informació

Un cop s'hagi enviat la informació, podeu navegar a Monitoratge → Darreres dades per veure el resultat: