ru:manual:discovery:low_level_discovery

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
Next revision Both sides next revision
ru:manual:discovery:low_level_discovery [2018/06/21 06:17]
127.0.0.1 external edit
ru:manual:discovery:low_level_discovery [2019/12/03 09:49]
127.0.0.1 external edit
Line 15: Line 15:
  
 Когда сервер получает значение элемента данных обнаружения,​ он смотрит на пару макрос -> значение и для каждой пары создает реальные элементы данных,​ триггеров и графиков,​ основанных на их прототипах. В приведенном выше примере с "​net.if.discovery",​ сервер будет создавать один набор элементов данных,​ триггеров и графиков для локального интерфейса "​lo"​ и другой набор для интерфейса "​eth0"​. Когда сервер получает значение элемента данных обнаружения,​ он смотрит на пару макрос -> значение и для каждой пары создает реальные элементы данных,​ триггеров и графиков,​ основанных на их прототипах. В приведенном выше примере с "​net.if.discovery",​ сервер будет создавать один набор элементов данных,​ триггеров и графиков для локального интерфейса "​lo"​ и другой набор для интерфейса "​eth0"​.
 +
 +Смотрите также: [[#​обнаруженные_объекты|Обнаруженные объекты]]
  
 === Настройка низкоуровневого обнаружения === === Настройка низкоуровневого обнаружения ===
Line 34: Line 36:
 Вкладка **Правило обнаружения** содержит общие атрибуты правила обнаружения:​ Вкладка **Правило обнаружения** содержит общие атрибуты правила обнаружения:​
  
-{{manual:​discovery:​low_level_discovery:​lld_rule_fs.png|}}+{{manual:​discovery:​low_level_discovery:​lld_rule_fs.png?600|}} 
 + 
 +Все обязательные поля ввода отмечены красной звёздочкой.
  
 ^Параметр^Описание^ ​ ^Параметр^Описание^ ​
Line 40: Line 44:
 |//​Тип// ​ |Тип проверки выполняемого обнаружения;​ должен быть //Zabbix агент//​ или //Zabbix агент (активный)//​ при обнаружении файловых систем. ​ |  |//​Тип// ​ |Тип проверки выполняемого обнаружения;​ должен быть //Zabbix агент//​ или //Zabbix агент (активный)//​ при обнаружении файловых систем. ​ | 
 |//​Ключ// ​ |Элемент данных "​vfs.fs.discovery"​ уже встроен в Zabbix агент начиная с версии 2.0 для многих платформах (для получения более детальных сведений смотрите [[ru:​manual:​appendix:​items:​supported_by_platform|список поддерживаемых ключей элементов данных]]),​ который возвращает список файловых систем,​ присутствующих в компьютере,​ и их типы в формате JSON.  |  |//​Ключ// ​ |Элемент данных "​vfs.fs.discovery"​ уже встроен в Zabbix агент начиная с версии 2.0 для многих платформах (для получения более детальных сведений смотрите [[ru:​manual:​appendix:​items:​supported_by_platform|список поддерживаемых ключей элементов данных]]),​ который возвращает список файловых систем,​ присутствующих в компьютере,​ и их типы в формате JSON.  | 
-|//​Интервал обновления// ​ |Это поле задает как часто Zabbix выполняет обнаружение. В начале,​ когда вы только настраиваете обнаружение файловых систем,​ вы можете указать маленький интервал,​ но как только вы удостоверитесь что всё работает,​ вы можете установить его в 30 минут или более, потому что обычно файловые системы не меняются очень часто.\\ Поддерживаются [[:​ru/​manual/​appendix/​suffixes|суффиксы времени]],​ например 30s, 1m, 2h, 1d, начиная с Zabbix 3.4.0.\\ [[:​ru/​manual/​config/​macros/​usermacros|Пользовательские макросы]] поддерживаются начиная с Zabbix 3.4.0.\\ //​Обратите внимание//:​ Если укажите значение равное '​0',​ элемент данных не будет обрабатываться. Однако,​ если также существует переменный интервал с ненулевым значением,​ элемент данных будет обрабатываться в течении действия переменного интервала. ​ | +|//​Интервал обновления// ​ |Это поле задает как часто Zabbix выполняет обнаружение. В начале,​ когда вы только настраиваете обнаружение файловых систем,​ вы можете указать маленький интервал,​ но как только вы удостоверитесь что всё работает,​ вы можете установить его в 30 минут или более, потому что обычно файловые системы не меняются очень часто.\\ Поддерживаются [[:​ru/​manual/​appendix/​suffixes|суффиксы времени]],​ например 30s, 1m, 2h, 1d, начиная с Zabbix 3.4.0.\\ [[:​ru/​manual/​config/​macros/​usermacros|Пользовательские макросы]] поддерживаются начиная с Zabbix 3.4.0.\\ //​Обратите внимание//:​ Если укажите значение равное '​0',​ элемент данных не будет обрабатываться. Однако,​ если также существует переменный интервал с ненулевым значением,​ элемент данных будет обрабатываться в течении действия переменного интервала.\\  //​Обратите внимание//,​ что уже созданное правило обнаружение можно выполнить незамедлительно нажатием [[#​кнопки_диалога|кнопки]] //​Проверить сейчас// ​.  | 
 |//​Пользовательские интервалы// ​ |Вы можете создавать пользовательские правила проверки элемента данных:​\\ **Гибкий** - создание исключений из Интервала обновления (интервал с другой частотой обновления)\\ **По расписанию** - создание пользовательского расписания проверки.\\ Для получения более подробной информации смотрите [[ru:​manual:​config:​items:​item:​custom_intervals|Пользовательские интервалы]]. Проверка по расписанию поддерживается начиная с Zabix 3.0.0. ​ |  |//​Пользовательские интервалы// ​ |Вы можете создавать пользовательские правила проверки элемента данных:​\\ **Гибкий** - создание исключений из Интервала обновления (интервал с другой частотой обновления)\\ **По расписанию** - создание пользовательского расписания проверки.\\ Для получения более подробной информации смотрите [[ru:​manual:​config:​items:​item:​custom_intervals|Пользовательские интервалы]]. Проверка по расписанию поддерживается начиная с Zabix 3.0.0. ​ | 
-|//​Период сохранения потерянных ресурсов// ​ |Это поле позволяет вам указать как много дней обнаруженный объект будет храниться (не будет удален),​ как только его состояние обнаружения станет "Не обнаруживается ​более" (мин ​1 час, макс 25 лет).\\ Поддерживаются [[:​ru/​manual/​appendix/​suffixes|суффиксы времени]],​ например 30s, 1m, 2h, 1d, начиная с Zabbix 3.4.0.\\ [[:​ru/​manual/​config/​macros/​usermacros|Пользовательские макросы]] поддерживаются начиная с Zabbix 3.4.0.\\ //​Обратите внимание://​ Если значение равно "​0",​ объекты будут удалены сразу. Использование значения "​0"​ не рекомендуется,​ так как простое ошибочное изменение фильтра может закончится тем, что объект будет удален вместе со всеми данными истории. ​  ​| ​+|//​Период сохранения потерянных ресурсов// ​ |Это поле позволяет вам указать как много дней обнаруженный объект будет храниться (не будет удален),​ как только его состояние обнаружения станет ​%%"%%Более не обнаруживается%%"%% (от 1 часа ​до 25 лет; или %%"​%%0%%"​%%).\\ Поддерживаются [[:​ru/​manual/​appendix/​suffixes|суффиксы времени]],​ например 30s, 1m, 2h, 1d, начиная с Zabbix 3.4.0.\\ [[:​ru/​manual/​config/​macros/​usermacros|Пользовательские макросы]] поддерживаются начиная с Zabbix 3.4.0.\\ //​Обратите внимание://​ Если значение равно ​%%"%%0%%"%%, объекты будут удалены сразу. Использование значения ​%%"%%0%%"%% не рекомендуется,​ так как простое ошибочное изменение фильтра может закончится тем, что объект будет удален вместе со всеми данными истории. ​  ​| ​
 |//​Описание// ​ |Введите описание. ​ |  |//​Описание// ​ |Введите описание. ​ | 
 |//​Состояние// ​ |Если отмечено,​ правило будет обрабатываться. | |//​Состояние// ​ |Если отмечено,​ правило будет обрабатываться. |
Line 49: Line 53:
 Вкладка **Фильтры** содержит определения фильтрации правила обнаружения:​ Вкладка **Фильтры** содержит определения фильтрации правила обнаружения:​
  
-{{manual:​discovery:​low_level_discovery:​lld_rule_fs2.png|}}+{{manual:​discovery:​low_level_discovery:​lld_rule_fs2.png?600|}}
  
 ^Параметр^Описание^ ^Параметр^Описание^
 |//Тип вычисления// ​ |Доступны следующие опции расчета фильтров:​\\ **И** - должны выполниться все фильтры;​\\ **Или** - достаточно выполнения одного фильтра;​\\ **И/​Или** - используется //И// для разных имен макросов и //Или// с одинаковым именем макроса;​\\ **Пользовательское выражение** - появляется возможность указать пользовательское вычисление фильтров. Формула должна включать в себя все фильтры из списка.\\ Ограничено 255 символами. ​ | |//Тип вычисления// ​ |Доступны следующие опции расчета фильтров:​\\ **И** - должны выполниться все фильтры;​\\ **Или** - достаточно выполнения одного фильтра;​\\ **И/​Или** - используется //И// для разных имен макросов и //Или// с одинаковым именем макроса;​\\ **Пользовательское выражение** - появляется возможность указать пользовательское вычисление фильтров. Формула должна включать в себя все фильтры из списка.\\ Ограничено 255 символами. ​ |
-|//​Фильтры// ​ | Фильтр можно использовать только для генерирования реальных элементов данных,​ триггеров и графиков конкретных файловых систем. Ожидается использование [[https://​ru.wikipedia.org/​wiki/​PCRE|Perl Compatible Regular Expression]] (PCRE). Например,​ если вы заинтересованы только в файловых системах C:, D: и E:, вы можете поместить {#FSNAME} в поле "​Макрос"​ и регулярное выражение <​nowiki>"​^C|^D|^E"</​nowiki>​ в текстовые поля "​Регулярное выражение"​. Фильтрация также возможна по типам файловых систем,​ при использовании макроса {#FSTYPE} (например,​ <​nowiki>"​^ext|^reiserfs"</​nowiki>​) и по типу диска (поддерживается только Windows агентов),​ используя макрос {#​FSDRIVETYPE} ​ (например,​ <​nowiki>"​fixed"</​nowiki>​).\\ Вы можете ввести в поле "​Регулярное выражение"​ регулярное выражение или ссылку на глобальное [[ru:​manual:​regular_expressions|регулярное выражение]].\\ Для проверки регулярного выражения вы можете использовать "grep -E", например:​ <code bash>for f in ext2 nfs reiserfs smbfs; do echo $f | grep -E '​^ext|^reiserfs'​ || echo "SKIP: $f"; done</​code>​Макрос {#​FSDRIVETYPE} на Windows поддерживается начиная с Zabbix **3.0.0**.\\ Определение нескольких фильтров поддерживается начиная с **2.4.0**.\\ Обратите внимание,​ что если какой-то макрос из фильтра пропущен в ответе,​ найденный объект будет игнорироваться. ​ |+|//​Фильтры// ​ | Фильтр можно использовать только для генерирования реальных элементов данных,​ триггеров и графиков конкретных файловых систем. Ожидается использование [[https://​ru.wikipedia.org/​wiki/​PCRE|Perl Compatible Regular Expression]] (PCRE). Например,​ если вы заинтересованы только в файловых системах C:, D: и E:, вы можете поместить {#FSNAME} в поле "​Макрос"​ и регулярное выражение <​nowiki>"​^C|^D|^E"</​nowiki>​ в текстовые поля "​Регулярное выражение"​. Фильтрация также возможна по типам файловых систем,​ при использовании макроса {#FSTYPE} (например,​ <​nowiki>"​^ext|^reiserfs"</​nowiki>​) и по типу диска (поддерживается только Windows агентов),​ используя макрос {#​FSDRIVETYPE} ​ (например,​ <​nowiki>"​fixed"</​nowiki>​).\\ Вы можете ввести в поле "​Регулярное выражение"​ регулярное выражение или ссылку на глобальное [[ru:​manual:​regular_expressions|регулярное выражение]].\\ Для проверки регулярного выражения вы можете использовать "grep -E", например:​ <code bash>for f in ext2 nfs reiserfs smbfs; do echo $f | grep -E '​^ext|^reiserfs'​ || echo "SKIP: $f"; done</​code>​Макрос {#​FSDRIVETYPE} на Windows поддерживается начиная с Zabbix **3.0.0**.\\ Определение нескольких фильтров поддерживается начиная с **2.4.0**.\\ Обратите внимание,​ что если какой-то макрос из фильтра пропущен в ответе,​ найденный объект будет игнорироваться.\\ Выпадающее меню в фильтре представлены два значения задать,​ которые можно использовать для соответствия регулярному выражению или наоборот,​ отсутствию соответствия.  |
  
 <note important>​Чтобы обнаружение сработало корректно,​ база данных Zabbix в MySQL должна быть создана чувствительной к регистру,​ если имена файловых систем различаются только по регистру.</​note>​ <note important>​Чтобы обнаружение сработало корректно,​ база данных Zabbix в MySQL должна быть создана чувствительной к регистру,​ если имена файловых систем различаются только по регистру.</​note>​
Line 60: Line 64:
    
 <​note>​История правил обнаружения не сохраняется.</​note>​ <​note>​История правил обнаружения не сохраняется.</​note>​
 +
 +== Кнопки диалога ==
 +
 +Кнопки в нижней части диалога позволяют выполнить несколько видов операций.
 +
 +|{{manual:​config:​button_add.png|}} ​ |Добавление правила обнаружения. Эта кнопка доступна только для новых правил обнаружения. ​ |
 +|{{manual:​config:​button_update.png|}} ​ |Обновление свойств правила обнаружения. Эта кнопка доступна только для уже существующих правил обнаружения. ​ |
 +|{{manual:​config:​button_clone.png|}} ​ |Создание другого правила обнаружения на основе свойств текущего правила обнанужения. ​ |
 +|{{manual:​config:​button_check_now.png|}} ​ |Выполнение немедленного обнаружения на основе правила обнаружения. Правило обнаружения должно существовать. Смотрите [[:​ru/​manual/​config/​items/​check_now|более подробную]] информацию.\\ //​Обратите внимание//,​ что когда обнаружение выполняется немедленно,​ кэш конфигурации не обновляется,​ поэтому на результат не повлияют совсем недавние изменения настроек правила обнаружения. |
 +|{{manual:​config:​button_delete.png|}} ​ |Удаление правила обнаружения. ​ |
 +|{{manual:​config:​button_cancel.png|}} ​ |тмена изменения свойств правила обнаружения. ​ |
 +
 === Прототипы элементов данных === === Прототипы элементов данных ===
  
Line 65: Line 81:
  
  
-{{manual:​discovery:​low_level_discovery:​item_prototype_fs.png|}}+{{manual:​discovery:​low_level_discovery:​item_prototype_fs1.png|}} 
 + 
 +Можно использовать [[:​ru/​manual/​config/​macros/​lld_macros|макросы]] низкоуровневого обнаружения и пользовательские [[:​ru/​manual/​appendix/​macros/​supported_by_location_user|макросы]] в настройках прототипа элементов данных и в [[:​ru/​manual/​config/​items/​item#​предобработка_значений_элемента_данных|параметрах]] предварительной обработки значений элемента данных. Обратите внимание,​ что при использовании в интервалах обновления,​ один макрос должен заполнять значение целиком. Запись нескольких макросов в значении или смешение макросов с текстом не поддерживается. 
 + 
 +<​note>​Контекстное экранирование макросов низкоуровневого обнаружения для безопасного их использования в регулярных выражениях и параметрах предварительной обработки XPath.</​note>​
  
 Специфичные для прототипов элементов данных атрибуты:​ Специфичные для прототипов элементов данных атрибуты:​
Line 113: Line 133:
 Представленные снимки экрана ниже иллюстрируют как выглядят уже обнаруженные элементы данных,​ триггера и графики в настройке узла сети. Обнаруженные объекты имеют префикс ссылку золотистого цвета, которая ведет к правилу обнаружения,​ создавшего эти объекты. Представленные снимки экрана ниже иллюстрируют как выглядят уже обнаруженные элементы данных,​ триггера и графики в настройке узла сети. Обнаруженные объекты имеют префикс ссылку золотистого цвета, которая ведет к правилу обнаружения,​ создавшего эти объекты.
  
-{{manual:​discovery:​low_level_discovery:​discovered_items.png|}}+{{manual:​discovery:​low_level_discovery:​discovered_items1.png|}}
  
-Обратите внимание,​ что обнаруженные объекты не будут созданы в случае,​ если объекты с такими же условиями уникальности уже существуют,​ например,​ элемент данных с таким же ключем или график с таким же именем.+Обратите внимание,​ что обнаруженные объекты не будут созданы в случае,​ если объекты с такими же условиями уникальности уже существуют,​ например,​ элемент данных с таким же ключом или график с таким же именем. В этом случае в веб-интерфейсе отобразится сообщений об ошибке,​ о том что правило обнаружения не смогло создать конкретные объекты. Однако,​ само правило обнаружение не станет неподдерживаемым поскольку не удалось создать некоторый объект и его пришлось пропустить. Правило обнаружения продолжит создавать/​обновлять другие объекты.
  
 Элементы данных (а также, триггеры и графики) созданые с помощью низкоуровневого правила обнаружения невозможно удалить вручную. Тем не менее, они будут удалены автоматически,​ если обнаруженный объект (файловая система,​ интерфейс и т.д.) более не обнаруживается (или более не попадает под фильтр). В этом случае они будут удалены спустя некоторое количество дней указанное в поле //​Период сохранения потерянных ресурсов//​. Элементы данных (а также, триггеры и графики) созданые с помощью низкоуровневого правила обнаружения невозможно удалить вручную. Тем не менее, они будут удалены автоматически,​ если обнаруженный объект (файловая система,​ интерфейс и т.д.) более не обнаруживается (или более не попадает под фильтр). В этом случае они будут удалены спустя некоторое количество дней указанное в поле //​Период сохранения потерянных ресурсов//​.
Line 127: Line 147:
 Объекты,​ которые содержат другие объекты,​ которые помечены на удаление,​ не будут обновлены,​ если будут изменены на уровне правила обнаружения. Например,​ триггеры на основе LLD не будут обновлены,​ если они содержат элементы данных,​ которые помечены на удаление. Объекты,​ которые содержат другие объекты,​ которые помечены на удаление,​ не будут обновлены,​ если будут изменены на уровне правила обнаружения. Например,​ триггеры на основе LLD не будут обновлены,​ если они содержат элементы данных,​ которые помечены на удаление.
  
-{{manual:​discovery:​low_level_discovery:​discovered_triggers.png|}}+{{manual:​discovery:​low_level_discovery:​discovered_triggers1.png|}}
  
-{{manual:​discovery:​low_level_discovery:​discovered_graphs.png|}}+{{manual:​discovery:​low_level_discovery:​discovered_graphs1.png|}}
  
 === Другие типы обнаружения === === Другие типы обнаружения ===