From 3811443bec0a7d729ee6a6d0520f1c1954cd2a71 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Pedro?= Date: Mon, 26 Jan 2026 11:43:36 -0300 Subject: [PATCH] docs: define telegram notification groups and MSP strategy --- README.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/README.md b/README.md index f56ea65..19455c0 100644 --- a/README.md +++ b/README.md @@ -53,6 +53,31 @@ Ferramenta para fundir o melhor de dois mundos: templates oficiais da Zabbix com --- +## 📢 Criação e Definição de Salas (Telegram) + +Para evitar a fadiga de alertas e garantir que problemas críticos sejam tratados imediatamente, utilizamos uma estrutura de grupos segmentada por **Severidade** e **Função**. + +### A Regra de Ouro do MSP (Multi-Cliente) +Como atendemos múltiplos clientes, não criamos um grupo por cliente. Centralizamos por função e usamos **Tags** no início da mensagem. +> **Exemplo:** `🔥 [Coca-Cola] Oracle Down` ou `🐘 [Pepsi] Deadlock detectado` + +### 📋 Tabela de Grupos e Mídias + +| Canal (Grupo Telegram) | Nível de Severidade / Uso | Objetivo | Retenção Sugerida | +| :--- | :--- | :--- | :--- | +| **🌐 iTGuys - Alertas Queda de Link** | 🚨 Disaster (Network only) | **EXCLUSIVO** para quedas de link do Datacenter (Redundância). | Eterna | +| **🔥 iTGuys - Alertas Criticos** | 🚨 Disaster (Action Required) | Focado em "VOCÊ TEM QUE FAZER ALGUMA COISA AGORA". Incidentes que exigem intervenção humana imediata. Zero ruído. | Eterna | +| **🔒 iTGuys - Alertas de Segurança** | 🚨 High, 🔥 Warning (SecOps) | Tentativas de invasão, Brute-force RDP/SSH, falhas de login excessivas, portas suspeitas. | Eterna | +| **🐘 iTGuys - Alertas Banco de Dados** | ⚠️ Warning, 🔥 High (DBA) | Deadlocks, Queries Lentas, Conexões. Centraliza problemas de DB de **todos os clientes**. | 90 Dias | +| **💾 iTGuys - Alertas Storage** | ⚠️ Warning, 🔥 High (Storage) | Tudo sobre Storage e Discos. Pode conter avisos preventivos, mas é o único lugar para assuntos de armazenamento. | 90 Dias | +| **♻️ iTGuys - Alertas Backups** | ℹ️ Info, ⚠️ Warning (Backup Jobs) | Exclusivo para jobs e processos de backup (Sucesso/Falha). Ignora status do host (UP/DOWN). | 90 Dias | +| **👾 Gitea Gerencial** | ⚠️ Warning (KPIs/Management) | Focado em **Gestão e Prazos**. Projetos atrasados, ausência de commits por 7+ dias. (Nada de "push" logs). | 30 Dias | +| **🃏 Ronald Santoro - Eventos dos Sistemas** | ℹ️ Info, ⚠️ Warning (Default) | **Curinga (Wildcard)**. Se o alerta não se enquadra nas categorias acima, ele cai aqui. | 30 Dias | + +> **💡 Dica:** Para descobrir o `Chat ID` de um grupo, adicione o bot `@RawDataBot` ao grupo, copie o ID negativo (ex: `-100123456789`) e depois remova o bot. + +--- + ## ✨ Como Contribuir 1. **Valide sempre:** Antes de commitar qualquer template, execute o `validate_zabbix_template.py`.