384 sintomas catalogados
Cada sintoma com causa provável e correção, ligado à lição da trilha Energia que explica o porquê. Descreva o sintoma para filtrar.
| Sintoma | Causa provável | Correção | Lição |
|---|---|---|---|
| Alertas não aparecem no Alertmanager | Erro de sintaxe nas regras ou Prometheus não recarregado | Cheque logs do Prometheus, valide sintaxe e recarregue o serviço | Alertas inteligentes: da detecção à ação |
| Alertas em excesso (falsos positivos) | Limites mal definidos ou ausência do parâmetro 'for' | Ajuste os limites e adicione 'for' para evitar alertas transitórios | Alertas inteligentes: da detecção à ação |
| Alertas não chegam por e-mail | Configuração incorreta do Alertmanager ou SMTP bloqueado | Revise alertmanager.yml e teste conexão SMTP | Alertas inteligentes: da detecção à ação |
| Interface web não carrega após instalação | Containers não iniciaram ou porta bloqueada | Verifique status dos containers com 'docker ps' e libere as portas no firewall | Ansible Tower/AWX: escalando automação (licença livre) |
| Erro de autenticação ao executar playbook | Credenciais SSH incorretas ou não importadas | Revise as credenciais no AWX e teste conexão manualmente | Ansible Tower/AWX: escalando automação (licença livre) |
| Execuções travam ou não distribuem carga | Execution nodes não registrados corretamente | Consulte logs dos nodes e revise configuração conforme documentação | Ansible Tower/AWX: escalando automação (licença livre) |
| Resistência de terra acima do recomendado | Solo de alta resistividade ou má conexão entre hastes | Adicione mais hastes ou refaça as conexões | Aterramento e DPS: instalação segura e validação |
| DPS dispara frequentemente | Surtos recorrentes na rede ou DPS subdimensionado | Reveja o dimensionamento do DPS e investigue a origem dos surtos | Aterramento e DPS: instalação segura e validação |
| Sem continuidade entre carcaça e terra | Falha na conexão do barramento de terra | Refaça as ligações e teste novamente | Aterramento e DPS: instalação segura e validação |
| Auditor solicita evidência de teste de autonomia e não encontra registro | Falta de registro documental ou teste não realizado | Realize o teste e registre o resultado imediatamente | Auditoria e conformidade: normas e inspeções técnicas |
| Alarme de falha do nobreak não dispara durante simulação | Configuração incorreta ou falha de hardware | Revise a configuração no NUT e teste o hardware | Auditoria e conformidade: normas e inspeções técnicas |
| Cabos de aterramento não identificados no quadro | Instalação fora da norma ABNT NBR 5410 | Identifique e sinalize os cabos conforme norma | Auditoria e conformidade: normas e inspeções técnicas |
| O job 'prometheus' aparece como DOWN em /targets | Erro de configuração no target ou Prometheus não está ouvindo na porta esperada | Ajuste o endereço/porta no prometheus.yml e recarregue a configuração | Auto-monitoramento: Prometheus olhando para si mesmo |
| Alertas não aparecem em /alerts | Arquivo de regras não incluído corretamente | Verifique a diretiva rule_files e erros de sintaxe no alerts.yml | Auto-monitoramento: Prometheus olhando para si mesmo |
| Painéis do Grafana não exibem dados | Fonte de dados Prometheus não configurada ou query incorreta | Revise a configuração da fonte de dados e a consulta PromQL | Auto-monitoramento: Prometheus olhando para si mesmo |
| Automação não dispara mesmo com consumo alto | Parâmetros do controlador incorretos ou dados históricos insuficientes | Revise configuração e verifique se há dados suficientes no período analisado | Automação baseada em previsão e análise de dados históricos |
| Dados históricos inconsistentes | Falha na coleta ou armazenamento dos dados | Verifique conectividade e integridade do banco de dados | Automação baseada em previsão e análise de dados históricos |
| Ação disparada fora de hora | Dados históricos com eventos atípicos não filtrados | Implemente filtragem de outliers e revise períodos analisados | Automação baseada em previsão e análise de dados históricos |
| Playbook falha ao acionar gerador | Permissão SSH insuficiente ou chave inválida | Revise as chaves SSH e permissões do usuário remoto | Automação de contingência em data center: estudo de caso |
| Notificações não chegam | Configuração incorreta do servidor SMTP | Ajuste as variáveis do módulo mail e teste envio manual | Automação de contingência em data center: estudo de caso |
| Shutdown não executa em alguns hosts | Host offline ou sem permissão de sudo | Verifique conectividade e configure sudoers corretamente | Automação de contingência em data center: estudo de caso |
| Script não executa após evento | Permissão incorreta ou caminho errado no NOTIFYCMD | Verifique permissões de execução e o caminho do script | Automatizando respostas a eventos críticos de energia |
| Logs não aparecem no syslog | NOTIFYFLAG sem SYSLOG configurado | Adicione SYSLOG à linha NOTIFYFLAG correspondente | Automatizando respostas a eventos críticos de energia |
| Ticket não é aberto no sistema externo | Erro de autenticação ou endpoint incorreto no script | Teste o comando curl manualmente e ajuste credenciais/URL | Automatizando respostas a eventos críticos de energia |
| O script não executa após o alerta | Permissões insuficientes ou erro no caminho do script | Ajuste permissões do arquivo e verifique o caminho absoluto no serviço | Automatizando respostas: scripts e webhooks com Alertmanager |
| O webhook não recebe alertas | URL incorreta ou serviço HTTP fora do ar | Confirme o endpoint e reinicie o serviço Flask | Automatizando respostas: scripts e webhooks com Alertmanager |
| Alertmanager retorna erro 500 ao enviar alerta | Payload inesperado ou erro de parsing no serviço receptor | Ajuste o código do serviço para tratar diferentes formatos de alerta | Automatizando respostas: scripts e webhooks com Alertmanager |
| UPS desarma ao ligar | Aterramento deficiente ou DPS mal dimensionado | Rever conexões de terra e especificação do DPS | Como integrar aterramento, DPS e UPS em uma arquitetura robu |
| NUT não comunica com UPS | Driver ou porta incorreta | Verificar configuração em /etc/nut/ups.conf e permissões de dispositivo | Como integrar aterramento, DPS e UPS em uma arquitetura robu |
| Equipamento queima mesmo com UPS | DPS ausente ou aterramento ineficaz | Instalar DPS adequado e revisar laço de terra | Como integrar aterramento, DPS e UPS em uma arquitetura robu |
| Não recebe resposta em issues abertas | Falta de detalhes ou não seguiu o template oficial | Inclua logs, passos para reproduzir e ambiente; revise as guidelines | Comunidades, contribuições e o futuro do OpenEMS |
| Pull request rejeitado sem explicação clara | Não seguiu padrões de codificação ou guidelines de contribuição | Leia e siga as contribution guidelines do repositório | Comunidades, contribuições e o futuro do OpenEMS |
| Não encontra documentação para um dispositivo específico | Dispositivo ainda não suportado oficialmente ou documentação desatualizada | Procure no fórum, pergunte à comunidade ou contribua com sua própria experiência | Comunidades, contribuições e o futuro do OpenEMS |
| O NUT não detecta eventos de bateria baixa | Configuração incorreta do monitoramento ou comunicação com a UPS | Revise upsmon.conf e teste a comunicação com 'upsc' | Configuração básica de UPS: parâmetros críticos para TI |
| Shutdown não ocorre ao atingir bateria baixa | Comando SHUTDOWNCMD incorreto ou permissões insuficientes | Verifique o comando e permissões do usuário do NUT | Configuração básica de UPS: parâmetros críticos para TI |
| Tensão de saída fora do padrão | Configuração física errada na UPS | Ajuste a tensão diretamente no painel da UPS | Configuração básica de UPS: parâmetros críticos para TI |
| Timeout em consulta SNMP | Comunidade SNMP errada ou OID inválido | Verifique comunidade e OID nos dispositivos e no playbook. | Configuração de módulos SNMP e SSH: coletando e gerenciando |
| Falha de autenticação SSH | Chave SSH ausente ou senha incorreta | Adicione a chave correta ao agente SSH ou revise as credenciais. | Configuração de módulos SNMP e SSH: coletando e gerenciando |
| Dados incompletos na coleta | OIDs não suportados pelo dispositivo | Consulte a MIB do fabricante e ajuste o OID. | Configuração de módulos SNMP e SSH: coletando e gerenciando |
| Métricas não aparecem no Prometheus | Exporter não está rodando ou endpoint incorreto na configuração | Verifique se o processo do exporter está ativo e se a porta está correta no scrape_configs | Consumindo APIs e logs: ampliando as fontes de dados |
| Valores de métricas não atualizam | Script de coleta travado ou cache de arquivo de log | Reinicie o exporter e confira se o log está sendo atualizado | Consumindo APIs e logs: ampliando as fontes de dados |
| Painel do Grafana mostra erro de datasource | Datasource Prometheus mal configurado | Reconfigure o datasource e teste conexão no Grafana | Consumindo APIs e logs: ampliando as fontes de dados |
| Logs do Ansible não estão sendo gerados | log_path não configurado corretamente ou permissões incorretas no diretório | Revise ansible.cfg e permissões de /var/log/ansible | Controle de acesso, sudo e logs: quem fez o quê, quando e co |
| Comandos sudo falham durante execução do playbook | Usuário ansible não tem permissão no sudoers ou comando não listado | Ajuste /etc/sudoers.d/ansible para incluir apenas os comandos necessários | Controle de acesso, sudo e logs: quem fez o quê, quando e co |
| Logs antigos não são removidos | logrotate não está configurado ou está com erro de sintaxe | Revise /etc/logrotate.d/ansible e rode logrotate manualmente para testar | Controle de acesso, sudo e logs: quem fez o quê, quando e co |
| Widget não exibe valor | Canal (channelId) incorreto ou sem dados | Verifique o channelId e se o dispositivo está comunicando | Dashboards do OpenEMS UI: o que monitorar de verdade |
| Alertas não disparam | Thresholds mal configurados ou métricas fora do range | Ajuste thresholds e teste com valores simulados | Dashboards do OpenEMS UI: o que monitorar de verdade |
| Dashboard lento ou travando | Excesso de widgets ou dados históricos longos | Reduza widgets e limite intervalo de histórico | Dashboards do OpenEMS UI: o que monitorar de verdade |
| Dashboard do Grafana não mostra dados | Script de exportação falhou ou datasource mal configurado | Verifique logs do script e configuração do InfluxDB no Grafana | Dashboards e relatórios: visualizando a saúde da energia |
| Nagios não alerta para falhas de bateria | Parâmetros de plugin incorretos ou nome do UPS errado | Revise o comando check_nut e confirme o nome do UPS com 'upsc -l localhost' | Dashboards e relatórios: visualizando a saúde da energia |
| Relatório diário está vazio | Script não executou ou permissões de arquivo insuficientes | Cheque permissões e agendamento no cron | Dashboards e relatórios: visualizando a saúde da energia |
| Dashboard vazio ou sem dados atualizados | Problema na coleta ou integração dos dados | Verifique logs do Ansible e a configuração das fontes de dados no Grafana | Dashboards e relatórios: visualizando o que importa em energ |
| Relatório HTML/CSV não gerado | Erro no template ou caminho de destino | Revise o template Jinja2 e permissões do diretório de destino | Dashboards e relatórios: visualizando o que importa em energ |
| Erro de autenticação na API do Grafana | Token ou usuário incorreto | Atualize as credenciais e teste via curl antes de automatizar | Dashboards e relatórios: visualizando o que importa em energ |
| Operador demora para achar informações | Excesso de gráficos ou layout confuso | Reduza elementos e agrupe por prioridade | Dashboards eficientes: menos é mais |
| Alertas são ignorados | Muitos alertas irrelevantes ou thresholds mal definidos | Revise regras de alerta e limite ao essencial | Dashboards eficientes: menos é mais |
| Dashboard lento para carregar | Muitos painéis ou consultas pesadas | Simplifique visualizações e otimize queries | Dashboards eficientes: menos é mais |
| Painel mostra 'No data' | Query válida, mas sem dados no período | Ajuste o intervalo de tempo ou verifique coleta no Prometheus | Dashboards quebrados: resolvendo erros no Grafana |
| Erro 'Datasource not found' | Datasource removido ou renomeado | Selecione o datasource correto nas configurações do painel | Dashboards quebrados: resolvendo erros no Grafana |
| Dashboard não abre | JSON corrompido | Restaure backup ou corrija o JSON manualmente | Dashboards quebrados: resolvendo erros no Grafana |
| Variável não carrega | Query da variável inválida | Corrija a query ou ajuste o datasource da variável | Dashboards quebrados: resolvendo erros no Grafana |
| Métricas não aparecem no Grafana | Exporter não está coletando dados ou OID/registrador incorreto | Verifique logs do exporter e revise configuração dos OIDs/registradores | Data center resiliente: monitorando energia sem folga para e |
| Alertas falsos positivos | Thresholds mal calibrados ou ruído na leitura | Ajuste os thresholds e use a opção 'for' para evitar alertas transitórios | Data center resiliente: monitorando energia sem folga para e |
| Exporter não conecta ao equipamento | Firewall bloqueando porta SNMP/Modbus ou IP incorreto | Libere portas e confirme IPs na configuração | Data center resiliente: monitorando energia sem folga para e |
| Delay nos alertas | Intervalo de scrape muito alto | Reduza o scrape_interval no Prometheus para 5s ou menos | Data center resiliente: monitorando energia sem folga para e |
| Dados ausentes ou atrasados em alguns pontos | Frequência de coleta muito alta para a capacidade do equipamento ou da rede | Aumente o scrape_interval e monitore novamente | Definindo pontos de medição e frequência de coleta |
| Servidor Prometheus lento ou travando | Excesso de pontos ou intervalos muito curtos | Reduza a quantidade de pontos ou aumente o intervalo de coleta | Definindo pontos de medição e frequência de coleta |
| Alertas falsos de indisponibilidade | Timeouts causados por sobrecarga de rede | Otimize o tráfego e distribua a coleta em horários diferentes | Definindo pontos de medição e frequência de coleta |
| Latência alta nas leituras Modbus | Polling interval muito curto ou muitos slaves na mesma linha | Aumente o polling interval e distribua os slaves em mais linhas físicas | Desempenho e lições aprendidas em operação contínua |
| Perda de conexão MQTT frequente | Instabilidade de rede ou QoS inadequado | Ajuste o QoS para 1 ou 2 e verifique a infraestrutura de rede | Desempenho e lições aprendidas em operação contínua |
| Disco cheio | Logs sem rotação | Implemente logrotate e apague arquivos antigos | Desempenho e lições aprendidas em operação contínua |
| Playbook executa tarefas não esperadas | Tags ausentes ou mal atribuídas | Revise e padronize o uso de tags em todas as tarefas e roles | Desenhando playbooks auditáveis: padrões e modularização |
| Auditor não entende o propósito de uma tarefa | Falta de comentários ou documentação embutida | Adicione name e comentários explicativos em cada tarefa | Desenhando playbooks auditáveis: padrões e modularização |
| Rollback difícil após erro | Versionamento ausente ou despadronizado | Implemente Git e padronize mensagens de commit | Desenhando playbooks auditáveis: padrões e modularização |
| Roles misturam funções diferentes | Estrutura modular inadequada | Separe funções em roles distintas e revise dependências | Desenhando playbooks auditáveis: padrões e modularização |
| UPS apitando continuamente | Bateria esgotada ou falha interna | Trocar a bateria e reiniciar o UPS | Detectando e corrigindo falhas comuns em UPS e aterramento |
| Choque ao tocar carcaça de servidor | Aterramento ausente ou defeituoso | Revisar e refazer o aterramento | Detectando e corrigindo falhas comuns em UPS e aterramento |
| Equipamento reinicia durante quedas de energia | Bateria do UPS degradada | Substituir a bateria | Detectando e corrigindo falhas comuns em UPS e aterramento |
| Dispositivo aparece como offline na UI | Falha de comunicação de rede ou endereço IP incorreto | Verifique conectividade com ping e ajuste o endereço IP na configuração | Diagnóstico rápido: logs, status e comunicação de dispositiv |
| Logs mostram timeout de conexão Modbus | Porta 502 bloqueada ou serviço Modbus parado | Teste a porta com netcat e reinicie o serviço Modbus se necessário | Diagnóstico rápido: logs, status e comunicação de dispositiv |
| Sem mensagens MQTT recebidas | Broker indisponível ou configuração de tópico incorreta | Verifique conexão com mosquitto_sub e ajuste configuração de tópicos | Diagnóstico rápido: logs, status e comunicação de dispositiv |
| UPS desarma ao ligar todos os equipamentos | Potência total excede a capacidade do UPS | Reduza a carga ou troque por UPS de maior capacidade | Dimensionamento de UPS: potência, autonomia e crescimento fu |
| Autonomia menor que a calculada | Baterias degradadas ou rendimento subestimado | Troque as baterias e revise o cálculo de rendimento | Dimensionamento de UPS: potência, autonomia e crescimento fu |
| NUT não reconhece o UPS | Driver incorreto ou porta errada | Verifique a configuração em ups.conf e consulte a lista de drivers suportados | Dimensionamento de UPS: potência, autonomia e crescimento fu |
| Resistência de aterramento acima do recomendado | Solo de alta resistividade ou eletrodo insuficiente | Adicione mais hastes em paralelo ou aumente a malha de aterramento | Dimensionando aterramento e DPS: normas e cálculos básicos |
| DPS dispara frequentemente | Surtos recorrentes ou DPS subdimensionado | Reveja a análise de risco e aumente a capacidade dos DPS | Dimensionando aterramento e DPS: normas e cálculos básicos |
| Choques em carcaças metálicas | Aterramento mal conectado ou inexistente | Verifique conexões e continuidade do condutor de proteção | Dimensionando aterramento e DPS: normas e cálculos básicos |
| Indicação de falha no DPS | DPS atingiu fim de vida útil | Substitua o DPS imediatamente | Dimensionando aterramento e DPS: normas e cálculos básicos |
| OpenEMS reinicia sozinho | Falta de memória RAM ou heap mal dimensionado | Aumente o parâmetro -Xmx e monitore o uso real | Dimensionando o Edge Controller: CPU, RAM, armazenamento |
| Perda de dados históricos | Espaço em disco insuficiente para buffers | Expanda a partição ou otimize a retenção de dados | Dimensionando o Edge Controller: CPU, RAM, armazenamento |
| Atraso em comandos ou leituras | CPU sobrecarregada ou muitos dispositivos | Reduza a frequência de leitura ou aumente os recursos de CPU | Dimensionando o Edge Controller: CPU, RAM, armazenamento |
| Dados de manutenção ausentes | Registro manual não realizado ou arquivo perdido | Padronize o uso de logs centralizados e backups regulares | Documentação e rotinas de manutenção: o que não pode faltar |
| Configuração do NUT desatualizada | Mudança de hardware não refletida na documentação | Inclua revisão de configuração no checklist após qualquer alteração física | Documentação e rotinas de manutenção: o que não pode faltar |
| Dificuldade em rastrear incidentes antigos | Histórico fragmentado ou não estruturado | Migre registros para formato único, como CSV ou Markdown | Documentação e rotinas de manutenção: o que não pode faltar |
| Checklist ignorado pela equipe | Falta de treinamento ou checklist pouco prático | Revise o checklist com a equipe e adapte à rotina real | Documentação e rotinas de manutenção: o que não pode faltar |
| Backup não roda no horário | Permissão do script ou erro no crontab | Verifique permissões e sintaxe do cron | Documentação, versionamento e backup: o tripé da confiabilid |
| Arquivo de configuração sumiu | Alteração não versionada ou falta de backup | Restaure do backup mais recente e registre no git | Documentação, versionamento e backup: o tripé da confiabilid |
| Restauração falha por permissão | Restore feito como usuário errado | Execute restore como root ou corrija permissões dos arquivos | Documentação, versionamento e backup: o tripé da confiabilid |
| Logs não são salvos no backup | Script não inclui diretório de logs | Adicione caminho correto no script de backup | Documentação, versionamento e backup: o tripé da confiabilid |
| UI não mostra dados atualizados | Backend desconectado do Edge ou banco de dados | Verifique logs do Backend e conexão MQTT. | Edge Controller, Backend e UI: O tripé do OpenEMS em produçã |
| Edge Controller não comunica com Backend | Configuração incorreta do broker MQTT ou firewall bloqueando porta | Revise config e regras de firewall. | Edge Controller, Backend e UI: O tripé do OpenEMS em produçã |
| Dados históricos ausentes | Persistência do Backend mal configurada | Ajuste parâmetros do banco no Backend e reinicie serviço. | Edge Controller, Backend e UI: O tripé do OpenEMS em produçã |
| Painel central não enxerga o UPS remoto | Firewall bloqueando porta 3493 ou configuração LISTEN incorreta | Revise regras de firewall e o arquivo upsd.conf | Escalando o NUT: múltiplos sites e integração distribuída |
| Alarme de UPS offline sem motivo aparente | POLLINTERVAL ou DEADTIME muito baixos para a latência do link | Aumente DEADTIME e teste novamente | Escalando o NUT: múltiplos sites e integração distribuída |
| Usuário ou senha rejeitados ao conectar remotamente | Erro de digitação ou permissão insuficiente em upsd.users | Verifique usuário, senha e flags no arquivo de usuários | Escalando o NUT: múltiplos sites e integração distribuída |
| Edge Controller não detecta dispositivos Modbus RTU | Porta serial ou adaptador USB/RS-485 mal configurado | Verifique parâmetros com 'stty' e troque adaptador se necessário | Escolha de hardware e topologia para o Edge Controller |
| Perda de conexão MQTT frequente | Rede instável ou broker local sobrecarregado | Monitore latência e CPU, ajuste QoS ou mova broker para outro hardware | Escolha de hardware e topologia para o Edge Controller |
| Consumo de RAM acima do esperado | Histórico local muito extenso ou serviços paralelos excessivos | Reduza retenção de dados ou distribua serviços | Escolha de hardware e topologia para o Edge Controller |
| Métricas não aparecem no Prometheus | Exporter não está rodando ou configuração errada | Cheque logs do exporter e revise o arquivo prometheus.yml | Escolhendo protocolos: SNMP vs Modbus vs Node Exporter |
| Valores incoerentes (ex: corrente negativa) | Registrador Modbus ou OID SNMP incorreto | Confirme o endereço na documentação do fabricante | Escolhendo protocolos: SNMP vs Modbus vs Node Exporter |
| Exporter SNMP retorna erro de autenticação | Community string ou versão SNMP incorreta | Ajuste para a community correta e versão suportada pelo equipamento | Escolhendo protocolos: SNMP vs Modbus vs Node Exporter |
| Dados de Modbus não aparecem | Configuração de endereço ou registers incorreta | Revise IP, porta e endereço dos registers no arquivo de configuração | Estudo de caso: integração de OpenEMS em ambiente fabril com |
| Mensagens MQTT não chegam ao OpenEMS | Broker não está rodando ou tópico incorreto | Verifique se o Mosquitto está ativo e revise o nome do tópico | Estudo de caso: integração de OpenEMS em ambiente fabril com |
| Dados do MES atrasados | Intervalo de polling REST muito alto ou rede lenta | Reduza o intervalo ou otimize a rede | Estudo de caso: integração de OpenEMS em ambiente fabril com |
| Alerta de sobrecarga em um UPS | Dimensionamento insuficiente ou falha em outro UPS | Reveja o dimensionamento e a saúde dos UPS redundantes | Expandindo sistemas de UPS: paralelismo e redundância |
| UPS não aparece no NUT | Driver ou porta incorretos na configuração | Confira o arquivo ups.conf e reinicie o serviço NUT | Expandindo sistemas de UPS: paralelismo e redundância |
| Bateria descarregando rápido demais | Bancos de baterias desbalanceados ou antigos | Teste individualmente cada banco e substitua baterias defeituosas | Expandindo sistemas de UPS: paralelismo e redundância |
| Métricas não aparecem no endpoint /metrics | Erro na coleta de dados ou falha ao iniciar o servidor HTTP | Verifique logs do exporter e dependências instaladas | Exporters customizados: quando o padrão não basta |
| Valores das métricas não mudam | Coleta não está sendo executada periodicamente | Confirme o loop de coleta e o intervalo de atualização | Exporters customizados: quando o padrão não basta |
| Prometheus não coleta do exporter | Endpoint incorreto ou bloqueio de firewall | Cheque o endereço e libere a porta no firewall | Exporters customizados: quando o padrão não basta |
| Comando upsc retorna 'Connection refused' | Serviço upsd não está rodando ou firewall bloqueando porta | Reinicie o serviço com 'systemctl restart nut-server' e verifique regras de firewall | Extraindo métricas de UPS com NUT: status, bateria e eventos |
| Variáveis aparecem como 'Unavailable' | Driver do UPS não está correto ou comunicação falhou | Revise o driver no ups.conf e reinicie o NUT | Extraindo métricas de UPS com NUT: status, bateria e eventos |
| Logs não mostram eventos do UPS | upsmon não está configurado corretamente | Verifique upsmon.conf e reinicie o serviço | Extraindo métricas de UPS com NUT: status, bateria e eventos |
| Eventos 'comm. lost' frequentes | Problema físico no cabo ou porta USB/serial | Troque o cabo e teste em outra porta | Extraindo métricas de UPS com NUT: status, bateria e eventos |
| UPS desliga inesperadamente | Sobrecarga ou bateria vencida | Reduza a carga conectada e troque as baterias | Falhas e lições aprendidas em sistemas de energia para TI |
| Equipamentos reiniciam sozinhos | Aterramento inadequado ou diferença de potencial | Reveja o sistema de aterramento conforme NBR 5410 | Falhas e lições aprendidas em sistemas de energia para TI |
| Alertas do NUT não chegam | Configuração incorreta ou falha de comunicação | Teste os scripts e revise upsmon.conf | Falhas e lições aprendidas em sistemas de energia para TI |
| Dados não aparecem no dashboard | Exporter fora do ar ou configuração de target incorreta | Verifique o status do exporter e a configuração no prometheus.yml | Fluxo de dados: do sensor ao dashboard |
| Métricas com valores zerados | Sensor sem leitura ou falha de comunicação | Cheque o sensor e o cabeamento; teste conexão com ferramenta do protocolo | Fluxo de dados: do sensor ao dashboard |
| Alertas atrasados ou inconsistentes | Intervalo de coleta muito alto ou perda de pacotes | Reduza o scrape_interval e monitore latência de rede | Fluxo de dados: do sensor ao dashboard |
| Não recebe dados MQTT no backend | Broker não acessível ou configuração errada no Edge | Verifique IP, porta e credenciais no arquivo de configuração MQTT. | Fluxos de dados: MQTT, REST e Modbus na prática |
| REST API retorna 401 Unauthorized | Credenciais inválidas ou autenticação não configurada | Confirme usuário e senha no curl e na configuração do OpenEMS. | Fluxos de dados: MQTT, REST e Modbus na prática |
| Leitura Modbus retorna timeout | IP, porta ou unitId incorretos, firewall bloqueando | Cheque parâmetros e regras de firewall entre Edge e equipamento. | Fluxos de dados: MQTT, REST e Modbus na prática |
| Playbooks demoram a executar mesmo com SSH multiplexado | ControlPath incorreto ou permissões erradas no diretório ~/.ssh | Verifique se ControlPath existe e tem permissão 700 | Gerenciamento de conexões seguras: SSH multiplexado e SNMPv3 |
| Erro de autenticação SNMPv3 | Senha ou protocolo de autenticação incorretos | Confirme usuário, senha e protocolos no dispositivo e no playbook | Gerenciamento de conexões seguras: SSH multiplexado e SNMPv3 |
| Falha ao descriptografar segredos do Vault | Senha do Vault errada ou arquivo corrompido | Recrie o arquivo com 'ansible-vault rekey' se necessário | Gerenciamento de conexões seguras: SSH multiplexado e SNMPv3 |
| Playbook lento ou travando | Inventário grande e mal segmentado | Divida em grupos menores e use filtros | Gerenciamento de inventários grandes: performance e organiza |
| Host não aparece no inventário | Erro no script dinâmico ou variável mal definida | Revise o script e os arquivos de variáveis | Gerenciamento de inventários grandes: performance e organiza |
| Variáveis conflitantes | Mesma variável definida em vários lugares | Centralize variáveis em group_vars ou host_vars | Gerenciamento de inventários grandes: performance e organiza |
| Erro de permissão ao rodar script | Script dinâmico sem permissão de execução | Use chmod +x inventory.py | Gerenciamento de inventários grandes: performance e organiza |
| Usuário não consegue acessar o sistema | Senha incorreta ou hash mal gerado | Regere o hash e revise o arquivo users.json | Gerenciamento de usuários, permissões e logs no OpenEMS |
| Permissão excessiva para um operador | Função atribuída incorretamente | Altere o campo 'roles' para a função correta e reinicie o serviço | Gerenciamento de usuários, permissões e logs no OpenEMS |
| Ações não aparecem nos logs | Nível de log insuficiente | Ajuste o logback.xml para nível DEBUG no backend.auth | Gerenciamento de usuários, permissões e logs no OpenEMS |
| Arquivo de log cresce demais | Retenção e rotação de logs não configuradas | Implemente rotação de logs via logrotate ou ajuste configuração | Gerenciamento de usuários, permissões e logs no OpenEMS |
| Dispositivos não respondem após atualização. | Configuração incompatível ou falha de comunicação. | Verifique versões de firmware, restaure configuração anterior e teste conectividade. | Gerenciando atualizações e manutenção sem downtime |
| Mensagens MQTT não chegam. | Broker não autenticado ou serviço parado. | Reinicie o broker MQTT e valide as credenciais. | Gerenciando atualizações e manutenção sem downtime |
| Logs mostram erros de inicialização do OpenEMS. | Arquivo de configuração corrompido ou incompatível. | Restaure backup do arquivo de configuração e reinicie o serviço. | Gerenciando atualizações e manutenção sem downtime |
| Carga crítica desligando mesmo com energia disponível | Prioridade configurada incorretamente ou perfil de consumo muito restritivo | Revise o valor de 'priority' e os limites de 'maxActivePower' no arquivo de configuração | Gerenciando perfis de energia e prioridades de carga |
| Alterações não aplicadas após edição de arquivo | Serviço OpenEMS não foi reiniciado | Execute 'systemctl restart openems' | Gerenciando perfis de energia e prioridades de carga |
| Carga não aparece na interface gráfica | Erro de sintaxe no arquivo de configuração | Revise o arquivo e corrija erros de digitação ou formatação | Gerenciando perfis de energia e prioridades de carga |
| Erro: 'Decryption failed' ao rodar playbook | Senha do Vault incorreta ou arquivo corrompido | Verifique a senha e a integridade do arquivo criptografado | Gestão de segredos e compliance: Vault, criptografia e polít |
| Senha não foi alterada após execução do playbook | Variável nova_senha não definida ou hash incorreto | Defina a variável corretamente e valide o filtro password_hash | Gestão de segredos e compliance: Vault, criptografia e polít |
| Arquivo de log não está sendo gerado | Diretiva log_path ausente ou permissão insuficiente | Ajuste o ansible.cfg e permissões do diretório de log | Gestão de segredos e compliance: Vault, criptografia e polít |
| Datasource Prometheus não conecta | URL incorreta ou firewall bloqueando porta 9090 | Verifique o endpoint e as regras de rede | Grafana Datasource e painéis: do dado ao insight |
| Painel exibe 'No data' | Query PromQL errada ou métrica inexistente | Ajuste a consulta e confirme se a métrica existe no Prometheus | Grafana Datasource e painéis: do dado ao insight |
| Variável não lista dispositivos | Label inexistente ou erro na query da variável | Use label_values correto e confira os labels das métricas | Grafana Datasource e painéis: do dado ao insight |
| Logs não aparecem no Grafana | Promtail não está enviando logs ou configuração incorreta do caminho dos arquivos. | Verifique logs do promtail e ajuste o __path__ no scrape_configs. | Grafana Loki e Tempo: além de métricas, logs e traces para e |
| Traces não aparecem | Tempo não está recebendo dados ou falta instrumentação nos sistemas. | Confirme ingestão pelo Tempo e revise integração OpenTelemetry. | Grafana Loki e Tempo: além de métricas, logs e traces para e |
| Dashboards lentos | Retenção ou volume de logs/traces muito alto. | Ajuste retention e filtros nas queries, aumente recursos do host. | Grafana Loki e Tempo: além de métricas, logs e traces para e |
| Usuário não consegue ver dashboards de um site | Permissão insuficiente na pasta correspondente | Revise e ajuste as permissões da pasta para incluir o usuário ou time. | Grafana para muitos: organizando dashboards em larga escala |
| Painel mostra dados errados ou vazios ao trocar datasource | Datasource não configurado corretamente ou variável mal definida | Verifique a configuração do datasource e os valores da variável. | Grafana para muitos: organizando dashboards em larga escala |
| Dashboards duplicados e inconsistentes | Falta de uso de templates e variáveis | Consolide dashboards usando variáveis e remova duplicados. | Grafana para muitos: organizando dashboards em larga escala |
| Usuário não consegue acessar dashboard esperado | Permissão não atribuída corretamente à equipe ou usuário. | Revise as permissões da pasta ou dashboard e adicione o usuário ou equipe com o nível correto. | Grafana seguro: usuários, permissões e auditoria |
| Logs de auditoria não aparecem em /var/log/grafana/grafana.log | Audit log não habilitado ou erro de permissão no arquivo. | Verifique se [log.audit] está ativado em grafana.ini e se o usuário do serviço Grafana pode gravar no diretório de logs. | Grafana seguro: usuários, permissões e auditoria |
| Usuário consegue editar dashboards sem permissão | Permissão herdada de grupo ou configuração padrão não removida. | Remova 'Everyone' das permissões e atribua explicitamente apenas os acessos necessários. | Grafana seguro: usuários, permissões e auditoria |
| Dashboards demoram a carregar | Queries pesadas ou excesso de painéis simultâneos | Otimize queries e reduza painéis desnecessários | Grafana sem engasgos: requisitos para dashboards fluidos |
| Erros 504 Gateway Timeout | Backend (Prometheus) sobrecarregado | Reduza frequência de queries e otimize Prometheus | Grafana sem engasgos: requisitos para dashboards fluidos |
| Usuários desconectados aleatoriamente | Limite baixo de workers ou sessões expirando | Ajuste max_concurrent_queries e session_life_time | Grafana sem engasgos: requisitos para dashboards fluidos |
| CPU do servidor Grafana em 100% | Excesso de consultas simultâneas | Aumente recursos ou limite usuários | Grafana sem engasgos: requisitos para dashboards fluidos |
| Clientes não conectam ao NUT master | Firewall bloqueando portas TCP necessárias | Libere as portas conforme documentação do NUT | Implantação de UPS e NUT em ambiente de datacenter |
| Shutdown não ocorre após falta de energia | Erro na configuração do SHUTDOWNCMD ou permissões insuficientes | Revise o comando e permissões do usuário NUT | Implantação de UPS e NUT em ambiente de datacenter |
| UPS não reconhecido pelo driver | Driver incorreto ou cabo mal conectado | Consulte a lista de drivers suportados e revise conexões físicas | Implantação de UPS e NUT em ambiente de datacenter |
| Alertas não enviados | NOTIFYCMD mal configurado ou script com erro | Teste o script manualmente e revise o caminho em upsmon.conf | Implantação de UPS e NUT em ambiente de datacenter |
| Valores zerados ou inconsistentes | Endereço de registrador incorreto ou formato de dado incompatível | Revise o mapeamento dos registradores e ajuste o data_type conforme o manual | Indústria conectada: integração de chão de fábrica via Modbu |
| Exporter não inicia | Porta em uso ou erro de configuração | Verifique logs do exporter e ajuste a porta ou configuração | Indústria conectada: integração de chão de fábrica via Modbu |
| Métricas não aparecem no Prometheus | Falha na configuração do scrape_configs | Cheque o endpoint do exporter e a configuração do Prometheus | Indústria conectada: integração de chão de fábrica via Modbu |
| Alertas falsos no Grafana | Limites mal definidos ou dados sujos | Ajuste os thresholds e filtre outliers | Indústria conectada: integração de chão de fábrica via Modbu |
| Playbook falha por permissão negada | Usuário sem sudo configurado no Ansible | Adicione 'become: yes' e configure o usuário com privilégios adequados | Infra como código: provisionando monitoramento com Ansible |
| Prometheus não inicia após playbook | Arquivo de configuração inválido ou serviço systemd ausente | Revise o template do prometheus.yml e o unit file systemd | Infra como código: provisionando monitoramento com Ansible |
| Grafana não está acessível na porta 3000 | Firewall bloqueando porta ou serviço não iniciado | Libere a porta no firewall e reinicie o serviço com 'systemctl restart grafana-server' | Infra como código: provisionando monitoramento com Ansible |
| Playbook falha com erro de permissão | Usuário remoto não tem sudo configurado | Ajuste o inventário para usar become e garanta que o usuário tenha permissão sudo | Infraestrutura como Código (IaC) para energia crítica: desaf |
| Configuração não é aplicada em todos os hosts | Hosts ausentes ou mal definidos no inventário | Revise o arquivo de inventário e teste conectividade com 'ansible -m ping' | Infraestrutura como Código (IaC) para energia crítica: desaf |
| Senhas expostas em logs | Segredos não protegidos com Ansible Vault | Armazene variáveis sensíveis em arquivos criptografados com Vault | Infraestrutura como Código (IaC) para energia crítica: desaf |
| UPS desliga ao ligar carga | Carga acima da capacidade ou curto-circuito | Reduza a carga ou verifique cabos e tomadas | Instalação correta de UPS: erros comuns e como evitar |
| UPS aquece demais | Ventilação insuficiente ou sobrecarga | Melhore a circulação de ar e reduza a carga | Instalação correta de UPS: erros comuns e como evitar |
| Bypass não funciona | Instalação incorreta do circuito de bypass | Revise o diagrama e refaça as conexões | Instalação correta de UPS: erros comuns e como evitar |
| Alarme de aterramento | Falta de aterramento funcional | Corrija o aterramento conforme normas | Instalação correta de UPS: erros comuns e como evitar |
| O serviço não inicia | Java não instalado ou versão incompatível | Verifique com 'java -version' e instale o JDK 11 ou superior. | Instalando o OpenEMS em um Edge Controller real |
| Erro de permissão ao rodar o serviço | Usuário sem permissão no diretório do OpenEMS | Ajuste as permissões com 'chown' ou rode como usuário correto. | Instalando o OpenEMS em um Edge Controller real |
| API REST não responde | Firewall bloqueando porta 8080 ou erro de configuração | Libere a porta no firewall e revise o arquivo de configuração. | Instalando o OpenEMS em um Edge Controller real |
| Node Exporter aparece como DOWN em /targets | Serviço não iniciado ou firewall bloqueando porta 9100 | Verifique status com systemctl e libere a porta no firewall | Instalando Prometheus e Node Exporter na prática |
| Prometheus não inicia | Erro de sintaxe no prometheus.yml | Valide o arquivo com promtool check config /etc/prometheus/prometheus.yml | Instalando Prometheus e Node Exporter na prática |
| Permissão negada ao iniciar serviços | Execução sem sudo ou usuário correto | Use sudo e confira permissões dos arquivos | Instalando Prometheus e Node Exporter na prática |
| Métricas ausentes ou incompletas | Node Exporter rodando com flags incorretas ou sem acesso a recursos do sistema | Consulte a documentação para flags e permissões necessárias | Instalando Prometheus e Node Exporter na prática |
| Métricas não aparecem no Zabbix | Hostname ou chave incorretos no zabbix_sender | Confirme o nome do host e a chave configurada no Zabbix | Integração Ansible com Zabbix, Prometheus e Grafana: monitor |
| Prometheus não coleta dados do host | Exporter não está rodando ou porta bloqueada | Verifique se o node_exporter está ativo e a porta 9100 está liberada | Integração Ansible com Zabbix, Prometheus e Grafana: monitor |
| Dashboard do Grafana vazio | Provisionamento incorreto do caminho do dashboard | Ajuste o caminho no arquivo de provisioning do Grafana | Integração Ansible com Zabbix, Prometheus e Grafana: monitor |
| O playbook não retorna informações SNMP | Community string incorreta ou SNMP desabilitado no dispositivo | Verifique a configuração SNMP do dispositivo e ajuste a community string | Integração Ansible-SNMP em ambiente industrial: estudo de ca |
| Traps SNMP não disparam playbooks | snmptrapd não está configurado corretamente ou script não tem permissão de execução | Revise o snmptrapd.conf e garanta permissão de execução ao script | Integração Ansible-SNMP em ambiente industrial: estudo de ca |
| Eventos SNMP são perdidos em grandes volumes | snmptrapd ou scripts sobrecarregados | Implemente filtros de eventos e monitore uso de recursos | Integração Ansible-SNMP em ambiente industrial: estudo de ca |
| upsc retorna 'Data stale' | Driver SNMP não está comunicando com o UPS | Verifique IP, comunidade SNMP e conectividade de rede | Integração do NUT com SNMP e sistemas de alerta |
| Alertas não são enviados | Script não executa ou permissão incorreta | Cheque permissões do script e logs do upsmon | Integração do NUT com SNMP e sistemas de alerta |
| Eventos não aparecem no syslog | Flag SYSLOG ausente ou syslog não configurado | Adicione SYSLOG na NOTIFYFLAG e verifique configuração do syslog | Integração do NUT com SNMP e sistemas de alerta |
| OpenEMS não conecta ao broker MQTT | Usuário ou senha incorretos, broker não iniciado ou firewall bloqueando porta 1883 | Revise credenciais, status do serviço Mosquitto e regras de firewall | Integrando o OpenEMS com sistemas SCADA via MQTT |
| Mensagens não chegam ao SCADA | Tópico incorreto ou SCADA não está assinando o tópico correto | Confirme os nomes dos tópicos e revise a configuração do SCADA | Integrando o OpenEMS com sistemas SCADA via MQTT |
| Mensagens duplicadas ou perdidas | QoS inadequado ou problemas de rede | Ajuste o QoS para 1 ou 2 e monitore a estabilidade da rede | Integrando o OpenEMS com sistemas SCADA via MQTT |
| snmp_up retorna 0 | SNMP community incorreta ou sensor inacessível | Verifique a community, IP e permissões do sensor | Integrando sensores SNMP e Modbus ao Prometheus |
| modbus_exporter não retorna dados | Endereço do registrador errado ou porta bloqueada | Revise o arquivo de configuração e libere a porta no firewall | Integrando sensores SNMP e Modbus ao Prometheus |
| Prometheus não encontra o exporter | Erro no endereço ou porta do job | Confirme IP, porta e se o serviço está rodando | Integrando sensores SNMP e Modbus ao Prometheus |
| Perda de dados ou leituras incompletas | Ciclo de processamento muito longo ou hardware insuficiente | Reduza a frequência de coleta ou aumente a capacidade do Edge Controller | Limites do OpenEMS: Quantos dispositivos, quantos dados? |
| Conexões recusadas ao adicionar novos dispositivos | Limite de arquivos abertos atingido no SO | Aumente o valor de ulimit -n | Limites do OpenEMS: Quantos dispositivos, quantos dados? |
| Latência alta na atualização dos dados | Sobrecarga de CPU ou ciclo mal dimensionado | Otimize o ciclo ou distribua a carga entre múltiplos Edge Controllers | Limites do OpenEMS: Quantos dispositivos, quantos dados? |
| Playbook para com erro de variável indefinida | Variável não foi definida ou está fora de escopo | Use debug para identificar e definir a variável antes do uso | Logs, debug e dry-run: encontrando e corrigindo falhas em pl |
| Permissão negada ao executar tarefa | Usuário remoto sem sudo ou SSH mal configurado | Ajuste permissões no inventário e valide conexão SSH | Logs, debug e dry-run: encontrando e corrigindo falhas em pl |
| Mudanças não aplicadas mesmo sem erro | Modo --check estava ativado | Execute sem --check para aplicar de fato | Logs, debug e dry-run: encontrando e corrigindo falhas em pl |
| Logs não aparecem no arquivo | Permissão de escrita ou configuração incorreta do appender | Revise permissões do diretório e sintaxe do logback.xml | Logs, métricas e integração com sistemas externos de monitor |
| API REST retorna erro 401 | Autenticação não configurada ou token inválido | Consulte a documentação de autenticação da API OpenEMS | Logs, métricas e integração com sistemas externos de monitor |
| Prometheus não coleta métricas | Endpoint do Telegraf inacessível ou configuração errada no prometheus.yml | Teste o endpoint manualmente e revise a configuração do Prometheus | Logs, métricas e integração com sistemas externos de monitor |
| Logs crescem rápido demais | Nível de log muito detalhado (DEBUG) | Reduza para INFO ou configure rotação de logs | Logs, métricas e integração com sistemas externos de monitor |
| Exportação retorna arquivo vazio | Query PromQL incorreta ou período sem dados | Revise o nome da métrica e o intervalo de tempo. | Machine learning em energia: anomalias e previsão com Promet |
| Modelo ML não detecta nenhuma anomalia | Parâmetro 'contamination' muito baixo ou dados muito limpos | Ajuste o parâmetro e revise os dados. | Machine learning em energia: anomalias e previsão com Promet |
| Erro ao reimportar métricas para Prometheus | Formato do arquivo .prom inválido | Siga o padrão de exposição de métricas do node_exporter. | Machine learning em energia: anomalias e previsão com Promet |
| UPS desarma ou apita com poucos equipamentos conectados | Cargas não lineares ou fator de potência subdimensionado | Recalcule potência aparente e verifique compatibilidade do UPS | Mapeamento de cargas críticas: o que realmente precisa de UP |
| Autonomia menor que o previsto | Equipamentos não críticos conectados ao UPS | Remova cargas desnecessárias e revise o inventário | Mapeamento de cargas críticas: o que realmente precisa de UP |
| Equipamento crítico ficou sem energia durante queda | Erro na classificação ou conexão física | Revise a lista de prioridades e o cabeamento | Mapeamento de cargas críticas: o que realmente precisa de UP |
| UPS aquece excessivamente | Sobrecarga por excesso de equipamentos | Reduza a carga total conectada | Mapeamento de cargas críticas: o que realmente precisa de UP |
| Carga não aparece no dashboard | Erro de configuração ou comunicação (endereço, protocolo) | Revise identificador, protocolo e conectividade física | Mapeamento de cargas, fontes e pontos críticos |
| Fonte de energia não reporta dados | Configuração incorreta de Modbus/MQTT ou IP errado | Verifique parâmetros de rede e unidade Modbus | Mapeamento de cargas, fontes e pontos críticos |
| Ponto crítico não recebe prioridade em restrição | Parâmetro de prioridade ausente ou incorreto | Ajuste configuração de prioridade no asset | Mapeamento de cargas, fontes e pontos críticos |
| Host não aparece no inventário lógico | Erro de indentação ou sintaxe YAML | Valide o YAML em yaml.org/spec ou com 'ansible-inventory --list' | Mapeando requisitos: inventário físico, lógico e de política |
| Variáveis sensíveis expostas em texto claro | Falta de uso do Ansible Vault | Criptografe os arquivos com 'ansible-vault encrypt' | Mapeando requisitos: inventário físico, lógico e de política |
| Playbooks falham por falta de acesso SSH | Chaves públicas não cadastradas ou políticas mal definidas | Revise as permissões e cadastre as chaves corretamente | Mapeando requisitos: inventário físico, lógico e de política |
| Inventário desatualizado após mudança física | Falta de processo de atualização | Implemente revisão periódica e obrigatória | Mapeando requisitos: inventário físico, lógico e de política |
| Playbook falha com erro de permissão | Usuário sem acesso SSH ou sudo nos hosts | Ajuste permissões e chaves SSH conforme documentação. | Master, Inventory e Playbooks: desenho da arquitetura Ansibl |
| Inventário não reconhece hosts | Erro de sintaxe no YAML ou caminho incorreto | Valide o arquivo com 'ansible-inventory --list'. | Master, Inventory e Playbooks: desenho da arquitetura Ansibl |
| Execução lenta ou travada | Rede congestionada ou master sobrecarregado | Monitore uso de recursos e avalie segmentação da automação. | Master, Inventory e Playbooks: desenho da arquitetura Ansibl |
| Cliente não consegue conectar ao servidor NUT | Firewall bloqueando porta 3493 ou IP não autorizado em upsd.conf | Libere a porta 3493/TCP e revise ACLs em upsd.conf | Monitorando múltiplos UPS com NUT: servidores e clientes |
| Status do UPS não aparece no cliente | Nome do UPS ou usuário/senha incorretos | Verifique nomes em ups.conf e credenciais em upsd.users | Monitorando múltiplos UPS com NUT: servidores e clientes |
| UPS não aparece no servidor | Driver incorreto ou porta errada em ups.conf | Consulte a documentação para o driver correto e revise conexões físicas | Monitorando múltiplos UPS com NUT: servidores e clientes |
| Painel central não recebe dados de um site | Tópico MQTT incorreto ou conexão de rede falha | Revise configuração de tópicos e conectividade do broker | Multi-site e múltiplos controladores: quando separar, quando |
| Comandos globais não são executados em todos os sites | Controladores não estão assinando o tópico global/commands | Inclua global/commands em Controller.MqttBroker.topics | Multi-site e múltiplos controladores: quando separar, quando |
| Dados duplicados ou inconsistentes entre sites | Falta de sincronização de tempo ou colisão de tópicos | Habilite NTP e revise nomes de tópicos | Multi-site e múltiplos controladores: quando separar, quando |
| Dados do UPS não aparecem no monitoramento | Driver incorreto ou dispositivo não reconhecido | Revise o ups.conf e use o comando 'nut-scanner' para identificar o driver correto | Normas internacionais e o futuro do monitoramento aberto |
| SNMP não retorna informações | SNMP não habilitado ou firewall bloqueando porta | Verifique a configuração SNMP do NUT e libere a porta 161 no firewall | Normas internacionais e o futuro do monitoramento aberto |
| Erro de permissão ao acessar dispositivo USB | Usuário do NUT sem permissão no /dev/usb/hiddev0 | Adicione o usuário 'nut' ao grupo apropriado ou ajuste as permissões do dispositivo | Normas internacionais e o futuro do monitoramento aberto |
| upsc retorna 'Connection refused' | O serviço do NUT não está rodando ou configuração incorreta. | Verifique se o nut-server está ativo e revise ups.conf. | NUT: instalação e configuração inicial no Linux |
| upsc mostra 'Data stale' | Driver não está conseguindo ler o UPS. | Cheque cabos, permissões USB ou conectividade SNMP. | NUT: instalação e configuração inicial no Linux |
| Driver não inicia após restart | Erro de sintaxe em ups.conf ou driver incompatível. | Revise o arquivo e consulte a lista de drivers suportados. | NUT: instalação e configuração inicial no Linux |
| O Controller de IA não inicia | Formato de modelo incompatível ou caminho incorreto | Verifique o formato suportado e o caminho configurado | OpenEMS e inteligência artificial: o que já existe e o que e |
| Previsões incoerentes ou fora da realidade | Modelo treinado com dados insuficientes ou desbalanceados | Reveja o conjunto de dados e re-treine o modelo | OpenEMS e inteligência artificial: o que já existe e o que e |
| Latência alta nas respostas | Modelo muito complexo para o hardware embarcado | Simplifique o modelo ou utilize inferência externa | OpenEMS e inteligência artificial: o que já existe e o que e |
| Dispositivo não aparece como conectado | Endereço ou porta Modbus incorretos na configuração | Revise o campo 'connection' e 'address' no config.json | OpenEMS: O que é, onde nasceu e por que é diferente |
| Dados não chegam ao backend | Broker MQTT fora do ar ou URL errada | Confirme se o broker está ativo e revise o campo 'url' do backend | OpenEMS: O que é, onde nasceu e por que é diferente |
| UI não exibe dados | Edge Controller não está enviando dados ou problema de autenticação | Cheque os logs do Edge Controller e as permissões do usuário na UI | OpenEMS: O que é, onde nasceu e por que é diferente |
| Playbook seguinte não executa | Condição 'when' não satisfeita ou erro anterior não tratado | Revise os registros de saída e ajuste as condições | Orquestração de múltiplos sistemas: chain de playbooks e dep |
| Rollback não ocorre após falha | Handler não foi notificado corretamente | Verifique se o notify está presente e se a condição do handler está correta | Orquestração de múltiplos sistemas: chain de playbooks e dep |
| Logs incompletos ou ausentes | Falta de tasks de registro ou permissão insuficiente | Adicione tasks de logging e ajuste permissões de escrita | Orquestração de múltiplos sistemas: chain de playbooks e dep |
| Dashboards mostram valores incoerentes ou divergentes | Unidades diferentes misturadas ou nomes ambíguos | Padronize nomes e unidades das métricas | Padronização de métricas: nomes, labels e unidades |
| Prometheus consome muita memória | Labels com alta cardinalidade (valores que mudam sempre) | Revise e reduza labels voláteis | Padronização de métricas: nomes, labels e unidades |
| Dificuldade para encontrar métricas no Prometheus | Nomes genéricos ou inconsistentes | Renomeie métricas seguindo o padrão estabelecido | Padronização de métricas: nomes, labels e unidades |
| Alarme não dispara ao atingir limite | Threshold ou canal de notificação mal configurado | Revise os parâmetros de alarme e o tópico MQTT | Parâmetros avançados: limites, alarmes e fallback |
| Fallback não é ativado em falha real | Condição de falha não está sendo detectada | Teste a simulação de falha e revise sensores/configuração | Parâmetros avançados: limites, alarmes e fallback |
| Limite de potência ignorado pelo sistema | Arquivo de configuração não foi recarregado | Reinicie o serviço OpenEMS Edge após alteração | Parâmetros avançados: limites, alarmes e fallback |
| Falha ao instalar Ansible no pipeline | Versão não especificada ou incompatível com a imagem base | Fixe a versão do Ansible e use imagem Python compatível | Pipelines CI/CD para automação de energia crítica |
| Erro de permissão ao acessar segredos | Vault password não configurada no runner | Configure a senha do Vault como variável protegida no CI | Pipelines CI/CD para automação de energia crítica |
| Rollback não reverte alterações | Tag Git não existe ou ambiente não clonado corretamente | Garanta que o runner faz fetch de tags e checkout correto | Pipelines CI/CD para automação de energia crítica |
| Novo ponto de medição não aparece no Grafana | Arquivo de targets não atualizado ou erro de sintaxe | Verifique logs do Prometheus e a sintaxe do JSON | Planejamento para expansão: pensando no amanhã |
| Exportador cai após adicionar muitos dispositivos | Limite de conexões simultâneas ou falta de recursos | Ajuste limites do exportador ou distribua a carga | Planejamento para expansão: pensando no amanhã |
| Dados inconsistentes após integração com sistema legado | Incompatibilidade de protocolo ou coleta concorrente | Consulte a documentação do protocolo e ajuste a frequência de coleta | Planejamento para expansão: pensando no amanhã |
| Playbook não executa no horário | Cron mal configurado ou permissão insuficiente | Revise a entrada do cron e permissões do usuário. | Playbooks de monitoramento contínuo: coleta e resposta a fal |
| Métricas SNMP retornam vazio | OID incorreto ou SNMP bloqueado | Confirme OID com o manual do equipamento e libere SNMP na rede. | Playbooks de monitoramento contínuo: coleta e resposta a fal |
| Alertas não chegam | Configuração de e-mail incorreta ou bloqueio de saída | Teste envio de e-mail fora do Ansible e ajuste parâmetros. | Playbooks de monitoramento contínuo: coleta e resposta a fal |
| Tarefa retorna erro de autenticação | Credenciais SSH incorretas ou usuário sem permissão | Verifique o arquivo de inventário e as permissões do usuário nos dispositivos | Playbooks na prática: provisionamento e gestão de dispositiv |
| Comando não reconhecido pelo dispositivo | Modelo ou firmware incompatível com o comando enviado | Consulte o manual do fabricante e ajuste o playbook para o modelo correto | Playbooks na prática: provisionamento e gestão de dispositiv |
| Playbook aplica mudanças repetidas vezes | Falta de idempotência no comando ou módulo utilizado | Adote módulos declarativos ou implemente verificações de estado antes de executar comandos | Playbooks na prática: provisionamento e gestão de dispositiv |
| Playbook falha com erro de autenticação | Credenciais incorretas ou SSH/SNMP desabilitado no dispositivo | Revise credenciais e habilite protocolos necessários | Por que automatizar energia crítica? Riscos, falhas e o pape |
| Dispositivo não responde ao Ansible | Firewall bloqueando porta ou IP incorreto no inventário | Ajuste regras de firewall e revise inventário | Por que automatizar energia crítica? Riscos, falhas e o pape |
| Configuração não é aplicada em todos os dispositivos | Versão de firmware incompatível ou módulos Ansible desatualizados | Atualize firmware e módulos Ansible | Por que automatizar energia crítica? Riscos, falhas e o pape |
| Servidor não inicia após queda de energia | Possível corrupção de sistema de arquivos ou falha de hardware | Verifique logs do sistema, execute fsck e teste componentes físicos. | Por que energia é o calcanhar de Aquiles da TI |
| Switch de rede reinicia aleatoriamente | Oscilações ou microdesligamentos na rede elétrica | Meça tensão no circuito e instale nobreak ou filtro de linha. | Por que energia é o calcanhar de Aquiles da TI |
| Banco de dados apresenta erros após blackout | Dados não gravados ou arquivos corrompidos | Execute procedimentos de recuperação específicos do SGBD, como o pg_resetwal no PostgreSQL. | Por que energia é o calcanhar de Aquiles da TI |
| Painel do Grafana sem dados | Endpoint não configurado corretamente no Prometheus | Revise o prometheus.yml e teste acesso ao endpoint com curl | Por que monitorar energia em TI: riscos, custos e oportunida |
| Valores de consumo inconsistentes | Fator de potência não considerado ou sensores descalibrados | Calibre sensores e ajuste queries para incluir fator de potência | Por que monitorar energia em TI: riscos, custos e oportunida |
| Alertas não disparam | Condições de alerta mal definidas no Grafana | Revise as regras de alerta e teste com valores simulados | Por que monitorar energia em TI: riscos, custos e oportunida |
| O sistema não reage a picos de demanda | Configuração incorreta do intervalo de leitura ou lógica de controle ausente | Revise as configurações de sensores e regras no OpenEMS. | Por que o gerenciamento de energia industrial exige controle |
| Dados de consumo aparecem atrasados | Intervalo de publicação dos medidores muito alto | Reduza o intervalo para 1 segundo. | Por que o gerenciamento de energia industrial exige controle |
| Cargas não desligam automaticamente | Atuadores não integrados corretamente | Verifique a comunicação entre OpenEMS e os dispositivos de atuação. | Por que o gerenciamento de energia industrial exige controle |
| Timeout ao tentar ler registradores | IP, porta ou unitId incorretos | Revise os parâmetros no arquivo de configuração | Primeira configuração: conectando um dispositivo via Modbus |
| Valores lidos inconsistentes ou zerados | Endereço do registrador errado ou escala incorreta | Verifique o manual do equipamento e ajuste o mapeamento | Primeira configuração: conectando um dispositivo via Modbus |
| Erro de conexão serial (RTU) | Porta serial, baudrate ou terminação errados | Confirme os parâmetros físicos e lógicos da porta | Primeira configuração: conectando um dispositivo via Modbus |
| Timeouts apenas em horários de pico | Buffer MQTT insuficiente ou processamento lento | Aumentar mqtt.buffer.size e revisar carga dos módulos | Problemas intermitentes: latência, timeout e inconsistências |
| Dados inconsistentes entre módulos | Race condition ou perda de pacotes | Revisar ordem de execução e sincronização de relógio | Problemas intermitentes: latência, timeout e inconsistências |
| Latência alta só em alguns dispositivos | Problemas de rede local ou congestionamento | Testar conectividade e isolar dispositivos problemáticos | Problemas intermitentes: latência, timeout e inconsistências |
| Métricas não aparecem no federador | Endpoint /federate inacessível ou filtro match[] errado | Verifique firewall, autenticação e sintaxe do match[] | Prometheus federado: monitoramento em escala |
| Uso de memória alto no federador | Cardinalidade excessiva nas métricas federadas | Reduza o número de métricas federadas e revise os labels | Prometheus federado: monitoramento em escala |
| Dados atrasados ou faltando | Intervalo de scraping muito longo ou filiais indisponíveis | Ajuste o scrape_interval e monitore disponibilidade das filiais | Prometheus federado: monitoramento em escala |
| Alvos aparecem como DOWN | Timeout muito curto ou endpoint fora do ar | Aumente o scrape_timeout ou verifique a disponibilidade do endpoint | Prometheus scrape configs: coletando só o que importa |
| Métricas irrelevantes continuam aparecendo | Filtros em relabel_configs não aplicados corretamente | Revise as expressões regex e as ações de drop/keep | Prometheus scrape configs: coletando só o que importa |
| Labels ausentes nas métricas | Labels não definidos em static_configs | Inclua labels manualmente ou ajuste relabel_configs | Prometheus scrape configs: coletando só o que importa |
| UPS não assume carga em caso de falha do outro | Configuração de paralelismo incorreta ou incompatibilidade entre modelos | Revise a configuração e compatibilidade dos UPS. Consulte a documentação do fabricante. | Proteção em camadas: combinando dispositivos para máxima res |
| Alarmes constantes de surto ou ruído | DPS subdimensionado ou filtros inadequados | Verifique especificação dos dispositivos e substitua por modelos adequados. | Proteção em camadas: combinando dispositivos para máxima res |
| NUT não reconhece todos os UPS | Driver ou porta incorreta na configuração | Ajuste o arquivo de configuração do NUT conforme a documentação. | Proteção em camadas: combinando dispositivos para máxima res |
| O acesso ao Prometheus está liberado sem pedir senha | O bloco auth_basic ou o caminho do .htpasswd está incorreto no Nginx | Revise a configuração do proxy e o caminho do arquivo .htpasswd | Protegendo Prometheus: autenticação e autorização |
| Erro de certificado ao acessar via HTTPS | Certificado SSL inválido ou mal configurado | Verifique caminhos dos arquivos de certificado e reinicie o Nginx | Protegendo Prometheus: autenticação e autorização |
| Usuário autorizado não consegue acessar /-/reload | Restrição de IP ou permissões excessivas no proxy | Ajuste o bloco location para permitir o IP correto | Protegendo Prometheus: autenticação e autorização |
| Target DOWN no Prometheus | Exporter parado, endereço errado ou firewall bloqueando | Reinicie o exporter, corrija o endereço e libere a porta no firewall | Quando o dado não chega: debug de coleta e exporters |
| Timeout ao acessar /metrics | Rede lenta ou exporter travado | Verifique a conectividade e reinicie o exporter | Quando o dado não chega: debug de coleta e exporters |
| Métricas ausentes ou incompletas | Erro de parsing ou exporter desatualizado | Atualize o exporter e valide o formato das métricas | Quando o dado não chega: debug de coleta e exporters |
| Consultas lentas no Grafana | Disco lento ou falta de RAM para cache | Migre para SSD e aumente a RAM | Quantos dados cabem? Dimensionando Prometheus para energia |
| Dados antigos sumindo antes do tempo configurado | Disco cheio ou retenção mal configurada | Aumente espaço em disco ou ajuste --storage.tsdb.retention.time | Quantos dados cabem? Dimensionando Prometheus para energia |
| Prometheus não inicia após restore de backup | Backup inconsistente (feito com Prometheus rodando) | Refaça backup com Prometheus parado ou em modo read-only | Quantos dados cabem? Dimensionando Prometheus para energia |
| Rollback não restaura configuração corretamente | Backup incompleto ou corrompido | Rever processo de backup, garantir integridade dos arquivos | Recuperação automática: rollback e automação de contingência |
| Playbook de rollback falha em alguns hosts | Permissões insuficientes ou caminhos incorretos | Verificar permissões e caminhos nos hosts afetados | Recuperação automática: rollback e automação de contingência |
| Contingência não é acionada após erro | Bloco rescue/always ausente ou mal configurado | Rever lógica dos blocos e garantir cobertura de exceções | Recuperação automática: rollback e automação de contingência |
| Rollback executa mas serviço não volta ao ar | Serviço depende de outros componentes não revertidos | Mapear dependências e incluir no rollback | Recuperação automática: rollback e automação de contingência |
| Logs de incidentes incompletos | Falta de padronização na documentação | Adotar template único e revisão periódica | Recuperação automática: rollback e automação de contingência |
| Playbook demora muito para rodar | CPU ou RAM insuficientes no control node | Reduza forks ou aumente recursos do servidor | Recursos de hardware e rede: limites práticos do Ansible em |
| Erros de conexão SSH | Limite baixo de conexões simultâneas no SSHD | Ajuste MaxSessions e MaxStartups nos hosts | Recursos de hardware e rede: limites práticos do Ansible em |
| Logs não são salvos ou arquivos temporários somem | Falta de espaço em disco | Libere espaço ou aumente storage local | Recursos de hardware e rede: limites práticos do Ansible em |
| A automação não dispara | Trigger mal configurado ou variável de entrada incorreta | Revise o nome da variável e os operadores usados | Regras automáticas: scripts, triggers e lógica embarcada |
| Script Groovy gera erro | Sintaxe inválida ou variável inexistente | Valide o script e consulte a documentação de variáveis disponíveis | Regras automáticas: scripts, triggers e lógica embarcada |
| Ação executada fora do esperado | Condições de trigger muito amplas ou conflito entre regras | Ajuste os valores de comparação e revise regras sobrepostas | Regras automáticas: scripts, triggers e lógica embarcada |
| upsmon não mostra status | upsd não está rodando ou driver travado | Reinicie nut-server e revise logs | Resolvendo problemas de comunicação e drivers no NUT |
| Erro 'Permission denied' | Permissões do dispositivo USB incorretas | Ajuste grupo e modo do dispositivo | Resolvendo problemas de comunicação e drivers no NUT |
| Erro 'No such device' | Nobreak desconectado ou caminho errado | Reconecte e revise ups.conf | Resolvendo problemas de comunicação e drivers no NUT |
| Falha de conexão remota | Firewall bloqueando porta 3493 | Libere a porta no firewall | Resolvendo problemas de comunicação e drivers no NUT |
| Driver não reconhece modelo | Driver incompatível ou desatualizado | Atualize NUT ou compile novo driver | Resolvendo problemas de comunicação e drivers no NUT |
| Erro 401 Unauthorized | Credenciais incorretas ou autenticação não configurada | Revise usuário/senha e configuração de autenticação | REST API do OpenEMS: automação e dashboards externos |
| Erro 404 Not Found | Endpoint ou canal inexistente | Verifique o caminho do endpoint e o ID do canal | REST API do OpenEMS: automação e dashboards externos |
| Timeout na requisição | API não acessível ou firewall bloqueando | Confirme conectividade e regras de firewall | REST API do OpenEMS: automação e dashboards externos |
| Resposta vazia ou incompleta | Permissões insuficientes ou erro no backend | Revise permissões e logs do OpenEMS | REST API do OpenEMS: automação e dashboards externos |
| Usuário não consegue conectar ao NUT | Senha incorreta ou IP não permitido no upsd.conf | Verifique senha no upsd.users e IPs permitidos no upsd.conf | Segurança da informação no NUT: autenticação e permissões |
| Comandos não são executados mesmo com login correto | Permissões insuficientes no upsd.users | Revise as permissões (actions, instcmds) do usuário | Segurança da informação no NUT: autenticação e permissões |
| Logs não mostram acessos ou comandos | Nível de log baixo ou syslog desativado | Ajuste MAXLOGLEVEL no upsd.conf e verifique syslog | Segurança da informação no NUT: autenticação e permissões |
| UPS desarma frequentemente | Sobrecarga ou falha no aterramento | Reduza a carga e meça a resistência do aterramento | Segurança elétrica: riscos e mitigação em UPS e aterramento |
| Cheiro de queimado próximo ao quadro | Aquecimento excessivo por mau contato | Desligue o sistema e reaperte conexões | Segurança elétrica: riscos e mitigação em UPS e aterramento |
| Choque ao tocar carcaça de servidor | Aterramento ausente ou deficiente | Corrija o aterramento conforme norma | Segurança elétrica: riscos e mitigação em UPS e aterramento |
| Cliente MQTT não conecta | Certificados TLS inválidos ou senha incorreta | Revise os certificados e o arquivo de senhas | Segurança em MQTT, REST e Modbus: o que realmente importa |
| REST API acessível por HTTP | HTTPS não habilitado corretamente | Verifique configuração do servidor e certificados | Segurança em MQTT, REST e Modbus: o que realmente importa |
| Modbus responde a IPs não autorizados | Firewall ou VLAN mal configurados | Revise regras de firewall e segmentação de rede | Segurança em MQTT, REST e Modbus: o que realmente importa |
| Mensagens MQTT interceptadas em texto claro | TLS não habilitado | Habilite e exija TLS no broker e clientes | Segurança em MQTT, REST e Modbus: o que realmente importa |
| Playbook falha em múltiplos shards simultaneamente | Problema de sincronização ou erro comum em todos os shards | Revise logs e sincronize novamente os arquivos de configuração | Sharding, balanceamento e tolerância a falhas em automações |
| Inventário desatualizado após failover | Sincronização manual não foi feita recentemente | Automatize a sincronização com scripts periódicos | Sharding, balanceamento e tolerância a falhas em automações |
| Nó de controle não assume execução após falha do primário | Configuração de permissões ou arquivos inconsistentes | Verifique permissões e integridade dos arquivos sincronizados | Sharding, balanceamento e tolerância a falhas em automações |
| O servidor não desliga após falha de energia. | O comando SHUTDOWNCMD está incorreto ou o script não tem permissão de execução. | Verifique o caminho e as permissões do script, além da sintaxe no upsmon.conf. | Shutdown automático de servidores: scripts com NUT |
| O script executa, mas serviços não param corretamente. | Comandos dentro do script estão errados ou serviços não existem. | Revise o script e adapte os comandos aos serviços reais do servidor. | Shutdown automático de servidores: scripts com NUT |
| Logs não mostram eventos do NUT. | upsmon não está rodando ou configurado corretamente. | Reinicie o serviço e revise o upsmon.conf. | Shutdown automático de servidores: scripts com NUT |
| Não aparece status do UPS no upsc | Driver incorreto ou UPS não suportado | Revise ups.conf e consulte a lista de compatibilidade | Tendências em UPS, baterias e monitoramento inteligente |
| Dados de sensores IoT não chegam ao sistema | Configuração de rede ou protocolo incompatível | Verifique portas, autenticação e formato dos dados | Tendências em UPS, baterias e monitoramento inteligente |
| Alertas não são enviados | Script de notificação com permissão insuficiente | Ajuste permissões do script e revise logs | Tendências em UPS, baterias e monitoramento inteligente |
| OpenEMS não reconhece dados do simulador Modbus | Configuração de endereço IP ou registradores incorreta | Revise o IP e os registradores configurados no OpenEMS e no simulador | Testes em ambiente real: simuladores, dry-run e homologação |
| Mensagens MQTT não são processadas | Tópico incorreto ou broker não acessível | Verifique o tópico usado e a conexão com o broker MQTT | Testes em ambiente real: simuladores, dry-run e homologação |
| Dry-run executa comandos reais | Modo simulado não ativado corretamente | Confirme a configuração do modo simulado no controlador | Testes em ambiente real: simuladores, dry-run e homologação |
| Testes do Molecule falham mesmo com playbook correto | Ambiente de teste mal configurado ou dependências ausentes | Revise o Dockerfile ou a configuração do cenário no Molecule | Testes, validação e auditoria contínua de automações |
| ansible-lint retorna muitos warnings | Código fora do padrão ou práticas inseguras | Ajuste o playbook seguindo as recomendações do ansible-lint | Testes, validação e auditoria contínua de automações |
| Logs de auditoria não aparecem | log_path não configurado corretamente ou permissões insuficientes | Verifique o ansible.cfg e permissões do diretório de log | Testes, validação e auditoria contínua de automações |
| Equipamento reinicia durante queda de energia | Tempo de comutação do UPS é maior que a tolerância do equipamento | Troque por UPS de topologia superior (line-interactive ou online) | Topologias de UPS: standby, line-interactive e online |
| Bateria descarrega rapidamente | Autonomia subdimensionada ou bateria degradada | Redimensione o UPS ou substitua as baterias | Topologias de UPS: standby, line-interactive e online |
| Alarmes frequentes de subtensão | Rede elétrica instável | Use UPS com AVR ou online para melhor regulação | Topologias de UPS: standby, line-interactive e online |
| UPS dispara alarme mesmo com energia normal | Problema de aterramento ou sobrecarga | Verifique a ligação à terra e reduza a carga conectada | UPS, aterramento e DPS: os três pilares da proteção elétrica |
| Equipamento queima após tempestade | DPS ausente ou aterramento ineficiente | Instale DPS adequado e meça a resistência do aterramento | UPS, aterramento e DPS: os três pilares da proteção elétrica |
| NUT não detecta o UPS | Driver ou porta incorretos | Consulte a documentação do NUT para configuração correta | UPS, aterramento e DPS: os três pilares da proteção elétrica |
| Variável não substituída no template | Variável não definida ou erro de digitação | Revise nomes de variáveis em group_vars, host_vars e no template | Variáveis, templates e handlers: personalizando automações d |
| Handler não executa após alteração | notify ausente ou nome do handler incorreto | Confirme que a tarefa tem 'notify' e o nome do handler está igual | Variáveis, templates e handlers: personalizando automações d |
| Arquivo de configuração não é atualizado | Permissões insuficientes ou caminho errado | Cheque permissões do usuário Ansible e o caminho em 'dest' | Variáveis, templates e handlers: personalizando automações d |
| Erro: 'Decryption failed' | Senha do Vault incorreta ou arquivo corrompido | Verifique a senha e tente restaurar o arquivo de um backup válido | Vault: protegendo segredos, senhas e chaves no Ansible |
| Erro: 'Undefined variable' | Nome da variável no playbook não corresponde ao arquivo Vault | Corrija o nome da variável ou o conteúdo do arquivo Vault | Vault: protegendo segredos, senhas e chaves no Ansible |
| Arquivo descriptografado aparece em backup | Backup feito após descriptografia manual | Evite backups de arquivos descriptografados; sempre use arquivos Vault | Vault: protegendo segredos, senhas e chaves no Ansible |
| Alteração sumiu após merge | Merge feito sem pull correto do branch principal | Sempre execute 'git pull origin main' antes de mergear. | Versionamento, documentação e governança de playbooks |
| Playbook sem documentação | README.md não atualizado ou ausência de comentários | Atualize README.md e adicione campos 'name' e comentários YAML. | Versionamento, documentação e governança de playbooks |
| Confusão entre versões do playbook | Nomenclatura inconsistente e ausência de tags | Padronize nomes e use 'git tag' para marcar versões estáveis. | Versionamento, documentação e governança de playbooks |
| Corrente alta mesmo com consumo baixo | Fator de potência baixo ou carga não linear | Investigue filtros de linha e fontes dos equipamentos | Watts, amperes e fator de potência: o que realmente importa |
| Disjuntores desarmando sem aparente sobrecarga | Subdimensionamento por não considerar potência aparente | Recalcule VA e corrente real | Watts, amperes e fator de potência: o que realmente importa |
| Medições inconsistentes entre equipamentos | Instrumentos com escalas ou precisão diferentes | Padronize medidores e calibração | Watts, amperes e fator de potência: o que realmente importa |
| Playbook não executa ao receber webhook | Permissões insuficientes ou erro no script Flask | Verifique logs do Flask e permissões do usuário que executa o subprocesso. | Webhooks, APIs e notificações: automação de resposta em temp |
| Notificação por e-mail não chega | Configuração incorreta de SMTP ou bloqueio de firewall | Teste envio manual de e-mail e ajuste configurações de SMTP e firewall. | Webhooks, APIs e notificações: automação de resposta em temp |
| Chamada de API retorna erro 401 | Token de autenticação inválido ou expirado | Renove o token e atualize o playbook. | Webhooks, APIs e notificações: automação de resposta em temp |
| Erro de parsing YAML | Indentação errada ou uso de tabulação | Revisar espaços, nunca usar TAB | YAML, SSH e SNMP: a base técnica da automação com Ansible |
| SSH pede senha | Chave pública não copiada ou permissões erradas | Verifique ~/.ssh/authorized_keys e permissões 600 | YAML, SSH e SNMP: a base técnica da automação com Ansible |
| SNMP não responde | Firewall bloqueando porta 161/UDP ou comunidade errada | Abrir porta no firewall e revisar string de comunidade | YAML, SSH e SNMP: a base técnica da automação com Ansible |
| Ansible falha ao executar módulo SNMP | Módulo não instalado ou dependências ausentes | Instale dependências Python SNMP (ex: pysnmp) | YAML, SSH e SNMP: a base técnica da automação com Ansible |
| Falha de autenticação SSH durante execução do playbook | Chave SSH ausente ou permissões incorretas | Verifique as permissões da chave e se está cadastrada no host remoto | Zero Trust, automação declarativa e tendências em segurança |
| Erro de descriptografia com Ansible Vault | Senha incorreta ou arquivo corrompido | Confirme a senha e a integridade do arquivo vault | Zero Trust, automação declarativa e tendências em segurança |
| Logs de execução não são gerados | Diretório de log sem permissão de escrita | Ajuste permissões do diretório de log | Zero Trust, automação declarativa e tendências em segurança |
