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
Next revision
Previous revision
ru:manual:config:items:item [2012/05/04 15:45]
dotneft
ru:manual:config:items:item [2014/09/26 11:35] (current)
sasha Links adapted because of a move operation
Line 12: Line 12:
 === Настройка === === Настройка ===
  
-{{:2.0:​manual:​config:​1.9.7_item.png?525|}}+{{ru:​manual:​config:​item.png?700|}}
  
 Атрибуты элемента данных:​ Атрибуты элемента данных:​
Line 18: Line 18:
 ^Параметр^Описание^ ^Параметр^Описание^
 |//Узел сети// |Выберите узел сети или шаблон. | |//Узел сети// |Выберите узел сети или шаблон. |
-|//​Интерфейс узла сети// |Выберите интерфейс узла сети. Это поле доступно при редактировании элемента данных на уровне узла сети. | 
 |//​Имя// ​ |Это, как элемент данных будет называться.\\ Могут быть использованы следующие макросы:​\\ **$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. Все значения сопоставляются чувствительным к регистру способом. ​Currently recognized values are, for:\\ //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 верхних основы,​ такие как "1m 15d 5h" или "2h 4m 46s". В случае,​ если нет дней, то тогда отображаются только два уровня - "1m 5h" (минут,​ секунд или миллисекунд не будут показаны). Будет переведено в "< 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 etc).| +|//Использовать пользовательский множитель//  |Если вы активируете эту опцию, все полученные значения будут умножены ​на целое или дробное число ​заданное в поле значения.\\ Использование этой опции сконвертирует полученные значения в 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 секунд. В остальных случаях будет использован интервал обновления по умолчанию.\\ ​If multiple flexible intervals overlapthe smallest ​//Задержка// value is used for the overlapping period.\\ See [[1.8:manual:config:​time_period|Time period specification]] page for description of the //Period// format.\\ //Note//: If set to '​0', ​the item will not be polled during the flexible interval duration and will resume polling according to the //Update interval// once the flexible interval period is over.| +|//​Переменные интервалы// ​ | Вы можете создавать исключения для //​Интервал обновления//​. Например:​\\ ​Интервал: **10**, Период:​ **1-5,​09:​00-18:​00** - в рабочие часы будет задано обновление каждые 10 секунд. В остальных случаях будет использован интервал обновления по умолчанию.\\ ​Если несколько гибких интервалов перекрываютсято используется наименьшее значение ​//Интервал// для перекрывающегося периода.\\ Смотрите страницу об установке ​[[ru:manual:appendix:​time_period|периодов времени]] для получения информации о формате поля ​//Период//.\\ //Обратите внимание//: Если задан ​'​0', ​элемент данных не будет обрабатываться в течении гибкого интервала времени и вернется в обработку согласно ​//Интервал обновления//, как только период гибкого интервала завершится.\\ //​Возьмите на заметку//:​ Недоступно для элементов данных с типом Zabbix агент активный. | 
-|//​Хранение истории\\ (в днях)// ​ |Number of days to keep detailed history in the databaseOlder data will be removed by Housekeeper.\\ It is recommended to keep the recorded values for the smallest possible number of days to reduce the size of value history in the databaseInstead of keeping long history of valuesyou can keep longer data of trends.  | +|//​Хранение истории\\ (в днях)// ​ |Количество дней хранения в базе данных детальной историиБолее старые данные будут удалены с помощью функцией автоматической очистки истории в базе данных.\\ Рекомендуется хранить записанные значения как можно меньшее количество дней для уменьшения размера истории в базе данныхВместо долговременного хранения истории значенийвы можете хранить дольше данные динамики изменений.  | 
-|//​Хранение динамики изменений\\ (в днях)// ​ |Keep aggregated ​(hourly minmaxavgcountdetailed history for days in the databaseOlder data will be removed by Housekeeper.\\ //Note:// Keeping trends is not available for non-numeric data - character, log and text. | +|//​Хранение динамики изменений\\ (в днях)// ​ |Хранение усредненных значений ​(ежечасные минмакссредколичестводетальной истории ​дней в базе данныхБолее старые данные будут удалены с помощью функцией автоматической очистки истории в базе данных.\\ //Обратите внимание:// Хранение динамики изменений недоступно для не числовых данных ​символжурнал и текст. | 
-|//Состояние//  |**Active** ​active (normal) status. Zabbix will process this item.\\ **Disabled** - item is disabled. This item will not be processed.\\ **Not supported** - item is not supported by Zabbix or SNMP agent. This item will not be processedhowever Zabbix may try to periodically set status of such items to //Active// if configured.| +|//​Хранение значения// ​ |**Как есть**  - без предварительной обработки\\ **Дельта ​(скорость в секунду)** - вычислять значение как ​(**значение**-**пред_значение**)/(**время**-**пред_время**), где\\ //значение// - текущее значение\\ //пред_значение// - ранее полученное значение\\ //время// - текущий штамп времени\\ //пред_время// - штамп времени предыдущего значения\\ Эта настройка крайне полезна при получении скорость в секунду для постоянно увеличивающегося значения.\\ //Обратите внимание//: Если текущее значение меньше чем предыдущее значение, Zabbix ​отбрасывает эту разницу ​(ничего не записываети ждет следующее значениеЭто помогает работать правильнонапримерс переполнением ​32-битных счетчиков ​SNMP.\\ **Дельта ​(простое изменение)** - вычислять значение как ​(**значение**-**пред_значение**), где\\ //значение// - текущее значение\\ //пред_значение// - ранее полученное значение
-|//​Хранение значения// ​ |**As is**  - no pre-processing\\ **Delta (speed per second)** - evaluate value as (**value**-**prev_value**)/(**time**-**prev_time**), where\\ //value// - current value\\ //value_prev// - previously received value\\ //time// - current timestamp\\ //prev_time// - timestamp of previous value\\ This setting is extremely useful to get speed per second for a constantly growing value.\\ //Note//: If current value is smaller than the previous value, Zabbix ​discards that difference ​(stores nothingand waits for another valueThis helps to work correctly withfor instancea wrapping (overflow) of 32-bit SNMP counters.\\ **Delta (simple change)** - evaluate as (**value**-**prev_value**), where\\ //value// - current value\\ //value_prev// - previously received value+|//​Отображение значения// ​ |Применение преобразования значений к этому элементу данныхПреобразование значений не меняет полученные значенияон работает только для отображаемых данных.\\ Преобразования значений работают только с целыми числовыми элементами данных.\\ Например,​ "​Windows service states"​.| 
-|//​Отображение значения// ​ |Apply value mapping to this itemValue mapping does not change received valuesit is for displaying data only.\\ It works with integer items only.\\ Например,​ "​Windows service states"​.| +|//​Формат времени журнала// ​ |Доступно только для элементов данных типа **Журнал**. Поддерживаемые значения:​\\ ​    * **y**: //Год (0001-9999)//​\\ ​    * **M**: //​Месяц (01-12)//​\\ ​    * **d**: //День (01-31)//​\\ ​    * **h**: //Час (00-23)//​\\ ​    * **m**: //​Минута (00-59)//​\\ ​    * **s**: //​Секунда (00-59)//​\\ ​    Если оставить это поле пустым,​ то штамп времени не будет обрабатываться.\\ Напримеррассмотрим следующую строку из файла журнала ​Zabbix ​агента:\\ " 23480:​20100328:​154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."​\\ ​Она начинается с шести символов ​PID, далее датавремя и остальная часть строки.\\ Формат времени журнала для этой строки должен быть ​"​pppppp:​yyyyMMdd:​hhmmss"​.\\ ​Обратите внимание,​ что символы ​"​p" ​и ":" ​являются лишь заменителями и могут быть чем угодно,​ кроме ​"​yMdhms"​. ​
-|//​Формат времени журнала// ​ |Доступно только для элементов данных типа **Журнал**. Поддерживаемые значения:​\\ ​    * **y**: //Год (0001-9999)//​\\ ​    * **M**: //​Месяц (01-12)//​\\ ​    * **d**: //День (01-31)//​\\ ​    * **h**: //Час (00-23)//​\\ ​    * **m**: //​Минута (00-59)//​\\ ​    * **s**: //​Секунда (00-59)//​\\ ​    If left blank the timestamp will not be parsed.\\ For exampleconsider the following line from the Zabbix ​agent log file:\\ " 23480:​20100328:​154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."​\\ ​It begins with six character positions for PID, followed by datetime, and the rest of the line.\\ Log time format for this line would be "​pppppp:​yyyyMMdd:​hhmmss"​.\\ ​Note that "​p" ​and ":" ​chars are just placeholders and can be anything but "​yMdhms"​. | +|//​Новая группа элементов данных// ​ |Введите имя новой группы элементов данных для этого элемента данных.  ​|  
-|//​Группы элементов данных// ​ |Соединение элемента данных с одним или несколькими группами элементов данных.| +|//​Группы элементов данных// ​ |Соединение элемента данных с одним или несколькими существующими группами элементов данных.| 
-|//​Заполнение поля\\ инвентаря узла сети// |Вы можете выбрать поле инвентарных данных,​ которое будет заполнено значением элемента данных. Это будет работать,​ если для узла сети включено автоматическое заполнение [[:ru:2.0:​manual:​config:​hosts:​inventory|интентарных данных]].|+|//​Заполнение поля\\ инвентаря узла сети// |Вы можете выбрать поле инвентарных данных,​ которое будет заполнено значением элемента данных. Это будет работать,​ если для узла сети включено автоматическое заполнение [[ru:​manual:​config:​hosts:​inventory|интентарных данных]].|
 |//​Описание//​ |Введите описание элемента данных. | |//​Описание//​ |Введите описание элемента данных. |
-|//Группа// |Если вы выберите группу узлов сети и нажмете ​//Сделать//, то элемент данных будет ​добавлен к узлам сети в этой группе узлов сети. |+|//Состояние//  |**Активирован** - элемент данных будет обработан.\\ **Деактивирован** - элемент данных отключен. Этот элемент данных не будет обрабатываться.\\ **Не поддерживается** - элемент не поддерживается 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/1.8/manual/web_interface/administration#​разное|разделе Администрирования]].+Элемент данных может стать неподдерживаемым,​ если его значение не было получено по каким-то причинам. Такие элементы данных будут перепроверены через определенный интервал времени,​ настраиваемый в [[ru:manual:web_interface:​frontend_sections:​administration:general#остальные_параметры|разделе Администрирования]].