This shows you the differences between two versions of the page.
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 first, second... 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 type. See 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 conversions, if any.\\ **Numeric (unsigned)** - 64bit unsigned integer\\ **Numeric (float)** - floating point number\\ **Character** - character (string) data limited to 255 bytes\\ **Log** - log file. Must 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 0 or 1. Thus, 'TRUE' is stored as 1 and 'FALSE' is stored as 0. All values are matched in a case-insensitive way. Currently recognized values are, for:\\ //TRUE// - true, t, yes, y, up, running, enabled, available\\ //FALSE// - false, f, no, n, down, unused, disabled, unavailable\\ Additionally, any 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.| | + | |//Тип данных// |Тип данных используется для целочисленных элементов данных для определения типа ожидаемых данных.:\\ **Логический** - текстовое представление переведенное в значения 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 будет автоматически выполнять конвертацию в число.| |
- | |//Единица измерения// |If a unit symbol is set, Zabbix will add post processing to the received value and display it with the set unit postfix.\\ By default, if the raw value exceeds 1000, it is divided by 1000 and displayed accordingly. For example, if you set //bps// and receive a value of 881764, it will be displayed as 881.76 Kbps. \\ Special processing is used for **B** (byte) units, which are divided by 1024. Thus, if 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 example, if 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 example, if you receive the value as 881764 (seconds), it will be displayed as "10d 4h 56m"\\ Only 3 upper major units are shown, like "1m 15d 5h" or "2h 4m 46s". If there are no days to display, only two levels are displayed - "1m 5h" (no minutes, seconds 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"\\ Отображаются только 3 верхних основы, такие как "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.| | + | |//Интервал обновления (в сек)// |Обновление этого элемента данных каждые N секунд.\\ //Обратите внимание//: Если задан '0', элемент данных не будет обрабатываться. Однако, если существует гибкий интервал с ненулевым значением, элемент данных будет обработан в течении продолжительности гибкого интервала.| |
- | |//Интервал обновления (в сек)// |Refresh this item every N seconds.\\ //Note//: If set to '0', the item will not be polled. However, if a flexible interval also exists with a non-zero value, the 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 hours. Otherwise default update interval will be used.\\ If multiple flexible intervals overlap, the 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 database. Older 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 database. Instead of keeping long history of values, you can keep longer data of trends. | | + | |//Хранение динамики изменений\\ (в днях)// |Хранение усредненных значений (ежечасные мин, макс, сред, количество) детальной истории N дней в базе данных. Более старые данные будут удалены с помощью функцией автоматической очистки истории в базе данных.\\ //Обратите внимание:// Хранение динамики изменений недоступно для не числовых данных - символ, журнал и текст. | |
- | |//Хранение динамики изменений\\ (в днях)// |Keep aggregated (hourly min, max, avg, count) detailed history for N days in the database. Older 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 processed, however 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 nothing) and waits for another value. This helps to work correctly with, for instance, a 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 item. Value mapping does not change received values, it is for displaying data only.\\ It works with integer items only.\\ For example, "Windows service states".| | + | |//Новая группа элементов данных// |Введите имя новой группы элементов данных для этого элемента данных. | |
- | |//Формат времени журнала// |Available for items of type **Log** only. Supported 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 example, consider 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 date, time, 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 populate. This 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#остальные_параметры|разделе Администрирования]]. |