Áú»¢¶Ä²©

This is the documentation page for an unsupported version of Áú»¢¶Ä²©.
Is this not what you were looking for? Switch to the current version or choose one from the drop-down menu.

1 Crear un element

Vista general

Per crear un element a la interf¨ªcie web de Áú»¢¶Ä²©, seguiu aquestes passes:

  • Aneu a: Recollida de dades ¡ú Equips
  • Feu clic a Elements a la fila corresponent a l'equip
  • Feu clic a Crea un element a la cantonada superior dreta de la pantalla
  • Introdu?u els par¨¤metres de l'element al formulari

Tamb¨¦ podeu crear un element obrint un element existent, prement el bot¨® Clona i desant-lo amb un nom diferent.

°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®

L'Element cont¨¦ atributs generals d'elements.

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

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
Nom Nom de l'element.
Tipus Tipus d'element. Veieu les seccions individuals tipus d'element.
Clau Clau d'element (fins a 2048 car¨¤cters).
Les claus d'element admeses es poden trobar a les seccions de tipus d'element individuals.
La clau ha d'¨¦sser ¨²nica dins d'un ¨²nic equip.<br >Si el tipus de clau ¨¦s "Agent Áú»¢¶Ä²©", "Agent Áú»¢¶Ä²© (actiu)" o "Comprovaci¨® senzilla", el valor de la clau ha d'¨¦sser compatible amb l'agent Áú»¢¶Ä²© o el servidor Áú»¢¶Ä²©.
Veieu tamb¨¦: el [format de clau] correcte(/manual/config/items/item/key).
Tipus d'informaci¨® Tipus de dades tal com s'emmagatzemen a la base de dades despr¨¦s de fer conversions, si n'hi ha.
Num¨¨ric (sense signe) - Enter sense signe de 64 bits
Num¨¨ric (flotant) - nombre de coma flotant de 64 bits
Aquest tipus permetr¨¤ una precisi¨® d'aproximadament 15 d¨ªgits i ballar¨¤ entre aproximadament -1,79E+308 i 1,79E+308 (a excepci¨® de PostgreSQL 11 i versions anteriors).
Tamb¨¦ s'admet la recepci¨® de valors en notaci¨® cient¨ªfica. Per exemple. 1.23E+7, 1e308, 1.1E-4.
°ä²¹°ù¨¤³¦³Ù±ð°ù - dades de text breu
Registre - dades de text llarg amb propietats opcionals relacionades amb el registre (marca de temps, font, gravetat, logeventid)
Text - dades de text llarg. Veieu tamb¨¦ l¨ªmits de dades de text.
Per a les claus d'element que nom¨¦s retornen dades en un format espec¨ªfic, el tipus d'informaci¨® coincident es selecciona autom¨¤ticament.
Interf¨ªcie de l'equip Seleccioneu la interf¨ªcie de l'equip. Aquest camp ¨¦s disponible en editar un element al nivell d'equip.
Unitats Si s'estableix un s¨ªmbol d'unitat, Áú»¢¶Ä²© afegir¨¤ postprocessament al valor rebut i el mostrar¨¤ amb el postfix d'unitat establert.
Per defecte, si el valor brut supera 1000, es divideix per 1000 i es mostra conseq¨¹entment. Per exemple, si configureu bps i rebeu un valor de 881764, es mostrar¨¤ com a 881,76 Kbps.
S'empra l'est¨¤ndard de mem¨°ria per processar unitats B (octet), Bps (octets per segon), que es divideixen per 1024. Per tant, si les unitats s'estableixen a B o Bps, Áú»¢¶Ä²© mostrar¨¤:
1 com a 1B/1Bps
1024 com 1KB/1KBps
1536 com 1,5KB/1,5KBps
S'empra un processament especial si s'empren les unitats relacionades amb el temps seg¨¹ents:
unixtime - tradu?t a "aaaa.mm.dd hh:mm:ss". Per traduir correctament, el valor rebut ha de ser un tipus d'informaci¨® num¨¨ric (sense signe).
uptime - tradu?t a "hh:mm:ss" o "N dies, hh:mm:ss"< br>Per exemple, si rebeu el valor com a 881764 (segons), es mostrar¨¤ com a "10 dies, 04:56:04"
s - tradu?t a "aaaa mmm ddd hhh mmm sss ms"; el par¨¤metre es tracta com a nombre de segons.
Per exemple, si rebeu el valor com a 881764 (segons), es mostrar¨¤ com a "10d 4h 56m"
Nom¨¦s es mostren les 3 unitats principals superiors, com ara "1m 15d 5h" o "2h 4m 46s". Si no hi ha dies per mostrar, nom¨¦s es mostren dos nivells: "1m 5h" (no es mostren minuts, segons o mil¡¤lisegons). Es traduir¨¤ a "< 1 ms" si el valor ¨¦s inferior a 0,001.
Tingueu en compte que si una unitat t¨¦ el prefix !, no s'aplicar¨¤ cap prefix/processament d'unitat als valors dels elements. Veieu conversi¨® d'unitats.
Interval d'actualitzaci¨® Recuperar un valor nou per a aquest element cada N segons. L'interval d'actualitzaci¨® m¨¤xim perm¨¨s ¨¦s de 86.400 segons (1 dia).
S'admeten sufixos de temps, p. ex. 30s, 1m, 2h, 1d.
S'admeten macros d'usuari.
Una sola macro ha d'omplir tot el camp. No s'admeten diverses macros en un camp o les macros barrejades amb text.
Nota: L'interval d'actualitzaci¨® nom¨¦s es pot establir a "0" si existeixen 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.
Tingueu en compte que la primera enquesta d'element despr¨¦s que l'element esdevingui actiu o despr¨¦s d'un canvi d'interval d'actualitzaci¨® es pot produir abans del valor configurat.
Un element passiu existent es pot consultar per valor immediatament prement el bot¨® Execute now (#form_buttons).
Intervals personalitzats Podeu crear regles personalitzades per comprovar l'element:
Flexible - crear una excepci¨® a l'Interval d'actualitzaci¨® (interval amb freq¨¹¨¨ncia diferent)
Programat - crear un programa de sondeig personalitzat.
Per obtindre informaci¨® detallada, consulteu intervals personalitzats.
Sufixos de temps s'admeten al camp Interval, p. ex. 30s, 1m, 2h, 1d.
S'admeten macros d'usuari.
Una sola macro ha d'omplir tot el camp. No s'admeten diverses macros en un camp o macros barrejades amb text.
La programaci¨® ¨¦s compatible des de Áú»¢¶Ä²© 3.0.0.
Nota: els intervals personalitzats per a comprovacions actives nom¨¦s s¨®n compatibles amb l'agent Áú»¢¶Ä²© 2.
Per¨ªode d'emmagatzematge de l'historial Trieu:
No conservar l'historial - l'historial d'elements no s'emmagatzema. ?til per als elements mestres si nom¨¦s cal conservar l'historial dels elements dependents.
Aquesta ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® no es pot substituir per la ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® de l'administrador global.
Per¨ªode d'emmagatzematge - especifiqueu la durada de conservaci¨® de l'historial detallat a la base de dades (d'1 hora a 25 anys). Les dades m¨¦s antigues seran esborrades per el procediment de neteja. Emmagatzemat en segons.
S'admeten sufixos d'hora, p. ex. 2h, 1d. Les macros d'usuari s¨®n compatibles.
El valor Per¨ªode d'emmagatzematge es pot substituir globalment a Administraci¨® ¡ú General ¡ú Housekeeper.
Si existeix un par¨¤metre d'anul¡¤laci¨® global, es mostra una icona d'informaci¨® verda . Si col¡¤loqueu el ratol¨ª a sobre, es mostra un missatge d'av¨ªs, p.e. Substitu?t per la ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® global de la neteja (1d).
Es recomana mantindre els valors registrats durant el menor temps possible per reduir la mida de l'historial de valors a la base de dades. En lloc de mantindre un llarg historial de valors, podeu conservar dades m¨¦s llargues de tend¨¨ncies.
Veieu tamb¨¦ hist¨°ric i tend¨¨ncies.
Per¨ªode d'emmagatzematge de tend¨¨ncies Trieu una de les dues opcions:
No conservar les tend¨¨ncies - les tend¨¨ncies no s'emmagatzemen.
Aquesta ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® no pot ¨¦sser anul¡¤lada per la ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® de neteja global.
Per¨ªode d'emmagatzematge - especifiqueu la durada de conservaci¨® de l'historial agregat (m¨ªnim, m¨¤xim, mitj¨¤, recompte) a la base de dades (d'1 dia a 25 anys). Les dades m¨¦s antigues seran eliminades per la neteja. Emmagatzemat en segons.
S'admeten sufixos d'hora, p. ex. 24h, 1d. Les macros d'usuari s¨®n compatibles.
El valor Per¨ªode d'emmagatzematge es pot substituir globalment a Administraci¨® ¡ú General ¡ú Housekeeper.
Si existeix un par¨¤metre d'anul¡¤laci¨® global, es mostra una icona d'informaci¨® verda . Si col¡¤loqueu el ratol¨ª a sobre, es mostra un missatge d'advert¨¨ncia, p.e. Substitu?t per la ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® global de la neteja (7d).
Nota: El manteniment de tend¨¨ncies no ¨¦s pas disponible per a dades no num¨¨riques: car¨¤cters, registre i text.
Veieu tamb¨¦ hist¨°ric i tend¨¨ncies.
Mapa de valors Aplica l'assignaci¨® de valors a aquest element. Mapa de valors no canvia els valors rebuts, nom¨¦s serveix per mostrar dades.
Funciona amb Numeric(sense signe), Numeric(flotant) i °ä²¹°ù¨¤³¦³Ù±ð°ù elements.
Per exemple, "Estats del servei de Windows".
Format d'hora de registre Disponible nom¨¦s per a elements del tipus Registre. Marcadors de posici¨® admesos:
* y: Any (1970-2038)
* M: Mes (01-12)
* d: Dia (01-31)
* h: Hora (00-23)
* m: Minut (00-59)
* s: Segon (00-59)
Si es deixa en blanc, la marca de temps s'establir¨¤ a 0 de temps Unix, que representa l'1 de gener de 1970.
Per exemple, tingueu en compte la l¨ªnia seg¨¹ent del fitxer de registre de l'agent Áú»¢¶Ä²©:
"23480:20100328:154718.045 S'ha iniciat l'agent Áú»¢¶Ä²©. Áú»¢¶Ä²© 1.8.2 (revisi¨® 11211)."
Comen?a amb sis posicions de car¨¤cters per al PID, seguides de la data, l'hora i la resta de la l¨ªnia.
Temps de registre. el format d'aquesta l¨ªnia seria "pppppp:yyyyMMdd:hhmmss".
Tingueu en compte que els car¨¤cters "p" i ":" s¨®n nom¨¦s marcadors de posici¨® i poden ser qualsevol cosa menys "yMdhms".
Emplena el camp d'inventari de l'equip Podeu seleccionar un camp d'inventari de l'equip que omplir¨¤ el valor de l'element. Aix¨° funcionar¨¤ si la poblaci¨® autom¨¤tica d'inventari ¨¦s habilitada per a l'equip.
Aquest camp no ¨¦s pas disponible si Tipus d'informaci¨® ¨¦s establert a 'Registre'.
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® Introdu?u una descripci¨® de l'element.
Activat Marqueu la casella de selecci¨® per habilitar l'element perqu¨¨ es processi.
Darreres dades Fes clic a l'enlla? per veure les darreres dades de l'element.
Aquest enlla? nom¨¦s ¨¦s disponible quan s'edita un element ja existent.

Els camps espec¨ªfics del tipus d'element es descriuen a les [p¨¤gines corresponents] (tipus d'elements).

En editar un element existent de nivell plantilla a nivell d'equip, el nombre de camps s¨®n nom¨¦s de lectura. Podeu emprar l'enlla? a la cap?alera del formulariper anar al nivell de plantilla i editar-ho all¨¤, tinguent en compte que els canvis a nivell de plantilla canviaran l'element per a tots els equips on la plantilla sigui enlla?ada.

La pestanya Etiquetes permet definir el nivell d'element etiquetes.

Preprocessament del valor de l'element

La pestanya Preprocessament permet definir regles de transformaci¨® per als valors rebuts.

Provant

Per fer proves d'elements, assegureu-vos que l'hora del sistema al servidor i al proxy sigui sincronitzada. Cas que el temps del servidor sigui endarrerit, la prova d'elements pot retornar un missatge d'error "La tasca ha caducat". Tanmateix, haver establert diferents zones hor¨¤ries al servidor i al proxy no afectar¨¤ pas el resultat de la prova.

?s possible provar un element i, si ¨¦s configurat correctament, obtindre un valor real a canvi. La prova es pot produir fins i tot abans que es desi un element.

Les proves s¨®n disponibles per a elements d'equips i plantilles, prototips d'elements i regles de descoberta de baix nivell. La prova no ¨¦s disponible per als elements actius.

La prova d'elements ¨¦s disponible per als tipus d'elements passius seg¨¹ents:

  • Agent Áú»¢¶Ä²©
  • Agent SNMP (v1, v2, v3)
  • Agent IPMI
  • Comprovacions SSH
  • Comprovacions de Telnet
  • Agent JMX
  • Comprovacions senzilles (excepte els elements icmpping*, vmware.*)
  • Áú»¢¶Ä²© intern
  • Elements calculats
  • Comprovacions externes
  • Monitor de base de dades
  • Agent HTTP
  • ³Ò³Ü¾±¨®

Per provar un element, feu clic al bot¨® Prova a la part inferior del formulari de ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® de l'element. Tingueu en compte que el bot¨® Prova es desactivar¨¤ per als elements que no es poden provar (com ara comprovacions actives, comprovacions simples excloses).

El formulari de prova d'elements t¨¦ camps per als par¨¤metres de l'equip necessaris (adre?a de l'equip, port, nom del proxy/sense proxy) i detalls espec¨ªfics de l'element (com ara la comunitat SNMPv2 o credencials de seguretat SNMPv3). Aquests camps tenen en compte el context:

  • Els valors s'emplenen pr¨¨viament quan ¨¦s possible; ¨¦s a dir, per als elements que requereixen un agent, agafant la informaci¨® de la interf¨ªcie de l'agent triada de l'equip
  • Els valors s'han d'omplir manualment per als elements de plantilla
  • Es resolen els valors de macro de text pla
  • Els camps on el valor (o part del valor) ¨¦s un secret o una macro de Vault s¨®n buits i s'han d'introduir manualment. Si algun par¨¤metre d'element cont¨¦ un valor de macro secreta, es mostra el missatge d'av¨ªs seg¨¹ent: "L'element cont¨¦ macros definides per l'usuari amb valors secrets. Els valors d'aquestes macros s'han d'introduir manualment".
  • Els camps es desactiven quan no s¨®n necessaris en el context del tipus d'element (per exemple, el camp de l'adre?a de l'equip i el camp del proxy s¨®n desactivats per als elements calculats)

Per provar l'article, feu clic a Obtindre valor. Si el valor es recupera correctament, omplir¨¤ el camp Valor, movent el valor actual (si n'hi ha) al camp Valor anterior alhora que calcular¨¤ el Prev. camp de temps, ¨¦s a dir, la difer¨¨ncia de temps entre els dos valors (clics) i intentar detectar una seq¨¹¨¨ncia EOL i canviar a CRLF si es detecta "\n\r" al valor recuperat.

Si la ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® ¨¦s incorrecta, es mostra un missatge d'error que descriu la ra¨® possible.

Un valor recuperat correctament de l'equip tamb¨¦ es pot emprar per provar passes de preprocessament.

Botons de formulari

Els botons abaix del formulari permeten fer m¨²ltiples operacions.

Afegeix un element. Aquest bot¨® nom¨¦s est¨¤ disponible per a elements nous.
Actualitza les propietats dels elements.
Crear un altre element basat en les propietats de l'element actual.
Executeu immediatament una comprovaci¨® d'un nou valor d'element. Nom¨¦s s'admet per a comprovacions passives (veieu m¨¦s detalls).
Tingueu en compte que quan comproveu un valor immediatament, la ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® de la mem¨°ria cau no s'actualitza, de manera que el valor no reflectir¨¤ canvis molt recents a la ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® de l'element.
Comprova si la ³¦´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨® de l'element ¨¦s correcta obtenint un valor.
Esborra l'historial i les tend¨¨ncies d'actius.
Esborra l'element.
Cancel¡¤la la modificaci¨® de les propietats de l'element.

Conversi¨® d'unitats

Per defecte, especificar una unitat per a un element fa que s'afegeixi un prefix multiplicador; per exemple, un valor entrant ? 2048 ? amb la unitat ? o ? es mostraria com a ? 2Ko ?.

Per evitar la conversi¨® d'unitats, empreu el prefix !, per exemple, !B. Per entendre millor com funciona la conversi¨® amb i sense el signe d'exclamaci¨®, consulteu els valors i unitats d'exemple seg¨¹ents:

 1024 !B ¡ú 1024o
        1024 B ¡ú 1 Ko
        61 !s ¡ú 61s
        61 s ¡ú 1m 1s
        0 !uptime ¡ú 0 uptime
        0 uptime¡ú 00:00:00
        0 !! ¡ú 0 !
        0 ! ¡ú 0

Abans de Áú»¢¶Ä²© 4.0, hi havia una llista d'aturada d'unitat codificada en brut composta de ms, rpm, RPM, %. Aquesta llista d'aturada est¨¤ obsoleta, de manera que la manera correcta d'evitar la conversi¨® d'aquestes unitats ¨¦s !ms, !rpm, !RPM, !%.

L¨ªmit de les dades de text

Els l¨ªmits del tipus de dades de text depenen del backend de la base de dades. Abans d'emmagatzemar els valors de text a la base de dades, es trunquen per coincidir amb el l¨ªmit de tipus de valor de la base de dades:

Base de dades Tipus d'informaci¨®
°ä²¹°ù¨¤³¦³Ù±ð°ù Registre Text
MySQL 255 car¨¤cters 65536 octets 65536 octets
PostgreSQL 255 car¨¤cters 65536 car¨¤cters 65536 car¨¤cters
Oracle 255 car¨¤cters 65536 car¨¤cters 65536 car¨¤cters
SQLite (nom¨¦s Áú»¢¶Ä²© proxy) 255 car¨¤cters 65536 car¨¤cters 65536 car¨¤cters

L¨ªmit d'script personalitzat

La longitud disponible d'script personalitzat dep¨¨n de la base de dades emprada:

Base de dades L¨ªmit en car¨¤cters L¨ªmit en octets
MySQL 65535 65535
PostgreSQL 65535 no limitat
Oracle 2048 4000
SQLite (nom¨¦s proxy Áú»¢¶Ä²©) 65535 no limitat

Elements no admesos

Un element pot quedar sense suport si el seu valor no es pot recuperar per algun motiu. Aquests elements sempre es tornen a comprovar amb el seu interval d'actualitzaci¨® ±ð²õ³Ù¨¤²Ô»å²¹°ù»å.

Els elements no suportats s'han marcat com a estat NO ADM?S.