3 Low-level discovery

Overzicht

Lage-niveau ontdekking biedt een manier om automatisch items, triggers en grafieken te maken voor verschillende entiteiten op een computer. Bijvoorbeeld, Zabbix kan automatisch starten met het monitoren van bestandssystemen of netwerkinterfaces op uw machine, zonder dat u handmatig items hoeft aan te maken voor elk bestandssysteem of netwerkinterface. Bovendien is het mogelijk om Zabbix te configureren om onnodige entiteiten automatisch te verwijderen op basis van de feitelijke resultaten van periodiek uitgevoerde ontdekkingen.

Een gebruiker kan hun eigen soorten ontdekking definiëren, mits ze een bepaald JSON-protocol volgen.

De algemene architectuur van het ontdekkingsproces is als volgt.

Ten eerste maakt een gebruiker een ontdekkingsregel aan in "Configuratie" → "Templates" → "Ontdekking" kolom. Een ontdekkingsregel bestaat uit (1) een item dat de benodigde entiteiten ontdekt (bijvoorbeeld bestandssystemen of netwerkinterfaces) en (2) prototypes van items, triggers en grafieken die moeten worden aangemaakt op basis van de waarde van dat item.

Een item dat de benodigde entiteiten ontdekt, lijkt op een gewoon item elders gezien: de server vraagt een Zabbix-agent (of welk type het item is ingesteld) om een waarde van dat item, de agent reageert met een tekstuele waarde. Het verschil is dat de waarde waarmee de agent reageert een lijst van ontdekte entiteiten in JSON-indeling moet bevatten. Hoewel de details van deze indeling alleen belangrijk zijn voor implementeerders van aangepaste ontdekkingscontroles, is het noodzakelijk om te weten dat de geretourneerde waarde een lijst bevat van macro → waarde-paren. Bijvoorbeeld, item "net.if.discovery" kan twee paren retourneren: "{#IFNAME}" → "lo" en "{#IFNAME}" → "eth0".

Deze macro's worden gebruikt in namen, sleutels en andere prototypevelden waar ze vervolgens worden vervangen door de ontvangen waarden om echte items, triggers, grafieken of zelfs hosts te maken voor elke ontdekte entiteit. Zie de volledige lijst van opties voor het gebruik van LLD-macro's.

Wanneer de server een waarde ontvangt voor een ontdekkingsitem, kijkt deze naar de macro → waarde-paren en genereert voor elk paar echte items, triggers en grafieken op basis van hun prototypes. In het bovenstaande voorbeeld met "net.if.discovery" zou de server één set items, triggers en grafieken genereren voor de loopback-interface "lo", en een andere set voor interface "eth0".

Merk op dat sinds Zabbix 4.2 het formaat van de JSON die wordt geretourneerd door lage-niveau ontdekkingsregels is gewijzigd. Er wordt niet langer verwacht dat de JSON het "data" object bevat. Lage-niveau ontdekking zal nu een normale JSON accepteren die een array bevat, om nieuwe functies zoals itemwaarde voorbewerking en aangepaste paden naar lage-niveau ontdekkingsmacrowaarden in een JSON-document te ondersteunen.

Ingebouwde ontdekkingsleutels zijn bijgewerkt om een array van LLD-rijen op het hoogste niveau van het JSON-document terug te geven. Zabbix zal automatisch een macro en waarde extraheren als een array-veld de {#MACRO} syntaxis als sleutel gebruikt. Elke nieuwe native ontdekkingscontrole zal de nieuwe syntaxis zonder de "data"-elementen gebruiken. Bij het verwerken van een lage-niveau ontdekkingswaarde wordt eerst de hoofdlocatie bepaald (array bij $. of $.data).

Hoewel het "data"-element is verwijderd uit alle native items die verband houden met ontdekking, zal Zabbix voor achterwaartse compatibiliteit nog steeds de JSON-notatie met een "data"-element accepteren, hoewel het gebruik ervan wordt afgeraden. Als de JSON een object bevat met slechts één "data"-array-element, dan zal het automatisch de inhoud van het element extraheren met behulp van JSONPath $.data. Lage-niveau ontdekking accepteert nu optionele door de gebruiker gedefinieerde LLD-macro's met een aangepast pad dat is gespecificeerd in JSONPath-syntaxis.

Zie ook: Ontdekte entiteiten

Het configureren van lage-niveau ontdekking

We zullen lage-niveau ontdekking illustreren aan de hand van een voorbeeld van bestandssysteemontdekking.

Om de ontdekking te configureren, doet u het volgende:

• Ga naar: Configuratie → Templates of Hosts
• Klik op Ontdekking in de rij van een geschikte template/host

• Klik in de rechterbovenhoek van het scherm op Ontdekkingsregel aanmaken
• Vul het formulier voor de ontdekkingsregel in met de vereiste gegevens

Ontdekkingsregel

Het formulier voor de ontdekkingsregel bevat vijf tabbladen die de gegevensstroom tijdens de ontdekking voorstellen, van links naar rechts:

• Ontdekkingsregel - specificeert, het belangrijkst, het ingebouwde item of aangepast script om ontdekkingsgegevens op te halen
• Voorverwerking - past enige voorverwerking toe op de ontdekte gegevens
• LLD-macro's - staat toe om bepaalde macrowaarden te extraheren en te gebruiken in ontdekte items, triggers, enz.
• Filters - staat toe om de ontdekte waarden te filteren
• Overrides - staat toe om items, triggers, grafieken of host-prototypen aan te passen bij toepassing op specifieke ontdekte objecten

Het tabblad Ontdekkingsregel bevat de item-sleutel die wordt gebruikt voor ontdekking (evenals enkele algemene attributen voor de ontdekkingsregel):

Alle verplichte invoervelden zijn gemarkeerd met een rode asterisk.

Voorverwerking

Het tabblad Voorverwerking maakt het mogelijk om transformatieregels te definiëren die worden toegepast op het resultaat van de ontdekking. In deze stap zijn één of meerdere transformaties mogelijk. Transformaties worden uitgevoerd in de volgorde waarin ze zijn gedefinieerd. Alle voorverwerking wordt gedaan door de Zabbix-server.

Zie ook:

• Details voorverwerking
• Testen voorverwerking

Merk op dat als de ontdekkingsregel is toegepast op de host via een sjabloon, de inhoud van dit tabblad alleen-lezen is.

Aangepaste macros

Het tabblad LLD-macro's maakt het mogelijk om aangepaste laag-niveau ontdekkingsmacro's te specificeren.

Aangepaste macro's zijn handig in gevallen waarin de geretourneerde JSON nog niet de vereiste macro's heeft gedefinieerd. Dus, bijvoorbeeld:

• De native vfs.fs.discovery sleutel voor het ontdekken van bestandssystemen retourneert een JSON met enkele vooraf gedefinieerde LLD-macro's zoals {#FSNAME}, {#FSTYPE}. Deze macro's kunnen direct worden gebruikt in item-, triggerprototypen (zie volgende secties van de pagina); het definiëren van aangepaste macro's is niet nodig;
• Het vfs.fs.get agent-item retourneert ook een JSON met bestandssysteemgegevens, maar zonder vooraf gedefinieerde LLD-macro's. In dit geval kunt u de macro's zelf definiëren en ze toewijzen aan de waarden in de JSON met behulp van JSONPath:

De geëxtraheerde waarden kunnen worden gebruikt in ontdekte items, triggers, enzovoort. Merk op dat waarden worden geëxtraheerd uit het resultaat van de ontdekking en eventuele voorverwerkingsstappen tot nu toe.

Filter

Een filter kan worden gebruikt om echte items, triggers en grafieken alleen te genereren voor entiteiten die aan de criteria voldoen. Het tabblad Filters bevat definitie van filters voor ontdekkingsregels die ontdekkingswaarden kunnen filteren:

Override

Het tabblad Override stelt u in staat regels in te stellen om de lijst van items, triggers, grafieken en hostprototypen of hun eigenschappen te wijzigen voor ontdekte objecten die aan bepaalde criteria voldoen.

Overrides (indien aanwezig) worden weergegeven in een rangschikbare drag-and-drop lijst en worden uitgevoerd in de volgorde waarin ze zijn gedefinieerd. Om details van een nieuwe override te configureren, klikt u op in het blok Overrides. Om een bestaande override te bewerken, klikt u op de naam van de override. Een popup-venster wordt geopend waarmee u de details van de override-regel kunt bewerken.

Alle verplichte parameters zijn gemarkeerd met rode asterisken.

Configuratie van een operatie

Om de details van een nieuwe operatie te configureren, klikt u op in het blok Operaties. Om een bestaande operatie te bewerken, klikt u op naast de operatie. Er wordt een popup-venster geopend waarin u de details van de operatie kunt bewerken.

Formulierknoppen

Onderaan het formulier staan knoppen waarmee verschillende handelingen kunnen worden uitgevoerd.

Ontdekte entiteiten

De onderstaande schermafbeeldingen illustreren hoe ontdekte items, triggers en grafieken eruitzien in de configuratie van de host. Ontdekte entiteiten hebben een oranje link naar de ontdekkingsregel waar ze vandaan komen.

Merk op dat ontdekte entiteiten niet worden gemaakt als er al bestaande entiteiten zijn met dezelfde unieke criteria, bijvoorbeeld een item met dezelfde sleutel of een grafiek met dezelfde naam. In dit geval wordt er in de frontend een foutmelding weergegeven dat de ontdekkingsregel voor laag niveau bepaalde entiteiten niet kon maken. De ontdekkingsregel zelf wordt echter niet ongeldig gemaakt omdat sommige entiteiten niet konden worden gemaakt en overgeslagen moesten worden. De ontdekkingsregel gaat door met het maken/bijwerken van andere entiteiten.

Items (vergelijkbaar met triggers en grafieken) die zijn gemaakt door een ontdekkingsregel voor laag niveau, worden automatisch verwijderd als een ontdekte entiteit (bestandssysteem, interface, enz.) niet meer wordt ontdekt (of niet meer door de filter komt). In dat geval worden de items, triggers en grafieken verwijderd nadat het aantal dagen dat is gedefinieerd in het veld Keep lost resources period is verstreken.

Wanneer ontdekte entiteiten 'Niet meer ontdekt' worden, wordt er een levensduurindicator weergegeven in de lijst met items. Beweeg met uw muis over de indicator en er wordt een bericht weergegeven met hoeveel dagen het nog duurt voordat het item wordt verwijderd.

Als entiteiten zijn gemarkeerd voor verwijdering, maar niet zijn verwijderd op het verwachte tijdstip (uitgeschakelde ontdekkingsregel of itemhost), worden ze de volgende keer dat de ontdekkingsregel wordt verwerkt verwijderd.

Entiteiten die andere entiteiten bevatten en zijn gemarkeerd voor verwijdering, worden niet bijgewerkt als ze op het niveau van de ontdekkingsregel zijn gewijzigd. Bijvoorbeeld, LLD-gebaseerde triggers worden niet bijgewerkt als ze items bevatten die zijn gemarkeerd voor verwijdering.

Andere soorten ontdekking

Meer gedetailleerde informatie en handleidingen voor andere soorten kant-en-klare ontdekkingen zijn beschikbaar in de volgende secties:

• Ontdekking van netwerkinterfaces;
• Ontdekking van CPU's en CPU-kernen;
• Ontdekking van SNMP OIDs;
• Ontdekking van JMX-objecten;
• Ontdekking met behulp van ODBC SQL-query's;
• Ontdekking van Windows-services;
• Ontdekking van hostinterfaces in Zabbix.

Voor meer informatie over het JSON-formaat voor ontdekkingsitems en een voorbeeld van hoe u uw eigen bestandssysteemontdekker kunt implementeren als een Perl-script, raadpleegt u het maken van aangepaste LLD-regels.