history.push

Описание

object history.push(object/array itemHistoryData)

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

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

IP-адрес веб-интерфейса Zabbix должен быть указан в поле Allowed hosts Zabbix trapper, чтобы метод работал.

Параметры

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

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

Parameter Type Description
itemid ID ID связанного элемента данных.

Поведение параметра:
- required if host and key are not set
host string Техническое имя узла сети.

Поведение параметра:
- required if itemid is not set
key string Ключ элемента данных.

Поведение параметра:
- required if itemid is not set
value mixed Значение элемента данных.

Поведение параметра:
- required
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.