¿Qué macros podemos utilizar en las alertas de Pandora FMS?

Existen con el propósito de dinamizar los mensajes de las acciones ejecutadas por las alertas.

Consisten en la sustitución de una cadena _macro_ por un texto.

Se definen por defecto las siguientes macros:

• _address_: Dirección del agente que disparó la alerta.
• _address_n_ : La dirección del agente que corresponde a la posición indicada en “n”. Ejemplo: address_1_ , address_2_.
• _agent_: Alias del agente que disparó la alerta. Si no tiene asignado alias, se usa el nombre del agente.
• _agentalias_: Alias del agente que disparó la alerta.
• _agentcustomfield_n_: Campo personalizado número “ene” del agente (ej. _agentcustomfield_9_).
• _agentcustomid_: Identificador (ID) personalizado del agente.
• _agentdescription_: Descripción del agente que disparó la alerta.
• _agentgroup_ : Nombre del grupo del agente.
• _agentname_: Nombre del agente que disparó la alerta.
• _agentos_: Sistema operativo del agente.
• _agentstatus_ : Estado actual del agente.
• _alert_critical_instructions_: Instrucciones contenidas en el módulo para un estado CRITICAL.
• _alert_description_: Descripción de la alerta.
• _alert_name_: Nombre de la alerta.
• _alert_priority_: Prioridad numérica de la alerta.
• _alert_text_severity_: Prioridad en texto de la alerta ( Maintenance, Informational, Normal, Minor, Warning, Major, Critical).
• _alert_threshold_: Umbral de la alerta.
• _alert_times_fired_: Número de veces que se ha disparado la alerta.
• _alert_unknown_instructions_: Instrucciones contenidas en el módulo para un estado UNKNOWN.
• _alert_warning_instructions_: Instrucciones contenidas en el módulo para un estado WARNING.
• _all_address_ : Todas las direcciones del agente que disparó la alerta.
• _data_: Dato que hizo que la alerta se disparase.
• _email_tag_: Emails asociados a las etiquetas (tags) de módulos.
• _event_cfX_: (Solo alertas de evento). Clave del campo personalizado del evento que disparó la alerta. Por ejemplo, si hay un campo personalizado cuya clave es IPAM, se puede obtener su valor usando la macro _event_cfIPAM_.
• _event_description_ : (Solo alertas de evento) Descripción textual del evento de Pandora FMS.
• _event_extra_id_ : (Solo alertas de evento) ID extra.
• _event_id_: (Solo alertas de evento) ID del evento que disparó la alerta.
• _event_text_severity_: (Solo alertas de evento) Prioridad en texto de el evento que dispara la alerta (Maintenance, Informational, Normal, Minor, Warning, Major, Critical).
• _eventTimestamp_: Timestamp en el que se creó el evento.
• _fieldX_: Campo C definido por el usuario.
• _groupcontact_: Información de contacto del grupo. Se configura al crear el grupo.
• _groupcustomid_: ID personalizado del grupo.
• _groupother_: Otra información sobre el grupo. Se configura al crear el grupo.
• _homeurl_: Es un enlace de la URL pública que debe configurarse en las opciones generales de la configuración.
• _id_agent_: ID del agente, útil para construir URL de acceso a la consola de Pandora FMS.
• _id_alert_: ID de la alerta, útil para correlacionar la alerta en herramientas de terceros.
• _id_group_ : ID del grupo de agente.
• _id_module_: ID del módulo.
• _interval_: Intervalo de la ejecución del módulo.
• _module_: Nombre del módulo.
• _modulecustomid_: ID personalizado del módulo.
• _moduledata_X_: Usando esta macro (“X” es el nombre del módulo en cuestión) recogemos el último dato de este módulo y si es numérico lo devuelve formateado con los decimales especificados en la configuración de la Consola y con su unidad (si la tiene). Serviría para, por ejemplo, al enviar un correo al saltar una alerta de módulo, enviar también información adicional (y quizás muy relevante) de otros módulos del mismo agente.
• _moduledescription_: Descripción del módulo.
• _modulegraph_nh_: (Solo para alertas que usen el comando eMail) Devuelve una imagen codificada en base64 de una gráfica del módulo con un período de “ene” horas (ejemplo: _modulegraph_24h_). Requiere de una configuración correcta de la conexión del servidor a la consola vía API, la cual se realiza en el fichero de configuración del servidor.
• _modulegraphth_nh_: (Solo para alertas que usen el comando eMail) Misma operación que la macro anterior pero sólo con los umbrales crítico y de advertencia del módulo, en caso de que estén definidos.
• _modulegroup_: Nombre del grupo del módulo.
• _modulestatus_: Estado del módulo.
• _modulelaststatuschange_: Timestamp en el que se produjo el último cambio de estado del módulo.
• _moduletags_: Las URL asociadas a los tags de módulos.
• _name_tag_: Nombre de los tags asociados al módulo.
• _phone_tag_: Teléfonos asociados a los tags de módulos.
• _plugin_parameters_: Parámetros del plugin del módulo.
• _policy_: Nombre de la política a la que pertenece el módulo (si aplica).
• _prevdata_: Dato previo antes de disparase la alerta.
• _rca_: Cadena de análisis de causa raíz (sólo para servicios).
• _secondarygroups_: Muestra los grupos secundarios del agente.
• _server_ip_: Dirección IP del servidor al que el agente está asignado.
• _server_name_: Nombre del servidor al que el agente está asignado.
• _target_ip_: Dirección IP del objetivo del módulo.
• _target_port_: Puerto del objetivo del módulo.
• _timestamp_: Hora y fecha en que se disparó la alerta.
• _timezone_: Zona horaria que se representa en _timestamp_.

Aparte de estas macros, podemos utilizar las macros personalizadas definidas en los módulos.

Para más información consulte nuestra Wiki oficial:
https://pandorafms.com/manual/es/documentation/04_using/01_alerts#lista_de_macros.