Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

6 Macros de expresión

Descripción general

Las macros de expresión son útiles para cálculos de fórmulas. Se calculan expandiendo todas las macros dentro de ellas y evaluando la expresión resultante.

Las macros de expresión tienen una sintaxis especial:

{?EXPRESIÓN}

La sintaxis en EXPRESIÓN es la misma que en expresiones de disparadores (ver limitaciones de uso más abajo).

Las macros {FUNCTION.VALUE<1-9>} y {FUNCTION.RECOVERY.VALUE<1-9>} pueden usarse para hacer referencia a los valores de función de las expresiones de disparadores y expresiones de recuperación de disparadores, por ejemplo:

{?{FUNCTION.VALUE2} - {FUNCTION.VALUE3}}

Las macros {HOST.HOST<1-9>} y {ITEM.KEY<1-9>} pueden usarse dentro de las funciones para hacer referencia a equipos y métricas, por ejemplo:

{?max(/{HOST.HOST}/{ITEM.KEY},3h)}

Uso

En las siguientes ubicaciones:

  • nombres de gráficos
  • etiquetas de elementos de mapa
  • etiquetas de formas de mapa
  • etiquetas de enlaces de mapa

solo se permite una única función, del siguiente conjunto: avg, last, max, min, como una macro de expresión, por ejemplo:

{?avg(/{HOST.HOST}/{ITEM.KEY},1h)}

Expresiones como {?last(/equipo/métrica1)/last(/equipo/métrica2)}, {?count(/equipo/métrica1,5m)} y {?last(/equipo/métrica1)*10} son incorrectas en estas ubicaciones.

Sin embargo, en:

  • nombres de eventos de disparadores
  • notificaciones y comandos basados en disparadores
  • notificaciones y comandos de actualización de problemas

se permiten expresiones complejas, por ejemplo:

{?trendavg(/equipo/métrica1,1M:now/M)/trendavg(/equipo/métrica1,1M:now/M-1y)*100}

Al usar macros de expresión en plantillas, por favor no especifique el nombre de la plantilla, sino que utilice {HOST.HOST<N>}, porque los nombres de las plantillas no se sustituyen por los equipos durante el enlace. También puede omitir la referencia al equipo por completo para el primer equipo, por ejemplo: {?avg(//métrica1,1h)}

Véase también:

  • Macros soportadas para una lista de ubicaciones soportadas de la macro de expresión
  • Ejemplo de uso de una macro de expresión en el nombre del evento