Sidebar

4 Usando macros em mensagens

Visão geral

As macros podem ser usadas de forma eficiente tanto no assunto quanto no corpo da mensagem para melhorar a qualidade da informação fornecida quando se alerta sobre um incidente.

Existe manual com a lista completa de macros que são suportadas pelo Zabbix.

Exemplos

Os exemplos a seguir ilustram como as macros podem ser utilizadas nas mensagens.

Exemplo 1

Assunto da mensagem:

{TRIGGER.NAME}: {TRIGGER.STATUS}

Quando você receber a mensagem, o assunto da mensagem será substituído por algo similar à:

Processor load is too high on server zabbix.zabbix.com: INCIDENTE
Exemplo 2

Mensagem:

Processor load is: {zabbix.zabbix.com:system.cpu.load[,avg1].last()}

Quando você receber a mensagem, o corpo da mensagem será substituído por algo similar à:

Processor load is: 1.45
Exemplo 3

Mensagem:

Latest value: {{HOST.HOST}:{ITEM.KEY}.last()}
       MAX for 15 minutes: {{HOST.HOST}:{ITEM.KEY}.max(900)}
       MIN for 15 minutes: {{HOST.HOST}:{ITEM.KEY}.min(900)}

Quando você receber a mensagem, o corpo da mensagem será substituído por algo similar à:

Latest value: 1.45
       MAX for 15 minutes: 2.33
       MIN for 15 minutes: 1.01
Exemplo 4

Informando sobre valores de diversos hosts em uma mesma expressão de trigger.

Mensagem:

Trigger: {TRIGGER.NAME}
       Trigger expression: {TRIGGER.EXPRESSION}
        
       1. Item value on {HOST.NAME1}: {ITEM.VALUE1} ({ITEM.NAME1})
       2. Item value on {HOST.NAME2}: {ITEM.VALUE2} ({ITEM.NAME2})

Quando você receber a mensagem, o corpo da mensagem será substituído por algo similar à:

Trigger: Processor load is too high on a local host
       Trigger expression: {Myhost:system.cpu.load[percpu,avg1].last()}>5 | {Myotherhost:system.cpu.load[percpu,avg1].last()}>5
       
       1. Item value on Myhost: 0.83 (Processor load (1 min average per core))
       2. Item value on Myotherhost: 5.125 (Processor load (1 min average per core))
Exemplo 5

Recebendo detalhes tanto do evento de problema quanto do evento de recuperação:

Mensagem:

Problem:
       
       Event ID: {EVENT.ID}
       Event value: {EVENT.VALUE} 
       Event status: {EVENT.STATUS} 
       Event time: {EVENT.TIME}
       Event date: {EVENT.DATE}
       Event age: {EVENT.AGE}
       Event acknowledgement: {EVENT.ACK.STATUS} 
       Event acknowledgement history: {EVENT.ACK.HISTORY}
       
       Recovery: 
       
       Event ID: {EVENT.RECOVERY.ID}
       Event value: {EVENT.RECOVERY.VALUE} 
       Event status: {EVENT.RECOVERY.STATUS} 
       Event time: {EVENT.RECOVERY.TIME}
       Event date: {EVENT.RECOVERY.DATE}

Quando você receber a mensagem as macros serão substituídas por algo similar à:

Problem:
       
       Event ID: 21874
       Event value: 1 
       Event status: PROBLEM 
       Event time: 13:04:30
       Event date: 2014.01.02
       Event age: 5m
       Event acknowledgement: Yes 
       Event acknowledgement history: 2014.01.02 13:05:51 "John Smith (Admin)"
       -acknowledged-
       
       Recovery: 
       
       Event ID: 21896
       Event value: 0 
       Event status: OK 
       Event time: 13:10:07
       Event date: 2014.01.02

As notificações em separado dos problemas e recuperações são suportadas desde o Zabbix 2.2.0.

Example 6

Receiving details of both the problem event and recovery event in a recovery message:

Message:

Problem:
       
       Event ID: {EVENT.ID}
       Event value: {EVENT.VALUE} 
       Event status: {EVENT.STATUS} 
       Event time: {EVENT.TIME}
       Event date: {EVENT.DATE}
       Event age: {EVENT.AGE}
       Event acknowledgment: {EVENT.ACK.STATUS} 
       Event update history: {EVENT.UPDATE.HISTORY}
       
       Recovery: 
       
       Event ID: {EVENT.RECOVERY.ID}
       Event value: {EVENT.RECOVERY.VALUE} 
       Event status: {EVENT.RECOVERY.STATUS} 
       Event time: {EVENT.RECOVERY.TIME}
       Event date: {EVENT.RECOVERY.DATE}

When you receive the message, the macros will be replaced by something like:

Problem:
       
       Event ID: 21874
       Event value: 1 
       Event status: PROBLEM 
       Event time: 13:04:30
       Event date: 2018.01.02
       Event age: 5m
       Event acknowledgment: Yes 
       Event update history: 2018.01.02 13:05:51 "John Smith (Admin)"
       Actions: acknowledged.
       
       Recovery: 
       
       Event ID: 21896
       Event value: 0 
       Event status: OK 
       Event time: 13:10:07
       Event date: 2018.01.02

Separate notification macros for the original problem event and recovery event are supported since Zabbix 2.2.0.