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. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāju lomas.

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.