history.push

Apraksts

object history.push(object/array itemHistoryData)

Šī metode ļauj nosūtīt vienuma vēstures datus uz Zabbix serveri.

Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāja lomas.

Lai šī metode darbotos, Zabbix lietotāja saskarnes IP adresei jābūt norādītai Zabbix trapper vienuma laukā Allowed hosts.

Parametri

(object/array) Nosūtāmie vienuma vēstures dati.

Metode atbalsta šādus parametrus.

Parametrs Tips Apraksts
itemid ID Saistītā vienuma ID.

Parametra darbība:
- obligāts, ja host un key nav iestatīti
host string Hosta tehniskais nosaukums.

Parametra darbība:
- obligāts, ja itemid nav iestatīts
key string Vienuma atslēga.

Parametra darbība:
- obligāts, ja itemid nav iestatīts
value mixed Vienuma vērtība.

Parametra darbība:
- obligāts
clock timestamp Laiks, kad vērtība tika saņemta.
ns integer Nanosekundes, kad vērtība tika saņemta.

Atgrieztās vērtības

(object) Atgriež datu nosūtīšanas operācijas rezultātu.

Piemēri

Nosūtīt vienuma vēstures datus

Nosūtīt vienuma vēstures datus uz Zabbix serveris vienumiem "10600", "10601" un "999999".

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "history.push",
    "params": [
        {
            "itemid": 10600,
            "value": 0.5,
            "clock": 1690891294,
            "ns": 45440940
        },
        {
            "itemid": 10600,
            "value": 0.6,
            "clock": 1690891295,
            "ns": 312431
        },
        {
            "itemid": 10601,
            "value": "[Tue Aug 01 15:01:35 2023] [error] [client 1.2.3.4] File does not exist: /var/www/html/robots.txt"
        },
        {
            "itemid": 999999,
            "value": 123
        }
    ],
    "id": 1
}

Atbilde:

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

Skatīt arī

Avots

CHistory::push() failā ui/include/classes/api/services/CHistory.php.