Alerta que responde 'onde, quantos e desde quando': montando a mensagem do Zabbix pro Telegram

"PROBLEM: Interface down on OLT-07". É assim que chega boa parte dos alertas do Zabbix nos grupos de Telegram de provedor. E a primeira reação do técnico é sempre a mesma: abrir o notebook pra descobrir onde fica a OLT-07, quantos clientes estão atrás dela e se isso é novo ou está assim há uma hora. A mensagem poderia ter respondido tudo isso.

O que um bom alerta responde

1. O quê — o problema, em linguagem que o plantão entende.
2. Onde — cidade, POP, endereço; idealmente um link de mapa.
3. Quanto — severidade e impacto (quantos clientes, qual serviço).
4. Desde quando — e, na recuperação, quanto tempo durou.
5. O que fazer — link pro procedimento ou pro painel.

As macros que entregam isso

O Zabbix já tem as informações; a mensagem só precisa usá-las:

• {EVENT.NAME} e {EVENT.SEVERITY} — o problema e a severidade.
• {HOST.NAME} e {HOST.IP} — o equipamento (lembrando: {HOSTNAME} e {IPADDRESS} saem no Zabbix 8.0).
• {INVENTORY.LOCATION} — endereço/local cadastrado no inventário do host.
• {INVENTORY.LOCATION.LAT} e {INVENTORY.LOCATION.LON} — coordenadas; dá pra montar um link de mapa direto na mensagem.
• {EVENT.TAGS} ou {EVENT.TAGS.<nome>} — tags como cidade, pop, clientes.
• {EVENT.AGE} e {EVENT.DURATION} — há quanto tempo o problema está aberto ou quanto durou.
• {EVENT.ID} e {TRIGGER.ID} — pra montar link direto pro evento no frontend.

Um modelo de mensagem

🔴 {EVENT.SEVERITY}: {EVENT.NAME}
📍 {INVENTORY.LOCATION} ({EVENT.TAGS.cidade})
🖥 {HOST.NAME} — {HOST.IP}
👥 Clientes afetados: {EVENT.TAGS.clientes}
⏱ Aberto há {EVENT.AGE}
🗺 https://maps.google.com/?q={INVENTORY.LOCATION.LAT},{INVENTORY.LOCATION.LON}

E na recuperação, a mesma estrutura com {EVENT.DURATION} — "voltou depois de 42 minutos" é informação que o atendimento usa na hora.

Pré-requisitos (onde a maioria trava)

• Inventário preenchido. Sem endereço e coordenadas no host, as macros saem vazias. Popular o inventário via API, a partir do cadastro de rede, resolve de uma vez.
• Tags consistentes. cidade num host e Cidade em outro quebra a mensagem. Defina o padrão e aplique por template.
• Grupos por severidade. Desastre vai pro grupo do plantão; aviso vai pra um canal de acompanhamento. Tudo no mesmo grupo vira ruído — e ruído vira grupo silenciado.

Mensagem com contexto é o primeiro passo; o segundo é ver todos esses alertas no mapa ao mesmo tempo. É o que o NOC Geomap faz.

Fontes: Zabbix — Supported macros (documentação 7.0) e Zabbix — Telegram media type.