Sidebar

Zabbix Summit 2022
View presentations

history.get

Описание

integer/array history.get(object parameters)

Метод позволяет получить данные истории по заданным параметрам.

См. также: известные проблемы

Этот метод может возвращать исторические данные удаленного объекта, если эти данные еще не были удалены служебной программой.

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

Параметры

(object) Параметры, определяющие желаемый результат.

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

Параметр Тип Описание
history integer Типы объектов истории для возврата.

Возможные значения:
0 – числовое значение с плавающей запятой;
1 – символ;
2 – журнал;
3 – числовое значение без знака;
4 - текст.

По умолчанию: 3.
hostids string/array Возвращает только историю с заданных хостов.
itemids string/array Возвращает только историю из указанных элементов.
time_from timestamp Возвращает только те значения, которые были получены после или в указанное время.
time_till timestamp Возвращает только те значения, которые были получены до или в указанное время.
sortfield string/array Сортировать результат по заданным свойствам.

Возможные значения: itemid и clock.
countOutput boolean Эти параметры являются общими для всех методов get и подробно описаны на странице справочный комментарий.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

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

(integer/array) Возвращает:

  • массив объектов;
  • количество извлеченных объектов, если использовался параметр countOutput.

Примеры

Получение данных истории элемента

Возвращает 10 последних значений, полученных от числового (плавающего) элемента.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "history.get",
           "params": {
           "output": "extend",
           "history": 0,
           "itemids": "23296",
           "sortfield": "clock",
           "sortorder": "DESC",
           "limit": 10
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
          "jsonrpc": "2.0",
          "result": [
          {
          "itemid": "23296",
          "clock": "1351090996",
          "value": "0.085",
          "ns": "563157632"
          },
          {
          "itemid": "23296",
          "clock": "1351090936",
          "value": "0.16",
          "ns": "549216402"
          },
          {
          "itemid": "23296",
          "clock": "1351090876",
          "value": "0.18",
          "ns": "537418114"
          },
          {
          "itemid": "23296",
          "clock": "1351090816",
          "value": "0.21",
          "ns": "522659528"
          },
          {
          "itemid": "23296",
          "clock": "1351090756",
          "value": "0.215",
          "ns": "507809457"
          },
          {
          "itemid": "23296",
          "clock": "1351090696",
          "value": "0.255",
          "ns": "495509699"
          },
          {
          "itemid": "23296",
          "clock": "1351090636",
          "value": "0.36",
          "ns": "477708209"
          },
          {
          "itemid": "23296",
          "clock": "1351090576",
          "value": "0.375",
          "ns": "463251343"
          },
          {
          "itemid": "23296",
          "clock": "1351090516",
          "value": "0.315",
          "ns": "447947017"
          },
          {
          "itemid": "23296",
          "clock": "1351090456",
          "value": "0.275",
          "ns": "435307141"
          }
          ],
          "id": 1
       }

Источник

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