This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
ru:manual:config:items:item [2012/11/11 08:52] dotneft numeric unsigned value translated correctly with unixtime |
ru:manual:config:items:item [2014/09/26 11:35] (current) sasha Links adapted because of a move operation |
||
---|---|---|---|
Line 12: | Line 12: | ||
=== Настройка === | === Настройка === | ||
- | {{:ru:2.0:manual:config:item.png?700|}} | + | {{ru:manual:config:item.png?700|}} |
Атрибуты элемента данных: | Атрибуты элемента данных: | ||
Line 19: | Line 19: | ||
|//Узел сети// |Выберите узел сети или шаблон. | | |//Узел сети// |Выберите узел сети или шаблон. | | ||
|//Имя// |Это, как элемент данных будет называться.\\ Могут быть использованы следующие макросы:\\ **$1, $2...$9** - ссылки на первый, второй... девятый параметры из ключа элемента данных\\ Например: Free disk space on $1\\ Если ключ элемента данных "vfs.fs.size[/,free]", описание будет автоматически изменено на "Free disk space on /" | | |//Имя// |Это, как элемент данных будет называться.\\ Могут быть использованы следующие макросы:\\ **$1, $2...$9** - ссылки на первый, второй... девятый параметры из ключа элемента данных\\ Например: Free disk space on $1\\ Если ключ элемента данных "vfs.fs.size[/,free]", описание будет автоматически изменено на "Free disk space on /" | | ||
- | |//Тип// |Тип элемента данных. Смотрите отдельные разделы по [[ru:2.0:manual:config:items:itemtypes|типам элементов данных]].| | + | |//Тип// |Тип элемента данных. Смотрите отдельные разделы по [[itemtypes|типам элементов данных]].| |
- | |//Ключ// |Ключ элемента данных.\\ Поддерживаемые [[ru:2.0:manual:config:items:itemtypes|ключи элементов данных]] могут быть найдены в отдельных разделах по типам элементов данных.\\ Ключ должен быть уникальным в пределах одного узла сети.\\ Если тип ключа 'Zabbix агент', 'Zabbix агент (активный)', 'Простая проверка' или 'Zabbix агрегированный', то значение ключа должно поддерживаться Zabbix агентом или Zabbix сервером.\\ Смотрите также: корректный [[ru:2.0:manual:config:items:item:key|формат ключа]]. | | + | |//Ключ// |Ключ элемента данных.\\ Поддерживаемые [[itemtypes|ключи элементов данных]] могут быть найдены в отдельных разделах по типам элементов данных.\\ Ключ должен быть уникальным в пределах одного узла сети.\\ Если тип ключа 'Zabbix агент', 'Zabbix агент (активный)', 'Простая проверка' или 'Zabbix агрегированный', то значение ключа должно поддерживаться Zabbix агентом или Zabbix сервером.\\ Смотрите также: корректный [[ru:manual:config:items:item:key|формат ключа]]. | |
|//Интерфейс узла сети// |Выберите интерфейс узла сети. Это поле доступно при редактировании элемента данных на уровне узла сети. | | |//Интерфейс узла сети// |Выберите интерфейс узла сети. Это поле доступно при редактировании элемента данных на уровне узла сети. | | ||
|//Тип информации// |Тип хранения данных в базе данных после выполнения преобразований, если таковые имеются.\\ **Числовой (целое положительное)** - целое 64битное число\\ **Числовой (с плавающей точкой)** - число с плавающей точкой\\ **Символ** - символьные (строка) данные ограниченные 255 байтами\\ **Журнал** - файл журнала. Должен быть задан для ключей log[].\\ **Текст** - текст с неограниченной длиной| | |//Тип информации// |Тип хранения данных в базе данных после выполнения преобразований, если таковые имеются.\\ **Числовой (целое положительное)** - целое 64битное число\\ **Числовой (с плавающей точкой)** - число с плавающей точкой\\ **Символ** - символьные (строка) данные ограниченные 255 байтами\\ **Журнал** - файл журнала. Должен быть задан для ключей log[].\\ **Текст** - текст с неограниченной длиной| | ||
|//Тип данных// |Тип данных используется для целочисленных элементов данных для определения типа ожидаемых данных.:\\ **Логический** - текстовое представление переведенное в значения 0 или 1. Таким образом, 'TRUE' хранится как и 'FALSE' хранится как 0. Все значения сопоставляются чувствительным к регистру способом. В данное время распознаются значения для:\\ //TRUE// - true, t, yes, y, up, running, enabled, available\\ //FALSE// - false, f, no, n, down, unused, disabled, unavailable\\ Кроме того, любое ненулевое значение считается TRUE, нулевое считается FALSE. \\ **Восьмеричный** - данные в восьмеричном формате\\ **Десятичный** - данные в десятичном формате\\ **Шестнадцатеричный** - данные в шестнадцатеричном формате\\ Zabbix будет автоматически выполнять конвертацию в число.| | |//Тип данных// |Тип данных используется для целочисленных элементов данных для определения типа ожидаемых данных.:\\ **Логический** - текстовое представление переведенное в значения 0 или 1. Таким образом, 'TRUE' хранится как и 'FALSE' хранится как 0. Все значения сопоставляются чувствительным к регистру способом. В данное время распознаются значения для:\\ //TRUE// - true, t, yes, y, up, running, enabled, available\\ //FALSE// - false, f, no, n, down, unused, disabled, unavailable\\ Кроме того, любое ненулевое значение считается TRUE, нулевое считается FALSE. \\ **Восьмеричный** - данные в восьмеричном формате\\ **Десятичный** - данные в десятичном формате\\ **Шестнадцатеричный** - данные в шестнадцатеричном формате\\ Zabbix будет автоматически выполнять конвертацию в число.| | ||
- | |//Единица измерения// |Если задан символ единицы измерения, Zabbix добавит пост обработку полученного значения и отобразит его с заданным постфиксом единицы измерения.\\ По умолчанию, если исходное значение превышает 1000, оно делится на 1000 и так отображается. Например, если вы задали //bps// и полученное значение равно 881764, оно будет отображено как 881.76 Kbps. \\ Для единицы измерения **B** (байт) используется специальная обработка, при которой значение делится на 1024. Таким образом, если единица измерения задана как **B**, Zabbix будет отображать:\\ 1 как 1B\\ 1024 как 1KB\\ 1536 как 1.5KB\\ Специальная обработка используется и для следующих единиц измерения связанных со временем:\\ **unixtime** - переводится в "yyyy.mm.dd hh:mm:ss". Для корректного перевода, возвращаемое значение должно быть с типом данных //Числовой (целое положительное)//.\\ **uptime** - переводится в "hh:mm:ss" или в "N days, hh:mm:ss"\\ Например, если вы получите значение равное 881764 (секунд), оно будет отображаться как "10 дней, 04:56:04"\\ **s** - переводится в "yyy mmm ddd hhh mmm sss ms"; параметр рассматривается как количество секунд.\\ Например, если вы получите значение равное 881764 (секунд), оно будет отображаться как "10d 4h 56m"\\ Отображаются только 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** - переводится в "yyyy.mm.dd hh:mm:ss". Для корректного перевода, возвращаемое значение должно быть с типом данных //Числовой (целое положительное)//.\\ **uptime** - переводится в "hh:mm:ss" или в "N days, hh:mm:ss"\\ Например, если вы получите значение равное 881764 (секунд), оно будет отображаться как "10 дней, 04:56:04"\\ **s** - переводится в "yyy mmm ddd hhh mmm sss ms"; параметр рассматривается как количество секунд.\\ Например, если вы получите значение равное 881764 (секунд), оно будет отображаться как "10d 4h 56m"\\ Отображаются только 3 верхних основы, такие как "1м 15д 5ч" или "2ч 4м 46с". В случае, если нет дней, то тогда отображаются только два уровня - "1м 5ч" (минут, секунд или миллисекунд не будут показаны). Будет переведено в "< 1 ms", если значение меньше чем 0.001.\\ Смотрите также [[#черный_список_единиц_измерения|черный список единиц измерения]]. | |
- | |//Использовать пользовательский множитель// |Если вы активируете эту опцию, все полученные значения будут умножены на целое или дробное число заданное в поле значения.\\ Использование этой опции сконвертирует полученные значения в KB, MBps, и т.д. в B, Bps. В противном случае Zabbix не сможет корректно установить [[:ru/2.0/manual/config/triggers/suffixes|префиксы]] (K, M, G и т.д.).| | + | |//Использовать пользовательский множитель// |Если вы активируете эту опцию, все полученные значения будут умножены на целое или дробное число заданное в поле значения.\\ Использование этой опции сконвертирует полученные значения в KB, MBps, и т.д. в B, Bps. В противном случае Zabbix не сможет корректно установить [[ru:manual:config:triggers:suffixes|префиксы]] (K, M, G и т.д.).| |
|//Интервал обновления (в сек)// |Обновление этого элемента данных каждые N секунд.\\ //Обратите внимание//: Если задан '0', элемент данных не будет обрабатываться. Однако, если существует гибкий интервал с ненулевым значением, элемент данных будет обработан в течении продолжительности гибкого интервала.| | |//Интервал обновления (в сек)// |Обновление этого элемента данных каждые N секунд.\\ //Обратите внимание//: Если задан '0', элемент данных не будет обрабатываться. Однако, если существует гибкий интервал с ненулевым значением, элемент данных будет обработан в течении продолжительности гибкого интервала.| | ||
- | |//Переменные интервалы// | Вы можете создавать исключения для //Интервал обновления//. Например:\\ Интервал: **10**, Период: **1-5,09:00-18:00** - в рабочие часы будет задано обновление каждые 10 секунд. В остальных случаях будет использован интервал обновления по умолчанию.\\ Если несколько гибких интервалов перекрываются, то используется наименьшее значение //Интервал// для перекрывающегося периода.\\ Смотрите страницу об установке [[ru:2.0:manual:appendix:time_period|периодов времени]] для получения информации о формате поля //Период//.\\ //Обратите внимание//: Если задан '0', элемент данных не будет обрабатываться в течении гибкого интервала времени и вернется в обработку согласно //Интервал обновления//, как только период гибкого интервала завершится.| | + | |//Переменные интервалы// | Вы можете создавать исключения для //Интервал обновления//. Например:\\ Интервал: **10**, Период: **1-5,09:00-18:00** - в рабочие часы будет задано обновление каждые 10 секунд. В остальных случаях будет использован интервал обновления по умолчанию.\\ Если несколько гибких интервалов перекрываются, то используется наименьшее значение //Интервал// для перекрывающегося периода.\\ Смотрите страницу об установке [[ru:manual:appendix:time_period|периодов времени]] для получения информации о формате поля //Период//.\\ //Обратите внимание//: Если задан '0', элемент данных не будет обрабатываться в течении гибкого интервала времени и вернется в обработку согласно //Интервал обновления//, как только период гибкого интервала завершится.\\ //Возьмите на заметку//: Недоступно для элементов данных с типом Zabbix агент активный. | |
|//Хранение истории\\ (в днях)// |Количество дней хранения в базе данных детальной истории. Более старые данные будут удалены с помощью функцией автоматической очистки истории в базе данных.\\ Рекомендуется хранить записанные значения как можно меньшее количество дней для уменьшения размера истории в базе данных. Вместо долговременного хранения истории значений, вы можете хранить дольше данные динамики изменений. | | |//Хранение истории\\ (в днях)// |Количество дней хранения в базе данных детальной истории. Более старые данные будут удалены с помощью функцией автоматической очистки истории в базе данных.\\ Рекомендуется хранить записанные значения как можно меньшее количество дней для уменьшения размера истории в базе данных. Вместо долговременного хранения истории значений, вы можете хранить дольше данные динамики изменений. | | ||
|//Хранение динамики изменений\\ (в днях)// |Хранение усредненных значений (ежечасные мин, макс, сред, количество) детальной истории N дней в базе данных. Более старые данные будут удалены с помощью функцией автоматической очистки истории в базе данных.\\ //Обратите внимание:// Хранение динамики изменений недоступно для не числовых данных - символ, журнал и текст. | | |//Хранение динамики изменений\\ (в днях)// |Хранение усредненных значений (ежечасные мин, макс, сред, количество) детальной истории N дней в базе данных. Более старые данные будут удалены с помощью функцией автоматической очистки истории в базе данных.\\ //Обратите внимание:// Хранение динамики изменений недоступно для не числовых данных - символ, журнал и текст. | | ||
Line 35: | Line 35: | ||
|//Новая группа элементов данных// |Введите имя новой группы элементов данных для этого элемента данных. | | |//Новая группа элементов данных// |Введите имя новой группы элементов данных для этого элемента данных. | | ||
|//Группы элементов данных// |Соединение элемента данных с одним или несколькими существующими группами элементов данных.| | |//Группы элементов данных// |Соединение элемента данных с одним или несколькими существующими группами элементов данных.| | ||
- | |//Заполнение поля\\ инвентаря узла сети// |Вы можете выбрать поле инвентарных данных, которое будет заполнено значением элемента данных. Это будет работать, если для узла сети включено автоматическое заполнение [[:ru:2.0:manual:config:hosts:inventory|интентарных данных]].| | + | |//Заполнение поля\\ инвентаря узла сети// |Вы можете выбрать поле инвентарных данных, которое будет заполнено значением элемента данных. Это будет работать, если для узла сети включено автоматическое заполнение [[ru:manual:config:hosts:inventory|интентарных данных]].| |
|//Описание// |Введите описание элемента данных. | | |//Описание// |Введите описание элемента данных. | | ||
- | |//Состояние// |**Активирован** - элемент данных будет обработан.\\ **Деактивирован** - элемент данных отключен. Этот элемент данных не будет обрабатываться.\\ **Не поддерживается** - элемент не поддерживается Zabbix'ом или SNMP агентом. Этот элемент данных не будет обрабатываться, однако Zabbix может периодически пытаться изменить состояние на //Активирован// в соответствии с заданным интервалом [[:ru/2.0/manual/web_interface/frontend_sections/administration/general?&#остальные_параметры|обновления неподдерживаемых элементов данных]].| | + | |//Состояние// |**Активирован** - элемент данных будет обработан.\\ **Деактивирован** - элемент данных отключен. Этот элемент данных не будет обрабатываться.\\ **Не поддерживается** - элемент не поддерживается Zabbix'ом или SNMP агентом. Этот элемент данных не будет обрабатываться, однако Zabbix может периодически пытаться изменить состояние на //Активирован// в соответствии с заданным интервалом [[ru:manual:web_interface:frontend_sections:administration:general?&#остальные_параметры|обновления неподдерживаемых элементов данных]].| |
Вы также можете создать элемент данных открыв уже существующий элемент данных, нажать на кнопку //Клонировать// и затем сохранить под другим именем. | Вы также можете создать элемент данных открыв уже существующий элемент данных, нажать на кнопку //Клонировать// и затем сохранить под другим именем. | ||
- | <note>При редактировании элемента данных уровня [[:ru:2.0:manual:config:templates|шаблона]] на уровне узла сети, некоторое количество полей доступно только для чтения. Вы можете воспользоваться ссылкой из заголовка формы и перейти на уровень шаблона и отредактировать элемент данных там, имея ввиду, что изменение элемента данных коснется всех узлов сети к которым присоединен шаблон.</note> | + | <note>При редактировании элемента данных уровня [[ru:manual:config:templates|шаблона]] на уровне узла сети, некоторое количество полей доступно только для чтения. Вы можете воспользоваться ссылкой из заголовка формы и перейти на уровень шаблона и отредактировать элемент данных там, имея ввиду, что изменение элемента данных коснется всех узлов сети к которым присоединен шаблон.</note> |
+ | |||
+ | == Черный список единиц измерения == | ||
+ | |||
+ | По умолчанию, указывая единицу измерения элементу данных, вы увидите добавленный префикс множителя - например, значение 2048 с единицой измерения B будет отображаться как 2КБ. Имеется несколько предопределенных, добавленных в код единиц измерения, которые препятствуют отображению данных с префиксом: | ||
+ | |||
+ | * ms | ||
+ | * RPM | ||
+ | * rpm | ||
+ | * % | ||
+ | |||
+ | Обратите внимание, что и в нижнем регистре, и в верхнем строки **rpm** (//rpm// и //RPM//) внесены в черный список. | ||
=== Неподдерживаемые элементы данных === | === Неподдерживаемые элементы данных === | ||
- | Элемент данных может стать неподдерживаемым, если его значение не было получено по каким-то причинам. Такие элементы данных будут перепроверены через определенный интервал времени, настраиваемый в [[:ru/2.0/manual/web_interface/frontend_sections/administration/general#остальные_параметры|разделе Администрирования]]. | + | Элемент данных может стать неподдерживаемым, если его значение не было получено по каким-то причинам. Такие элементы данных будут перепроверены через определенный интервал времени, настраиваемый в [[ru:manual:web_interface:frontend_sections:administration:general#остальные_параметры|разделе Администрирования]]. |