Documentation
Table of Contents
> Объект элемента данных
Следующие объекты напрямую связаны с item API.
Элементы данных
Веб элементы нельзя напрямую создавать, обновлять или удалять через Zabbix API.
Объект элемента данных имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| itemid | строка | (только чтение) ID элемента данных. |
| delay (требуется) |
целое число | Интервал обновления элемента данных в секундах. |
| hostid (требуется) |
строка | ID узла сети, которому принадлежит элемент данных. |
| interfaceid (требуется) |
строка | ID интерфейса узла сети элемента данных. Используется только элементами данных на узлах сети. Опционален для элементов данных Zabbix агента (активного), Zabbix внутреннего, Zabbix траппер, Zabbix агрегативного, монитора баз данных и вычисляемого. |
| key_ (требуется) |
строка | Ключ элемента данных. |
| name (требуется) |
строка | Имя элемента данных. |
| type (требуется) |
целое число | Тип элемента данных. Возможные значения: 0 - Zabbix агент; 1 - SNMPv1 агент; 2 - Zabbix траппер; 3 - простая проверка; 4 - SNMPv2 агент; 5 - Zabbix внутренний; 6 - SNMPv3 агент; 7 - Zabbix агент (активный); 8 - Zabbix агрегативный; 9 - веб элемент данных; 10 - внешняя проверка; 11 - монитор баз данных; 12 - IPMI агент; 13 - SSH агент; 14 - TELNET агент; 15 - вычисляемый; 16 - JMX агент; 17 - SNMP трап. |
| value_type (требуется) |
целое число | Тип информации элемента данных. Возможные значения: 0 - числовое с плавающей точкой; 1 - символ; 2 - журнал (лог); 3 - числовое целое положительное; 4 - текст. |
| authtype | целое число | Метод аутентификации SSH. Используется только элементами данных SSH агента. Возможные значения: 0 - (по умолчанию) пароль; 1 - публичный ключ. |
| data_type | целое число | Тип данных элемента данных. Возможные значения: 0 - (по умолчанию) десятичный; 1 - восьмиричный; 2 - шестнадцатеричный; 3 - логическый. |
| delay_flex | строка | Переменные интервалы в виде сериализованной строки. Каждый сериализованный переменный интервал содержит интервал обновления и период времени, разделенные прямой косой чертой. Несколько интервалов разделяются при помощи двоеточия. |
| delta | целое число | Значение, которое будет сохраняться. Возможные значения: 0 - (по умолчанию) Как есть; 1 - Дельта, скорость в секунду; 2 - Дельта, простое изменение. |
| description | строка | Описание элемента данных. |
| error | строка | (только чтение) Текст ошибки, если имеются проблемы с обновлением элемента данных. |
| flags | целое число | (только чтение) Происхождение элемента данных. Возможные значения: 0 - обычный элемент данных; 4 - обнаруженный элемент данных. |
| formula | целое число/дробное число | Пользовательский множитель. По умолчанию: 1. |
| history | целое число | Количество дней хранения данных истории элемента данных. По умолчанию: 90. |
| inventory_link | целое число | ID поля инвентарных данных узла сети, которое заполняется элементом данных. Обратитесь к странице данных инвентаризации узла сети для получения списка поддерживаемых полей инвентарных данных узла сети и их ID. По умолчанию: 0. |
| ipmi_sensor | строка | Сенсор IPMI. Используется только элементами данных IPMI. |
| lastclock | timestamp | (только чтение) Время, когда элемент данных был в последний раз обновлен. Это свойство вернёт значение только за период указанный в ZBX_HISTORY_PERIOD. |
| lastns | целое число | (только чтение) Наносекунды, когда элемент данных был в последний раз обновлен. Это свойство вернёт значение только за период указанный в ZBX_HISTORY_PERIOD. |
| lastvalue | строка | (только чтение) Последнее значение элемента данных. Это свойство вернёт значение только за период указанный в ZBX_HISTORY_PERIOD. |
| logtimefmt | строка | Формат времени в записях журнала. Используется только в элементах данных журналов. |
| mtime | timestamp | Время, когда наблюдаемый файл журнала был в последний раз обновлен. Используется только элементами данных журналов. |
| multiplier | целое число | Следует ли использовать пользовательский множитель. |
| params | строка | Дополнительные параметры, которые зависят от типа элемента данных: - выполняемый скрипт в случае элементов данных SSH и Telnet; - SQL запрос в случае элементов данных монитора базы данных; - формула в случае вычисляемых элементов данных. |
| password | строка | Пароль для аутентификации. Используется элементами данных простой проверки, SSH, Telnet, монитором баз данных и JMX. |
| port | строка | Наблюдаемый элементом данных порт. Используется только элементами данных SNMP. |
| prevvalue | строка | (только чтение) Предыдущее значение элемента данных. то свойство вернёт значение только за период указанный в ZBX_HISTORY_PERIOD. |
| privatekey | строка | Имя файла приватного ключа. |
| publickey | строка | Имя файла публичного ключа. |
| snmp_community | строка | SNMP community. Используется только элементами данных SNMPv1 и SNMPv2. |
| snmp_oid | строка | SNMP OID. |
| snmpv3_authpassphrase | строка | Фраза-пароль аутентификации SNMPv3. Используется только элементами данных SNMPv3. |
| snmpv3_authprotocol | целое число | Протокол аутентификации SNMPv3. Используется только элементами данных SNMPv3. Возможные значения: 0 - (по умолчанию) MD5; 1 - SHA. |
| snmpv3_contextname | строка | Имя контекста SNMPv3. Используется только элементами данных SNMPv3. |
| snmpv3_privpassphrase | строка | Фраза-пароль безопасности SNMPv3. Используется только элементами данных SNMPv3. |
| snmpv3_privprotocol | целое число | Протокол безопасности SNMPv3. Используется только элементами данных SNMPv3. Возможные значения: 0 - (по умолчанию) DES; 1 - AES. |
| snmpv3_securitylevel | целое число | Уровень безопасности SNMPv3. Используется только элементами данных SNMPv3. Возможные значения: 0 - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv. |
| snmpv3_securityname | строка | Имя безопасности SNMPv3. Используется только элементами данных SNMPv3. |
| state | целое число | (только чтение) Статус элемента данных. Возможные значения: 0 - (по умолчанию) нормальный; 1 - неподдерживается. |
| status | целое число | Состояние элемента данных. Возможные значения: 0 - (по умолчанию) активированный элемент данных; 1 - деактивированный элемент данных. |
| templateid | строка | (только чтение) ID родительского элемента данных из шаблона. |
| trapper_hosts | строка | Разрешенные хосты. Используется только траппер элементами данных. |
| trends | целое число | Количество дней хранения данных динамики изменений элемента данных. По умолчанию: 365. |
| units | строка | Единицы измерения значений. |
| username | строка | Имя пользователя для аутентификации. Используется элементами данных простой проверкой, SSH, Telnet, монитором баз данных и JMX. Требуется для элементов данных SSH и Telnet. |
| valuemapid | строка | ID связанного преобразования значений. |