ru:manual:config:items:item

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
ru:manual:config:items:item [2019/10/07 06:35]
127.0.0.1 external edit
ru:manual:config:items:item [2020/06/26 15:18] (current)
marinagen
Line 23: Line 23:
 |//​Имя// ​ |Имя элемента данных.\\ Поддерживаются следующие макросы,​ однако,​ их использование устарело:​\\ **$1, $2...$9** - ссылка на первый,​ второй... девятый параметры ключа элемента данных\\ Например:​ Свободно дискового пространства в $1\\ Если ключ элемента данных "​vfs.fs.size[/,​free]",​ описание автоматически изменится на "​Свободно дискового пространства в /" | |//​Имя// ​ |Имя элемента данных.\\ Поддерживаются следующие макросы,​ однако,​ их использование устарело:​\\ **$1, $2...$9** - ссылка на первый,​ второй... девятый параметры ключа элемента данных\\ Например:​ Свободно дискового пространства в $1\\ Если ключ элемента данных "​vfs.fs.size[/,​free]",​ описание автоматически изменится на "​Свободно дискового пространства в /" |
 |//​Тип// ​ |Тип элемента данных. Смотрите отдельные разделы по [[itemtypes|типам элементов данных]].| |//​Тип// ​ |Тип элемента данных. Смотрите отдельные разделы по [[itemtypes|типам элементов данных]].|
-|//​Ключ// ​ |Ключ элемента данных.\\ Поддерживаемые [[itemtypes|ключи элементов данных]] описаны в отдельных разделах по типам элементов данных.\\ Ключ должен быть уникальным в пределах одного узла сети.\\ Если тип ключа '​Zabbix агент',​ '​Zabbix агент (активный)',​ '​Простая проверка'​ или '​Zabbix агрегированный',​ то значение ключа должно поддерживаться Zabbix агентом или Zabbix сервером.\\ Смотрите также: корректный [[ru:​manual:​config:​items:​item:​key|формат ключа]]. ​ |+|//​Ключ// ​ |Ключ элемента данных ​(до 2048 символов).\\ Поддерживаемые [[itemtypes|ключи элементов данных]] описаны в отдельных разделах по типам элементов данных.\\ Ключ должен быть уникальным в пределах одного узла сети.\\ Если тип ключа '​Zabbix агент',​ '​Zabbix агент (активный)',​ '​Простая проверка'​ или '​Zabbix агрегированный',​ то значение ключа должно поддерживаться Zabbix агентом или Zabbix сервером.\\ Смотрите также: корректный [[ru:​manual:​config:​items:​item:​key|формат ключа]]. ​ |
 |//​Интерфейс узла сети// |Выбор интерфейса узла сети. Это поле доступно при изменении элемента данных на уровне узла сети. | |//​Интерфейс узла сети// |Выбор интерфейса узла сети. Это поле доступно при изменении элемента данных на уровне узла сети. |
-|//Тип информации// ​ |Тип хранения ​данных в базе данных после всех преобразований, если ​таковые имеются.\\ **Числовой (целое ​положительное)** - целое 64битное число\\ **Числовой (с плавающей точкой)** число с плавающей точкой\\ Отрицательные значения могут ​храниться.\\ Допустимые значения -999999999999.9999 до 999999999999.9999. \\ Начиная с Zabbix 2.2, также поддерживается ​получение значений в научном представлении. Например, 1e+7, 1e-4.\\ **Символ** - короткие текстовые данные\\ **Журнал** - длинные текстовые данные с необязательными свойствами для журналов (штамп времени,​ источник,​ важность,​ logeventid).\\ **Текст** - длинные текстовые данные. Смотрите также [[#​Ограничения_текстовых_данных|ограничения по текстовым данных]]. |+|//Тип информации// ​ |Этот тип будет обеспечивать точность ​приблизительно ​15 цифр и диапазон от -1,79E + 308 до 1,79E + 308 (за исключением [[:​manual/​installation/​known_issues#​floating_point_values|PostgreSQL 11 и более ранних ​версий]]). \\ Получение значений в научной нотации ​также поддерживается. Например. 1.23E + 7, 1e308, 1.1E-4. \\ **Символ** - короткие текстовые данные\\ **Журнал** - длинные текстовые данные с необязательными свойствами для журналов (штамп времени,​ источник,​ важность,​ logeventid).\\ **Текст** - длинные текстовые данные. Смотрите также [[#​Ограничения_текстовых_данных|ограничения по текстовым данных]]. |
 |//​Единица измерения// ​ |Если указан символ единицы измерения,​ Zabbix добавит пост обработку полученного значения и отобразит его с заданным постфиксом единицы измерения.\\ По умолчанию,​ если исходное значение превышает 1000, оно делится на 1000 и так отображается. Например,​ если вы задали //bps// и полученное значение равно 881764, оно будет отображено как 881.76 Kbps. \\ Для единиц измерения **B** (байт), **Bps** (байты в секунду) используется специальная обработка,​ при которой значение делится на 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.\\ //​Обратите внимание//,​ что если единица измерения представлена с ''​!''​ префиксом,​ тогда к значениям элементов данных префиксы/​обработка единиц измерения применяться не будут. Смотрите [[#​чёрный_список_единиц_измерения|чёрный список единиц измерения]].| |//​Единица измерения// ​ |Если указан символ единицы измерения,​ Zabbix добавит пост обработку полученного значения и отобразит его с заданным постфиксом единицы измерения.\\ По умолчанию,​ если исходное значение превышает 1000, оно делится на 1000 и так отображается. Например,​ если вы задали //bps// и полученное значение равно 881764, оно будет отображено как 881.76 Kbps. \\ Для единиц измерения **B** (байт), **Bps** (байты в секунду) используется специальная обработка,​ при которой значение делится на 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.\\ //​Обратите внимание//,​ что если единица измерения представлена с ''​!''​ префиксом,​ тогда к значениям элементов данных префиксы/​обработка единиц измерения применяться не будут. Смотрите [[#​чёрный_список_единиц_измерения|чёрный список единиц измерения]].|
-|//​Интервал обновления// ​ |Получение нового значения по этому элементу данных каждые N секунд. Максимально допустимый интервал обновления - 86400 секунд (1 день).\\ [[:​ru/​manual/​appendix/​suffixes|Функции времени]] поддерживаются,​ например,​ 30s, 1m, 2h, 1d.\\ Поддерживаются [[:​ru/​manual/​config/​macros/​usermacros|пользовательские макросы]].\\ //​Обратите внимание//: ​Если задано значение равное '​0',​ элемент данных не будет обрабатываться. Однако, если также существует ​пользовательский интервал (гибкий/по расписанию) с ненулевым значением,​ элемент ​данных ​будет обработан в течении длительности пользовательского ​интервала.\\  //​Обратите внимание//,​ что у существующего пассивного элемента данных можно выполнить опрос значения немедленно,​ нажав на [[#​кнопки_диалога|кнопку]] //​Проверить сейчас//​.|+|//​Интервал обновления// ​ |Получение нового значения по этому элементу данных каждые N секунд. Максимально допустимый интервал обновления - 86400 секунд (1 день).\\ [[:​ru/​manual/​appendix/​suffixes|Функции времени]] поддерживаются,​ например,​ 30s, 1m, 2h, 1d.\\ Поддерживаются [[:​ru/​manual/​config/​macros/​usermacros|пользовательские макросы]] ​(в этом поле может быть использован только один макрос. Комбинации из нескольких макросов или макроса с текстом не поддерживаются).\\  //​Обратите внимание//:​ интервал обновления ​может быть «0», только если заданы нестандартные интервалы с ненулевым значением. Если ​установлено значение «0» и существует ​нестандартный интервал (гибкий ​или запланированный) с ненулевым значением,​ элемент будет опрашиваться в период, заданный нестандартным ​интервалом\\  //​Обратите внимание//,​ что у существующего пассивного элемента данных можно выполнить опрос значения немедленно,​ нажав на [[#​кнопки_диалога|кнопку]] //​Проверить сейчас//​.|
 |//​Пользовательские интервалы// ​ |Вы можете создавать пользовательские правила проверки элемента данных:​\\ **Гибкий** - создание исключений из //​Интервала обновления//​ (интервал с другой частотой обновления)\\ **По расписанию** - создание пользовательского расписания проверки.\\ Для получения более подробной информации смотрите [[ru:​manual:​config:​items:​item:​custom_intervals|Пользовательские интервалы]].\\ [[:​ru/​manual/​appendix/​suffixes|Функции времени]] поддерживаются в поле //​Интервал//,​ например,​ 30s, 1m, 2h, 1d.\\ Поддерживаются [[:​ru/​manual/​config/​macros/​usermacros|пользовательские макросы]].\\ Проверка по расписанию поддерживается начиная с Zabix 3.0.0.\\ //​Обратите внимание//:​ Недоступно для активных элементов данных Zabbix агента. | |//​Пользовательские интервалы// ​ |Вы можете создавать пользовательские правила проверки элемента данных:​\\ **Гибкий** - создание исключений из //​Интервала обновления//​ (интервал с другой частотой обновления)\\ **По расписанию** - создание пользовательского расписания проверки.\\ Для получения более подробной информации смотрите [[ru:​manual:​config:​items:​item:​custom_intervals|Пользовательские интервалы]].\\ [[:​ru/​manual/​appendix/​suffixes|Функции времени]] поддерживаются в поле //​Интервал//,​ например,​ 30s, 1m, 2h, 1d.\\ Поддерживаются [[:​ru/​manual/​config/​macros/​usermacros|пользовательские макросы]].\\ Проверка по расписанию поддерживается начиная с Zabix 3.0.0.\\ //​Обратите внимание//:​ Недоступно для активных элементов данных Zabbix агента. |
 |//​Период хранения истории// ​ |Количество дней хранения в базе данных детальной истории (от 1 часа до 25 лет). Более старые данные будут удалены с помощью функции автоматической очистки истории базы данных.\\ Хранится в секундах. [[:​ru/​manual/​appendix/​suffixes|Функции времени]] поддерживаются,​ например,​ 2h, 1d.\\ Поддерживаются [[:​ru/​manual/​config/​macros/​usermacros|пользовательские макросы]].\\ Данное значение можно переопределить глобально в // Администрирование -> Общие -> [[ru:​manual:​web_interface:​frontend_sections:​administration:​general#​очистка_истории|Очистка истории]]//​. Если опция активирована,​ то вы увидите предупреждение:​ {{manual:​config:​override_item.png|}} \\ Рекомендуется хранить записанные значения как можно меньшее количество дней для уменьшения размера истории в базе данных. Вместо долговременного хранения истории значений,​ вы можете хранить более долгий срок данные динамики изменений.\\ Смотрите также [[:​ru/​manual/​config/​items/​history_and_trends|История и динамика изменений]]. ​ | |//​Период хранения истории// ​ |Количество дней хранения в базе данных детальной истории (от 1 часа до 25 лет). Более старые данные будут удалены с помощью функции автоматической очистки истории базы данных.\\ Хранится в секундах. [[:​ru/​manual/​appendix/​suffixes|Функции времени]] поддерживаются,​ например,​ 2h, 1d.\\ Поддерживаются [[:​ru/​manual/​config/​macros/​usermacros|пользовательские макросы]].\\ Данное значение можно переопределить глобально в // Администрирование -> Общие -> [[ru:​manual:​web_interface:​frontend_sections:​administration:​general#​очистка_истории|Очистка истории]]//​. Если опция активирована,​ то вы увидите предупреждение:​ {{manual:​config:​override_item.png|}} \\ Рекомендуется хранить записанные значения как можно меньшее количество дней для уменьшения размера истории в базе данных. Вместо долговременного хранения истории значений,​ вы можете хранить более долгий срок данные динамики изменений.\\ Смотрите также [[:​ru/​manual/​config/​items/​history_and_trends|История и динамика изменений]]. ​ |
Line 35: Line 35:
 |//​Новая группа элементов данных// ​ |Введите имя новой группы элементов данных для этого элемента данных. ​ |  |//​Новая группа элементов данных// ​ |Введите имя новой группы элементов данных для этого элемента данных. ​ | 
 |//​Группы элементов данных// ​ |Соединение элемента данных с одним или несколькими существующими группами элементов данных.| |//​Группы элементов данных// ​ |Соединение элемента данных с одним или несколькими существующими группами элементов данных.|
-|//​Заполнение поля\\ инвентаря узла сети// |Вы можете выбрать поле инвентарных данных,​ которое будет заполняться значением элемента данных. Функция будет работать,​ если у узла сети включено автоматическое заполнение [[:​ru:​manual:​config:​hosts:​inventory|инвентарных данных]].|+|//​Заполнение поля\\ инвентаря узла сети// |Вы можете выбрать поле инвентарных данных,​ которое будет заполняться значением элемента данных. Функция будет работать,​ если у узла сети включено автоматическое заполнение [[:​ru:​manual:​config:​hosts:​inventory|инвентарных данных]]. \\ Это поле недоступно,​ если выбран //Тип информации//​ '​Log'​.|
 |//​Описание//​ |Введите описание элемента данных. | |//​Описание//​ |Введите описание элемента данных. |
 |//​Активировано// ​ |Отметьте для активации элемента данных,​ таким образом он будет обрабатываться. | |//​Активировано// ​ |Отметьте для активации элемента данных,​ таким образом он будет обрабатываться. |
Line 66: Line 66:
  
 <note tip>​Если вы используете пользовательский множитель или хранение значений как //​Изменение в секунду//​ у элементов данных с типом информации //​Числовой (целое положительное)//​ и результирующее вычисленное значение в действительности дробное число, тогда вычисленное значение всё же будет считаться приемлемым,​ однако дробная часть будет обрезана и значение запишется как целое положительное.</​note>​ <note tip>​Если вы используете пользовательский множитель или хранение значений как //​Изменение в секунду//​ у элементов данных с типом информации //​Числовой (целое положительное)//​ и результирующее вычисленное значение в действительности дробное число, тогда вычисленное значение всё же будет считаться приемлемым,​ однако дробная часть будет обрезана и значение запишется как целое положительное.</​note>​
 +
 +=== Тестирование ===
 +
 +Можно протестировать элемент и, если он настроен правильно,​ в результате получить реальное значение. Тестирование может проводиться даже до сохранения элемента.
 +
 +Доступно тестирование для элементов данных узлов сети и шаблонов,​ прототипов элементов данных и низкоуровневых правил обнаружения. Тестирование недоступно для активных элементов данных.
 +
 +Тестирование предметов доступно для следующих типов пассивных элементов данных:​
 +  * Zabbix агент
 +  * SNMP агент (v1, v2, v3)
 +  * IPMI агент
 +  * Проверки SSH 
 +  * Проверки Telnet
 +  * JMX агент
 +  * Простые проверки (кроме элементов данных ''​icmpping*'',​ ''​vmware.*''​)
 +  * Внутренние проверки
 +  * Аггрегированные проверки
 +  * Вычисляемые элементы
 +  * Внешние проверки
 +  * Мониторинг баз данных
 +  * HTTP агент
 +
 +Чтобы проверить элемент,​ нажмите кнопку //​Тест//​ в нижней части формы конфигурации элемента. Обратите внимание,​ что кнопка //​Тест//​ будет отключена для элементов,​ которые невозможно проверить (например,​ активные проверки,​ исключенные простые проверки).
 +
 +{{:​manual:​config:​items:​item_test_button.png|}}
 +
 +Форма тестирования элемента содержит поля для обязательных параметров хоста (адрес хоста, порт, имя прокси/​нет прокси). Эти поля являются контекстно-зависимыми:​
 +
 +   * Значения предварительно заполняются,​ когда это возможно,​ то есть для элементов,​ требующих агента,​ путем получения информации из интерфейса выбранного агента хоста
 +   * Значения должны быть заполнены вручную для элементов шаблона
 +   * Поля отключаются,​ когда они не нужны в контексте типа элемента (например,​ поле адреса хоста отключено для вычисляемых и агрегированных элементов,​ поле прокси отключено для вычисляемых элементов)
 +
 +Чтобы проверить элемент,​ нажмите //​Получить значение//​. Если значение получено успешно,​ оно заполнит поле //​Значение//,​ перемещая текущее значение (если оно есть) в поле //​Предыдущее значение//,​ одновременно вычисляя //Пред. время//,​ т. е. разницу во времени между двумя значениями (нажатиями) и пытаясь обнаружить последовательность EOL и переключиться на CRLF, если в полученном значении обнаруживается %%"​%%\n\r%%"​%%.
 +
 +{{:​manual:​config:​items:​item_test.png?​600|}}
 +
 +Если настройка выполнена неверно,​ отображается сообщение об ошибке с описанием возможной причины.
 +{{:​manual:​config:​items:​item_test_error.png|}}
 +
 +Успешно полученное значение с хоста также может быть использовано для проверки [[:​ru/​manual/​config/​items/​preprocessing#​testing|шагов предобработки]]. ​
  
 == Кнопки диалога == == Кнопки диалога ==
Line 88: Line 128:
 | PostgreSQL | 255 символов | 65536 символов | 65536 символов | | PostgreSQL | 255 символов | 65536 символов | 65536 символов |
 | Oracle ​    | 255 символов | 65536 символов | 65536 символов | | Oracle ​    | 255 символов | 65536 символов | 65536 символов |
-| DB2        | 255 байт ​     | 2048 байт ​      | 2048 байт ​      |+
  
 == Чёрный список единиц измерения == == Чёрный список единиц измерения ==