3 Descoberta de baix nivell

Vista general

La descoberta de baix nivell ajuda a crear automàticament elements, triggers i gràfics per a diferents entitats en un ordinador. Per exemple, Zabbix pot començar automàticament a monitorar sistemes de fitxers o interfícies de xarxa al vostre ordinador, sense necessitat de crear manualment elements per a cada sistema de fitxers o interfície de xarxa. A més, és possible configurar Zabbix per esborrar automàticament les entitats innecessàries en funció dels resultats reals de la descoberta realitzada periòdicament.

Un usuari pot definir els seus propis tipus de descoberta, sempre que segueixi un protocol JSON concret.

L'arquitectura general del procés de descoberta és la següent.

En primer lloc, un usuari crea una regla de descoberta a la columna Recull de dades → Plantilles, a la columna Descoberta. Una regla de descoberta consisteix en (1) un element que descobreix les entitats necessàries (per exemple, sistemes de fitxers o interfícies de xarxa) i (2) elements prototip, triggers i gràfics que s'han de crear basant-hi en el valor d'aquest element.

Un element que descobreix les entitats necessàries és com un element estàndard vist en altres llocs: el servidor demana a un agent Zabbix (o qualsevol tipus d'element que es defineixi) un valor d'aquest element, l'agent respon amb un valor textual. La diferència és que el valor amb el qual respon l'agent ha de contindre una llista d'entitats descobertes en un format JSON específic. Encara que els detalls d'aquest format només són importants per als desenvolupadors de comprovacions de descoberta personalitzades, cal saber que el valor retornat conté una llista de parelles de macro → valor. Per exemple, l'element "net.if.discovery" pot tornar dues parelles: "{#IFNAME}" → "lo" i "{#IFNAME}" → "eth0".

Aquestes macros s'empren en noms, claus i altres camps de prototips on després es substitueixen amb els valors rebuts per crear elements reals, triggers, gràfics o fins i tot equips per a cada entitat descoberta. Consulteu la llista completa d'opcions per emprar macros LLD.

Quan el servidor rep un valor per a un element de descoberta, examina les parelles macro → valor i genera elements reals, triggers i gràfics per a cada parella, basant-se en els seus prototips. A l'exemple amb "net.if.discovery" anterior, el servidor generaria un conjunt d'elements, triggers i gràfics per a la interfície de bucle "lo" i un altre conjunt per a la interfície "eth0".

Tingueu en compte que des de Zabbix 4.2, el format de JSON retornat per les regles de descoberta de baix nivell ha canviat. Ja no s'espera que JSON contingui l'objecte "dades". La descoberta de baix nivell ara admetrà JSON normal que contingui una matriu, per admetre noves funcions, com ara el preprocessament de valors d'element i camins personalitzats als valors de macro de descoberta de baix nivell en un document JSON.

S'han actualitzat les claus de descoberta integrades per retornar una matriu de fileres LLD a l'arrel del document JSON. Zabbix extreu automàticament una macro i un valor si un camp de matriu empra la sintaxi {#MACRO} com a clau. Qualsevol nova comprovació de descoberta nadiua emprarà la nova sintaxi sense els elements "dades". Quan es processa un valor de descoberta de baix nivell, primer es localitza l'arrel (matriu a $. o $.data).

Tot i que l'element "dades" s'ha esborrat de tots els elements nadius relacionats amb la descoberta, per compatibilitat amb les versions anteriors, Zabbix encara admetrà la notació JSON amb un element "dades", tot i que es desaconsella el seu ús. Si el JSON conté un objecte amb un únic element de matriu "data", extreu automàticament el contingut de l'element mitjançant JSONPath $.data. La descoberta de baix nivell ara admet macros LLD opcionals definides per l'usuari amb un camí personalitzat especificat a la sintaxi JSONPath.

Després dels canvis anteriors, els nous agents ja no podran treballar amb un servidor Zabbix antic.

Veieu també: Entitats descobertes

Configuració de la descoberta de baix nivell

Demostrarem la descoberta de baix nivell mitjançant un exemple de descoberta de sistemes de fitxers.

Per configurar la descoberta, seguiu aquestes passes:

  • Aneu a: Recull de dadesPlantilles o Equips
  • Feu clic a Descoberta a la línia d'un model/equip adequat.

  • Feu clic a Crear una regla de descoberta a l'extrem superior dret de la pantalla.
  • Ompliu el formulari de regla de descoberta amb els detalls requerits

Regla de descoberta

El formulari de regla de descoberta conté cinc pestanyes que representen, d'esquerra a dreta, el flux de dades durant la descoberta:

  • Regla de descoberta - especifica, sobretot, l'element integrat o l'script personalitzat per recuperar les dades de descoberta
  • Preprocessament - aplica el preprocessament a les dades descobertes
  • LLD Macros - extreu determinats valors de macro per emprar-los a elements descoberts, triggers, etc.
  • Filtres - permet filtrar els valors descoberts
  • Anul·lació - permet modificar elements, triggers, gràfics o prototips d'equips quan s'aplica a objectes descoberts específics

La pestanya Regla de descoberta conté la clau de l'element que cal emprar per a la descoberta (a més d'alguns atributs generals de la regla de descoberta):

Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.

Paràmetre Descripció
Nom Nom de la regla de descoberta.
Tipus El tipus de comprovació per realitzar la descoberta
En aquest exemple, som emprant una clau d'element agent Zabbix.
La regla de descoberta també pot ser un element dependent. No pot dependre d'una altra regla de descoberta. Per a un element dependent, seleccioneu el tipus corresponent (Element dependent) i especifiqueu l'element mestre al camp 'Element mestre'. L'element mestre ha d'existir.
Clau Introduïu la clau d'element de descoberta (fins a 2048 caràcters).
Per exemple, podeu emprar la clau d'element integrada "vfs.fs.discovery" per retornar un JSON amb la llista de fitxers de sistemes de descoberta presents a l'ordinador, i els seus tipus.
Tingueu en compte que una altra opció per a la descoberta del sistema de fitxers empra els resultats de la descoberta mitjançant la clau de l'agent "vfs.fs.get", compatible des de Zabbix 4.4.5 (veieu l'exemple).
Interval d'actualització Aquest camp especifica amb quina freqüència Zabbix realitza la descoberta. Al principi, quan només sou configurant la descoberta del sistema de fitxers, podeu establir un petit interval, però un cop sabeu que funciona, podeu configurar-ho en 30 minuts o més perquè els sistemes de fitxers normalment no canvien gaire sovint.
Els sufixos de temps, com ara 30s, 1m, 2h, 1d, s'admeten des de Zabbix 3.4.0.
S'admeten macros d'usuari.
Nota: L'interval d'actualització només es pot establir a '0' si hi ha intervals personalitzats amb un valor diferent de zero. Si s'estableix a '0' i existeix un interval personalitzat (flexible o programat) amb un valor diferent de zero, l'element es consultarà durant la durada de l'interval personalitzat.
Les regles de descoberta noves es comprovaran dins dels 60 segons de la seva creació, tret que tinguin un interval d'actualització de programació o flexible i l'Interval d'actualització estigui definit a 0.
Tingueu en compte que per a una regla de descoberta existent, la descoberta es pot fer de seguida prement el botó Comprovar ara.
Interval personalitzat Podeu crear regles personalitzades per comprovar l'element:
Flexible - crear una excepció a l'interval d'actualització (interval amb una freqüència diferent)
Programació - crear un programa d'enquesta personalitzat.
Per obtindre més informació, veieu els intervals personalitzats.

|Timeout|Definiu el temps d'espera de la comprovació de descoberta. Trieu l'opció de temps d'espera:
Global - s'empra el temps d'espera proxy/global (es mostra al camp Temps d'espera en gris);
Substituir - s'empra el temps d'espera personalitzat (establert al Camp Timeout; interval permès: 1 - 600 s). Els Sufixos de temps, com ara 30s, 1m i les macros d'usuari són compatibles.
Fent clic a l'enllaç Temps d'espera us permet configurar els temps d'espera del proxy o global (si no s'empra un proxy). Tingueu en compte que l'enllaç Temps d'espera només és visible per als usuaris del tipus Super administrador amb permisos per a AdministracióGeneral o AdministracióProxys seccions d'interfície.| |Esborrar els recursos perduts|Especifiqueu amb quina rapidesa s'esborrarà l'entitat descoberta un cop el seu estat de descoberta sigui "Ja no es troba":
Mai - no s'esborrarà;
Immediatament - s'esborra immediatament;
Després de - s'esborra després del període de temps especificat. El valor ha de ser superior al valor de Desactivar els recursos perduts.
S'admeten sufixos de temps, com ara 2h, 1d.
S'admeten les macros d'usuari.
Nota: No es recomana emprar "Immediatament", ja que editar el filtre de manera incorrecta pot fer que s'esborri l'entitat i totes les dades històriques.
Tingueu en compte que els recursos desactivats manualment no s'esborraran pas per una descoberta de baix nivell.| |Desactivar els recursos perduts|Especifiqueu quan es desactivarà l'entitat descoberta un cop el seu estat de descoberta esdevingui "Ja no es troba":
Mai - no es desactivarà pas;
Immediatament - es desactiva immediatament;
Després de - es desactiva després del període de temps especificat. El valor hauria de ser superior a l'interval d'actualització de la regla de descoberta.
Tingueu en compte que els recursos desactivats automàticament es tornaran a activar si es tornen a trobar per una descoberta de baix nivell. Els recursos desactivats manualment no es tornaran pas a habilitar si es tornen a trobar.
Aquest camp no es mostra si l'opció Esborrar els recursos perduts s'estableix a "Immediatament".
S'admeten sufixos d'hora, com ara 2h, 1d.
S'admeten macros d'usuari.| | Descripció | Introduïu una descripció. | | Activat | Si es marca, es processarà la regla. |

L'històric de les regles de descoberta no es conserva.

Preprocessament

La pestanya Preprocessament permet definir regles de transformació per aplicar al resultat de la descoberta. En aquesta passa són possibles una o diverses transformacions. Les transformacions s'executen en l'ordre en què es defineixen. Tot el preprocessament el fa el servidor Zabbix.

Veieu també:

|Tipus|<|<| |-|-----------|-------------------------------------- ----| | |Transformació|Descripció| |Text|<|<| |<|Expressió regular|Fa coincidir el valor rebut amb l'expressió regular <patró> i substitueix el valor amb la <sortida> extreta. L'expressió regular admet l'extracció d'un màxim de 10 grups capturats amb la seqüència \N.
Paràmetres:
patró - expressió regular
sortida - plantilla de format de sortida. Una seqüència d'escapada \N (on N=1...9) es substitueix per l'enèssim grup coincident. Una seqüència d'escapada \0 es substitueix pel text coincident.
Si marqueu la casella de selecció Personalitzada en cas d'error, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|Reemplaça|Cerca la cadena de cerca i substitueix-la per una altra (o res). Se substituiran totes les ocurrències de la cadena de cerca.
Paràmetres:
cadena de cerca - la cadena a cercar i substituir, distingeix entre majúscules i minúscules (obligatori)
reemplaçament - la cadena a cercar per substituir. La cadena de substitució també pot ésser buida de manera efectiva, permetent esborrar la cadena de cerca quan es trobi.
És possible emprar seqüències d'escapada per cercar o substituir salts de línia, retorn de carro, tabulacions i espais "\n \r \ t \s"; La barra invertida es pot escapar com a "\\" i les seqüències d'escapament es poden escapar com a "\\n". L'escapament dels salts de línia, el retorn de carro i les pestanyes es fa automàticament durant la descoberta de baix nivell.| |Dades estructurades|<|<| |<|JSONPath|Extreu el valor o el fragment de les dades JSON mitjançant la funcionalitat JSONPath.
Si marqueu la casella de selecció Personalitzat en cas d'error, l'element no s'admetrà en cas d'error en el passa de preprocessament i és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |<|XML XPath|Extreu valor o fragment de dades XML mitjançant la funcionalitat XPath.
Per tal que aquesta opció funcioni, el servidor Zabbix s'ha de compilar amb suport libxml.
Exemples:
number(/document /item/value) extreu 10 de <document><item><value>10</value></item></document>
number(/document/item/@attribute) extreu 10 de <document><item attribute="10"></item></document>
/document/item extreu <item><value>10</value ></item> de <document><item><value>10</value></item></document>
Tingueu en compte que els espais de noms no són compatibles.
S'admet des de la versió 4.4.0.
Si marqueu la casella de selecció Personalitzat en cas d'error, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |<|CSV a JSON|Convertir les dades del fitxer CSV al format JSON.
Per obtindre més informació, consulteu: Preprocessament de CSV a JSON.
Suportat des de la versió 4.4.0.| |^|XML a JSON|Converteix les dades en format XML a JSON.
Per obtindre més informació, veieu: Regles de serialització.
Si marqueu la casella de selecció Personalitzat en cas d'error, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |SNMP|<|<| | |Valor de walk SNMP|Extreu el valor pel nom OID/MIB especificat i apliqueu les opcions de format:
Sense modificar - retorna Hex-STRING com a cadena hexadecimal sense escapar;
UTF-8 de Hex- STRING - converteix Hex-STRING en cadena UTF-8;
MAC de Hex-STRING - converteix Hex-STRING en cadena d'adreces MAC (que tindrà ' ' substituït per ':' );
Enter de BITS - converteix els primers 8 octets d'una cadena de bits expressada com una seqüència de caràcters hexadecimals (per exemple, "1A 2B 3C 4D") en un nombre enter sense signe de 64 bits. En les cadenes de bits de més de 8 octets, els octets conseqüents s'ignoraran.
Si marqueu la casella de selecció Personalitzat en cas d'error, és possible especificar opcions personalitzades de gestió d'errors: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| | |SNMP walk a JSON|Converteix els valors SNMP a JSON. Especifiqueu un nom de camp al JSON i la ruta d'OID SNMP corresponent. Els valors dels camps s'emplenaran amb els valors del camí d'accés SNMP OID especificat.
Podeu emprar aquesta passa de preprocessament per a la descoberta SNMP OID.
Opcions de format de valors semblants com a al pas valor de caminada SNMP estan disponibles.
Si marqueu la casella de selecció Personalitzat en cas d'error, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un valor de missatge d'error.| | |valor SNMP get|Aplica opcions de format al valor d'obtenció SNMP:
UTF-8 de Hex-STRING - converteix Hex-STRING en UTF-8;
MAC de Hex- STRING - converteix Hex-STRING en una cadena d'adreça MAC (que tindrà ' ' substituït per ':');
Enter de BITS - converteix els primers 8 octets d'una cadena de bits expressada com una seqüència de caràcters hexadecimals (per exemple, "1A 2B 3C 4D") en un nombre enter sense signe de 64 bits. En les cadenes de bits de més de 8 octets, els octets conseqüents s'ignoraran.
Si marqueu la casella de selecció Personalitzat en cas d'error, és possible especificar opcions personalitzades de gestió d'errors: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |Scripts personalitzats|<|<| |<|JavaScript|Introduïu el codi JavaScript a l'editor modal que s'obre quan cliquem al camp de paràmetres, o a la icona de text del llàpis que hi ha al costat.
Tingueu en compte que la longitud de JavaScript disponible depèn de la base de dades emprada.
Per obtindre més informació, veieu: Preprocessament de JavaScript| |Validació|<|<| |<|No coincideix amb l'expressió regular|Especifiqueu una expressió regular amb la qual un valor no ha de coincidir.
Ex. Error:(.*?)\.
Si marqueu la casella de selecció Personalitzat en cas d'error, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|Comprovar si hi ha errors a JSON|Comprova si hi ha un missatge d'error a nivell d'aplicació situat a JSONPath. Atura el processament si s'ha realitzat correctament i el missatge no és buit; en cas contrari, continua el processament amb el valor que hi havia abans d'aquesta passa de preprocessament. Tingueu en compte que aquests errors de servei extern s'informa a l'usuari tal qual, sense afegir informació sobre la passa de preprocessament.
P. $.errors. Si es rep un JSON com {"errors":"e1"}, la següent passa de preprocessament no s'executarà.
Si marqueu la Casella de selecció personalitzada en cas d'error, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|Comprovar si hi ha errors a l'XML|Comprova si hi ha un missatge d'error a nivell d'aplicació situat a xpath. Atura el processament si s'ha realitzat correctament i el missatge no és buit; en cas contrari, continueu el processament amb el valor que hi havia abans d'aquest passa de preprocessament. Tingueu en compte que aquests errors de servei extern s'informaran a l'usuari tal qual, sense afegir informació sobre la passa de preprocessament.
No s'informarà d'error en cas de no poder analitzar un XML no vàlid.
Suportat des de la versió 4.4.0.
Si marqueu la casella de selecció Personalitzat en cas d'error, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |<|Coincideix amb l'expressió regular|Especifiqueu una expressió regular amb la qual ha de coincidir un valor.
Si marqueu la casella de selecció Personalitzat en cas d'error, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, estableix un valor especificat o estableix un missatge d'error especificat.| |Accelerar|<|<| |<|Descartar sense canvis amb heartbeat|Descartar un valor si no ha canviat dins del període de temps definit (en segons).
S'admeten valors enters positius per especificar els segons (mínim - 1 segon). Els sufixos de temps es poden emprar en aquest camp (per exemple, 30 s, 1 m, 2 h, 1 d). En aquest camp es poden emprar macros d'usuari i macros de descoberta de baix nivell.
Només es pot especificar una opció d'acceleració per a un element de descoberta.
Ex. 1m. Si es passa un text idèntic a aquesta regla dues vegades en 60 segons, es descartarà.
Nota: Canviar els prototips d'elements no restableix l'acceleració. L'acceleració només es restableix quan es canvien els passos de preprocessament.| |Prometheus|<|<| |<|Prometheus a JSON|Convertiu les mètriques de Prometheus requerides a JSON.
Consulteu les comprovacions de Prometheus per a més detalls.|

Tingueu en compte que si la regla de descoberta s'ha aplicat a l'equip mitjançant una plantilla, el contingut d'aquesta pestanya és només de lectura.

Macros personalitzades

La pestanya Macros LLD us permet especificar macros personalitzades de descoberta de baix nivell.

Les macros personalitzades són útils en els casos en què el JSON retornat no té les macros necessàries ja definides. Així, per exemple:

  • La clau nadiua vfs.fs.discovery per a la descoberta del sistema de fitxers retorna un JSON amb macros LLD predefinides com {#FSNAME}, {#FSTYPE}. Aquestes macros es poden emprar a l'element, activar prototips (vegeu les seccions següents de la pàgina) directament; no cal definir macros personalitzades;
  • L'element d'agent vfs.fs.get també retorna JSON amb dades del sistema de fitxers, però sense macros LLD predefinides. En aquest cas, podeu definir les macros vosaltres mateixos i assignar-les als valors JSON mitjançant JSONPath:

Els valors extrets es poden emprar en elements descoberts, triggers, etc. Tingueu en compte que els valors es prendran del resultat de la descoberta i de totes les passes de preprocessament processades fins ara.

Paràmetre Descripció
Macro LLD Nom de la macro de descoberta de baix nivell, emprant la sintaxi següent: {#MACRO}.
JSONPath Ruta que s'empra per extreure el valor de la macro LLD d'una fila LLD, emprant la sintaxi JSONPath.
Els valors extrets del JSON retornats s'empren per substituir les macros LLD als camps del prototip d'element, trigger, etc.
JSONPath es pot especificar mitjançant la notació de punts o la notació de claudàtors. La notació de claudàtors s'ha d'emprar en cas de caràcters especials i Unicode, com ara $['unicode + caràcters especials #1']['unicode + caràcters especials #2'].

Per exemple, $ .foo extreu "bar" i "baz" d'aquest JSON: [{"foo":"bar"}, {"foo":"baz"}]
Tingueu en compte que $.foo extreu "bar" i "baz" també d'aquest JSON: {"data":[{"foo":"bar"}, {"foo":"baz"}]} perquè un únic objecte "data" és processat automàticament (per a compatibilitat amv versions anteriors amb la implementació de descoberta de baix nivell a les versions de Zabbix anteriors a la 4.2).

Filtre

Es pot emprar un filtre per generar elements reals, triggers i gràfics només per a les entitats que coincideixen amb els criteris. La psónya Filtres conté definicions de filtres de regles de descoberta per filtrar valors de descoberta:

Paràmetre Descripció
Tipus de càlcul Les opcions de càlcul de filtres següents són disponibles:
I - han de complir-ho tots els filtres;
O - n'hi ha prou si un filtre compleix;< br>I/O - empra I amb diferents noms de macro i O amb el mateix nom de macro;
Expressió personalitzada - ofereix la possibilitat de definir un càlcul personalitzat de filtres. La fórmula ha d'incloure tots els filtres de la llista. Limitat a 255 símbols.
Filtres Els operadors de condicions de filtre següents són disponibles: coincideix, no coincideix, existeix, no existeix.
Els operadors coincideix i no coincideix esperen una expressió regular compatible amb Perl (PCRE). Per exemple, si només sou interessats en els sistemes de fitxers C:, D: i E:, podeu posar {#FSNAME} a "Macro" i l'expressió regular "^C|^D|^E" al camp de text "Expressió regular". El filtre també és possible per tipus de sistema de fitxers emprant la macro {#FSTYPE} (per exemple, "^ext|^reiserfs") i per tipus d'unitat (només és compatible amb l'agent Windows) mitjançant la macro {#FSDRIVETYPE} (per exemple, "fixat").
Podeu introduir una expressió regular o fer referència a una expressió regular global al camp "Expressió regular".
Per provar una expressió regular, podeu emprar "grep -E", per exemple: for f a ext2 nfs reiserfs smbfs; do echo $f \| grep -E '^ext\|^reiserfs' \|\| echo "SKIP: $f"; done

La macro {#FSDRIVETYPE} a Windows s'admet des de Zabbix 3.0.0.

Els operadors existeix i no existeix pas permet filtrar entitats en funció de la presència o absència de la macro LLD especificada a la resposta (suportada des de la versió 5.4.0).
La configuració de diversos filtres és compatible des de Zabbix 2.4.0.
Tingueu en compte que si manca una macro de filtre a la resposta, l'entitat trobada s'ignorarà tret que s'especifiqui una condició "no existeix" per a aquesta macro.
< br>Es mostrarà un avís si l'absència d'una macro afecta al resultat de l'expressió. Per exemple, si hi manca {#B} a:
{#A} coincideix amb 1 i {#B} coincideix amb 2 - donarà un avís
{#A} coincideix amb 1 o {#B} coincideix amb 2 - no hi haurà cap avís.

Un error o una errada en l'expressió regular emprada a la regla LLD (per exemple, una expressió regular "Sistema de fitxers per a la descoberta" incorrecta) pot provocar l'esborrat de milers d'elements de configuració, valors històrics i esdeveniments de molts equips.

La base de dades Zabbix a MySQL s'ha de crear amb distinció entre majúscules i minúscules, de manera que els noms del sistema de fitxers només difereixin en cas que siguin correctament descoberts.

Anul·lar

La pestanya Anul·lar permet definir regles per modificar la llista d'elements prototip, triggers, gràfics i equips o els seus atributs per als objectes descoberts que compleixen uns criteris determinats.

Les sobrecàrregues (si n'hi ha) es mostren en una llista reordenable arrossegant i deixant anar i s'executen en l'ordre en què es defineixen. Per configurar els detalls d'una nova anul·lació, feu clic a al bloc Sobrecàrregues. Per modificar una anul·lació existent, feu clic al nom de l'anul·lació. S'obrirà una finestra emergent que us permetrà editar els detalls de la regla d'anul·lació.

Tots els paràmetres necessaris són marcats amb asteriscs vermells.

Paràmetre Descripció
Nom Un nom d'anul·lació únic (segons la regla LLD).
Si el filtre coincideix Defineix si s'han de processar les anul·lacions següents quan es compleixin les condicions del filtre:
Continuar les anul·lacions - es processaran les anul·lacions posteriors.
Aturar el processament - atura operacions anteriors (si n'hi ha) i s'executarà aquesta sobrecàrrega, s'ignoraran les anul·lacions posteriors per a les línies LLD corresponents.
Filtres Determina a quines entitats descobertes s'ha d'aplicar la substitució. Els filtres de sobrecàrrega es processen després dels filtres de la regla de descoberta i tenen la mateixa funcionalitat.
Operacions Les operacions de sobrecàrrega es mostren amb aquests detalls:
Condició - un tipus d'objecte (prototip d'element/prototip de trigger/prototip de gràfic/prototip d'equip) i una condició que s'ha de complir (igual/no és igual/conté/no conté/coincideix/no coincideix)
Acció - es mostren enllaços per modificar i esborrar una operació.

Configurar una operació

Per configurar els detalls d'una nova operació, feu clic a al bloc Operacions. Per editar una operació existent, feu clic a al costat de l'operació. S'obrirà una finestra emergent on podeu editar els detalls de l'operació.

|Paràmetre|<|<|Descripció| |-|-|-----------|------------------------------------ ------| |Objecte|<|<|Hi ha quatre tipus d'objectes disponibles:
Prototip d'element
Prototip de trigger
Prototip de gràfic
Prototip d'equip| |Condició|<|<|Permet filtrar les entitats a les quals s'ha d'aplicar l'operació.| | |Operador|<|Operadors admesos:
igual - s'aplica a aquest prototip
no és igual - s'aplica a tots els prototips excepte aquest
conté - s'aplica, si el nom del prototip conté una cadena
no conté - s'aplica, si el nom del prototip no conté una cadena
* *coincideix - s'aplica, si el nom del prototip coincideix amb l'expressió regular
no coincideix** - s'aplica, si el nom del prototip no coincideix amb l'expressió regular
| |^|Patró|<|Expressió regular o cadena a cercar.| |^|Objecte: Prototip d'element|<|<| |^| |Creació activada|Quan és marcat, apareixeran botons que permetran anul·lar la configuració original del prototip d'element:
- l'element s'afegirà en un estat activat.
No - l'element s'afegirà a una entitat descoberta però en estat discapacitat.| |||Descoberta|Quan és marcat, apareixeran botons que us permetran anul·lar la configuració del prototip d'element original:
- l'element s'afegirà.
* No* - l'element no s'afegirà.| |||Interval d'actualització|Quan és marcat, apareixeran dues opcions, que us permetran establir un interval diferent per a l'element:
Endarreriment - Interval d'actualització de l'element. S'admeten tant macros d'usuari com sufixos de temps (p. ex., 30 s, 1 m, 2 h, 1 d). S'ha d'establir a 0 si s'empra un Interval personalitzat.
Interval personalitzat - feu clic a per especificar un interval flexible/planificat. Per obtindre informació detallada, veieu els intervals personalitzats.| |||Historial|Quan és marcat, apareixen botons que us permeten establir un període d'emmagatzematge de l'historial diferent per a l'element:
No conservar l'historial - si s'escull, l'historial no s'emmagatzemarà.
Emmagatzemar fins a - si es tria, a la dreta apareixerà un camp d'entrada per especificar el període d'emmagatzematge. S'admeten tant macros d'usuari com macros LLD.| |||Tendències|Quan és marcat, apareixen botons que permeten establir un període d'emmagatzematge de tendències diferent per a l'element:
No conservar les tendències - si es tria, les tendències no s'emmagatzemaran.
Període d'emmagatzematge - si es tria, apareixerà un camp d'entrada per especificar el període d'emmagatzematge a la dreta. S'admeten tant macros d'usuari com macros LLD.| |||Etiquetes|Quan la casella és marcada, apareixerà un bloc nou que permetrà especificar parelles d'etiqueta-valor.
Aquestes etiquetes s'afegiran a les etiquetes especificades al prototip de l'element, encara que a l'etiqueta els noms coincideixen.| |^|Objecte: Prototip de trigger|<|<| |^| |Creació activada|Quan és marcat, apareixeran botons que us permetran anul·lar la configuració original del prototip de trigger:
- el trigger s'afegirà en estat activat.
No - el trigger s'afegirà a una entitat descoberta, però en estat desactivat.| |||Descoberta|Quan és marcat, apareixeran botons que us permetran anul·lar la configuració original del prototip del trigger:
- s'afegirà el trigger.
No - el trigger no s'afegirà pas.| |||Gravetat|Quan és marcat, apareixeran botons de gravetat del trigger, que permetran canviar la gravetat del trigger.| |||Etiquetes|Quan la casella és marcada, apareixerà un bloc nou, que permetrà especificar parelles d'etiqueta-valor.
Aquestes etiquetes s'afegiran a les etiquetes especificades al prototip de trigger, encara que els noms d'etiquetes coincideixin.| |^|Objecte: Prototip de gràfic|<|<| |^| |Descoberta|Quan és marcat, apareixeran botons que us permetran anul·lar la configuració original del gràfic prototip:
- el gràfic s'afegirà.
No - el gràfic no s'afegirà. | |^|Objecte: Prototip d'equip|<|<| |^| |Creació activada|Quan és marcat, apareixeran botons que us permetran anul·lar la configuració del prototip d'equip original:
- l'equip es crearà en estat habilitat.
No - l'equip es crearà en estat desactivat.| |||Descoberta|Quan és marcat, apareixeran botons que us permetran anul·lar la configuració del prototip d'equip original:
- l'equip es descobrirà.
* No* - l'equip no serà descobert.| |||Enllaçar plantilles|Quan és marcat, apareixerà un camp d'entrada per especificar plantilles. Comenceu a escriure el nom de la plantilla o feu clic a Triar al costat del camp i trieu plantilles de la llista en una finestra emergent.
Totes les plantilles enllaçades a un prototip d'equip se substituiran per plantilles d'aquesta subsitució.| |||Etiquetes|Quan és marcat, apareixerà un bloc nou que permetrà especificar parelles d'etiquetes-valors.
Aquestes etiquetes s'afegiran a les etiquetes especificades al prototip de l'equip, fins i tot si els noms d'etiquetes coincideixen.| |||Inventari d'equips|Quan és marcat, apareixeran botons que us permetran triar un mode diferent d'inventari per a l'equip prototip:
Desactivat - no emplena l'inventari de l'equip
Manual - proporcionar detalls manualment
Automàtic - emplena automàticament les dades de l'inventari de l'equip en funció de les mètriques recollides.|

Botons de formulari

Els botons de la part inferior del formulari us permeten realitzar diverses operacions.

Afegeix una regla de descoberta. Aquest botó només és disponible per a regles de descoberta noves.
Actualitza les propietats d'una regla de descoberta. Aquest botó només és disponible per a les regles de descoberta existents.
Crea una altra regla de descoberta basada en les propietats de la regla de descoberta actual.
Fer la descoberta de seguida segons la regla de descoberta. La regla de descoberta ha d'existir. Veieu més detalls.
Tingueu en compte que durant la descoberta immediata, la memòria cau de configuració no s'actualitza, de manera que el resultat no reflectirà els canvis més recents a la configuració de la regla de descoberta.
ESborra la regla de descoberta.
Cancel·la la modificació de propietats de la regla de descoberta.

Entitats trobades

Les captures de pantalla següents il·lustren com són els elements, triggers i gràfics descoberts a la configuració de l'equip. Les entitats descobertes van precedides d'un enllaç carbassa a la regla de descoberta de la qual es van originar.

Tingueu en compte que les entitats descobertes no es crearan si ja hi ha entitats existents amb els mateixos criteris d'unicitat, per exemple, un element amb la mateixa clau o un gràfic amb el mateix nom. En aquest cas, es mostra un missatge d'error a la interfície que indica que la regla de descoberta de baix nivell no ha pogut crear determinades entitats. La regla de descoberta en si, però, no quedarà sense suport perquè algunes entitats no es van poder crear i s'han hagut de descartar. La regla de descoberta continuarà creant/actualitzant altres entitats.

Els elements (juntament amb triggers i gràfics) creats per una regla de descoberta de baix nivell s'esborraran automàticament si una entitat descoberta (sistema de fitxers, interfície, etc.) deixa d'ésser descoberta (o ja no passa el filtre). En aquest cas, els elements, triggers i gràfics s'esborraran un cop hagin passat els dies definits al camp Període de retenció per a recursos perduts.

Quan les entitats descobertes passen a ésser "Ja no es descobreixen", es mostra un indicador de vida útil a la llista d'elements. Mou el punter del ratolí per sobre i apareixerà un missatge que indicarà quants dies queden perquè s'esborri l'element.

Si s'han marcat les entitats per esborrar-les, però no s'han esborrat quan s'esperava (regla de descoberta o elements d'equip desactivades), s'esborraran el proper cop que es processi la regla de descoberta.

Les entitats que contenen altres entitats, que són marcades per a esborrar, no s'actualitzaran si es modifiquen a nivell de regla de descoberta. Per exemple, els triggers basats en LLD no s'actualitzaran si contenen elements marcats per esborrar-los.

Altres tipus de descoberta

A les seccions següents trobareu més detalls i explicacions sobre altres tipus de descoberta predefinits:

Per obtindre més detalls sobre el format JSON dels elements de descoberta i un exemple d'implementació de la vostra pròpia eina de descoberta del sistema de fitxers amb un script Perl, veieu creació de regles LLD personalitzades.