diff --git a/README.md b/README.md index 38be267..014e6b4 100644 --- a/README.md +++ b/README.md @@ -65,15 +65,38 @@ Como atendemos múltiplos clientes, não criamos um grupo por cliente. Centraliz | Canal (Grupo Telegram) | Chat ID | Nível de Severidade / Uso | Objetivo | Retenção Sugerida | | :--- | :--- | :--- | :--- | :--- | -| **🌐 iTGuys - Alertas Queda de Link** | `-1002788825367` | 🚨 Disaster (Network only) | **EXCLUSIVO** para quedas de link do Datacenter (Redundância). | Eterna | -| **🔥 iTGuys - Alertas Criticos** | `-1002109756180` | 🚨 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** | *Pendente* | 🚨 High, 🔥 Warning (SecOps) | Tentativas de invasão, Brute-force RDP/SSH, falhas de login excessivas, portas suspeitas. | Eterna | -| **🐘 iTGuys - Alertas Banco de Dados** | *Pendente* | ⚠️ Warning, 🔥 High (DBA) | Deadlocks, Queries Lentas, Conexões. Centraliza problemas de DB de **todos os clientes**. | 90 Dias | -| **💾 iTGuys - Alertas Storage** | *Pendente* | ⚠️ 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** | `-1002390490763` | ℹ️ Info, ⚠️ Warning (Backup Jobs) | Exclusivo para jobs e processos de backup (Sucesso/Falha). Ignora status do host (UP/DOWN). | 90 Dias | -| **👾 Gitea Gerencial** | `-4557333759` | ⚠️ Warning (KPIs/Management) | Focado em **Gestão e Prazos**. Projetos atrasados, ausência de commits por 7+ dias. (Nada de "push" logs). | 30 Dias | -| **🔨 Gitea - Operacional** | `-4561812933` | ℹ️ Info (DevOps) | Logs técnicos, Commits, Pushes e Merges do dia a dia. | 30 Dias | -| **🃏 Ronald Santoro - Eventos dos Sistemas** | `-1002285824936` | ℹ️ Info, ⚠️ Warning (Default) | **Curinga (Wildcard)**. Se o alerta não se enquadra nas categorias acima, ele cai aqui. | 30 Dias | +| **🌐 iT Guys - Alertas Queda de Link** | `-1002788825367` | 🚨 Disaster (Network only) | **EXCLUSIVO** para quedas de link do Datacenter (Redundância). | Eterna | +| **🔥 iT Guys - Alertas Criticos** | `-1002109756180` | 🚨 Disaster (Action Required) | Focado em "VOCÊ TEM QUE FAZER ALGUMA COISA AGORA". Incidentes que exigem intervenção humana imediata. Zero ruído. | Eterna | +| **🔒 iT Guys - Alertas de Segurança** | *Pendente* | 🚨 High, 🔥 Warning (SecOps) | Tentativas de invasão, Brute-force RDP/SSH, falhas de login excessivas, portas suspeitas. | Eterna | +| **🐘 iT Guys - Alertas Banco de Dados** | *Pendente* | ⚠️ Warning, 🔥 High (DBA) | Deadlocks, Queries Lentas, Conexões. Centraliza problemas de DB de **todos os clientes**. | 90 Dias | +| **💾 iT Guys - Alertas Storage** | *Pendente* | ⚠️ Warning, 🔥 High (Storage) | Tudo sobre Storage e Discos. Pode conter avisos preventivos, mas é o único lugar para assuntos de armazenamento. | 90 Dias | +| **♻️ iT Guys - Alertas Backups** | `-1002390490763` | ℹ️ Info, ⚠️ Warning (Backup Jobs) | Exclusivo para jobs e processos de backup (Sucesso/Falha). Ignora status do host (UP/DOWN). | 90 Dias | +| **👾 iT Guys - Gitea Gerencial** | `-4557333759` | ⚠️ Warning (KPIs/Management) | Focado em **Gestão e Prazos**. Projetos atrasados, ausência de commits por 7+ dias. (Nada de "push" logs). | 30 Dias | +| **🔨 iT Guys - Gitea Operacional** | `-4561812933` | ℹ️ Info (DevOps) | Logs técnicos, Commits, Pushes e Merges do dia a dia. | 30 Dias | +| **🃏 iT Guys - Ronald Santoro (Eventos)** | `-1002285824936` | ℹ️ Info, ⚠️ Warning (Default) | **Curinga (Wildcard)**. Se o alerta não se enquadra nas categorias acima, ele cai aqui. | 30 Dias | + +### 🎣 Configuração de Webhooks (Gitea) +Para garantir a eficiência dos canais acima, configure os webhooks do Gitea da seguinte forma: + +#### 1. 👾 iT Guys - Gitea Gerencial +**Foco:** Gestão de Projetos, Prazos e Entregas (Releases/PRs). +* [x] **Repositório** (Criado/Excluído) +* [x] **Versão** (Publicada/Atualizada) +* [x] **Pull Request** (Apenas Abertura/Fechamento/Merge) +* [x] **Issues** (Abertura/Fechamento - *Sem comentários*) +* [x] **Pacote** (Publicado) + +#### 2. 🔨 iT Guys - Gitea Operacional +**Foco:** Atividade de Código, Logs de Desenvolvimento e Code Review. +* [x] **Push** (Commits) +* [x] **Criar** (Branch/Tag) +* [x] **Excluir** (Branch/Tag) +* [x] **Fork** +* [x] **Comentário da issue** (Discussões técnicas) +* [x] **Comentário no Pull Request** (Code Review) +* [x] **Pull Request Review Requested** +* [x] **Pull Request Sincronizado** +* [x] **Wiki** (Edições) ### 🔑 Credenciais de Bots (API Keys) > **⚠️ CUIDADO:** Estas chaves dão acesso de escrita aos grupos. @@ -88,6 +111,48 @@ Como atendemos múltiplos clientes, não criamos um grupo por cliente. Centraliz --- +### ⚙️ Configuração Zabbix 7.0 (The Gold Way) + +Utilizamos a estratégia de **Roteamento via Ações (Action-Based Routing)**. +Neste modelo, o **Media Type** é apenas o "cano" e a **Action** é o "cérebro" que escolhe qual cano usar. + +#### 1. Media Types (Canais) +Como cada bot tem um Token único, precisamos de um Media Type para cada um. +1. Vá em **Alertas > Tipos de Mídias**. +2. **Clone** o tipo `Telegram` padrão. +3. **Renomeie** para: `Telegram_[Nome_Do_Canal]` (ex: `Telegram_Criticos`). +4. **Token:** Insira o Token do bot específico na variável `api_token`. + +#### 2. Usuário de Serviço (`itguys`) +Não crie um usuário para cada bot. Use um usuário central (ex: `itguys`). +1. Vá em **Alertas > Mídia** do usuário `itguys`. +2. Adicione **TODOS** os Media Types criados no passo anterior. +3. **Não use filtros de severidade aqui.** Deixe `1-7,00:00-24:00; N I A M A D` (tudo habilitado). + +#### 3. Actions (O Cérebro) +Aqui definimos quem recebe o quê. Para cada canal, crie uma **Action** separada. + +**Passo a Passo na Interface:** +1. **Ação:** Dê um nome claro (ex: `📢 Dispatch: Críticos`). +2. **Condições:** Defina as regras (Tag ou Severidade). +3. **Operações:** Adicione uma operação de envio. + * **Enviar para usuários:** Selecione `itguys` (ou `Zabbix administrators`). + * **Send to media type:** Selecione **APENAS** o Media Type específico daquele canal (ex: `Telegram_Criticos`). + +**Matriz de Ações Recomendada:** + +| Nome da Action | Aba: Condições (A) | Aba: Operações (B) -> Send directly to media type | +| :--- | :--- | :--- | +| **📢 Dispatch: Link** | Tag `target` igual a `network_wan` | `Telegram_Link` | +| **📢 Dispatch: Segurança** | Tag `class` igual a `security` | `Telegram_Sec` | +| **📢 Dispatch: Banco/Dados**| Tag `class` igual a `database` | `Telegram_Dados` | +| **📢 Dispatch: Storage** | Tag `class` igual a `storage` | `Telegram_Storage` | +| **📢 Dispatch: Backups** | Tag `class` igual a `backup` | `Telegram_Backup` | +| **📢 Dispatch: Críticos** | Severidade maior ou igual a `Média` | `Telegram_Criticos` | +| **📢 Dispatch: Geral** | (Sem condições específicas) | `Telegram` (Padrão/Ronald) | + +--- + ## ✨ Como Contribuir 1. **Valide sempre:** Antes de commitar qualquer template, execute o `validate_zabbix_template.py`.