> Объект элемента данных

Следующие объекты напрямую связаны с 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 родительского элемента данных из шаблона.

Подсказка: Используйте свойство hostid, чтобы указать принадлежность элемента данных к шаблону.
trapper_hosts строка Разрешенные хосты. Используется только траппер элементами данных.
trends целое число Количество дней хранения данных динамики изменений элемента данных.

По умолчанию: 365.
units строка Единицы измерения значений.
username строка Имя пользователя для аутентификации. Используется элементами данных простой проверкой, SSH, Telnet, монитором баз данных и JMX.

Требуется для элементов данных SSH и Telnet.
valuemapid строка ID связанного преобразования значений.