1. Создание элемента данных

Обзор

Для создания элемента данных в веб-интерфейсе Zabbix выполните следующее:

• Перейдите в: Сбор данных → Узлы сети (Data collection → Hosts)
• Нажмите на Элементы данных (Items) в строке с узлом сети
• Нажмите на Создать элемент данных (Create item) в правом верхнем углу экрана
• В диалоге введите параметры элемента данных

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

Настройка

Вкладка Элемент данных (Item) содержит следующие атрибуты элементов данных.

Все обязательные поля ввода отмечены красной звёздочкой.

Параметр	Описание
Имя (Name)	Имя элемента данных. Поддерживаются пользовательские макросы.
Тип (Type)	Тип элемента данных. Смотрите отдельные разделы по типам элементов данных.
Ключ (Key)	Ключ элемента данных (до 2048 символов). Поддерживаемые ключи элементов данных описаны в отдельных разделах по типам элементов данных. Ключ должен быть уникальным в пределах одного узла сети. Если тип ключа «Zabbix агент», «Zabbix агент (активный)» или «Простая проверка», то значение ключа должно поддерживаться Zabbix агентом или Zabbix сервером. Смотрите также: корректный формат ключа.
Тип информации (Type of information)	Тип хранения данных в базе данных после выполнения преобразований, если имеются. Числовой (целое положительное) — 64-битное целое число без знака Обратите внимание, что если для целочисленного элемента данных получено значение с плавающей точкой, то оно будет урезано до целой части. Числовой (с плавающей точкой) — 64-битное число с плавающей точкой Этот тип будет обеспечивать точность приблизительно 15 цифр и диапазон от -1,79E+308 до 1,79E+308 (за исключением PostgreSQL 11 и более ранних версий). Получение значений в научной нотации также поддерживается. Например: 1.23E+7, 1e308, 1.1E-4. Символ — короткие текстовые данные. Журнал — длинные текстовые данные с опциональными свойствами для журналов (отметка времени, источник, важность, logeventid). Текст — длинные текстовые данные. Смотрите также ограничения по текстовым данным. Бинарный — бинарные данные (поддерживается только для зависимых элементов данных). В разделе Последние данные (Latest data) бинарные данные будут раскрываться в статическую строку «бинарное значение» («binary value»); {ITEM.VALUE}, {ITEM.LASTVALUE} и макросы выражений будут раскрываться в UNKNOWN. Для ключей элементов данных, которые возвращают данные только в одном конкретном формате, соответствующий тип информации будет выбран автоматически.
Интерфейс узла сети (Host interface)	Выбор интерфейса узла сети. Это поле доступно при изменении элемента данных на уровне узла сети.
Единицы измерения (Units)	Если указан символ единицы измерения, Zabbix добавит постобработку полученного значения и отобразит его с заданным постфиксом единицы измерения. По умолчанию, если исходное значение превышает 1000, оно делится на 1000 и соответственно отображается. Например, если вы задали bps и полученное значение равно 881764, оно будет отображено как 881.76 Kbps. Для единиц измерения B (байт), Bps (байты в секунду) при обработке используется JEDEC [en] стандарт памяти, при котором значение делится на 1024. Таким образом, если единица измерения указана как B или Bps, Zabbix будет отображать: 1 как 1B/1Bps 1024 как 1KB/1KBps 1536 как 1.5KB/1.5KBps Специальная обработка используется и для следующих единиц измерения, связанных со временем: unixtime — переводится в «гггг.мм.дд чч:мм:сс». Для корректного перевода возвращаемое значение должно быть с типом данных Числовой (целое положительное). uptime — переводится в «чч:мм:сс» или в «N дней, чч:мм:сс» Например, если вы получили значение, равное 881764 (секунд), оно отобразится как «10 дней, 04:56:04» s — переводится в «ггг ммм ддд ччч ммм ссс мс»; параметр рассматривается как количество секунд. Например, если вы получили значение, равное 881764 (секунд), оно будет отображаться как «10д 4ч 56м» Отображаются только 3 верхних единицы, такие как «1м 15д 5ч» или «2ч 4м 46с». В случае, если нет дней, то тогда отображаются только два уровня — «1м 5ч» (минуты, секунды или миллисекунды не будут отображаться). Будет переведено в «< 1 ms», если значение меньше чем 0.001. Обратите внимание, если единица измерения представлена с префиксом «!», тогда к значениям элементов данных префиксы / обработка единиц измерения применяться не будет. Смотрите конвертацию единиц измерения.
Интервал обновления (Update interval)	Получение нового значения по этому элементу данных каждые N секунд. Максимально допустимый интервал обновления — 86400 секунд (одни сутки). Поддерживаются суффиксы времени, например, 30s, 1m, 2h, 1d. Поддерживаются пользовательские макросы. Один макрос должен заполнять это поле целиком. Несколько макросов в поле или макросы вперемешку с текстом не поддерживаются. Обратите внимание: интервал обновления может быть «0», только если заданы нестандартные интервалы с ненулевым значением. Если установлено значение «0» и задан пользовательский интервал (переменный или по расписанию) с ненулевым значением, элемент данных будет опрашиваться в соответствии с заданным пользовательским интервалом. Обратите внимание, что первый опрос элемента данных после его активации или после изменения интервала обновления может произойти раньше, чем заданное значение. Новые элементы данных будут опрошены в течение 60 секунд после их создания, если только у них не задан Интервал по расписанию или Переменный интервал, а Интервал обновления при этом выставлен в 0. У существующего пассивного элемента данных можно запросить опрос значения немедленно, нажав на кнопку Выполнить сейчас.
Пользовательские интервалы (Custom intervals)	Вы можете создавать пользовательские правила проверки элемента данных: Переменный (Flexible) — создание исключений из Интервала обновления (интервал с другой частотой обновления) По расписанию (Scheduling) — создание пользовательского расписания проверки. Для получения более подробной информации смотрите Пользовательские интервалы. Суффиксы времени поддерживаются в поле Интервал, например, 30s, 1m, 2h, 1d. Поддерживаются пользовательские макросы. Один макрос должен заполнять это поле целиком. Несколько макросов в поле или макросы вперемешку с текстом не поддерживаются.
Время ожидания (Timeout)	Задать время ожидания (тайм-аут) проверки элемента данных (доступно для поддерживаемых типов элементов данных). Выберите вариант тайм-аута: Глобальный (Global) — используется тайм-аут глобальный либо прокси (отображается в поле Время ожидания с фоном серого цвета); Замещение (Override) — используется пользовательский тайм-аут (заданный в поле Время ожидания; допустимый диапазон: 1 — 600s). Поддерживаются суффиксы времени (например: 30s, 1m) и пользовательские макросы. Нажатие на ссылку Время ожидания (Timeouts) позволяет вам настроить тайм-ауты прокси или глобальные тайм-ауты (если прокси не используется). Обратите внимание, что ссылка Время ожидания (Timeouts) отображается только для пользователей с типом Супер-администратор, имеющих права доступа к разделам веб-интерфейса Администрирование → Общие (Administration → General) или Администрирование → Прокси (Administration → Proxies).
История (History)	Выберите: Не хранить (Do not store) — история элемента данных не сохраняется. Полезно для основных (master) элементов данных, если историю нужно хранить только по зависимым элементам данных. Эту настройку нельзя переопределить глобальными настройками очистки истории. Хранить до (Store up to) — укажите длительность хранения в базе данных детальной истории (от 1 часа до 25 лет). Более старые данные будут удалены с помощью функции автоматической очистки истории базы данных. Хранится в секундах. Поддерживаются суффиксы времени, например, 2h, 1d. Поддерживаются пользовательские макросы. Значение Хранить до можно переопределить глобально в Администрирование → Очистка истории (Administration → Housekeeping). Если глобальное переопределение активировано, будет отображаться оранжевая иконка информации. Если вы поместите курсор мыши на эту иконку, отобразится сообщение с предупреждением, например, Переопределено глобальной настройкой очистки истории (1d). Рекомендуется хранить записанные значения как можно меньшее количество дней для уменьшения размера истории в базе данных. Вместо долговременного хранения истории значений вы можете хранить в течение более долгого срока данные динамики изменений. Смотрите также История и динамика изменений.
Динамика изменений (Trends)	Выберите: Не хранить (Do not store) — динамика изменений не сохраняется. Эту настройку нельзя переопределить глобальными настройками очистки истории. Хранить до — укажите период хранения усреднённых значений (ежечасные мин, макс, сред, количество) истории в базе данных (от 1 дня до 25 лет). Более старые данные будут удалены с помощью функции автоматической очистки истории базы данных. Хранится в секундах. Поддерживаются суффиксы времени, например, 24h, 1d. Поддерживаются пользовательские макросы. Значение Хранить до (Store up to) можно переопределить глобально в Администрирование → Очистка истории (Administration → Housekeeping). Если глобальное переопределение активировано, будет отображаться оранжевая иконка информации. Если вы поместите курсор мыши на эту иконку, отобразится сообщение с предупреждением, например, Переопределено глобальной настройкой очистки истории (7d). Обратите внимание: Хранение динамики изменений недоступно для нечисловых данных — символ, журнал и текст. Смотрите также история и динамика изменений.
Преобразование значений (Value mapping)	Применение преобразования значений к этому элементу данных. Преобразование значений не меняет полученные значения, оно служит только для отображения данных. Работает только с элементами данных с типом Числовой (целое положительное), Числовой (с плавающей точкой) и Символ. Например: «Windows service states».
Формат времени журнала (Log time format)	Доступно только для элементов данных типа Журнал. Поддерживаемые заменители: * y: Год (1970-2038) * M: Месяц (01-12) * d: День (01-31) * h: Час (00-23) * m: Минута (00-59) * s: Секунда (00-59) Если оставить это поле пустым, то штамп времени будет выставлен в 0, что в формате Unix time представляет 1 января 1070 года. Например, рассмотрим следующую строку из файла журнала Zabbix агента: « 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211).» Она начинается с шести символьных позиций PID, далее дата, время и остальная часть сообщения. Формат времени журнала для этой строки должен быть «pppppp:yyyyMMdd:hhmmss». Обратите внимание, что символы «p» и «:» являются лишь заменителями и могут быть какими угодно, кроме «yMdhms».
Заполнение поля инвентаря узла сети (Populates host inventory field)	Вы можете выбрать поле инвентарных данных, которое будет заполняться значением элемента данных. Функция будет работать, если у узла сети включено автоматическое заполнение инвентарных данных. Это поле недоступно, если для поля Тип информации выбрано значение «Журнал».
Описание (Description)	Введите описание элемента данных.
Активировано (Enabled)	Отметьте для активации элемента данных; таким образом, он будет обрабатываться.
Последние данные (Latest data)	Нажмите на ссылку для просмотра последних данных по этому элементу данных. Эта ссылка доступна только при изменении уже существующего элемента данных.

Вкладка Теги (Tags) позволяет задавать теги уровня элемента данных.

Предобработка значений элементов данных

Вкладка Предобработка (Preprocessing) позволяет задать правила преобразования полученных значений.

Тестирование

Можно протестировать элемент данных и, если он настроен должным образом, в результате тестирования получить реальное значение. Тестирование может проводиться даже до сохранения элемента данных.

Доступно тестирование для элементов данных узлов сети и шаблонов, прототипов элементов данных и правил низкоуровневого обнаружения. Тестирование недоступно для элементов данных с типом «Zabbix агент (активный)».

Тестирование элементов данных доступно для следующих типов пассивных элементов данных:

• Zabbix агент
• SNMP агент (v1, v2, v3)
• IPMI агент
• Проверка SSH
• Проверка Telnet
• JMX агент
• Простые проверки (кроме элементов данных icmpping*, vmware.*)
• Внутренние проверки
• Вычисляемые элементы данных
• Внешние проверки
• Мониторинг баз данных
• HTTP агент
• Скрипт
• Браузер

Для тестирования элемента данных нажмите кнопку Тест (Test) в нижней части диалога настройки элемента данных. Обратите внимание, что кнопка Тест будет отключена для элементов данных, которые невозможно проверить (например, активные проверки, исключения из простых проверок).

Форма тестирования элемента данных имеет поля для обязательных параметров узла сети (адрес узла сети, порт, тестировать посредством сервера/прокси (имя прокси)) и подробностей, специфичных для элемента данных (таких как community для SNMPv2 или учётные данные для SNMPv3). Эти поля контекстно-зависимые:

• Когда это возможно, значения предварительно заполнены; например, для элементов данных, требующих агента, путём получения информации из выбранного интерфейса агента с узла сети
• Значения должны быть заполнены вручную для элементов данных шаблона
• Значения макросов с обычным текстом раскрываются
• Поля, в которых значение (или часть значения) скрыто или задано как макрос Хранилища, остаются пустыми, и их необходимо заполнить вручную. Если какой-либо параметр элемента данных содержит значение скрытого макроса, отобразится следующее предупреждающее сообщение: «Элемент данных содержит пользовательский макрос со скрытыми значениями. Значения таких макросов необходимо ввести вручную».
• Поля отключены, когда они не нужны в контексте типа элемента данных (например, поле адреса узла сети отключено для вычисляемых элементов данных)

Чтобы проверить элемент данных, нажмите Получить значение (Get value). Если значение получено успешно, оно заполнит поле Значение (Value), переместив текущее значение (если оно есть) в поле Предыдущее значение (Previous value), одновременно вычисляя Пред. время (Prev.time), т. е. разницу во времени между двумя значениями (нажатиями) и пытаясь обнаружить последовательность EOL и переключиться на CRLF, если в полученном значении обнаруживается «\n\r».

Значения, полученные от узла сети, и результаты теста обрезаются до максимального размера 512 КБ при отправке на веб-интерфейс. Если результат усечён, отображается значок предупреждения. Описание предупреждения отображается при наведении мыши. Обратите внимание, что данные размером более 512 КБ по-прежнему полностью обрабатываются сервером Zabbix.

Если настройка выполнена неверно, отобразится сообщение об ошибке с описанием возможной причины.

Успешно полученное значение с узла сети также можно использовать для проверки шагов предобработки.

Кнопки диалога

Кнопки в нижней части диалога позволяют выполнить несколько видов операций.

(Добавить)	Добавление элемента данных. Эта кнопка доступна только для новых элементов данных.
(Обновить)	Обновление свойств элемента данных.
(Клонировать)	Создание другого элемента данных на основе свойств текущего элемента данных.
(Выполнить сейчас)	Выполнение немедленной проверки нового значения элемента данных. Поддерживается только для пассивных проверок (смотрите более детальную информацию). Обратите внимание, что когда выполняется немедленная проверка значения, кэш конфигурации не обновляется, поэтому значение не будет отражать совсем недавние изменения настроек элемента данных.
(Тест)	Проверка корректности настройки элемента данных путём попытки получения значения.
(Очистить историю и динамику изменений)	Удаление истории и динамики изменений элемента данных.
(Удалить)	Удаление элемента данных.
(Отмена)	Отмена изменения свойств элемента данных.

Ограничения текстовых данных

Ограничения текстовых данных зависят от выбранной базы данных. Перед сохранением текстовых значений в базу данных эти значения обрезаются в соотвествии с ограничением типа значений в базе данных:

Конвертация единиц измерения

По умолчанию, указывая единицу измерения для элемента данных, вы увидите добавленный префикс множителя — например, значение «2048» с единицей измерения «B» будет отображаться как «2KB».

Однако, используя префикс «!», можно избежать конвертации любой единицы измерения, например: !B. Чтобы лучше проиллюстрировать то, каким образом это преобразование работает с и без чёрного списка, взгляните на следующие примеры значений и единиц измерения:

1024 !B → 1024 B
       1024 B → 1 KB
       61 !s → 61 s
       61 s → 1m 1s
       0 !uptime → 0 uptime
       0 uptime → 00:00:00
       0 !! → 0 !
       0 ! → 0

Ограничения пользовательских скриптов

Доступная длина пользовательских скриптов зависит от используемой базы данных:

Неподдерживаемые элементы данных

Элемент данных может стать неподдерживаемым, если его значение не удалось получить по какой-либо причине. Такие элементы данных по-прежнему перепроверяются в соответствии с их стандартным Интервалом обновления.

О неподдерживаемых элементах данных сообщается как об имеющих состояние НЕ ПОДДЕРЖИВАЕТСЯ.