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 [2017/05/26 09:39]
dotneft
ru:manual:config:items:item [2020/01/06 06:02] (current)
dotneft
Line 1: Line 1:
-==== - #1 Создание элемента данных ====+==== 1 Создание элемента данных ====
  
 === Обзор === === Обзор ===
Line 6: Line 6:
  
   * Перейдите в: //​Настройка//​ -> //Узлы сети// ​   * Перейдите в: //​Настройка//​ -> //Узлы сети// ​
-  * Нажмите на //​Элементы данных//​ в строке узла сети+  * Нажмите на //​Элементы данных//​ в строке ​с узлом сети
   * Нажмите на //​Создать элемент данных//​ в правом верхнем углу экрана   * Нажмите на //​Создать элемент данных//​ в правом верхнем углу экрана
   * В диалоге введите параметры элемента данных   * В диалоге введите параметры элемента данных
Line 24: Line 24:
 |//​Интерфейс узла сети// |Выбор интерфейса узла сети. Это поле доступно при изменении элемента данных на уровне узла сети. | |//​Интерфейс узла сети// |Выбор интерфейса узла сети. Это поле доступно при изменении элемента данных на уровне узла сети. |
 |//Тип информации// ​ |Тип хранения данных в базе данных после всех преобразований,​ если таковые имеются.\\ **Числовой (целое положительное)** - целое 64битное число\\ **Числовой (с плавающей точкой)** - число с плавающей точкой\\ Отрицательные значения могут храниться.\\ Допустимые значения -999999999999.9999 до 999999999999.9999. \\ Начиная с Zabbix 2.2, также поддерживается получение значений в научном представлении. Например,​ 1e+7, 1e-4.\\ **Символ** - короткие текстовые данные\\ **Журнал** - длинные текстовые данные с необязательными свойствами для журналов (штамп времени,​ источник,​ важность,​ logeventid).\\ **Текст** - длинные текстовые данные\\ //​Ограничения по текстовым данным описаны в [[#​Ограничения_текстовых_данных|таблице]] ниже.// | |//Тип информации// ​ |Тип хранения данных в базе данных после всех преобразований,​ если таковые имеются.\\ **Числовой (целое положительное)** - целое 64битное число\\ **Числовой (с плавающей точкой)** - число с плавающей точкой\\ Отрицательные значения могут храниться.\\ Допустимые значения -999999999999.9999 до 999999999999.9999. \\ Начиная с Zabbix 2.2, также поддерживается получение значений в научном представлении. Например,​ 1e+7, 1e-4.\\ **Символ** - короткие текстовые данные\\ **Журнал** - длинные текстовые данные с необязательными свойствами для журналов (штамп времени,​ источник,​ важность,​ logeventid).\\ **Текст** - длинные текстовые данные\\ //​Ограничения по текстовым данным описаны в [[#​Ограничения_текстовых_данных|таблице]] ниже.// |
-|//Тип данных// ​ |Тип данных,​ используемый целочисленными элементами данных для определения типа ожидаемых данных:​\\ **Логический** - текстовое представление,​ переведенное в значения 0 или 1. Таким образом,​ '​TRUE'​ хранится как 1 и '​FALSE'​ хранится как 0. Все значения сопоставляются чувствительным к регистру способом. В данное время распознаются значения для:\\ //TRUE// - true, t, yes, y, on, up, running, enabled, available\\ //FALSE// - false, f, no, n, off, down, unused, disabled, unavailable\\ Кроме того, любое ненулевое значение считается TRUE, нулевое считается FALSE. \\ **Восьмеричный** - данные в восьмеричном формате\\ **Десятичный** - данные в десятичном формате\\ **Шестнадцатеричный** - данные в шестнадцатеричном формате\\ Zabbix будет автоматически выполнять конвертацию в числовое представление. Конвертация выполняется Zabbix сервером (даже если узел сети наблюдается через прокси)| 
 |//​Единица измерения// ​ |Если указан символ единицы измерения,​ 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.\\ Смотрите также [[#​черный_список_единиц_измерения|черный список единиц измерения]]. |
-|//Использовать пользовательский множитель//  |Если вы активируете эту ​опцию, ​все полученные ​значения ​будут умножены на целое или ​дробное число заданное в поле значения.\\ Использование этой опции ​сконвертирует полученные значения ​в KB, MBps, и т.д. в B, Bps. В противном случае Zabbix ​не сможет корректно подставить [[ru:manual:​config:​triggers:​suffixes|префиксы]] (K, M, G и т.д.).\\ Начиная с  Zabbix 2.2, также ​поддерживается научное представление. Например, ​1e+70. | +|//Интервал ​обновления//  |Получение нового значения ​по этому элементу данных каждые секунд. Максимально ​допустимый интервал обновления - 86400 секунд (1 день).\\ [[:ru/manual/appendix/suffixes|Функции времени]] поддерживаютсянапример, ​30s, 1m, 2h, 1d, начиная с Zabbix 3.4.0.\\ [[:ru/manual/config/​macros/​usermacros|Пользовательские макросы]] поддерживаются начиная с Zabbix 3.4.0.\\ //​Обратите внимание//:​ Если задано значение равное '​0',​ элемент данных не будет обрабатываться. Однако,​ если также существует пользовательский интервал (гибкий/​по расписанию) с ненулевым значением,​ элемент данных будет обработан в течении длительности пользовательского интервала.| 
-|//Интервал обновления (в сек)//  |Получение нового значения по этому элементу данных каждые N секунд.\\ //​Обратите внимание//:​ Если задано значение равное '​0',​ элемент данных не будет обрабатываться. Однако,​ если также существует пользовательский интервал (гибкий/​по расписанию) с ненулевым значением,​ элемент данных будет обработан в течении длительности пользовательского интервала.| +|//​Пользовательские интервалы// ​ |Вы можете создавать пользовательские правила проверки элемента данных:​\\ **Гибкий** - создание исключений из //​Интервала обновления//​ (интервал с другой частотой обновления)\\ **По расписанию** - создание пользовательского расписания проверки.\\ Для получения более подробной информации смотрите [[ru:​manual:​config:​items:​item:​custom_intervals|Пользовательские интервалы]].\\ [[:​ru/​manual/​appendix/​suffixes|Функции времени]] поддерживаются в поле //​Интервал//,​ например,​ 30s, 1m, 2h, 1d, начиная с Zabbix 3.4.0.\\ [[:​ru/​manual/​config/​macros/​usermacros|Пользовательские макросы]] поддерживаются начиная с Zabbix 3.4.0.\\ ​Проверка по расписанию поддерживается начиная с Zabix 3.0.0.\\ //​Обратите внимание//:​ Недоступно для активных элементов данных Zabbix агента. | 
-|//​Пользовательские интервалы// ​ |Вы можете создавать пользовательские правила проверки элемента данных:​\\ **Гибкий** - создание исключений из //​Интервала обновления//​ (интервал с другой частотой обновления)\\ **По расписанию** - создание пользовательского расписания проверки.\\ Для получения более подробной информации смотрите [[ru:​manual:​config:​items:​item:​custom_intervals|Пользовательские интервалы]]. Проверка по расписанию поддерживается начиная с Zabix 3.0.0.\\ //​Обратите внимание//:​ Недоступно для активных элементов данных Zabbix агента. | +|//​Период хранения истории// ​ |Количество дней хранения в базе данных детальной истории ​(от 1 часа до 25 лет). Более старые данные будут удалены с помощью функции автоматической очистки истории базы данных.\\ ​Хранится в секундах. [[:​ru/​manual/​appendix/​suffixes|Функции времени]] поддерживаются,​ например,​ 2h, 1d, начиная с Zabbix ​3.4.0.\\ [[:​ru/​manual/​config/​macros/​usermacros|Пользовательские макросы]] поддерживаются начиная с Zabbix 3.4.0.\\ Данное значение можно переопределить глобально в // Администрирование -> Общие -> [[ru:​manual:​web_interface:​frontend_sections:​administration:​general#​очистка_истории|Очистка истории]]//​. Если опция активирована,​ то вы увидите предупреждение:​ {{manual:​config:​override_item.png|}} \\ Рекомендуется хранить записанные значения как можно меньшее количество дней для уменьшения размера истории в базе данных. Вместо долговременного хранения истории значений,​ вы можете хранить более долгий срок данные динамики изменений.\\ Смотрите также [[:​ru/​manual/​config/​items/​history_and_trends|История и динамика изменений]]. ​ | 
-|//​Период хранения истории\\ (в днях)//  |Количество дней хранения в базе данных детальной истории. Более старые данные будут удалены с помощью функции автоматической очистки истории базы данных.\\ ​Начиная с Zabbix ​2.данное значение можно переопределить глобально в // Администрирование -> Общие -> [[ru:​manual:​web_interface:​frontend_sections:​administration:​general#​очистка_истории|Очистка истории]]//​. Если опция активирована,​ то вы увидите предупреждение:​ {{manual:​config:​override_item.png|}} \\ Рекомендуется хранить записанные значения как можно меньшее количество дней для уменьшения размера истории в базе данных. Вместо долговременного хранения истории значений,​ вы можете хранить более долгий срок данные динамики изменений.\\ Смотрите также [[:​ru/​manual/​config/​items/​history_and_trends|История и динамика изменений]]. ​ | +|//​Период хранения динамики изменений// ​ |Хранение усредненных значений (ежечасные мин, макс, сред, количество) детальной истории N дней в базе данных ​(от 1 дня до 25 лет). Более старые данные будут удалены с помощью функцией автоматической очистки истории базы данных.\\ ​Хранится в секундах. [[:​ru/​manual/​appendix/​suffixes|Функции времени]] поддерживаются,​ например,​ 24h, 1d, начиная с Zabbix ​3.4.0.\\ [[:​ru/​manual/​config/​macros/​usermacros|Пользовательские макросы]] поддерживаются начиная с Zabbix 3.4.0.\\ Данное значение можно переопределить глобально в // Администрирование -> Общие -> [[ru:manual:​web_interface:​frontend_sections:​administration:​general#​очистка_истории|Очистка истории]]//​. Если опция активирована,​ то вы увидите предупреждение:​ {{manual:​config:​override_trends.png|}} \\ //​Обратите внимание://​ Хранение динамики изменений недоступно для не числовых данных - символ,​ журнал и текст.\\ Смотрите также [[:​ru/​manual/​config/​items/​history_and_trends|История и динамика изменений]]. | 
-|//​Период хранения динамики изменений\\ (в днях)//  |Хранение усредненных значений (ежечасные мин, макс, сред, количество) детальной истории N дней в базе данных. Более старые данные будут удалены с помощью функцией автоматической очистки истории базы данных.\\ ​Начиная с Zabbix ​2.данное значение можно переопределить глобально в // Администрирование -> Общие -> [[manual:​web_interface:​frontend_sections:​administration:​general#​очистка_истории|Очистка истории]]//​. Если опция активирована,​ то вы увидите предупреждение:​ {{manual:​config:​override_trends.png|}} \\ //​Обратите внимание://​ Хранение динамики изменений недоступно для не числовых данных - символ,​ журнал и текст.\\ Смотрите также [[:​ru/​manual/​config/​items/​history_and_trends|История и динамика изменений]]. | +|//Отображение значений// ​ |Применение преобразования значений к этому элементу данных. Преобразование значений не меняет полученные ​значения, оно служит только для отображаемых данных.\\ Эта опция работает с элементами данных ​//​Числовой (целое положительное)//​, //Числовой(с плавающей точкой)// и //Символ//.\\ Например,​ "​Windows service states"​.|
-|//Хранение значений// ​ |**Как есть** ​ - без предварительной обработки\\ **Дельта (скорость в секунду)** - вычисление значений как (**значение**-**пред_значение**)/​(**время**-**пред_время**),​ где\\ //значение//​ - текущее ​значение\\ //​пред_значение//​ - ранее полученное значение\\ //время// - текущий штамп времени\\ //​пред_время// - штамп времени предыдущего ​значения\\ Эта настройка крайне полезна при получении скорости в секунду в случае постоянно увеличивающихся значений.\\ Если текущее значение меньше чем предыдущее значение,​ Zabbix ​отбрасывает эту ​разницу (ничего не записывает) и ждет следующее значение. Такое поведение помогает отрабатывать, ​например,​ переполнение 32-битных счетчиков SNMP.\\ //​Обратите внимание//: Так как результатом этого вычисления может быть число с плавающей точкой, рекомендуется использовать '​Тип информации'​ - //​Числовой (с плавающей точкой)//,​ даже если входящие значения целые положительные числа. Это особенно ​актуально для маленьких чисел где дробная часть имеет значение. Если числа с плавающей ​точкой очень большие и могут превысить длину поля в этом случае введенное значение может быть потеряно, в таком случае предлагается использовать тип ​//​Числовой (целое положительное)//​ и это отбросит только дробную часть. \\ **Дельта (простое изменение)** - вычисление значений как (**значение**-**пред_значение**),​ где\\ //​значение//​ - текущее значение\\ //​пред_значение//​ - ранее полученное значение| +
-|//Отображение значений//  |Применение преобразования значений к этому элементу данных. Преобразование значений не меняет полученные значения,​ оно служит только для отображаемых данных.\\ Работает только с целыми числовыми элементами данных.\\ Например,​ "​Windows service states"​.|+
 |//​Формат времени журнала// ​ |Доступен только для элементов данных типа **Журнал**. Поддерживаемые значения:​\\ ​    * **y**: //Год (1970-2038)//​\\ ​    * **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**: //Год (1970-2038)//​\\ ​    * **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"​. |
 |//​Новая группа элементов данных// ​ |Введите имя новой группы элементов данных для этого элемента данных. ​ |  |//​Новая группа элементов данных// ​ |Введите имя новой группы элементов данных для этого элемента данных. ​ | 
 |//​Группы элементов данных// ​ |Соединение элемента данных с одним или несколькими существующими группами элементов данных.| |//​Группы элементов данных// ​ |Соединение элемента данных с одним или несколькими существующими группами элементов данных.|
-|//​Заполнение поля\\ инвентаря узла сети// |Вы можете выбрать поле инвентарных данных,​ которое будет заполняться значением элемента данных. Функция будет работать,​ если у узла сети включено автоматическое заполнение [[:​ru:​manual:​config:​hosts:​inventory|интентарных данных]].|+|//​Заполнение поля\\ инвентаря узла сети// |Вы можете выбрать поле инвентарных данных,​ которое будет заполняться значением элемента данных. Функция будет работать,​ если у узла сети включено автоматическое заполнение [[:​ru:​manual:​config:​hosts:​inventory|инвентарных данных]].|
 |//​Описание//​ |Введите описание элемента данных. | |//​Описание//​ |Введите описание элемента данных. |
 |//​Активировано// ​ |Отметьте для активации элемента данных,​ таким образом он будет обрабатываться. | |//​Активировано// ​ |Отметьте для активации элемента данных,​ таким образом он будет обрабатываться. |
 +
 +<​note>​Уникальные поля по типам элементов данных описаны на [[itemtypes|соответствующих страницах]].</​note>​
  
 <​note>​При редактировании элемента данных уровня [[ru:​manual:​config:​templates|шаблона]] на уровне узла сети, некоторое количество полей доступно только для чтения. Вы можете воспользоваться ссылкой из заголовка диалога и перейти на уровень шаблона и отредактировать элемент данных там, однако имейте в виду, что изменение элемента данных коснется всех узлов сети к которым присоединен шаблон.</​note>​ <​note>​При редактировании элемента данных уровня [[ru:​manual:​config:​templates|шаблона]] на уровне узла сети, некоторое количество полей доступно только для чтения. Вы можете воспользоваться ссылкой из заголовка диалога и перейти на уровень шаблона и отредактировать элемент данных там, однако имейте в виду, что изменение элемента данных коснется всех узлов сети к которым присоединен шаблон.</​note>​
  
-<note tip>​Если вы используете пользовательский множитель или ​хранение значения ​как //Дельта (скорость в секунду)//​ у элементов данных с типом информации ​ //​Числовой елое положительное)// и результат вычисляемого ​значения в действительности дробное число, тогда вычисленное ​значение все еще ​будет считаться корректным, будет отрезана дробная часть и значение запишется как целое.</​note>​+=== Ограничения текстовых данных === 
 + 
 +Ограничения ​текстовых данных ​зависят от выбранной базы данных. Перед сохранением текстовых значений в базу ​данныхэти значения обрезаются ​в соотвествии с ограничением ​типа значений в базе данных:
  
-== Ограничения текстовых данных ==  
-Ограничения текстовых данных зависят от выбранной базы данных:​ 
 ^ База данных ^  Тип информации ​ ^^^ ^ База данных ^  Тип информации ​ ^^^
 ^ ::: ^ Символ ​  ^ Журнал (лог) ​            ^ Текст ​            ^ ^ ::: ^ Символ ​  ^ Журнал (лог) ​            ^ Текст ​            ^
-Mysql      | 255 символов | 65536 байт ​     | 65536 байт ​     | +MySQL      | 255 символов | 65536 байт ​     | 65536 байт ​     | 
-Postgresql ​| 255 символов | 65536 символов | 65536 символов |+PostgreSQL ​| 255 символов | 65536 символов | 65536 символов |
 | Oracle ​    | 255 символов | 65536 символов | 65536 символов | | Oracle ​    | 255 символов | 65536 символов | 65536 символов |
 | DB2        | 255 байт ​     | 2048 байт ​      | 2048 байт ​      | | DB2        | 255 байт ​     | 2048 байт ​      | 2048 байт ​      |
  
-== Черный список единиц измерения ==+=== Черный список единиц измерения ​===
  
 По умолчанию,​ указывая единицу измерения элементу данных,​ вы увидите добавленный префикс множителя - например,​ значение 2048 с единицой измерения B будет отображаться как 2КБ. Имеется несколько предопределенных,​ добавленных в код, единиц измерения,​ которые защищены от отображения данных с префиксом:​ По умолчанию,​ указывая единицу измерения элементу данных,​ вы увидите добавленный префикс множителя - например,​ значение 2048 с единицой измерения B будет отображаться как 2КБ. Имеется несколько предопределенных,​ добавленных в код, единиц измерения,​ которые защищены от отображения данных с префиксом:​
Line 64: Line 63:
 Обратите внимание,​ что **rpm** строки (//rpm// и //RPM//) внесены в черный список,​ и в нижнем регистре,​ и в верхнем. Обратите внимание,​ что **rpm** строки (//rpm// и //RPM//) внесены в черный список,​ и в нижнем регистре,​ и в верхнем.
  
-=== Item value peprocessing ​===+=== Предобработка значений элемента данных ​===
  
-The **Preprocessing** tab allows to define transformation rules for the received valuesOne or several transformations are possible before saving values to the databaseTransformations are executed in the order in which they are definedAll preprocessing is done by Zabbix ​server.+Вкладка ​**Предобработка** позволяет задать правила преобразования полученных значенийМожно использовать одно или несколько правил предобработки до сохранения значений в базу данныхПреобразования выполняются в том порядке,​ в котором они были добавленыВся предобработка выполняется ​Zabbix ​сервером. 
 + 
 +Смотрите также: [[:​ru/​manual/​appendix/​items/​preprocessing|Детальная информация по предварительной обработке]]
  
 {{manual:​config:​item2.png|}} {{manual:​config:​item2.png|}}
  
-^Transformation^Description^ +<note>Элемент данных станет ​[[:ru/manual/config/items/​item#​неподдерживаемые_элементы_данных|неподдерживаемым]], если какой-либо из шагов предобработки завершится с ошибкой.</note>
-|//Regular expression// ​ |Match the value to the <patternregular expression and replace value with <​output>​. The regular expression supports extraction of maximum 10 captured groups with the \N sequence.\\ Parameters:​\\ **pattern** - regular expression\\ **output** - output formatting template. An \N (where N=1…9) escape sequence is replaced with the Nth matched group. ​ | +
-|//​Trim// ​ |Remove specified characters from the beginning and end of the value. ​ | +
-|//Right trim// ​ |Remove specified characters from the end of the value. ​ | +
-|//Left trim// ​ |Remove specified characters from the beginning of the value. ​ | +
-|//Custom multiplier// ​ |Multiply the value by the specified integer or floating-point value.\\ Use this option to convert values received in KB, MBps, etc into B, Bps. Otherwise Zabbix cannot correctly set [[:manual/appendix/suffixes|prefixes]] (KM, G etc).\\ Starting with Zabbix 2.2, using scientific notation is also supported. E.g. 1e+70. ​ | +
-|//Simple change// ​ |Calculate difference between the current and previous value.\\ Evaluated as **value**-**prev_value**,​ where\\ //value// - current value; //​prev_value//​ - previously received value\\ Only one change operation per item is allowed | +
-|//Change per second// ​ |Calculate the value change (difference between the current and previous value) speed per second.\\ Evaluated as (**value**-**prev_value**)/​(**time**-**prev_time**),​ where\\ //value// - current value; //​prev_value//​ - 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. 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.\\ //Note//: As this calculation may produce floating point numbers, it is recommended to set the 'Type of information'​ to //Numeric (float)//, even if the incoming raw values are integers. This is especially relevant for small numbers where the decimal part matters. If the floating point values are large and may exceed the '​float'​ field length in which case the entire value may be lost, it is actually suggested to use //Numeric (unsigned)//​ and thus trim only the decimal part.\\ Only one change operation per item is allowed. ​ | +
-|//Boolean to decimal// ​ |Convert the value from boolean format to decimal. Textual representation is 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, on, up, running, enabled, available\\ //FALSE// - false, f, no, n, off, down, unused, disabled, unavailable\\ Additionally,​ any non-zero numeric value is considered to be TRUE and zero is considered to be FALSE. ​  | +
-|//Octal to decimal// ​ |Convert the value from octal format to decimal. ​ | +
-|//​Hexadecimal to decimal// ​ |Convert the value from hexadecimal format to decimal. ​ |+
  
-<note tip>If you use a custom multiplier or store value as //Change per second// for items with the type of information set to //Numeric ​(unsigned)// and the resulting calculated ​value is actually a float number, ​the calculated ​value is still accepted as correct one by trimming the decimal part and storing the value as integer.</​note>​+^Преобразование^Описание^ 
 +|//​Регулярное выражение// ​ |Совпадение значения с регулярным выражением ​<шаблонаи замена значения в соответствии с <​выводом>​. Регулярное выражение поддерживает извлечение до 10 захваченных групп в \N последовательности. Элемент данных станет неподдерживаемым в случае ошибки при поиске соответствия во входящем значении.\\ Параметры:​\\ **шаблон** - регулярное выражение\\ **вывод** - шаблон форматирования вывода. \N (где N=1..9) - управляющая последовательность заменяется N-нной совпадающей группой. Управляющая последовательность \0 заменяется совпадающим текстом\\ Поддерживается начиная с 3.4.0. \\ Пожалуйста,​ обратитесь в разделу [[ru:​manual:​regular_expressions#​пример|регулярных выражений]] для ознакомления с некоторыми существующими примерами. ​ | 
 +|//Обрезка//  ​|Удаление указанных символов с начала или конца значения. ​ | 
 +|//Обрезка справа// ​ |Удаление указанных символов с конца значения. ​ | 
 +|//​Обрезка слева// ​ |Удаление указанных символов с начала значения. ​ | 
 +|//XML XPath// ​ |Извлечение значения или фрагмента из XML данных с использованием XPath функционала.\\ Чтобы эта опция заработала,​ Zabbix сервер необходимо скомпилировать с поддержкой libxml.\\ Примеры:​\\ ''​number(/document/​item/value)''​ извлечёт ''​10''​ из ''<​document><​item><​value>​10</​value></​item></​document>''​\\ ''​number(/​document/​item/​@attribute)''​ извлечёт ''​10''​ из ''<​nowiki><​document><​item attribute="​10"></​item></​document></​nowiki>''​\\ ''/​document/​item''​ извлечёт ''<​item><​value>​10</​value></​item>''​ из ''<​document><​item><​value>​10</​value></​item></​document>''​\\ Обратите внимание на точто пространства имен не поддерживаются.\\ Поддерживается начиная с 3.4.0. ​ | 
 +|//JSON Path// ​ |Извлечение значения или фрагмента с JSON данных с использованием простейшего набора возможностей JSONPath функционала.\\ JSONPath можно указывать,​ используя обозначение через точку:​\\ ''​$.document.item[0].value''​\\ или обозначение со скобками:​\\ ''​$['​document'​]['​item'​][0]['​value'​]''​\\ Первое,​ обозначение через точку можно использовать только,​ если имена объектов состоят из букв и цифр + символов подчёркивания:​\\ ''​$.document.item_0.value''​\\ Если имя объекта содержит другие символы,​ например,​ пробелы,​ прочерки,​ вам нужно использовать обозначение со скобками:​\\ ''​$['​document'​]['​item 0'​]['​value-0'​]''​\\ Допускается смешивание обоих видов обозначений:​\\ ''​$.document['​item'​][0].value''​\\ В обоих видах обозначений поддерживаются только прямые пути к одиночным объектам.\\ Извлечение нескольких значений не поддерживается.\\ Ещё примеры:​\\ ''​$.document.item.value''​ извлечёт ''​10''​ из ''<​nowiki>​{"​document":​{"​item":​{"​value":​ 10}}}</​nowiki>''​\\ ''​$.document.item''​ извлечёт ''<​nowiki>​{"​value":​ 10}</​nowiki>''​ из ''<​nowiki>​{"​document":​{"​item":​{"​value":​ 10}}}</​nowiki>''​\\ ''​$['​document'​].item.value''​ извлечёт ''​10''​ из ''<​nowiki>​{"​a document":​{"​item":​{"​value":​ 10}}}</​nowiki>''​\\ ''​$.document.items[1].value''​ извлечёт ''​20''​ из ''<​nowiki>​{"​document":​{"​items":​[{"​value":​ 10}, {"​value":​ 20}]}}</​nowiki>''​\\ Поддерживается начиная с 3.4.0. ​ | 
 +|//​Пользовательский множитель// ​ |Умножение значения на заданное целое или дробное число.\\ Использование этой опции сконвертирует полученные значения в KB, MBps, и т.д. в B, Bps. В противном случае Zabbix не сможет корректно подставить [[:​ru/​manual/​appendix/​suffixes|префиксы]] (K, M, G и т.д.).\\ Начиная с  Zabbix 2.2, также поддерживается научное представление. Например,​ 1e+70. ​ | 
 +|//​Простое изменение// ​ |Вычисление разницы между текущим и предыдущим значениями.\\ Вычисляется **значение**-**пред_значение**,​ где\\ //​значение//​ - текущее значение;​ //​пред_значение//​ - ранее полученное значение\\ Эта опция может быть полезной для измерения постоянно растущего значения. Если текущее значение меньше предыдущего,​ тогда Zabbix отбрасывает это изменение (ничего не записывает) и ждет следующего значения.\\ На один элемент данных разрешена только одна операция изменения. ​ | 
 +|//​Изменение в секунду// ​ |Вычисление изменения значения (разница между текущим и предыдущим значениями) скорость в секунду.\\ Вычисляется (**значение**-**пред_значение**)/​(**время**-**пред_время**),​ где\\ //​значение//​ - текущее значение;​ //​пред_значение//​ - ранее полученное значение;​ //​Время//​ - текущий штамп времени;​ //​пред_значение//​ - штамп времени предыдущего значения.\\ Эта настройка крайне полезна при получении скорости в секунду в случае постоянно увеличивающихся значений. Если текущее значение меньше чем предыдущее значение,​ Zabbix отбрасывает эту разницу (ничего не записывает) и ждет следующее значение. Такое поведение помогает отрабатывать,​ например,​ переполнение 32-битных счетчиков SNMP.\\ //​Обратите внимание//:​ Так как результатом этого вычисления может быть число с плавающей точкой,​ рекомендуется использовать '​Тип информации'​ - //​Числовой (с плавающей точкой)//,​ даже если входящие значения целые положительные числа. Это особенно актуально для маленьких чисел где дробная часть имеет значение. Если числа с плавающей точкой очень большие и могут превысить длину поля в этом случае введенное значение может быть потеряно,​ в таком случае предлагается использовать тип //​Числовой (целое положительное)//​ и это отбросит только дробную часть.\\ На один элемент данных разрешена только одна операция изменения. ​ | 
 +|//​Двоичное в десятичное// ​ |Конвертация значения из логического в десятичный формат. Текстовое представление переводится в значения 0 или 1. Таким образом,​ '​TRUE'​ хранится как 1 и '​FALSE'​ хранится как 0. Все значения сопоставляются чувствительным к регистру способом. В данное время распознаются значения для:\\ //TRUE// - true, t, yes, y, on, up, running, enabled, available\\ //FALSE// - false, f, no, n, off, down, unused, disabled, unavailable\\ Кроме того, любое ненулевое значение считается TRUE, нулевое считается FALSE. ​  | 
 +|//​Восьмеричное в десятичное// ​ |Конвертация значения из восьмеричного в десятичный формат. ​ | 
 +|//​Шестнадцатеричное в десятичное// ​ |Конвертация значения из шестнадцатеричного в десятичный формат.\\ Смотрите также: известные проблемы для [[:​ru/​manual/​installation/​known_issues#​известные_проблемы_для_340_-_3413|3.4.0-3.4.13]]. ​ | 
 + 
 +<note tip>​Если вы используете пользовательский множитель или хранение значений как //​Изменение в секунду//​ у элементов данных с типом информации //​Числовой (целое положительное)//​ и результирующее вычисленное значение в действительности дробное число, тогда вычисленное значение всё же будет считаться приемлемым,​ однако дробная часть будет обрезана и значение запишется как целое положительное.</​note>​
  
 === Неподдерживаемые элементы данных === === Неподдерживаемые элементы данных ===
  
 Элемент данных может стать неподдерживаемым,​ если его значение не было получено по некоторым причинам. Такие элементы данных будут перепроверены через определенный интервал времени,​ настраиваемый в [[ru:​manual:​web_interface:​frontend_sections:​administration:​general#​остальные_параметры|разделе Администрирования]]. Элемент данных может стать неподдерживаемым,​ если его значение не было получено по некоторым причинам. Такие элементы данных будут перепроверены через определенный интервал времени,​ настраиваемый в [[ru:​manual:​web_interface:​frontend_sections:​administration:​general#​остальные_параметры|разделе Администрирования]].
 +
 +Неподдерживаемые элементы данных отображаются со статусом НЕ ПОДДЕРЖИВАЕТСЯ.