12 Trapper vienumi

Pārskats

Trapper vienumi pieņem ienākošos datus, nevis tos pieprasa. Tas ir noderīgi jebkuriem datiem, kurus vēlaties nosūtīt uz Zabbix.

Konfigurācija

Lai konfigurētu trapper vienumu:

1. Dodieties uz Datu ievākšana → Hosti.
2. Noklikšķiniet uz Vienumi attiecīgā hosta rindā.
3. Noklikšķiniet uz Izveidot vienumu.
4. Ievadiet vienuma parametrus konfigurācijas formā.

Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti.

Lauki, kuriem trapper vienumiem nepieciešama specifiska informācija, ir:

Datu nosūtīšana

Datu nosūtīšana uz Zabbix serveri vai starpniekserveri ir iespējama, izmantojot utilītu Zabbix sender vai Zabbix sender protokolu. Datu nosūtīšana uz Zabbix serveri ir iespējama arī, izmantojot API metodi history.push.

Zabbix sender

Lai nosūtītu datus uz Zabbix serveris vai starpniekserveris, izmantojot Zabbix sender utilītu, varat izpildīt šādu komandu, lai nosūtītu "test value":

zabbix_sender -z <server IP address> -p 10051 -s "New host" -k trap -o "test value"

Lai nosūtītu "test value", tiek izmantotas šādas komandas opcijas:

• -z lai norādītu Zabbix serveris IP adresi
• -p lai norādītu Zabbix serveris porta numuru (pēc noklusējuma 10051)
• -s lai norādītu hosts (pārliecinieties, ka izmantojat tehnisko, nevis redzamo hosta nosaukumu)
• -k lai norādītu trigeris vienums atslēgu, kas konfigurēta trapper vienumā
• -o lai norādītu nosūtāmo vērtību

Plašāku informāciju par saziņu starp Zabbix sender un Zabbix serveris vai starpniekserveris skatiet Zabbix sender protocol.

history.push

Lai nosūtītu datus uz Zabbix serveris, izmantojot history.push API metodi, varat veikt šādu HTTP POST pieprasījumu, kas satur dažas testa vērtības:

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}'

Ja pieprasījums ir pareizs, API atgrieztā atbilde varētu izskatīties šādi:

{
    "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
}

Kļūdas atbildes datos norāda, ka datu nosūtīšana konkrētiem vienumiem nav izturējusi Zabbix serveris validāciju. Tas var notikt šādu iemeslu dēļ:

• lietotājam, kurš nosūta datus, nav lasīšanas atļaujas uz vienuma hostu;
• hosts ir atspējots vai atrodas uzturēšanas režīmā bez datu vākšanas;
• vienums neeksistē vai vēl nav iekļauts servera konfigurācijas kešatmiņā;
• vienums ir atspējots vai tā tips nav Zabbix trapper vai HTTP aģents (ar iespējotu trapping);
• lietotāja IP vai DNS nav iestatīts vienuma Allowed hosts sarakstā;
• citam vienumam ir vērtība ar dublējošu laikspiedolu nanosekunžu līmenī.

Kļūdu neesamība norāda, ka nosūtītās vērtības ir pieņemtas apstrādei, kas ietver priekšapstrādi (ja tāda ir), trigeris apstrādi un saglabāšanu datubāzē. Ņemiet vērā, ka arī pieņemtās vērtības apstrāde var neizdoties (piemēram, priekšapstrādes laikā), kā rezultātā vērtība tiek atmesta.

Plašāku informāciju par darbu ar Zabbix API skatiet sadaļā API.

Datu attēlošana

Kad dati ir nosūtīti, varat doties uz Monitoring → Jaunākie dati, lai skatītu rezultātu: