3 Откриће ниског нивоа

Преглед

Откривање ниског нивоа пружа начин за аутоматско креирање ставки, окидача и графикона за различите ентитете на рачунару. На пример, Zabbix може аутоматски да почне да прати системе датотека или мрежне интерфејсе на вашем рачунару, без потребе да ручно креирате ставке за сваки систем датотека или мрежни интерфејс. Поред тога, могуће је конфигурисати Zabbix да аутоматски уклања непотребне ентитете на основу стварних резултата периодично извршеног откривања.

Корисник може да дефинише сопствене типове откривања, под условом да прате одређени JSON протокол.

Општа архитектура процеса откривања је следећа.

Прво, корисник креира правило откривања у Прикупљање података → Шаблони, у колони Откривање. Правило откривања се састоји од (1) ставке која открива потребне ентитете (на пример, системе датотека или мрежне интерфејсе) и (2) прототипова ставки, окидача и графикона који треба да се креирају на основу вредности те ставке.

Ставка која открива потребне ентитете је као обична ставка која се види негде другде: сервер тражи од Zabbix агента (или било ког типа ставке који је подешен) вредност те ставке, агент одговара са текстуалном вредношћу. Разлика је у томе што вредност којом агент одговара треба да садржи листу откривених ентитета у JSON формату. Иако су детаљи овог формата важни само за имплементаторе прилагођених провера откривања, неопходно је знати да враћена вредност садржи листу парова макро → вредност. На пример, ставка "net.if.discovery" може вратити два пара: "{#IFNAME}" → "lo" и "{#IFNAME}" → "eth0".

Ови макрои се користе у именима, кључевима и другим пољима прототипа где се затим замењују примљеним вредностима за креирање стварних ставки, окидача, графикона или чак домаћина за сваки откривени ентитет. Погледајте комплетну листу опција за коришћење LLD макроа.

Када сервер прими вредност за ставку откривања, он прегледа парове макро → вредност и за сваки пар генерише стварне ставке, окидаче и графиконе, на основу њихових прототипова. У примеру са "net.if.discovery" изнад, сервер би генерисао један скуп ставки, окидача и графикона за интерфејс петље "lo", и други скуп за интерфејс "eth0".

Имајте на уму да је од Zabbix 4.2 формат JSON-а који враћају правила откривања ниског нивоа промењен. Више се не очекује да ће JSON садржати објекат "data". Откривање ниског нивоа ће сада прихватати нормалан JSON који садржи низ, како би се подржале нове функције као што су претходна обрада вредности ставке и прилагођене путање до вредности макроа откривања ниског нивоа у JSON документу.

Уграђени кључеви за откривање су ажурирани да би вратили низ LLD редова у корену JSON документа. Zabbix ће аутоматски издвојити макро и вредност ако поље низа користи синтаксу {#MACRO} као кључ. Све нове провере изворног откривања користиће нову синтаксу без елемената "data". Приликом обраде вредности откривања ниског нивоа, прво се налази корен (низ на $. или $.data).

Иако је елемент "data" уклоњен из свих изворних ставки везаних за откривање, ради компатибилности са уназад, Zabbix ће и даље прихватати JSON нотацију са елементом "data", иако се њена употреба не препоручује. Ако JSON садржи објекат са само једним елементом низа "data", онда ће аутоматски издвојити садржај елемента користећи JSONPath $.data. Откривање ниског нивоа сада прихвата опционе кориснички дефинисане LLD макрое са прилагођеном путањом наведеном у JSONPath синтакси.

Види такође: Откривени ентитети

Конфигурисање откривања ниског нивоа

Илустроваћемо откривање ниског нивоа на основу примера откривања система датотека.

Да бисте конфигурисали откривање, урадите следеће:

• Идите на: Прикупљање података → Шаблони или Домаћини
• Кликните на Откриће у реду одговарајући шаблон/домаћин

• Кликните на Креирај правило откривања у горњем десном углу екрана
• Попуните откриће образац правила са потребним детаљима

Discovery rule

The discovery rule form contains five tabs, representing, from left to right, the data flow during discovery:

• Discovery rule - specifies, most importantly, the built-in item or custom script to retrieve discovery data
• Preprocessing - applies some preprocessing to the discovered data
• LLD macros - allows to extract some macro values to use in discovered items, triggers, etc
• Filters - allows to filter the discovered values
• Overrides - allows to modify items, triggers, graphs or host prototypes when applying to specific discovered objects

The Discovery rule tab contains the item key to use for discovery (as well as some general discovery rule attributes):

All mandatory input fields are marked with a red asterisk.

Preprocessing

The Preprocessing tab allows to define transformation rules to apply to the result of discovery. One or several transformations are possible in this step. Transformations are executed in the order in which they are defined. All preprocessing is done by Zabbix server.

See also:

• Preprocessing details
• Preprocessing testing

Note that if the discovery rule has been applied to the host via template then the content of this tab is read-only.

Custom macros

The LLD macros tab allows to specify custom low-level discovery macros.

Custom macros are useful in cases when the returned JSON does not have the required macros already defined. So, for example:

• The native vfs.fs.discovery key for filesystem discovery returns a JSON with some pre-defined LLD macros such as {#FSNAME}, {#FSTYPE}. These macros can be used in item, trigger prototypes (see subsequent sections of the page) directly; defining custom macros is not needed;
• The vfs.fs.get agent item also returns a JSON with filesystem data, but without any pre-defined LLD macros. In this case you may define the macros yourself, and map them to the values in the JSON using JSONPath:

The extracted values can be used in discovered items, triggers, etc. Note that values will be extracted from the result of discovery and any preprocessing steps so far.

Filter

A filter can be used to generate real items, triggers, and graphs only for entities that match the criteria. The Filters tab contains discovery rule filter definitions allowing to filter discovery values:

Override

The Override tab allows setting rules to modify the list of item, trigger, graph and host prototypes or their attributes for discovered objects that meet given criteria.

Overrides (if any) are displayed in a reorderable drag-and-drop list and executed in the order in which they are defined.  To configure details of a new override, click on in the Overrides block. To edit an existing override, click on the override name. A popup window will open allowing to edit the override rule details.

All mandatory parameters are marked with red asterisks.

Configuring an operation

To configure details of a new operation, click on in the Operations block. To edit an existing operation, click on next to the operation. A popup window where you can edit the operation details will open.

Form buttons

Buttons at the bottom of the form allow to perform several operations.

Discovered entities

The screenshots below illustrate how discovered items, triggers, and graphs look like in the host's configuration. Discovered entities are prefixed with an orange link to a discovery rule they come from.

Note that discovered entities will not be created in case there are already existing entities with the same uniqueness criteria, for example, an item with the same key or graph with the same name. An error message is displayed in this case in the frontend that the low-level discovery rule could not create certain entities. The discovery rule itself, however, will not turn unsupported because some entity could not be created and had to be skipped. The discovery rule will go on creating/updating other entities.

If a discovered entity (host, file system, interface, etc) stops being discovered (or does not pass the filter anymore) the entities that were created based on it may be automatically disabled and eventually deleted.

Lost resources may be automatically disabled based on the value of the Disable lost resources parameter. This affects lost hosts, items and triggers.

Lost resources may be automatically deleted based on the value of the Delete lost resources parameter. This affects lost hosts, host groups, items, triggers, and graphs.

When discovered entities become 'Not discovered anymore', a lifetime indicator is displayed in the entity list. Move your mouse pointer over it and a message will be displayed indicating its status details.

If entities were marked for deletion, but were not deleted at the expected time (disabled discovery rule or item host), they will be deleted the next time the discovery rule is processed.

Entities containing other entities, which are marked for deletion, will not update if changed on the discovery rule level. For example, LLD-based triggers will not update if they contain items that are marked for deletion.

Other types of discovery

More detail and how-tos on other types of out-of-the-box discovery is available in the following sections:

• discovery of network interfaces;
• discovery of CPUs and CPU cores;
• discovery of SNMP OIDs;
• discovery of JMX objects;
• discovery using ODBC SQL queries;
• discovery of Windows services;
• discovery of host interfaces in Zabbix.

For more detail on the JSON format for discovery items and an example of how to implement your own file system discoverer as a Perl script, see creating custom LLD rules.