ru:manual:config:items:item

Differences

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

Link to this comparison view

Next revision
Previous revision
ru:manual:config:items:item [2012/05/01 06:09]
dotneft created
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|}}
  
 Атрибуты элемента данных:​ Атрибуты элемента данных:​
  
 ^Параметр^Описание^ ^Параметр^Описание^
-|//Узел сети// |Select the host or template. | +|//Узел сети// |Выберите узел сети ​или шаблон. | 
-|//Интерфейс узла сети// |Select the host interface. This field is available when editing an item on the host level. | +|//​Имя// ​ |Это, как элемент данных будет называться.\\ Могут быть использованы следующие макросы:\\ **$1, $2...$9** - ссылки на первыйвторой... девятый параметры из ключа элемента данных\\ Например: Free disk space on $1\\ Если ключ элемента данных ​"​vfs.fs.size[/,​free]", ​описание будет автоматически изменено на "Free disk space on /" | 
-|//​Имя// ​ |This is how the item will be named.\\ The following macros can be used:\\ **$1, $2...$9** - referring to the firstsecond... ninth parameter of the item key\\ For example: Free disk space on $1\\ If the item key is "​vfs.fs.size[/,​free]", ​the description will automatically change to "Free disk space on /" | +|//​Тип// ​ |Тип элемента данныхСмотрите отдельные разделы по [[itemtypes|типам элементов данных]].| 
-|//​Тип// ​ |Item typeSee individual ​[[2.0:​manual:​config:​items:​itemtypes|item type]] sections.| +|//​Ключ// ​ |Ключ элемента данных.\\ Поддерживаемые ​[[itemtypes|ключи элементов данных]] могут быть найдены в отдельных разделах по типам элементов данных.\\ Ключ должен быть уникальным в пределах одного узла сети.\\ Если тип ключа ​'​Zabbix ​агент', '​Zabbix ​агент ​(активный)', 'Простая проверка' ​или ​'​Zabbix ​агрегированный', ​то значение ключа должно поддерживаться ​Zabbix ​агентом или ​Zabbix ​сервером.\\ Смотрите такжекорректный ​[[ru:​manual:​config:​items:​item:​key|формат ключа]].  ​
-|//​Ключ// ​ |Item key.\\ [[2.0:​manual:​config:​items:​itemtypes|The supported item keys]] can be found in individual item type sections.\\ The key must be unique within a single host.\\ If key type is '​Zabbix ​agent', '​Zabbix ​agent (active)', 'Simple check' ​or '​Zabbix ​aggregate', ​the key value must be supported by Zabbix ​agent or Zabbix ​server.\\ See also: [[2.0:​manual:​config:​items:​item:​key|the correct key format]].  | +|//​Интерфейс узла сети// |Выберите интерфейс узла сети. Это поле доступно при редактировании элемента данных на уровне узла сети. ​
-|//Тип информации// ​ |Type of data as stored in the database after performing conversionsif any.\\ **Numeric ​(unsigned)** - 64bit unsigned integer\\ **Numeric ​(float)** - floating point number\\ **Character** - character ​(stringdata limited to 255 bytes\\ **Log** - log fileMust be set for keys log[].\\ **Text** - text of unlimited size+|//Тип информации// ​ |Тип хранения данных в базе данных после выполнения преобразованийесли таковые имеются.\\ **Числовой ​(целое положительное)** - целое 64битное число\\ **Числовой ​(с плавающей точкой)** - число с плавающей точкой\\ **Символ** - символьные ​(строкаданные ограниченные ​255 байтами\\ **Журнал** - файл журналаДолжен быть задан для ключей ​log[].\\ **Текст** - текст с неограниченной длиной
-|//Тип данных// ​ |Data type is used for integer items in order to specify the expected data type:\\ **Boolean** - textual representation translated into either ​or 1. Thus, '​TRUE' ​is stored as 1 and '​FALSE' ​is stored as 0. All values are matched in a case-insensitive wayCurrently recognized values are, for:\\ //TRUE// - true, t, yes, y, up, running, enabled, available\\ //FALSE// - false, f, no, n, down, unused, disabled, unavailable\\ ​Additionallyany non-zero numeric value is considered to be TRUE and zero is considered to be FALSE. \\ **Octal** - data in octal format\\ **Decimal** - data in decimal format\\ **Hexadecimal** - data in hexadecimal format\\ Zabbix ​will automatically perform conversion to numeric.| +|//Тип данных// ​ |Тип данных используется для целочисленных элементов данных для определения типа ожидаемых данных.:\\ **Логический** - текстовое представление переведенное в значения ​или ​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 ​будет автоматически выполнять конвертацию в число.| 
-|//​Единица измерения// ​ |If a unit symbol is set, Zabbix ​will add post processing to the received value and display it with the set unit postfix.\\ By defaultif the raw value exceeds ​1000, it is divided by 1000 and displayed accordinglyFor exampleif you set //​bps// ​and receive a value of 881764, ​it will be displayed as 881.76 Kbps. \\ Special processing is used for **B** (byteunitswhich are divided by 1024. Thusif units are set to **B**, Zabbix ​will display:\\ 1 as 1B\\ 1024 as 1KB\\ 1536 as 1.5KB\\ ​Special processing is used if the following time-related units are used:\\ **unixtime** - translated to "​yyyy.mm.dd hh:​mm:​ss"​\\ **uptime** - translated to "​hh:​mm:​ss" ​or "N days, hh:​mm:​ss"​\\ ​For exampleif you receive the value as 881764 (seconds), it will be displayed as "​10 ​days, 04:​56:​04"​\\ **s** - translated to "yyy mmm ddd hhh mmm sss ms"; ​parameter is treated as number of seconds.\\ For exampleif you receive the value as 881764 (seconds), it will be displayed as "10d 4h 56m"​\\ ​Only upper major units are shownlike "1m 15d 5h" ​or "2h 4m 46s"​. ​If there are no days to displayonly two levels are displayed ​- "1m 5h" (no minutesseconds or milliseconds are shown). Will be translated to "< 1 ms" ​if the value is less than 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"​\\ ​Отображаются только ​верхних основытакие как ​"1м 15д 5ч" ​или ​"2ч 4м 46с"​. ​В случаеесли нет дней, то тогда отображаются только два уровня ​- "1м 5ч" (минутсекунд или миллисекунд не будут показаны). Будет переведено в "< 1 ms", если значение меньше чем ​0.001.\\ Смотрите также [[#​черный_список_единиц_измерения|черный список единиц измерения]]. | 
-|//​Использовать множитель// ​ |Pre-process received values.\\ **Do not use** - do not pre-process received values\\ **Custom multiplier** - multiply received values by value defined in //Custom multiplier//​\\ Use this option to convert values received in KB, MBps, etc into B, Bps. Otherwise ​Zabbix ​cannot correctly set [[:2.0/manual/config/triggers/suffixes|prefixes]] (K, M, G etc).| +|//​Использовать ​пользовательский ​множитель// ​ |Если вы активируете эту опцию, все полученные значения будут умножены на целое или дробное число заданное в поле значения.\\ Использование этой опции сконвертирует полученные значения в KB, MBps, и т.д. в B, Bps. В противном случае ​Zabbix ​не сможет корректно установить ​[[ru:manual:config:triggers:suffixes|префиксы]] (K, M, G и т.д.).| 
-|//​Пользовательский множитель// ​ |Multiply all received value by this integer or floating-point value.| +|//​Интервал обновления (в сек)// ​ |Обновление этого элемента данных каждые ​секунд.\\ //Обратите внимание//: Если задан ​'​0', ​элемент данных не будет обрабатыватьсяОднакоесли существует гибкий интервал с ненулевым значениемэлемент данных будет обработан в течении продолжительности гибкого интервала.| 
-|//​Интервал обновления (в сек)// ​ |Refresh this item every seconds.\\ //Note//: If set to '​0', ​the item will not be polledHoweverif a flexible interval also exists with a non-zero valuethe item will be polled during the flexible interval duration.| +|//​Переменные интервалы// ​ | Вы можете создавать исключения для ​//Интервал обновления//. Например:\\ Интервал: **10**, ​Период: **1-5,​09:​00-18:​00** - в рабочие часы будет задано обновление каждые ​10 секундВ остальных случаях будет использован интервал обновления по умолчанию.\\ Если несколько гибких интервалов перекрываютсято используется наименьшее значение ​//Интервал// для перекрывающегося периода.\\ Смотрите страницу об установке ​[[ru:manual:appendix:​time_period|периодов времени]] для получения информации о формате поля ​//Период//.\\ //Обратите внимание//: Если задан ​'​0', ​элемент данных не будет обрабатываться в течении гибкого интервала времени и вернется в обработку согласно ​//Интервал обновления//, как только период гибкого интервала завершится.\\ //​Возьмите на заметку//:​ Недоступно для элементов данных с типом Zabbix агент активный. | 
-|//​Переменные интервалы// ​ | You can create exceptions to //Update interval//. For example:\\ Delay: **10**, ​Period: **1-5,​09:​00-18:​00** - will set the refresh to every 10 seconds for working hoursOtherwise default update interval will be used.\\ If multiple flexible intervals overlapthe smallest ​//Delay// 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.| +|//​Хранение истории\\ (в днях)// ​ |Количество дней хранения в базе данных детальной историиБолее старые данные будут удалены с помощью функцией автоматической очистки истории в базе данных.\\ Рекомендуется хранить записанные значения как можно меньшее количество дней для уменьшения размера истории в базе данныхВместо долговременного хранения истории значенийвы можете хранить дольше данные динамики изменений.  | 
-|//​Хранение истории\\ (в днях)// ​ |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. | +|//​Хранение значения// ​ |**Как есть**  - без предварительной обработки\\ **Дельта ​(скорость в секунду)** - вычислять значение как ​(**значение**-**пред_значение**)/(**время**-**пред_время**), где\\ //значение// - текущее значение\\ //пред_значение// - ранее полученное значение\\ //время// - текущий штамп времени\\ //пред_время// - штамп времени предыдущего значения\\ Эта настройка крайне полезна при получении скорость в секунду для постоянно увеличивающегося значения.\\ //Обратите внимание//: Если текущее значение меньше чем предыдущее значение, Zabbix ​отбрасывает эту разницу ​(ничего не записываети ждет следующее значениеЭто помогает работать правильнонапримерс переполнением ​32-битных счетчиков ​SNMP.\\ **Дельта ​(простое изменение)** - вычислять значение как ​(**значение**-**пред_значение**), где\\ //значение// - текущее значение\\ //пред_значение// - ранее полученное значение
-|//Состояние//  |**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.| +|//​Отображение значения// ​ |Применение преобразования значений к этому элементу данныхПреобразование значений не меняет полученные значенияон работает только для отображаемых данных.\\ Преобразования значений работают только с целыми числовыми элементами данных.\\ Например, "​Windows service states"​.| 
-|//​Хранение значения// ​ |**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+|//​Формат времени журнала// ​ |Доступно только для элементов данных типа ​**Журнал**. Поддерживаемые значения:\\     * **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"​. ​
-|//​Отображение значения// ​ |Apply value mapping to this itemValue mapping does not change received valuesit is for displaying data only.\\ It works with integer items only.\\ For example, "​Windows service states"​.| +|//​Новая группа элементов данных// ​ |Введите имя новой группы элементов данных для этого элемента данных.  ​|  
-|//​Формат времени журнала// ​ |Available for items of type **Log** onlySupported placeholders:\\     * **y**: //Year (0001-9999)//​\\ ​    * **M**: //Month (01-12)//​\\ ​    * **d**: //Day (01-31)//​\\ ​    * **h**: //Hour (00-23)//​\\ ​    * **m**: //Minute ​(00-59)//​\\ ​    * **s**: //Second ​(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"​. | +|//​Группы элементов данных// ​ |Соединение элемента данных с одним или несколькими существующими группами элементов данных.| 
-|//​Группы элементов данных// ​ |Link item to one or more applications.| +|//Заполнение поля\\ инвентаря узла сети// |Вы можете выбрать поле инвентарных данных,​ которое будет заполнено значением элемента данныхЭто будет работать,​ если для узла сети включено автоматическое заполнение ​[[ru:​manual:​config:​hosts:​inventory|интентарных данных]].| 
-|//Item will\populate host\\ inventory field// |You can select a host inventory field that the value of item will populateThis will work if automatic ​[[:2.0:​manual:​config:​hosts:​inventory|inventory]] population is enabled for the host.| +|//​Описание//​ |Введите описание элемента данных. | 
-|//​Описание//​ |Enter an item description. | +|//Состояние// ​ |**Активирован** - элемент данных будет обработан.\\ **Деактивирован** - элемент данных отключен. Этот элемент данных не будет обрабатываться.\\ **Не ​поддерживается** - элемент не поддерживается Zabbix'​ом или SNMP агентом. Этот элемент данных не будет обрабатываться,​ однако Zabbix может периодически пытаться изменить состояние на //Активирован// в соответствии с заданным интервалом [[ru:​manual:​web_interface:​frontend_sections:​administration:​general?&#​остальные_параметры|обновления неподдерживаемых элементов данных]].|
-|//Группа// ​|If you select a host group and click on //Do// the item will be added to the hosts of that host group. |+
  
 Вы также можете создать элемент данных открыв уже существующий элемент данных,​ нажать на кнопку //​Клонировать//​ и затем сохранить под другим именем. Вы также можете создать элемент данных открыв уже существующий элемент данных,​ нажать на кнопку //​Клонировать//​ и затем сохранить под другим именем.
  
-<​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#остальные_параметры|разделе Администрирования]].