history.push

Opis

object history.push(object/array itemHistoryData)

Ta metoda umożliwia wysyłanie danych historii pozycji do serwer Zabbix.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji znajduje się w sekcji Role użytkowników.

Parametry

(object/array) Dane historii pozycji do wysłania.

Metoda obsługuje następujące parametry.

Parametr Type Opis
itemid ID ID powiązanej pozycji.

Zachowanie parametru:
- wymagany, jeśli host i key nie są ustawione
host string Nazwa techniczna hosta.

Zachowanie parametru:
- wymagany, jeśli itemid nie jest ustawione
key string Klucz pozycji.

Zachowanie parametru:
- wymagany, jeśli itemid nie jest ustawione
value mixed Wartość pozycji.

Zachowanie parametru:
- wymagany
clock timestamp Czas otrzymania wartości.
ns integer Nanosekundy w momencie otrzymania wartości.

Zwracane wartości

(object) Zwraca wynik operacji wysyłania danych.

Przykłady

Wysyłanie danych historii pozycji

Wyślij dane historii pozycji do serwera Zabbix dla pozycji „10600”, „10601” i „999999”.

Żądanie:

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

Odpowiedź:

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

Zobacz także

Źródło

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