history.push

Описание

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

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

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

Параметры

(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.