history.push

Описание

object history.push(объект/массив itemHistoryData)

Этот метод позволяет отправлять данные истории элементов на сервер Zabbix.

Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(object/array) Данные истории элемента данных для отправки.

Метод поддерживает следующие параметры.

Параметр Тип Описание
itemid ID ID связанного элемента данных.

Поведение параметра:
- обязателен, если host и key не заданы
host string Техническое имя узла сети.

Поведение параметра:
- обязателен, если itemid не задан
key string Ключ элемента данных.

Поведение параметра:
- обязателен, если itemid не задан
value mixed Значение элемента данных.

Поведение параметра:
- обязателен
clock timestamp Время получения значения.
ns integer Наносекунды в момент получения значения.

Возвращаемые значения

(object) Возвращает результат операции отправки данных.

Примеры

Отправка данных истории элемента данных

Отправьте данные истории элемента данных на сервер Zabbix для элементов данных "10600", "10601" и "999999".

Запрос:

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

Ответ:

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

См. также

Исходный код

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