韓誥傭痔

Table of Contents

2 Macros d'usuari

2 Macros d'usuari

Vista general

Les macros d'usuari s'admeten a 韓誥傭痔 per a una major flexibilitat, a m谷s de les macros admeses de base.

Les macros d'usuari es poden definir a nivell global, model i equip. Aquestes macros tenen una sintaxi especial:

 {$MACRO}

韓誥傭痔 resol les macros segons la prioritat seg邦ent:

Macros del nivell d'equip (marcades primer)
macros definides per a plantilles d'equips de primer nivell (谷s a dir, plantilles enlla?ades directament a l'equip), ordenades per ID de plantilla
macros definides per a plantilles d'equips de segon nivell, ordenades per ID de plantilla
macros definides per a plantilles d'equips de tercer nivell, ordenades per ID de plantilla, etc.
macros globals (darrer marcada)

En altres paraules, si una macro no existeix per a un equip, 韓誥傭痔 intentar角 trobar-la en plantilles d'equips de m谷s profunditat. Si encara no es troba, s'emprar角 una macro global, si existeix.

Si existeix una macro amb el mateix nom en diversos models enlla?ats del mateix nivell, s'emprar角 la macro del model amb l'identificador m谷s baix. Per tant, tindre macros amb el mateix nom en diverses plantilles 谷s un risc de configuraci車.

Si 韓誥傭痔 no troba una macro, la macro no es resoldr角.

Les macros (incloses les macros d'usuari) es deixen sense resoldre a la secci車唬棗紳款勳眶喝娶硃釵勳車 (per exemple, a la llista de triggers) per disseny per fer que la configuraci車 complexa sigui m谷s transparent.

Les macros d'usuari es poden emprar a:

el par角metre clau de l'element
Intervals d'actualitzaci車 d'elements i intervals flexibles
el nom i la descripci車 del trigger
par角metres i constants de l'expressi車 activa (veieu exemples)
moltes altres ubicacions - veieu la llista sencera

Casos comuns d'usos de macros globals i d'equips

empreu una macro global a diversos llocs; tot seguit, canvieu el valor de la macro i apliqueu els canvis de configuraci車 a totes les ubicacions amb un sol clic
Aprofiteu els patrons amb atributs espec赤fics de l'equip: mots de pas, nombres de port, noms de fitxers, expressions regulars, etc.

?s recomanable emprar macros d'equip en lloc de macros globals perqu豕 afegir, actualitzar o esborrar macros globals obliga a l'actualitzaci車 incremental de la configuraci車 per a tots els equips. Per obtindre m谷s informaci車, veieu Notes d'actualitzaci車 per a 6.4.0.

唬棗紳款勳眶喝娶硃釵勳車

Per definir macros d'usuari, aneu a la ubicaci車 corresponent a la interf赤cie:

per a macros globals, visiteu 插餃鳥勳紳勳莽喧娶硃釵勳車 ↙ Macros
Per a les macros de nivell d'equip i plantilla, obriu les propietats de l'equip o de la plantilla i cerqueu la pestanya Macros

Si s'empra una macro d'usuari en elements o triggers d'una plantilla, es recomana afegir aquesta macro a la plantilla encara que sigui definida a nivell global. Aix赤, si el tipus de macro 谷s text, exportar el model a XML i importar-lo a un altre sistema far角 que funcioni com s'esperava. Els valors de macro secretes no s'exporten.

Una macro d'usuari t谷 els atributs seg邦ents:

捩硃娶角鳥梗喧娶梗	嗨梗莽釵娶勳梯釵勳車
Macro	Nom de la macro. El nom ha d'anar entre claus i comen?ar amb un signe de d辰lar. Exemple: {$FRONTEND_URL}. Els car角cters seg邦ents es permeten als noms de macro: A-Z (nom谷s en maj迆scules), 0-9, _, .
Valor	Valor de macro. S'admeten tres tipus de valors: Text (predeterminat) - valor de text sense format Text secret - el valor 谷s emmascarat amb asteriscs Vault secret - el valor cont谷 un cam赤 de refer豕ncia a un Vault Secret Per canviar el valor feu clic al bot車 al final del camp d'entrada de valor L'allargada m角xima d'un valor de la macro d'usuari 谷s de 2048 car角cters (255 car角cters en versions anteriors a la 5.2.0).
嗨梗莽釵娶勳梯釵勳車	Camp de text emprat per proporcionar m谷s informaci車 sobre aquesta macro.

A les expressions triggers, les macros d'usuari es resoldran si fan refer豕ncia a un par角metre o una constant. NO es resoldran si es refereixen a un equip, clau d'element, funci車, operador o una altra expressi車 trigger. Les macros secretes no es poden emprar en expressions de triggers.

Exemples

Exemple 1

?s d'una macro a nivell d'equip a la clau d'element "estat del dimoni SSH":

net.tcp.service[ssh,,{$SSH_PORT}]

Aquest element es pot atribuir a diferents equips, amb la condici車 que el valor d'{$SSH_PORT} sigui definit a aquests equips.

Exemple 2

?s d'una macro d'equip al trigger "La c角rrega del processador 谷s molt alta":

last(/ca_001/system.cpu.load[,avg1])>{$MAX_CPULOAD}

Aquest trigger es crearia a la plantilla, no es modificaria en equips individuals.

Si voleu emprar la quantitat de valors com a par角metre de funci車 (per exemple, max(/host/key,#3)), incloeu el signe de lletra a la definici車 de macro com aquesta: SOME_PERIOD => #3

Exemple 3

?s de dues macros al trigger "La c角rrega de CPU 谷s molt alta":

min(/ca_001/system.cpu.load[,avg1],{$CPULOAD_PERIOD})>{$MAX_CPULOAD}

Veieu que una macro es pot emprar com a par角metre de la funci車 de trigger; en aquest exemple, la funci車 min().

Exemple 4

Sincronitzaci車 de la condici車 de no disponibilitat de l'agent amb l'interval d'actualitzaci車 de l'element:

definit la macro {$INTERVAL} i emprar-la a l'interval d'actualitzaci車 de l'element;
emprar {$INTERVAL} com a par角metre del trigger de no disponibilitat de l'agent?:

nodata(/ca_001/agent.ping,{$INTERVAL})=1

Exemple 5

Centralitzar la configuraci車 de les hores de feina:

crear una macro global {$WORKING_HOURS} igual a 1-5,09:00-18:00;
emprar-la al camp Horari laboral a 插餃鳥勳紳勳莽喧娶硃釵勳車 ↙ General ↙ GUI;
emprar-la al camp Quan sigui actiu a Usuaris ↙ Usuari ↙ Suports d'un usuari;
emprar-la per configurar una consulta m谷s freq邦ent d'elements durant l'horari laboral:

emprar-la a la condici車 d'acci車 捩梗娶赤棗餃梗;
ajustar el temps de treball a 插餃鳥勳紳勳莽喧娶硃釵勳車 ↙ Macros, si cal.

Exemple 6

Emprar la macro del prototip d'equip per configurar coses per als equips descoberts:

en un prototip d'equip, establiu la macro d'usuari {$SNMPVALUE} amb la macro {#SNMPVALUE} de descoberta de baix nivell com a valor:

assigneu la plantilla Generic SNMPv2 al prototip d'equip;
empreu {$SNMPVALUE} al camp SNMP OID dels elements de plantilla Generic SNMPv2.

Context de la macro d'usuari

Veieu macros d'usuari amb context.