> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/sistema/relatorios/recursos/gatilhos-ativos.md). # Gatilhos disparados ## 📝 Relatório de Gatilhos Disparados no Tiflux ``` 📍 Localização: 📂 Menu > Relatórios > Recurso > Gatilhos disparados ``` *** ### 🎯 Introdução O relatório de **Gatilhos Disparados** é uma ferramenta essencial para monitoramento proativo de recursos monitorados no Tiflux. Este relatório exibe todos os alertas e eventos automáticos que foram acionados pelo sistema de monitoramento e que ainda não foram resolvidos ou visualizados pela equipe técnica. Com ele, você consegue acompanhar em tempo real problemas detectados em recursos como links, servidores, scripts, ping, métricas de desempenho e muito mais. A interface permite marcar cada evento como "Resolvido", mantendo a lista sempre atualizada com apenas os incidentes pendentes de atenção. > ✅ Ideal para monitoramento de infraestrutura, resposta rápida a incidentes e controle de disponibilidade de recursos. *** ### Sumário * 📋 Visão geral do relatório * 🔍 Filtros disponíveis * Colunas e informações exibidas * ✅ Como marcar gatilhos como resolvidos * 🎯 Tipos de métricas monitoradas * Como utilizar na prática * ⚠️ Avisos importantes * ❓ Perguntas Frequentes (FAQ) * 🔍 Palavras-chave para IA, indexação e busca *** ### 📋 Visão geral do relatório Ao acessar o relatório de **Gatilhos Disparados**, você verá uma lista com todos os eventos de monitoramento que foram acionados automaticamente pelo sistema e que ainda estão pendentes de resolução. #### Características principais: * **Exibição em tempo real**: Os gatilhos aparecem assim que são disparados * **Foco em pendências**: Apenas eventos não resolvidos são exibidos * **Ação rápida**: Botão "Resolvido" para cada evento * **Informações detalhadas**: Tipo de gatilho, recurso, cliente, data e métrica * **Filtros personalizáveis**: Permite buscar por cliente, período e métrica > 💡 **Dica:** Este relatório funciona como uma "caixa de entrada" de alertas de monitoramento, ajudando a equipe a priorizar e resolver incidentes rapidamente. *** ### 🔍 Filtros disponíveis Para facilitar a busca e visualização dos gatilhos disparados, o sistema oferece os seguintes filtros: #### **Clientes** * **Opção "Todos"**: Exibe gatilhos de todos os clientes * **Cliente específico**: Selecione um cliente para ver apenas os alertas relacionados a ele * **Uso recomendado**: Utilize quando precisar focar em um cliente específico ou verificar todos os alertas de uma carteira #### **Data do disparo** * **Data inicial**: Defina o início do período para busca * **Data final**: Defina o fim do período para busca * **Uso recomendado**: Filtre por períodos específicos para identificar padrões ou problemas recorrentes #### **Métrica** * **Opção "Todos"**: Exibe todos os tipos de métricas * **Métrica específica**: Filtre por tipo de monitoramento (Link, Offline, Processador, Script, Ping, etc.) * **Uso recomendado**: Utilize para identificar problemas específicos de infraestrutura #### **Botão "Exibir"** * Após configurar os filtros, clique no botão verde **"Exibir"** (com ícone de olho) à direita para aplicar os filtros e atualizar a lista > 💡 **Dica:** Combine múltiplos filtros para obter resultados mais precisos. Exemplo: Cliente X + Período específico + Métrica "Link" para verificar problemas de conectividade de um cliente. *** ### 📊 Colunas e informações exibidas A tabela de gatilhos disparados exibe as seguintes informações: #### **Gatilho** * Nome ou descrição do gatilho configurado * Identifica qual regra de monitoramento foi acionada * Exemplo: "Monitoramento Link Principal", "Ping Servidor", etc. #### **Recurso/Link** * Recurso específico que disparou o alerta * Pode ser um link, servidor, script, URL ou outro recurso monitorado * Informações técnicas do recurso afetado #### **Cliente** * Cliente ao qual o recurso pertence * Permite identificar rapidamente de quem é o recurso com problema * Facilita a priorização e comunicação com o cliente #### **Data do disparo** * Data e hora exata em que o gatilho foi acionado * Essencial para entender a cronologia dos eventos * Ajuda a identificar problemas recorrentes ou contínuos #### **Métrica** * Tipo de monitoramento que disparou o alerta * Principais tipos: * **Link**: Problemas de conectividade * **Offline**: Recurso indisponível * **Processador**: Uso de CPU * **Script**: Erros em scripts automatizados * **Ping**: Falha na resposta de ping * E outras métricas configuradas #### **Valor** * Valor específico que disparou o gatilho * Pode ser: * Status: "offline", "Erro" * Porcentagem: "12.05%" * Endereço: "[www.globo.com](http://www.globo.com)", "52.67.108.237" * Outros valores conforme a métrica #### **Botão "Resolvido"** * Botão verde com ícone de check (✓) * Clique para marcar o evento como resolvido * Remove o gatilho da lista de pendentes * Registro é mantido no histórico do sistema > 💡 **Dica:** Ao analisar um gatilho, verifique todas as colunas para entender o contexto completo antes de marcar como resolvido. *** ### ✅ Como marcar gatilhos como resolvidos O processo para resolver gatilhos disparados é simples e rápido: #### **Passo a passo:** 1. **Acesse o relatório** * Navegue até **Relatórios > Recurso > Gatilhos disparados** 2. **Analise o gatilho** * Verifique todas as informações: tipo, recurso, cliente, data, métrica e valor * Identifique a causa do problema 3. **Tome as ações necessárias** * Resolva o problema técnico (reinicie servidor, corrija link, ajuste configuração, etc.) * Entre em contato com o cliente se necessário * Documente a solução aplicada 4. **Marque como resolvido** * Localize o gatilho na lista * Clique no botão verde **"Resolvido"** à direita do registro * O gatilho será removido da lista de pendentes 5. **Verifique o resultado** * O gatilho não aparecerá mais na lista * O registro fica salvo no histórico para consultas futuras > 💡 **Dica:** Só marque como "Resolvido" após confirmar que o problema foi realmente solucionado. Isso mantém a lista sempre atualizada e confiável. *** ### 🎯 Tipos de métricas monitoradas O sistema de gatilhos do Tiflux monitora diversos tipos de métricas para garantir a disponibilidade e o bom funcionamento dos recursos dos clientes. Abaixo estão as principais métricas disponíveis no filtro **"Métrica"** do relatório: #### 🌐 **Link** * **O que monitora**: Conectividade e disponibilidade de links de internet * **Valores comuns exibidos**: `offline`, `online` * **Quando dispara**: Quando o link fica indisponível, instável ou abaixo do limite de performance configurado * **Exemplo de valor na tabela**: `offline` * **Ação recomendada**: * Verificar equipamentos de rede (modem, roteador, switch) * Testar a conexão diretamente no local * Contatar o provedor de internet * Verificar cabeamento e infraestrutura física *** #### **Offline** * **O que monitora**: Disponibilidade geral de recursos (servidores, sistemas, aplicações, dispositivos) * **Valores comuns exibidos**: `offline` * **Quando dispara**: Quando um recurso monitorado fica completamente inacessível ou fora do ar * **Exemplo de valor na tabela**: `offline` * **Ação recomendada**: * Verificar se o recurso está ligado e em funcionamento * Reiniciar serviços ou máquinas virtuais * Checar conectividade de rede * Validar configurações de firewall e acesso *** #### ⚙️ **Processador** * **O que monitora**: Uso da CPU (processador) de servidores, máquinas ou dispositivos * **Valores comuns exibidos**: Porcentagens de uso (ex: `12.05%`, `85%`, `99%`) * **Quando dispara**: Quando o uso do processador ultrapassa o limite percentual configurado no gatilho * **Exemplo de valor na tabela**: `12.05%` * **Ação recomendada**: * Identificar processos que estão consumindo mais CPU * Verificar se há tarefas agendadas rodando no momento * Otimizar aplicações ou serviços pesados * Avaliar necessidade de upgrade de hardware *** #### 📜 **Script** * **O que monitora**: Execução e resultado de scripts automatizados configurados no recurso * **Valores comuns exibidos**: `Erro`, mensagens de falha personalizadas, códigos de retorno * **Quando dispara**: Quando um script falha na execução, retorna erro ou não atende ao critério esperado * **Exemplo de valor na tabela**: `Erro` * **Ação recomendada**: * Verificar logs de execução do script * Revisar o código do script em busca de erros * Validar permissões de execução * Testar o script manualmente para reproduzir o problema *** #### 📡 **Ping** * **O que monitora**: Resposta a comandos de ping em endereços IP ou domínios específicos * **Valores comuns exibidos**: Endereços IP (ex: `52.67.108.237`) ou domínios (ex: `www.globo.com`) * **Quando dispara**: Quando não há resposta ao ping, o tempo de resposta está alto ou o destino está inacessível * **Exemplo de valor na tabela**: `www.globo.com` ou `52.67.108.237` * **Ação recomendada**: * Testar a conectividade de rede com o destino * Verificar rotas e DNS * Checar regras de firewall que possam bloquear ICMP * Confirmar se o servidor de destino está ativo *** #### 📊 **Outras métricas personalizadas** Além das métricas padrão acima, o Tiflux permite a configuração de métricas personalizadas conforme a necessidade de cada cliente. Alguns exemplos comuns incluem: | Métrica | O que monitora | Exemplo de valor | | ------------------ | ------------------------------- | ---------------- | | **Memória** | Uso de RAM do servidor | `78%` | | **Disco** | Espaço em disco utilizado | `90%` | | **Temperatura** | Temperatura de hardware | `75°C` | | **Latência** | Tempo de resposta de rede | `250ms` | | **Serviço** | Status de um serviço específico | `Parado` | | **Banco de dados** | Disponibilidade do banco | `Indisponível` | > 💡 **Dica:** Para saber quais métricas estão configuradas para um cliente específico, acesse **Recursos > \[Recurso desejado] > Gatilhos** e verifique as regras de monitoramento ativas. *** ### 🔧 Como utilizar na prática #### **Cenário 1: Monitoramento diário** 1. Acesse o relatório no início do dia 2. Verifique todos os gatilhos pendentes 3. Priorize por criticidade (clientes importantes, problemas graves) 4. Resolva cada um e marque como concluído 5. Ao final do dia, verifique se não restaram pendências críticas #### **Cenário 2: Problema recorrente** 1. Use o filtro de período (últimos 7 dias, por exemplo) 2. Filtre por cliente específico 3. Identifique padrões (mesmo gatilho disparando várias vezes) 4. Investigue a causa raiz 5. Implemente solução definitiva #### **Cenário 3: Cliente reclamando** 1. Filtre pelo cliente que está reclamando 2. Verifique se há gatilhos disparados relacionados 3. Analise o histórico de disparos 4. Use as informações para diagnosticar o problema 5. Resolva e documente #### **Cenário 4: Relatório para gestão** 1. Aplique filtros de período (mês, semana) 2. Exporte os dados (se disponível) 3. Analise métricas: * Total de gatilhos disparados * Tempo médio de resolução * Clientes com mais incidentes * Tipos de problemas mais comuns 4. Use para melhorar processos e prevenir problemas > 💡 **Dica:** Crie uma rotina de verificação do relatório (manhã, tarde e final do dia) para manter o monitoramento sempre atualizado. *** ### ⚠️ Avisos importantes * 📋 **Apenas pendentes são exibidos**: O relatório mostra apenas gatilhos não resolvidos. Gatilhos marcados como "Resolvido" são removidos da lista. * 🕒 **Ação rápida é essencial**: Gatilhos representam problemas ativos. Quanto mais rápido resolver, menor o impacto para o cliente. * 🔔 **Não substitui notificações**: Use este relatório em conjunto com notificações por e-mail ou outros canais de alerta. * 📊 **Histórico disponível**: Mesmo após marcar como resolvido, o registro permanece no sistema para consultas futuras e auditoria. * 👥 **Acesso controlado**: Verifique se sua permissão de usuário permite visualizar e resolver gatilhos. * 🔍 **Filtros são temporários**: Ao sair da página, os filtros são resetados. Aplique-os novamente quando necessário. * ✅ **Confirme a resolução**: Só marque como resolvido após confirmar que o problema foi realmente solucionado. * **Acompanhamento mobile**: Verifique se o sistema está acessível via mobile para resolver gatilhos urgentes fora do horário comercial. * **Priorização inteligente**: Nem todos os gatilhos têm a mesma urgência. Priorize por criticidade do cliente e severidade do problema. * **Atualização manual**: A lista pode precisar ser atualizada manualmente (F5) para mostrar gatilhos recém-disparados. *** ### Perguntas Frequentes (FAQ) **Por que alguns gatilhos aparecem e outros não?**\ Apenas gatilhos não resolvidos aparecem na lista. Gatilhos já marcados como "Resolvido" são removidos da visualização. 🔹 **Como sei se um gatilho é importante?**\ Verifique o cliente afetado, o tipo de métrica e o valor. Gatilhos de clientes críticos ou métricas essenciais (link, offline) geralmente têm maior prioridade. 🔹 **Posso filtrar por tipo de gatilho?**\ Sim! Use o filtro "Métrica" para selecionar tipos específicos como Link, Offline, Processador, Script, Ping, etc. 🔹 **O que acontece quando marco como "Resolvido"?**\ O gatilho é removido da lista de pendentes e fica salvo no histórico do sistema para consultas futuras. **Posso ver gatilhos já resolvidos?**\ Este relatório específico mostra apenas pendentes. Para ver o histórico completo, verifique se há outro relatório de "Gatilhos resolvidos" ou "Histórico de gatilhos". 🔹 **Como os gatilhos são disparados?**\ Eles são acionados automaticamente pelo sistema de monitoramento quando as métricas configuradas ultrapassam os limites definidos ou quando recursos ficam indisponíveis. 🔹 **Posso configurar novos gatilhos por aqui?**\ Não. Este relatório é apenas para visualização e resolução. A configuração de gatilhos é feita na área de Recursos ou Monitoramento. **Quantos gatilhos posso resolver por vez?**\ Um de cada vez, clicando no botão "Resolvido" de cada registro. 🔹 **O cliente é notificado quando marco como resolvido?**\ Depende da configuração do sistema. Verifique com o administrador se há notificações automáticas para os clientes. 🔹 **Posso exportar este relatório?**\ Verifique se há botão de exportação (CSV, Excel, PDF) na interface. Se não houver, entre em contato com o suporte do Tiflux. 🔹 **Por que não aparece nenhum gatilho na lista?**\ Pode significar que: (1) Não há gatilhos pendentes no momento; (2) Os filtros aplicados estão muito restritivos; (3) Você não tem permissão para visualizar; (4) O sistema de monitoramento está desativado. 🔹 **Como priorizar quais gatilhos resolver primeiro?**\ Considere: criticidade do cliente, tipo de problema (offline > link > performance), tempo desde o disparo, e SLA contratado. 🔹 **O relatório atualiza automaticamente?**\ Geralmente não. É necessário atualizar a página (F5) ou clicar em "Exibir" novamente para ver novos gatilhos disparados. *** ### 🔍 Palavras-chave para IA, indexação e busca ``` gatilhos disparados, monitoramento Tiflux, alertas de recursos, gatilhos pendentes, resolver gatilhos, monitoramento de links, ping monitoramento, offline recursos, métricas de desempenho, script erro, processador uso, relatório de gatilhos, gestão de incidentes, monitoramento proativo, disparo de alertas, recursos monitorados, status de gatilhos, resolução de incidentes, controle de disponibilidade, monitoramento de infraestrutura, TI monitoring, alertas automáticos, gestão de recursos, Tiflux relatórios, monitoramento clientes, gatilhos resolvidos, histórico de monitoramento, disparo automático, métricas de rede, conectividade link, métrica link, métrica offline, métrica processador, métrica script, métrica ping, filtro métrica, tipos de métricas, monitoramento CPU, monitoramento memória, monitoramento disco ```