[comment]: # ({50342b23-50342b23}) # 1. Создание элемента данных [comment]: # ({/50342b23-50342b23}) [comment]: # ({d3a04061-d3a04061}) #### Обзор Для создания элемента данных в веб-интерфейсе Zabbix выполните следующее: - Перейдите в: *Настройка* → *Узлы сети* - Нажмите на *Элементы данных* в строке с узлом сети - Нажмите на *Создать элемент данных* в правом верхнем углу экрана - В диалоге введите параметры элемента данных Вы также можете создать элемент данных, открыв уже существующий элемент данных, после чего нажать на кнопку *Клонировать* и затем сохранить под другим именем. [comment]: # ({/d3a04061-d3a04061}) [comment]: # ({b1bab119-d0a0a311}) #### Настройка Вкладка **Элемент данных** содержит следующие атрибуты элементов данных. ![](../../../../assets/en/manual/config/items/item.png) Все обязательные поля ввода отмечены красной звёздочкой. |Параметр|Описание| |--|--------| |*Имя (Name)*|Имя элемента данных.| |*Тип (Type)*|Тип элемента данных. Смотрите отдельные разделы по [типам элементов данных](itemtypes).| |*Ключ (Key)*|Ключ элемента данных (до 2048 символов).
Поддерживаемые [ключи элементов данных](itemtypes) описаны в отдельных разделах по типам элементов данных.
Ключ должен быть уникальным в пределах одного узла сети.
Если тип ключа «Zabbix агент», «Zabbix агент (активный)» или «Простая проверка», то значение ключа должно поддерживаться Zabbix агентом или Zabbix сервером.
Смотрите также: корректный [формат ключа](/manual/config/items/item/key).| |*Тип информации*
*(Type of information)*|Тип хранения данных в базе данных после выполнения преобразований, если имеются.
**Числовой (целое положительное)** — 64-битное целое число без знака
**Числовой (с плавающей точкой)** — 64-битное число с плавающей точкой
Этот тип будет обеспечивать точность приблизительно 15 цифр и диапазон от -1,79E+308 до 1,79E+308 (за исключением [PostgreSQL 11 и более ранних версий](/manual/installation/known_issues#диапазон-типа-данных-числовой-с-дробной-точкой-в-postgresql-11-и-более-старых-версиях)).
Получение значений в научной нотации также поддерживается. Например: 1.23E+7, 1e308, 1.1E-4.
**Символ** — короткие текстовые данные.
**Журнал** — длинные текстовые данные с опциональными свойствами для журналов (штамп времени, источник, важность, logeventid).
**Текст** — длинные текстовые данные. Смотрите также [ограничения по текстовым данным](#ограничения-текстовых-данных).
Для ключей элементов данных, которые возвращают данные только в одном конкретном формате, соответствующий тип информации будет выбран автоматически.| |*Интерфейс узла сети*
*(Host interface)*|Выбор интерфейса узла сети. Это поле доступно при изменении элемента данных на уровне узла сети.| |*Единицы измерения*
*(Units)*|Если указан символ единиц измерения, Zabbix добавит постобработку полученного значения и отобразит его с заданным постфиксом единиц измерения.
По умолчанию, если исходное значение превышает 1000, оно делится на 1000 и соответственно отображается. Например, если вы задали *bps* и полученное значение равно 881764, оно будет отображено как 881.76 Kbps.
Специальная обработка применяется к следующим единицам измерения: **B**, **Bps**, **unixtime**, **uptime**, **s**.
Для единиц измерения **B** (байт), **Bps** (байты в секунду) при обработке используется [JEDEC](https://en.wikipedia.org/wiki/JEDEC_memory_standards) стандарт памяти, при котором значение делится на 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 мс», если значение меньше чем 0.001.
*Обратите внимание*, если единица измерения представлена с префиксом «`!`», тогда к значениям элементов данных префиксы / обработка единиц измерения применяться не будет. Смотрите [предотвращение преобразования единиц измерения](/manual/appendix/suffixes#предотвращение-преобразования-единиц-измерения).| |*Интервал обновления*
*(Update interval)*|Получение нового значения по этому элементу данных каждые N секунд. Максимально допустимый интервал обновления — 86400 секунд (одни сутки).
Поддерживаются [суффиксы времени](/manual/appendix/suffixes), например, 30s, 1m, 2h, 1d.
Поддерживаются [пользовательские макросы](/manual/config/macros/user_macros).
Один макрос должен заполнять это поле целиком. Несколько макросов в поле или макросы вперемешку с текстом не поддерживаются.
*Обратите внимание*: интервал обновления может быть «0», только если заданы нестандартные интервалы с ненулевым значением. Если установлено значение «0» и задан пользовательский интервал (переменный или по расписанию) с ненулевым значением, элемент будет опрашиваться в соответствии с заданным пользовательским интервалом.
*Обратите внимание*, что первый опрос элемента данных после его активации или после изменения интервала обновления может произойти раньше, чем заданное значение.
У существующего пассивного элемента данных можно запросить опрос значения немедленно, нажав на [кнопку](#кнопки_диалога) *Проверить сейчас*.| |*Пользовательские интервалы*
*(Custom intervals)*|Вы можете создавать пользовательские правила проверки элемента данных:
**Переменный** — создание исключений из *Интервала обновления* (интервал с другой частотой обновления)
**По расписанию** — создание пользовательского расписания проверки.
Для получения более подробной информации смотрите [Пользовательские интервалы](/manual/config/items/item/custom_intervals).
[Суффиксы времени](/manual/appendix/suffixes) поддерживаются в поле *Интервал*, например, 30s, 1m, 2h, 1d.
Поддерживаются [пользовательские макросы](/manual/config/macros/user_macros).
Один макрос должен заполнять это поле целиком. Несколько макросов в поле или макросы вперемешку с текстом не поддерживаются.
Проверка по расписанию поддерживается начиная с Zabix 3.0.0.
*Обратите внимание*: пользовательские интервалы для активных проверок поддерживаются только Zabbix агентом 2.| |*Период хранения истории*
*(History storage period)*|Выберите:
**Не хранить историю** — история элемента данных не сохраняется. Полезно для мастер элементов данных, если историю нужно хранить только по зависимым элементам данных.
Эту настройку нельзя переопределить глобальными [настройками](/manual/web_interface/frontend_sections/administration/general#очистка-истории) очистки истории.
**Период хранения** — укажите длительность хранения в базе данных детальной истории (от 1 часа до 25 лет). Более старые данные будут удалены с помощью функции автоматической очистки истории базы данных. Хранится в секундах.
Поддерживаются [суффиксы времени](/manual/appendix/suffixes), например, 2h, 1d. Поддерживаются [пользовательские макросы](/manual/config/macros/user_macros).
*Период хранения* можно переопределить глобально в *Администрирование → Общие → [Очистка истории](/manual/web_interface/frontend_sections/administration/general#очистка-истории)*.
Если глобальное переопределение активировано, будет отображаться оранжевая ![](../../../../assets/en/manual/config/info_orange.png) иконка информации. Если вы поместите курсор мыши на эту иконку, отобразится сообщение с предупреждением, например, *Переопределено глобальной настройкой очистки истории (1d)*.
Рекомендуется хранить записанные значения как можно меньшее количество дней для уменьшения размера истории в базе данных. Вместо долговременного хранения истории значений, вы можете хранить в течение более долгого срока данные динамики изменений.
Смотрите также [История и динамика изменений](/manual/config/items/history_and_trends).| | *Период хранения динамики изменений*
*(Trend storage period)*|Выберите:
**Не хранить динамику изменений** — динамика изменений не сохраняется.
Эту настройку нельзя переопределить глобальными [настройками](/manual/web_interface/frontend_sections/administration/general#очистка-истории) очистки истории.
**Период хранения** — укажите период хранения усреднённых значений (ежечасные мин, макс, сред, количество) истории в базе данных (от 1 дня до 25 лет). Более старые данные будут удалены с помощью функции автоматической очистки истории базы данных. Хранится в секундах.
Поддерживаются [суффиксы времени](/manual/appendix/suffixes), например, 24h, 1d. Поддерживаются [пользовательские макросы](/manual/config/macros/user_macros).
*Период хранения* значение можно переопределить глобально в *Администрирование → Общие → [Очистка истории](/manual/web_interface/frontend_sections/administration/general#очистка-истории)*.
Если глобальное переопределение активировано, будет отображаться оранжевая ![](../../../../assets/en/manual/config/info_orange.png) иконка информации. Если вы поместите курсор мыши на эту иконку, отобразится сообщение с предупреждением, например, *Переопределено глобальной настройкой очистки истории (7d)*.
*Обратите внимание:* Хранение динамики изменений недоступно для нечисловых данных — символ, журнал и текст.
Смотрите также [история и динамика изменений](/manual/config/items/history_and_trends).| |*Преобразование значений*
*(Value mapping)*|Применение преобразования значений к этому элементу данных. [Преобразование значений](/manual/config/items/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)*|Вы можете выбрать поле инвентарных данных, которое будет заполняться значением элемента данных. Функция будет работать, если у узла сети включено автоматическое заполнение [инвентарных данных](/manual/config/hosts/inventory).
Это поле недоступно, если для поля *Тип информации* выбрано значение «Журнал».| |*Описание*
*(Description)*|Введите описание элемента данных.| |*Активировано*
*(Enabled)*|Отметьте для активации элемента данных; таким образом, он будет обрабатываться.| |*Последние данные*
*(Latest data)*|Нажмите на ссылку для просмотра последних данных по этому элементу данных.
Эта ссылка доступна только при изменении уже существующего элемента данных.| ::: noteclassic Особые поля, зависящие от типа элемента данных, описаны на [соответствующих страницах](itemtypes). ::: ::: noteclassic При редактировании элемента данных уровня [шаблона](/manual/config/templates) на уровне узла сети, некоторое количество полей доступно только для чтения. Вы можете воспользоваться ссылкой из заголовка диалога, перейти на уровень шаблона и отредактировать элемент данных там; однако, имейте в виду, что изменение элемента данных коснется всех узлов сети, к которым шаблон присоединён. ::: Вкладка **Теги** позволяет задавать [теги](/manual/config/tagging) уровня элемента данных. ![](../../../../assets/en/manual/config/items/item_b.png) [comment]: # ({/b1bab119-d0a0a311}) [comment]: # ({4f9077b8-4f9077b8}) ##### Предобработка значений элементов данных Вкладка **Предобработка** позволяет задать [правила преобразования](/manual/config/items/preprocessing) полученных значений. [comment]: # ({/4f9077b8-4f9077b8}) [comment]: # ({ff2c0878-006c45ea}) #### Тестирование ::: noteimportant Чтобы выполнить тестирование элемента данных, убедитесь, что системное время на сервере и прокси [синхронизировано](/manual/installation/requirements#синхронизация-времени). В случае, если время на сервере отстаёт, в результате тестирования элемента данных может быть получено сообщение об ошибке: «The task has been expired». Однако, наличие различных часовых поясов (временных зон) на сервере и прокси на результаты тестирования не влияет. ::: Можно протестировать элемент и, если он настроен должным образом, в результате тестирования получить реальное значение. Тестирование может проводиться даже до сохранения элемента данных. Доступно тестирование для элементов данных узлов сети и шаблонов, прототипов элементов данных и правил низкоуровневого обнаружения. Тестирование недоступно для элементов данных с типом "Zabbix агент (активный)". Тестирование элементов данных доступно для следующих типов пассивных элементов данных: - Zabbix агент - SNMP агент (v1, v2, v3) - IPMI агент - Проверка SSH - Проверка Telnet - JMX агент - Простые проверки (кроме элементов данных `icmpping*`, `vmware.*`) - Внутренние проверки - Вычисляемые элементы - Внешние проверки - Мониторинг баз данных - HTTP агент - Скрипт Для тестирования элемента данных нажмите кнопку *Тест* в нижней части диалога настройки элемента данных. Обратите внимание, что кнопка *Тест* будет отключена для элементов данных, которые невозможно проверить (например, активные проверки, исключения из простых проверок). ![](../../../../assets/en/manual/config/items/item_test_button.png) Форма тестирования элемента данных имеет поля для обязательных параметров узла сети (адрес узла сети, порт, имя прокси/отсутствие прокси) и подробностей, специфичных для элемента данных (таких как community для SNMPv2 или учётные данные для SNMPv3). Эти поля контекстно-зависимые: - Когда это возможно, значения предварительно заполнены; например, для элементов данных, требующих агента, путём получения информации из выбранного интерфейса агента с узла сети - Значения должны быть заполнены вручную для элементов данных шаблона - Значения макросов с обычным текстом раскрываются - Поля, в которых значение (или часть значения) скрыто или задано как макрос Хранилища, остаются пустыми, и их необходимо заполнить вручную. Если какой-либо параметр элемента данных содержит значение скрытого макроса, отобразится следующее предупреждающее сообщение: «Элемент данных содержит пользовательский макрос со скрытыми значениями. Значения таких макросов необходимо ввести вручную». - Поля отключены, когда они не нужны в контексте типа элемента данных (например, поле адреса узла сети отключено для вычисляемых элементов данных) Чтобы проверить элемент данных, нажмите *Получить значение*. Если значение получено успешно, оно заполнит поле *Значение*, переместив текущее значение (если оно есть) в поле *Предыдущее значение*, одновременно вычисляя *Пред. время*, т. е. разницу во времени между двумя значениями (нажатиями) и пытаясь обнаружить последовательность EOL и переключиться на CRLF, если в полученном значении обнаруживается «\\n\\r». ![](../../../../assets/en/manual/config/items/item_test.png){width="600"} Если настройка выполнена неверно, отобразится сообщение об ошибке с описанием возможной причины. ![](../../../../assets/en/manual/config/items/item_test_error.png) Успешно полученное значение с узла сети также можно использовать для проверки [шагов предобработки](/manual/config/items/preprocessing#тестирование). [comment]: # ({/ff2c0878-006c45ea}) [comment]: # ({961d04fe-4b126a62}) #### Кнопки диалога Кнопки в нижней части диалога позволяют выполнить несколько видов операций. | | | |--|--------| |![](../../../../assets/en/manual/config/button_add.png) (Добавить)|Добавление элемента данных. Эта кнопка доступна только для новых элементов данных.| |![](../../../../assets/en/manual/config/button_update.png) (Обновить)|Обновление свойств элемента данных.| |![](../../../../assets/en/manual/config/button_clone.png) (Клонировать)|Создание другого элемента данных на основе свойств текущего элемента данных.| |![](../../../../assets/en/manual/config/button_execute.png) (Выполнить сейчас)|Выполнение немедленной проверки нового значения элемента данных. Поддерживается только для **пассивных** проверок (смотрите более [детальную информацию](/manual/config/items/check_now)).
*Обратите внимание*, что когда выполняется немедленная проверка значения, кэш конфигурации не обновляется, поэтому значение не будет отражать совсем недавние изменения настроек элемента данных.| |![](../../../../assets/en/manual/config/button_test.png) (Тест)|Проверка корректности настройки элемента данных методом попытки получения значения.| |![](../../../../assets/en/manual/config/button_clear_history.png) (Очистить историю и динамику изменений)|Удаление истории и динамики изменений элемента данных.| |![](../../../../assets/en/manual/config/button_delete.png) (Удалить)|Удаление элемента данных.| |![](../../../../assets/en/manual/config/button_cancel.png) (Отмена)|Отмена изменения свойств элемента данных.| [comment]: # ({/961d04fe-4b126a62}) [comment]: # ({681568e8-8cb32bf5}) #### Ограничения текстовых данных Ограничения текстовых данных зависят от выбранной базы данных. Перед сохранением текстовых значений в базу данных эти значения обрезаются в соотвествии с ограничением типа значений в базе данных: |База данных|Тип информации|<|<| |--|---|---|---| | |**Символ**|**Журнал (лог)**|**Текст**| |MySQL|255 символов|65536 байт|65536 байт| |PostgreSQL|255 символов|65536 символов|65536 символов| |Oracle|255 символов|65536 символов|65536 символов| |SQLite
(только Zabbix прокси)|255 символов|65536 символов|65536 символов| [comment]: # ({/681568e8-8cb32bf5}) [comment]: # ({526f3e7c-d4406a73}) #### Ограничения пользовательских скриптов Доступная длина пользовательских скриптов зависит от используемой базы данных: |База данных|Ограничение в символах|Ограничение в байтах| |---|---|---| |**MySQL**|65535|65535| |**Oracle Database**|2048|4000| |**PostgreSQL**|65535|ограничений нет| |**SQLite (только Zabbix прокси)**|65535|ограничений нет| [comment]: # ({/526f3e7c-d4406a73}) [comment]: # ({1426102b-2cd40177}) #### Неподдерживаемые элементы данных О неподдерживаемых элементах данных сообщается как об имеющих состояние *Не поддерживается*, и они по-прежнему перепроверяются со стандартным *[интервалом обновления](/manual/config/items/item?#настройка)*. Элемент данных становится неподдерживаемым, если его значение не удалось получить по какой-либо причине (например, ошибка подключения, нет настроенных поллеров для обработки элемента данных). Кроме того, элементы данных, которые не получают исторические данные, остаются в статусе *Не поддерживается*. Это ожидаемое поведение — элемент данных переходит в статус *Нормальный* только при получении новых, корректных исторических данных. Как и проблемы, неподдерживаемые элементы данных переоцениваются только при получении новых данных — даже если для этого элемента данных больше нет исторических данных. Другими словами, элементы данных и триггеры изменяют своё состояние только при получении новых данных. Однако если выражение триггера включает функции [даты и времени](/manual/appendix/functions/time) и/или nodata(), триггер будет пересчитываться каждые 30 секунд (подробности смотрите в разделе [время расчёта триггеров](/manual/config/triggers#время-вычисления)). [comment]: # ({/1426102b-2cd40177})