docs: normalize telegram groups and add zabbix 7.0 config guide
This commit is contained in:
João Pedro
parent
92ebc26cbc
commit
57ae74a031
71
README.md
71
README.md
|
|
@ -71,9 +71,32 @@ Como atendemos múltiplos clientes, não criamos um grupo por cliente. Centraliz
|
|||
| **🐘 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 |
|
||||
| **👾 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 - 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`.
|
||||
|
|
|
|||
Loading…
Reference in New Issue