12 Elements trapper

Vista general

Els elements Trapper accepten les dades entrants enlloc de demanar-les. És útil per totes les dades que volem entafonar a Zabbix.

Configuració de l'element

Per configurar un element trapper:

  • Aneu a: Recull de dadesEquips.
  • 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:

Tipus Trieu Zabbix trapper aquí.
Clau Poseu la clau que s'emprarà per reconèixer l'element quan s'enviïn les dades.
Tipus d'informació Trieu el tipus d'informació que correspon al format de dades que s'enviaran.
Equips autoritzats Llistat d'adreces IP delimitades per comes, opcionalment en notació CIDR, o noms d'equips.
Si s'especifica, les connexions entrants només s'acceptaran per els equips llistats aquí.
Si el suport IPv6 és actiu, '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' es tracten de la mateixa manera i '::/0' autoritzarà qualsevol adreça IPv4 o IPv6.
'0.0.0.0/0' es pot emprar per autoritzar qualsevol adreça IPv4.
Veieu que "les adreces IPv6 compatibles amb IPv4" (prefix 0000::/96) s'admeten però es desaconsellen per l'RFC4291.

Exemple: 127.0.0.1, 192.168.1.0/24, 192.168.3.1-255, 192.168.1-10.1-255, ::1,2001:db8::/32, mysqlserver1, zabbix.example.com, {HOST.HOST}

S'admeten espais, macros d'usuari, i macros d'equips {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN}.

És possible que hàgiu d'esperar fins a 60 segons després de desar l'element fins que el servidor prengui els canvis d'una actualització de la memòria cau de configuració, abans de poder enviar valors.

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

El procés Zabbix Trapper no expandeix les macros emprades a la clau de l'element per provar de verificar la existència de la clau de l'element corresponent per l'equip destí.

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 MonitoratgeDarreres dades per veure el resultat:

Veieu que si s'envia un únic valor numèric, el gràfic de dades afegirà una línia horitzontal a l'esquerra i a la dreta del punt temporal del valor.