This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
ru:manual:config:items:item [2018/09/15 22:56] dotneft |
ru:manual:config:items:item [2020/01/06 06:02] (current) dotneft |
||
---|---|---|---|
Line 28: | Line 28: | ||
|//Пользовательские интервалы// |Вы можете создавать пользовательские правила проверки элемента данных:\\ **Гибкий** - создание исключений из //Интервала обновления// (интервал с другой частотой обновления)\\ **По расписанию** - создание пользовательского расписания проверки.\\ Для получения более подробной информации смотрите [[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|Пользовательские интервалы]].\\ [[: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 агента. | | ||
|//Период хранения истории// |Количество дней хранения в базе данных детальной истории (от 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|История и динамика изменений]]. | | |//Период хранения истории// |Количество дней хранения в базе данных детальной истории (от 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|История и динамика изменений]]. | | ||
- | |//Период хранения динамики изменений// |Хранение усредненных значений (ежечасные мин, макс, сред, количество) детальной истории N дней в базе данных (от 1 дня до 25 лет). Более старые данные будут удалены с помощью функцией автоматической очистки истории базы данных.\\ Хранится в секундах. [[:ru/manual/appendix/suffixes|Функции времени]] поддерживаются, например, 24h, 1d, начиная с Zabbix 3.4.0.\\ [[:ru/manual/config/macros/usermacros|Пользовательские макросы]] поддерживаются начиная с Zabbix 3.4.0.\\ Данное значение можно переопределить глобально в // Администрирование -> Общие -> [[manual:web_interface:frontend_sections:administration:general#очистка_истории|Очистка истории]]//. Если опция активирована, то вы увидите предупреждение: {{manual:config:override_trends.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|История и динамика изменений]]. | |
- | |//Отображение значений// |Применение преобразования значений к этому элементу данных. Преобразование значений не меняет полученные значения, оно служит только для отображаемых данных.\\ Работает только с целыми числовыми элементами данных.\\ Например, "Windows service states".| | + | |//Отображение значений// |Применение преобразования значений к этому элементу данных. Преобразование значений не меняет полученные значения, оно служит только для отображаемых данных.\\ Эта опция работает с элементами данных //Числовой (целое положительное)//, //Числовой(с плавающей точкой)// и //Символ//.\\ Например, "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> | ||
- | == Ограничения текстовых данных == | + | === Ограничения текстовых данных === |
Ограничения текстовых данных зависят от выбранной базы данных. Перед сохранением текстовых значений в базу данных, эти значения обрезаются в соотвествии с ограничением типа значений в базе данных: | Ограничения текстовых данных зависят от выбранной базы данных. Перед сохранением текстовых значений в базу данных, эти значения обрезаются в соотвествии с ограничением типа значений в базе данных: | ||
Line 49: | Line 52: | ||
| DB2 | 255 байт | 2048 байт | 2048 байт | | | DB2 | 255 байт | 2048 байт | 2048 байт | | ||
- | == Черный список единиц измерения == | + | === Черный список единиц измерения === |
По умолчанию, указывая единицу измерения элементу данных, вы увидите добавленный префикс множителя - например, значение 2048 с единицой измерения B будет отображаться как 2КБ. Имеется несколько предопределенных, добавленных в код, единиц измерения, которые защищены от отображения данных с префиксом: | По умолчанию, указывая единицу измерения элементу данных, вы увидите добавленный префикс множителя - например, значение 2048 с единицой измерения B будет отображаться как 2КБ. Имеется несколько предопределенных, добавленных в код, единиц измерения, которые защищены от отображения данных с префиксом: | ||
Line 67: | Line 70: | ||
{{manual:config:item2.png|}} | {{manual:config:item2.png|}} | ||
+ | |||
+ | <note>Элемент данных станет [[:ru/manual/config/items/item#неподдерживаемые_элементы_данных|неподдерживаемым]], если какой-либо из шагов предобработки завершится с ошибкой.</note> | ||
^Преобразование^Описание^ | ^Преобразование^Описание^ | ||
Line 74: | Line 79: | ||
|//Обрезка слева// |Удаление указанных символов с начала значения. | | |//Обрезка слева// |Удаление указанных символов с начала значения. | | ||
|//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. | | |//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 функционала.\\ Примеры:\\ ''$.document.item.value'' извлечёт ''10'' с ''<nowiki>{"document":{"item":{"value": 10}}}</nowiki>''\\ ''$.document.item'' извлечёт ''<nowiki>{"value": 10}</nowiki>'' с ''<nowiki>{"document":{"item":{"value": 10}}}</nowiki>''\\ ''$['a document'].item.value'' извлечёт ''10'' с ''<nowiki>{"a document":{"item":{"value": 10}}}</nowiki>''\\ ''$.document.items[1].value'' извлечёт ''20'' с ''<nowiki>{"document":{"items":[{"value": 10}, {"value": 20}]}}</nowiki>''\\ Обратите внимание, что поддерживаются только прямые пути к одиночным объектам в обозначении точкой или квадратной скобкой.\\ В JSONPath обозначении точкой ''($.a.b.c)'' можно использовать только буквенно-цифровые символы + символ подчёркивания . Если имя объекта JSON содержит другие символы, необходимо использовать обозначение квадратной скобкой ''($['a']['b']['c'])''. Допускается смешивание обозначений ''($.a['b'].c)''\\ Извлечение нескольких значений не поддерживается.\\ Поддерживается начиная с 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>''\\ ''$['a 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. | | |//Пользовательский множитель// |Умножение значения на заданное целое или дробное число.\\ Использование этой опции сконвертирует полученные значения в KB, MBps, и т.д. в B, Bps. В противном случае Zabbix не сможет корректно подставить [[:ru/manual/appendix/suffixes|префиксы]] (K, M, G и т.д.).\\ Начиная с Zabbix 2.2, также поддерживается научное представление. Например, 1e+70. | | ||
|//Простое изменение// |Вычисление разницы между текущим и предыдущим значениями.\\ Вычисляется **значение**-**пред_значение**, где\\ //значение// - текущее значение; //пред_значение// - ранее полученное значение\\ Эта опция может быть полезной для измерения постоянно растущего значения. Если текущее значение меньше предыдущего, тогда Zabbix отбрасывает это изменение (ничего не записывает) и ждет следующего значения.\\ На один элемент данных разрешена только одна операция изменения. | | |//Простое изменение// |Вычисление разницы между текущим и предыдущим значениями.\\ Вычисляется **значение**-**пред_значение**, где\\ //значение// - текущее значение; //пред_значение// - ранее полученное значение\\ Эта опция может быть полезной для измерения постоянно растущего значения. Если текущее значение меньше предыдущего, тогда Zabbix отбрасывает это изменение (ничего не записывает) и ждет следующего значения.\\ На один элемент данных разрешена только одна операция изменения. | | ||
Line 87: | Line 92: | ||
Элемент данных может стать неподдерживаемым, если его значение не было получено по некоторым причинам. Такие элементы данных будут перепроверены через определенный интервал времени, настраиваемый в [[ru:manual:web_interface:frontend_sections:administration:general#остальные_параметры|разделе Администрирования]]. | Элемент данных может стать неподдерживаемым, если его значение не было получено по некоторым причинам. Такие элементы данных будут перепроверены через определенный интервал времени, настраиваемый в [[ru:manual:web_interface:frontend_sections:administration:general#остальные_параметры|разделе Администрирования]]. | ||
+ | |||
+ | Неподдерживаемые элементы данных отображаются со статусом НЕ ПОДДЕРЖИВАЕТСЯ. |