375 sintomas catalogados
Cada sintoma com causa provável e correção, ligado à lição da trilha Smart Cities que explica o porquê. Descreva o sintoma para filtrar.
| Sintoma | Causa provável | Correção | Lição |
|---|---|---|---|
| Agente Wazuh não envia logs | Configuração incorreta do servidor ou firewall bloqueando porta | Verifique o arquivo /var/ossec/etc/ossec.conf e regras de firewall. | A superfície de ataque real em cidades inteligentes: sensore |
| Política OPA não bloqueia acesso fora do horário | Erro na lógica da política ou formato do input | Revise a política Rego e os dados enviados à API OPA. | A superfície de ataque real em cidades inteligentes: sensore |
| APIs expostas sem autenticação | Falta de configuração de middleware de autenticação | Implemente autenticação obrigatória nas rotas críticas. | A superfície de ataque real em cidades inteligentes: sensore |
| Métricas não aparecem no painel Geomap | Labels de latitude/longitude ausentes ou mal configurados | Garanta que os exporters incluam esses labels e revise o mapeamento no painel | Além do básico: integração com ML, mapas e IoT em larga esca |
| Alertas preditivos não disparam | Modelo ML não está exportando métricas corretamente | Verifique logs do exporter e do Pushgateway | Além do básico: integração com ML, mapas e IoT em larga esca |
| Perda de dados em ingestão massiva | Prometheus sobrecarregado ou broker MQTT instável | Implemente sharding e monitore a saúde do broker | Além do básico: integração com ML, mapas e IoT em larga esca |
| O alerta dispara, mas o serviço não é reiniciado | Webhook não acessível ou erro no script | Verifique se o endpoint está rodando e revise logs de erro do script | Alertas automatizados: integração com scripts e webhooks |
| Serviço reinicia repetidamente sem parar | Loop de automação por falta de checagem de estado | Adicione validação para só agir se o problema persistir | Alertas automatizados: integração com scripts e webhooks |
| Alertmanager mostra erro ao enviar webhook | Endpoint fora do ar ou porta errada | Confirme a URL e se o serviço HTTP está escutando | Alertas automatizados: integração com scripts e webhooks |
| Logs não mostram ações automáticas | Script sem logging ou permissões insuficientes | Implemente logs e rode o script com permissões adequadas | Alertas automatizados: integração com scripts e webhooks |
| Alerta não dispara mesmo com valor acima do threshold | Erro na expressão ou no tempo de avaliação | Revise a expressão e o parâmetro 'for'. | Alertas inteligentes: threshold, ausência e anomalias |
| Alertas por ausência de dados nunca disparam | Nome da métrica incorreto ou coleta irregular | Confirme o nome exato da métrica e a frequência de scrape. | Alertas inteligentes: threshold, ausência e anomalias |
| Muitos falsos positivos em alertas de anomalia | Janela de cálculo inadequada | Ajuste o intervalo de avg_over_time e stddev_over_time. | Alertas inteligentes: threshold, ausência e anomalias |
| Alertas não aparecem no Alertmanager | Prometheus não está configurado corretamente para enviar alertas. | Revise a seção alerting do prometheus.yml e reinicie o serviço. | Alertmanager: instalando e integrando com Prometheus |
| Alertas não são enviados por e-mail | Configuração de SMTP incorreta no alertmanager.yml. | Verifique host, porta, usuário e senha SMTP. | Alertmanager: instalando e integrando com Prometheus |
| Alertmanager não inicia | Erro de sintaxe no arquivo alertmanager.yml. | Valide o YAML e consulte a documentação oficial. | Alertmanager: instalando e integrando com Prometheus |
| Logs de Auditd incompletos ou truncados | Rotação de logs antes da cópia | Configure rotação para manter histórico suficiente e copie imediatamente após o incidente | Análise forense: reconstruindo incidentes com logs de Auditd |
| Hash de integridade não bate após exportação | Arquivo alterado ou corrompido durante a transferência | Transfira usando scp ou rsync com verificação de integridade | Análise forense: reconstruindo incidentes com logs de Auditd |
| Eventos não aparecem no Wazuh | Agente não configurado para coletar logs de Auditd | Revise a configuração do agente conforme a documentação oficial | Análise forense: reconstruindo incidentes com logs de Auditd |
| API rejeita conexões do gateway | Certificado do gateway inválido ou não confiável | Reemita o certificado e atualize a CA confiada pela API | Arquitetura de referência: onde Wazuh, OPA, TLS e OAuth2 se |
| OPA não responde às consultas das APIs | OPA não está acessível na rede ou política de firewall bloqueando porta | Verifique conectividade e regras de firewall | Arquitetura de referência: onde Wazuh, OPA, TLS e OAuth2 se |
| Wazuh não recebe logs do gateway | Agente mal configurado ou porta bloqueada | Revise configuração do agente e libere porta 1514 TCP | Arquitetura de referência: onde Wazuh, OPA, TLS e OAuth2 se |
| Logs do Auditd não aparecem no Wazuh | Agente Wazuh não está coletando audit logs ou comunicação falhou | Verifique configuração do agente e conectividade; revise 'ossec.conf' e status do serviço | Auditd, Wazuh e compliance: rastreabilidade legal em cidades |
| Alertas de compliance não são disparados | Regra Wazuh mal configurada ou chave errada | Revise regras no 'ruleset' e teste eventos manualmente | Auditd, Wazuh e compliance: rastreabilidade legal em cidades |
| Exportação de logs incompleta | Filtro de busca errado ou permissões insuficientes | Ajuste filtros do ausearch e execute como root | Auditd, Wazuh e compliance: rastreabilidade legal em cidades |
| Recebe 401 Unauthorized ao acessar o Context Broker | Token ausente ou inválido | Obtenha novo token OAuth2 do Keyrock e inclua no header X-Auth-Token | Autenticação e autorização no FIWARE: Keyrock e AuthZForce |
| Recebe 403 Forbidden | Usuário não tem permissão segundo a política XACML | Revise as políticas no AuthZForce e os papéis do usuário | Autenticação e autorização no FIWARE: Keyrock e AuthZForce |
| PEP Proxy não consegue validar token | Configuração incorreta do host/porta do Keyrock no PEP Proxy | Verifique variáveis de ambiente e conectividade entre containers | Autenticação e autorização no FIWARE: Keyrock e AuthZForce |
| Usuário não consegue acessar dashboard mesmo estando no time correto | Permissão não atribuída ao time ou conflito de permissões individuais | Revise as permissões na pasta e no dashboard, ajuste prioridades | Autenticação e autorização no Grafana e Prometheus |
| Prometheus segue acessível sem pedir senha | Proxy reverso mal configurado ou acesso direto à porta interna | Garanta que só o proxy exponha a porta e revise as regras de firewall | Autenticação e autorização no Grafana e Prometheus |
| Usuários LDAP não autenticam no Grafana | Erro no ldap.toml ou firewall bloqueando comunicação com o servidor LDAP | Teste conexão LDAP manualmente e revise sintaxe do arquivo | Autenticação e autorização no Grafana e Prometheus |
| Dashboards vazios para métricas internas | Prometheus não está coletando suas próprias métricas | Confirme se o target 'prometheus-self' está configurado e 'up'. | Auto-monitoramento: Prometheus e Grafana sob vigilância |
| Alertas não disparam mesmo com falha | Regra de alerta mal configurada ou Alertmanager inativo | Revise a expressão da regra e o status do Alertmanager. | Auto-monitoramento: Prometheus e Grafana sob vigilância |
| Métricas do Grafana não aparecem | Endpoint /metrics não habilitado | Habilite métricas no grafana.ini e reinicie o serviço. | Auto-monitoramento: Prometheus e Grafana sob vigilância |
| Pods sendo OOMKilled | Limits de memória muito baixos para o padrão real de uso | Aumente os limits e requests de memória conforme medições | Calculando recursos: CPU, memória e storage para IoT urbano |
| Pods em Pending | Requests de recursos acima da capacidade dos nodes | Reduza requests ou aumente a capacidade do cluster | Calculando recursos: CPU, memória e storage para IoT urbano |
| Falha ao gravar dados em PVC | Uso de storage acima de 90% | Expanda o PVC conforme a documentação do provisionador | Calculando recursos: CPU, memória e storage para IoT urbano |
| Sensores não aparecem no Context Broker | Payload incompatível ou endpoint incorreto | Ajuste o formato do payload e valide o endpoint de ingestão | Camadas de uma arquitetura urbana: sensores, rede, contexto |
| Dados atrasados nas aplicações | Problemas de rede ou buffer mal dimensionado | Monitore latência e ajuste buffers e QoS | Camadas de uma arquitetura urbana: sensores, rede, contexto |
| Erro 404 ao consultar entidades | Entidade não registrada ou tipo incorreto | Confirme o tipo e o ID da entidade no Context Broker | Camadas de uma arquitetura urbana: sensores, rede, contexto |
| Pipeline falha na etapa de validação do Wazuh | Erro de sintaxe no XML | Corrija o arquivo usando 'xmllint --noout ./ossec.conf' até não haver erros | CI/CD de políticas: pipelines automáticos para OPA e Wazuh |
| OPA não carrega novas políticas após deploy | Políticas não copiadas corretamente ou sintaxe inválida | Verifique logs do OPA e rode 'opa test ./policies/' localmente | CI/CD de políticas: pipelines automáticos para OPA e Wazuh |
| Rollback não restaura serviço | Backup não foi criado ou caminho incorreto | Confirme existência do arquivo .bak antes do deploy e revise scripts de rollback | CI/CD de políticas: pipelines automáticos para OPA e Wazuh |
| Métricas não aparecem no Prometheus | Endpoint /metrics inacessível ou formato incorreto | Verifique se o serviço está rodando e expondo /metrics corretamente | Como o Prometheus coleta, armazena e expõe métricas |
| Erro 403 ou 404 ao coletar métricas | Firewall ou configuração de rede bloqueando acesso | Libere a porta do serviço e revise regras de firewall | Como o Prometheus coleta, armazena e expõe métricas |
| Dados desatualizados ou ausentes | scrape_interval muito longo ou falha de coleta | Reduza o intervalo e cheque logs do Prometheus | Como o Prometheus coleta, armazena e expõe métricas |
| Entidade não atualiza no Orion | IoT Agent não está recebendo mensagens do broker ou configuração de dispositivo incorreta | Verifique logs do IoT Agent e revise o registro do dispositivo | Conectando sensores via MQTT ao FIWARE |
| Erro de conexão entre IoT Agent e Mosquitto | Endereço ou porta incorretos na configuração do IoT Agent | Confirme variáveis de ambiente e conectividade de rede | Conectando sensores via MQTT ao FIWARE |
| Mensagem MQTT não chega ao broker | Firewall bloqueando porta 1883 ou Mosquitto não iniciado | Verifique status do Mosquitto e regras de firewall | Conectando sensores via MQTT ao FIWARE |
| Aplicação não lê o novo valor após atualizar o ConfigMap ou Secret | Pod não foi reiniciado após a alteração | Execute 'kubectl rollout restart deployment <nome> -n <namespace>' | ConfigMaps e Secrets: parametrizando aplicações IoT |
| Erro de permissão ao acessar Secret | RBAC do ServiceAccount não permite acesso ao Secret | Ajuste as permissões RBAC para o ServiceAccount do Pod | ConfigMaps e Secrets: parametrizando aplicações IoT |
| Valor do Secret aparece em logs | Aplicação ou script está logando variáveis sensíveis | Revise o código para evitar log de segredos | ConfigMaps e Secrets: parametrizando aplicações IoT |
| Não recebe notificações no endpoint | Endpoint inacessível ou formato não compatível | Verifique logs do endpoint, aceite POST NGSI e confira a URL na subscription | Configurando entidades e subscriptions no Orion Context Brok |
| Subscription não aparece na listagem | Erro de payload ou permissão insuficiente | Valide o JSON enviado e permissões do usuário | Configurando entidades e subscriptions no Orion Context Brok |
| Entidade não é encontrada | id ou type incorretos na criação ou consulta | Garanta nomenclatura consistente e revise os parâmetros | Configurando entidades e subscriptions no Orion Context Brok |
| Erro 401 Unauthorized ao consumir API | Falta de token de autenticação ou token inválido | Obtenha um token válido do Keyrock e inclua no header X-Auth-Token | Consumindo dados FIWARE com dashboards e aplicações web |
| Dashboard do Grafana não exibe dados | URL ou parâmetros incorretos na fonte de dados | Revise a configuração da URL e dos filtros NGSI | Consumindo dados FIWARE com dashboards e aplicações web |
| Respostas lentas ou timeouts | Consultas sem filtros ou volume excessivo de dados | Use parâmetros limit, offset e filtros por tipo ou id | Consumindo dados FIWARE com dashboards e aplicações web |
| Alertas não aparecem no dashboard | Regras XML mal formatadas ou serviço não reiniciado | Valide a sintaxe do arquivo e reinicie o Wazuh Manager | Dashboards e alertas: visualização e resposta rápida com Waz |
| Notificações não chegam por e-mail ou webhook | Configuração incorreta de SMTP ou URL do webhook | Revise os parâmetros em ossec.conf e teste conectividade | Dashboards e alertas: visualização e resposta rápida com Waz |
| Logs de decisão do OPA não aparecem | decision_logs desabilitado ou erro de permissão | Habilite decision_logs no config.yaml e reinicie o OPA | Dashboards e alertas: visualização e resposta rápida com Waz |
| Métrica 'up' sempre zero | Target offline ou configuração de scrape incorreta | Verifique conectividade e ajuste o 'targets' no scrape_configs | Definindo métricas que importam: disponibilidade, latência e |
| Latência não aparece no painel | Métrica de histograma não exposta pelo serviço | Instrumente o serviço para expor histogramas de latência | Definindo métricas que importam: disponibilidade, latência e |
| Alertas de evento crítico não disparam | Regra de alerta mal configurada ou Alertmanager não integrado | Revise a regra de alerta e a configuração do Alertmanager | Definindo métricas que importam: disponibilidade, latência e |
| Release falha ao instalar | Erro de sintaxe em templates ou dependência não encontrada | Revise os templates e rode 'helm lint ./iot-app' | Deploy de aplicações IoT com Helm: versionamento e rollback |
| Rollback não reverte o estado desejado | Configuração persistente fora do chart (ex: PVCs não versionados) | Inclua recursos persistentes no chart e documente limitações | Deploy de aplicações IoT com Helm: versionamento e rollback |
| Upgrade interrompe serviço | Probes de readiness/liveness mal configurados | Ajuste os probes nos templates para garantir atualização sem downtime | Deploy de aplicações IoT com Helm: versionamento e rollback |
| Prometheus não exibe métricas do Node Exporter | Target incorreto ou Node Exporter não está rodando | Verifique se o nome do target em prometheus.yml está igual ao nome do serviço no docker-compose.yml | Deploy rápido: Prometheus, Grafana e Node Exporter em Docker |
| Dashboards do Grafana somem após reiniciar | Volume de dados não configurado corretamente | Confirme se o volume grafana_data está declarado e montado | Deploy rápido: Prometheus, Grafana e Node Exporter em Docker |
| Erro de permissão ao iniciar containers | Diretórios locais com permissões restritivas | Ajuste as permissões dos diretórios usados como volumes | Deploy rápido: Prometheus, Grafana e Node Exporter em Docker |
| Mensagens não aparecem no FIWARE | Tópico MQTT incorreto ou sensor desconectado | Corrija o tópico no sensor ou restabeleça a conexão de rede | Depurando falhas de comunicação entre sensores e FIWARE |
| Mensagens chegam duplicadas | QoS 1 sem deduplicação no FIWARE | Implemente deduplicação ou ajuste QoS | Depurando falhas de comunicação entre sensores e FIWARE |
| Erro de autenticação no broker | Usuário ou senha MQTT incorretos | Ajuste as credenciais no sensor e no IoT Agent | Depurando falhas de comunicação entre sensores e FIWARE |
| Dados pessoais vazando em payloads NGSI | Anonimização insuficiente ou scripts mal configurados | Revise scripts de anonimização e valide campos expostos | Desafios emergentes: privacidade, ética e IA em cidades inte |
| Modelo de IA com decisões enviesadas | Conjunto de dados de treinamento desbalanceado | Reavalie o dataset e aplique ferramentas de fairness | Desafios emergentes: privacidade, ética e IA em cidades inte |
| Logs sem rastreabilidade de mudanças | Falta de metadados de auditoria nos registros | Adicione campos de auditoria nos payloads NGSI | Desafios emergentes: privacidade, ética e IA em cidades inte |
| Pods concentrados em uma única zona | topologySpreadConstraints ausente ou mal configurado | Revise o topologyKey e garanta que os labels dos nós estejam corretos | Desenhando clusters resilientes: nós, pods e zonas de falha |
| Latência alta entre dispositivos e pods | Pods agendados em zonas distantes dos dispositivos | Ajuste nodeAffinity para aproximar pods dos endpoints IoT | Desenhando clusters resilientes: nós, pods e zonas de falha |
| Falha ao aplicar constraints de zona | Uso de label obsoleto (failure-domain.beta.kubernetes.io/zone) | Atualize para topology.kubernetes.io/zone nos manifests e nos nós | Desenhando clusters resilientes: nós, pods e zonas de falha |
| Pod em CrashLoopBackOff | Erro de inicialização do container ou dependência externa indisponível | Verifique logs do pod e eventos para identificar a falha; corrija o erro no código ou dependência. | Diagnóstico de pods, nós e serviços: comandos essenciais |
| Pod com status Pending | Falta de recursos no nó ou erro de scheduling | Revise requests/limits do pod e disponibilidade dos nós; ajuste recursos ou distribua pods. | Diagnóstico de pods, nós e serviços: comandos essenciais |
| Erro MountVolume.SetUp failed | Problema ao montar volume persistente | Verifique o PVC, permissões e storage class; ajuste ou re-provisione o volume. | Diagnóstico de pods, nós e serviços: comandos essenciais |
| Wazuh não inicia após alteração de configuração | Erro de sintaxe no ossec.conf | Rode '/var/ossec/bin/ossec-control configtest' e corrija o erro apontado. | Diagnóstico rápido: logs, métricas e erros comuns em Wazuh e |
| OPA retorna erro 500 ao avaliar política | Política Rego inválida ou input malformado | Execute 'opa check' e revise o input enviado. | Diagnóstico rápido: logs, métricas e erros comuns em Wazuh e |
| Alertas do Wazuh não aparecem no dashboard | Problema de comunicação entre agentes e manager | Verifique logs de rede e conectividade dos agentes. | Diagnóstico rápido: logs, métricas e erros comuns em Wazuh e |
| Eventos de log atrasados ou perdidos | Sobrecarga no servidor ou disco lento | Aumentar recursos ou escalar horizontalmente | Dimensionando Wazuh e OPA: requisitos mínimos e limites prát |
| OPA responde lentamente | Políticas complexas ou falta de cache | Simplificar políticas ou habilitar cache | Dimensionando Wazuh e OPA: requisitos mínimos e limites prát |
| Agentes desconectando | Latência de rede alta | Ajustar 'queue_size' e buffers | Dimensionando Wazuh e OPA: requisitos mínimos e limites prát |
| Elasticsearch indisponível | Falta de RAM ou disco cheio | Adicionar recursos e limpar índices antigos | Dimensionando Wazuh e OPA: requisitos mínimos e limites prát |
| Pod reinicia repetidamente | Requests/limits subdimensionados ou probes mal configuradas | Ajuste os valores e revise as probes | Do requisito ao manifesto: modelando workloads IoT |
| Pod fica em Pending | Falta de recursos no cluster ou PVC não provisionado | Libere recursos ou corrija o PersistentVolumeClaim | Do requisito ao manifesto: modelando workloads IoT |
| Consumo de CPU/memória excede o esperado | Carga real maior que o previsto | Reavalie requests/limits e monitore o workload | Do requisito ao manifesto: modelando workloads IoT |
| Dashboard sumiu após atualização | Alteração não versionada ou rollback ausente | Restaure a versão anterior via 'git checkout' | Documentação viva: versionamento e transparência |
| Configuração do Prometheus inválida após merge | Conflito de merge não resolvido corretamente | Revise o diff, corrija manualmente e faça novo commit | Documentação viva: versionamento e transparência |
| Documentação desatualizada | Alterações aplicadas sem atualização do CHANGELOG | Implemente política de revisão obrigatória antes do merge | Documentação viva: versionamento e transparência |
| Dados de consumo não aparecem no Grafana | Endpoint de métricas inacessível ou configuração incorreta do target | Teste o acesso ao endpoint via curl e revise o prometheus.yml. | Energia e iluminação pública: métricas que previnem falhas |
| Alertas não são disparados | Regra de alerta mal configurada ou Alertmanager não integrado | Revise a expressão da regra e a configuração do Alertmanager. | Energia e iluminação pública: métricas que previnem falhas |
| Mapa não mostra todos os pontos | Dados georreferenciados ausentes ou mal formatados | Inclua latitude e longitude nas métricas ou revise o painel do Grafana. | Energia e iluminação pública: métricas que previnem falhas |
| Erro 401 ao acessar o broker | Token ausente, expirado ou inválido | Solicite novo token no Keyrock e envie no header Authorization | Erros comuns no Orion Context Broker: causas e soluções |
| Subscription criada, mas não recebe notificações | Endpoint de callback incorreto ou indisponível | Corrija a URL do endpoint e teste a conectividade | Erros comuns no Orion Context Broker: causas e soluções |
| Erro 400 ao criar entidade | JSON malformado ou campos obrigatórios ausentes | Valide o JSON e revise os campos conforme NGSI v2 | Erros comuns no Orion Context Broker: causas e soluções |
| HPA não escala pods mesmo com alta CPU | Requests de CPU não definidos ou métricas indisponíveis | Defina requests de CPU nos deployments e verifique se o metrics-server está funcionando | Escalabilidade horizontal e vertical: limites e estratégias |
| Pods reiniciando inesperadamente com VPA | VPA em modo 'Auto' aplicando novos limites | Altere para modo 'Off' ou 'Initial' para workloads críticos | Escalabilidade horizontal e vertical: limites e estratégias |
| HPA não responde a métricas customizadas | Adapter de métricas customizadas não instalado ou configurado | Instale e configure o k8s-prometheus-adapter corretamente | Escalabilidade horizontal e vertical: limites e estratégias |
| Cluster atinge limite de pods por nó | Limite físico ou configuração do kubelet | Distribua pods entre mais nós ou ajuste o parâmetro --max-pods | Escalabilidade horizontal e vertical: limites e estratégias |
| Agente Wazuh não alterna para o manager passivo | Configuração incorreta do arquivo ossec.conf ou sincronização falha | Revise o ossec.conf e teste a conectividade entre agente e ambos os managers | Escalando Wazuh e OPA: clusters, balanceamento e alta dispon |
| OPA não recebe atualizações de políticas | Bundle central inacessível ou configuração de polling errada | Verifique logs do OPA e conectividade HTTP/S3 | Escalando Wazuh e OPA: clusters, balanceamento e alta dispon |
| Balanceador não distribui requisições corretamente | Configuração errada de upstream ou health check | Revise configuração do NGINX/HAProxy e os logs de erro | Escalando Wazuh e OPA: clusters, balanceamento e alta dispon |
| Mensagens não chegam ao Context Broker | IoT Agent MQTT não está configurado corretamente ou não está rodando | Revise as configurações do IoT Agent e reinicie o serviço | Escolha de protocolos: quando usar MQTT, HTTP ou outros |
| Sensores não conseguem publicar no MQTT | Broker não está escutando ou autenticação falhou | Verifique configuração do Mosquitto e permissões de usuário | Escolha de protocolos: quando usar MQTT, HTTP ou outros |
| Dados chegam com atraso | Latência de rede ou sobrecarga no Context Broker | Monitore uso de CPU/memória e considere balanceamento de carga | Escolha de protocolos: quando usar MQTT, HTTP ou outros |
| Banco de dados crescendo rápido demais | Frequência de coleta alta ou retenção excessiva | Reduza a frequência ou ajuste a política de retenção | Estimando volume de dados: sensores, frequência e armazename |
| Perda de dados em horários de pico | Rede ou disco subdimensionados | Aumente a capacidade da rede ou do armazenamento | Estimando volume de dados: sensores, frequência e armazename |
| Latência alta na consulta de dados históricos | Banco de dados não otimizado para leitura | Implemente índices e particionamento | Estimando volume de dados: sensores, frequência e armazename |
| O contentor não aparece no Context Broker | O dispositivo não foi registrado corretamente no IoT Agent | Revise o cadastro do dispositivo e verifique logs do IoT Agent | Estudo de caso: gestão de resíduos urbanos conectada |
| O valor fillingLevel não atualiza | O payload enviado pelo sensor não corresponde ao mapeamento de atributos | Confirme se o object_id no cadastro bate com o campo do JSON enviado | Estudo de caso: gestão de resíduos urbanos conectada |
| Erro de conexão entre IoT Agent e Context Broker | Variáveis de ambiente do container estão erradas | Verifique IOTA_CB_HOST e IOTA_CB_PORT | Estudo de caso: gestão de resíduos urbanos conectada |
| Dados de localização não aparecem no Context Broker | IoT Agent não configurado corretamente ou erro no envio do dado | Revise o cadastro do dispositivo e o endpoint usado no curl | Estudo de caso: transporte público inteligente com FIWARE |
| Cygnus não grava dados no MongoDB | Variáveis de ambiente do Cygnus apontando para host incorreto | Confirme o nome do serviço MongoDB no docker-compose e ajuste CYGNUS_MONGO_HOST | Estudo de caso: transporte público inteligente com FIWARE |
| API NGSI retorna erro 404 para entidade | Entidade não foi criada ou identificador incorreto | Verifique o nome da entidade e repita o envio de dados | Estudo de caso: transporte público inteligente com FIWARE |
| Prometheus consumindo muita RAM | Cardinalidade alta por labels dinâmicos | Remova ou limite labels que mudam muito, como IDs únicos | Evite armadilhas: cardinalidade, retenção e rotulagem |
| Disco enchendo rápido | Retenção longa demais ou muitas séries | Reduza o tempo de retenção ou limite o número de séries | Evite armadilhas: cardinalidade, retenção e rotulagem |
| Queries lentas no Grafana | Métricas com muitos labels e alta cardinalidade | Simplifique as métricas e reduza a granularidade dos labels | Evite armadilhas: cardinalidade, retenção e rotulagem |
| Exporter não responde na porta | Porta bloqueada por firewall ou exporter não iniciado | Verifique firewall e se o processo está rodando | Exporters: integrando sensores IoT e serviços legados |
| Métricas não aparecem no Prometheus | Erro no scrape_configs ou exporter fora do ar | Revise a configuração e teste o endpoint manualmente | Exporters: integrando sensores IoT e serviços legados |
| Valores estranhos ou nulos | Script do exporter com erro de leitura ou parsing | Cheque logs e valide a leitura do sensor | Exporters: integrando sensores IoT e serviços legados |
| Timeout no scrape | Exporter lento ou sensor demorando a responder | Otimize o script e aumente timeout no Prometheus se necessário | Exporters: integrando sensores IoT e serviços legados |
| Eventos do Auditd não aparecem no Wazuh | Regras do Auditd ausentes ou módulo auditd do Wazuh desativado | Adicione regras ao Auditd e ative o módulo no Wazuh | Falhas em integração: como detectar e corrigir problemas ent |
| Wazuh não consegue consultar o OPA | Conectividade de rede ou autenticação mal configurada | Ajuste firewall, proxy ou headers de autenticação | Falhas em integração: como detectar e corrigir problemas ent |
| OPA retorna HTTP 403 para o Wazuh | Token inválido ou política de acesso restritiva | Gere novo token e revise políticas do OPA | Falhas em integração: como detectar e corrigir problemas ent |
| Dados não aparecem no Context Broker | IoT Agent MQTT não está configurado corretamente ou não está recebendo as mensagens MQTT | Verifique logs do IoT Agent e se o broker MQTT está acessível | FIWARE, NGSI e MQTT: padrões abertos para IoT urbano |
| Erro 404 ao consultar entidade | Entidade não foi criada ou o ID está incorreto | Confirme o ID e repita o comando de criação | FIWARE, NGSI e MQTT: padrões abertos para IoT urbano |
| Publicação MQTT sem efeito | Tópico MQTT ou payload incompatível com a configuração do IoT Agent | Revise o mapeamento de tópicos e o formato da mensagem conforme a documentação | FIWARE, NGSI e MQTT: padrões abertos para IoT urbano |
| Agente não aparece como ativo | Problema de rede ou token expirado | Verifique conectividade e gere novo token | Gerenciando milhares de sensores: automação e orquestração e |
| Erro de autenticação ao registrar agente | Token inválido ou já utilizado | Gere novo token e repita o registro | Gerenciando milhares de sensores: automação e orquestração e |
| Configuração não aplicada em todos os sensores | Falha no playbook ou permissões insuficientes | Revise logs do Ansible e permissões SSH | Gerenciando milhares de sensores: automação e orquestração e |
| API do Wazuh não responde | Serviço parado ou firewall bloqueando porta 55000 | Reinicie o serviço e ajuste regras de firewall | Gerenciando milhares de sensores: automação e orquestração e |
| Sensores não aparecem no Orion após provisionamento | Erro no JSON ou endpoint incorreto | Revise o payload e a URL usada no provisionamento | Gerenciando milhares de sensores: práticas para ambientes ma |
| Dados de sensores não atualizam | Problema de comunicação entre IoT Agent e sensores | Verifique logs do IoT Agent e conectividade dos dispositivos | Gerenciando milhares de sensores: práticas para ambientes ma |
| Comando de atualização OTA falha | Sensor não suporta OTA ou comando mal formatado | Confirme compatibilidade do dispositivo e formato do comando | Gerenciando milhares de sensores: práticas para ambientes ma |
| Serviço falha após rotação de certificado | Novo certificado não foi aplicado corretamente ou serviço não foi recarregado. | Revise o deploy-hook e recarregue o serviço manualmente. | Gestão de segredos: chaves, tokens e certificados em ambient |
| Logs de auditoria não mostram acessos | Auditd não está configurado ou não está rodando. | Reinicie o auditd e revise as regras com 'auditctl -l'. | Gestão de segredos: chaves, tokens e certificados em ambient |
| Token de API antigo ainda é aceito | Revogação não foi propagada para todos os sistemas. | Verifique scripts de rotação e sincronize dependências. | Gestão de segredos: chaves, tokens e certificados em ambient |
| Deploy não atualiza após commit no Git | ArgoCD/Flux não está monitorando o repositório correto ou falta permissão de acesso | Revise configuração do repositório na ferramenta GitOps e permissões de acesso | GitOps e CI/CD para IoT: fluxo de deploy contínuo |
| Pipeline falha ao atualizar manifest | Permissão insuficiente no repositório ou erro de sintaxe no script | Verifique permissões do token de CI/CD e revise comandos de atualização | GitOps e CI/CD para IoT: fluxo de deploy contínuo |
| Rollback não reverte o estado do cluster | Ferramenta GitOps não está sincronizando automaticamente | Forçar sincronização manual ou revisar configuração de auto-sync | GitOps e CI/CD para IoT: fluxo de deploy contínuo |
| Dados antigos não são descartados | Política de retenção ausente ou mal configurada | Revise a configuração do banco e das políticas de retenção | Governança e ciclo de vida dos dados urbanos |
| Usuários acessam dados sem autorização | Wilma PEP Proxy não está ativo ou mal configurado | Verifique variáveis de ambiente e integração com OAuth2 | Governança e ciclo de vida dos dados urbanos |
| Logs de auditoria ausentes | Cygnus não está recebendo eventos ou não está persistindo | Cheque configuração do Cygnus e permissões do banco de logs | Governança e ciclo de vida dos dados urbanos |
| Dashboard demora para carregar | Queries complexas ou muitos painéis simultâneos | Simplifique queries e reduza o número de painéis | Grafana e dashboards: limites práticos de visualização |
| Timeouts ao abrir dashboards | Limite de queries simultâneas excedido | Ajuste max_concurrent_queries e divida dashboards | Grafana e dashboards: limites práticos de visualização |
| Dados inconsistentes entre painéis | Painéis consultando períodos diferentes ou filtros conflitantes | Padronize variables e períodos nos painéis | Grafana e dashboards: limites práticos de visualização |
| Usuário não consegue ver dashboards de outra cidade | Permissão de Viewer não atribuída à pasta correspondente | Adicione permissão de Viewer ao time correto na pasta desejada | Grafana em escala: dashboards multi-cidade e multi-equipe |
| Dashboard mostra dados errados ao trocar de cidade | Queries não usam a variável $cidade corretamente | Revise as consultas para garantir uso de $cidade | Grafana em escala: dashboards multi-cidade e multi-equipe |
| Equipe consegue editar dashboards de outra cidade | Permissão de Editor concedida globalmente ou em pasta errada | Restrinja permissões de Editor apenas à pasta da equipe | Grafana em escala: dashboards multi-cidade e multi-equipe |
| Variável de cidade não aparece | Erro na configuração da variável ou ausência da label city no Prometheus | Verifique a query da variável e os dados no Prometheus | Grafana em escala: dashboards multi-cidade e multi-equipe |
| Painel mostra 'Datasource Error' | URL errada, Prometheus offline ou autenticação falha | Corrija a URL, valide o serviço Prometheus e ajuste credenciais | Grafana sem dados? Debug de queries e painéis |
| Painel vazio sem erro | Query válida, mas sem dados no intervalo selecionado | Ajuste o intervalo de tempo ou revise a query | Grafana sem dados? Debug de queries e painéis |
| Erro de sintaxe PromQL | Query malformada ou métrica inexistente | Revise a query e valide métricas disponíveis | Grafana sem dados? Debug de queries e painéis |
| Painel não exibe dados de um Prometheus | Endpoint incorreto ou Prometheus inacessível | Verifique o endereço e conectividade de rede | Grafana: conectando múltiplos Prometheus e fontes externas |
| Erro 'Data source not found' em painel misto | Datasource removido ou renomeado | Atualize o painel para apontar para o datasource correto | Grafana: conectando múltiplos Prometheus e fontes externas |
| Painel lento ou travando | Consultas pesadas em múltiplos datasources | Otimize as queries e reduza o intervalo de tempo | Grafana: conectando múltiplos Prometheus e fontes externas |
| Usuário não visualiza painel esperado | Permissão insuficiente na pasta ou dashboard | Revise as permissões em Folders > Permissions | Grafana: criando painéis e usuários para equipes urbanas |
| Variável não aparece no dashboard | Erro na configuração da variável | Verifique Dashboard settings > Variables e ajuste a query | Grafana: criando painéis e usuários para equipes urbanas |
| Painéis mostram dados de áreas erradas | Queries sem filtro de variável | Inclua as variáveis nas queries Prometheus | Grafana: criando painéis e usuários para equipes urbanas |
| Painel não exibe dados | URL do Prometheus incorreta ou Prometheus offline | Verifique se o Prometheus está rodando e a URL está correta. | Grafana: de onde vêm os dados e como são exibidos |
| Erro de permissão ao adicionar data source | Usuário Grafana sem permissão de admin | Acesse com uma conta de administrador. | Grafana: de onde vêm os dados e como são exibidos |
| Dados atrasados ou incompletos | Intervalo de atualização muito curto ou Prometheus sobrecarregado | Aumente o intervalo de refresh ou otimize consultas no Prometheus. | Grafana: de onde vêm os dados e como são exibidos |
| Alertas críticos não estão sendo gerados | Regra com nível baixo ou filtro excessivo | Revise níveis e condições das regras | Hardening do Wazuh: regras, alertas e tuning para ambientes |
| Falsos positivos continuam aparecendo | Filtros <ignore> mal configurados ou decoders ausentes | Ajuste as tags <ignore> e revise decoders | Hardening do Wazuh: regras, alertas e tuning para ambientes |
| Logs não chegam ao SIEM externo | Configuração syslog incorreta ou firewall bloqueando porta | Verifique bloco <syslog_output> e regras de firewall | Hardening do Wazuh: regras, alertas e tuning para ambientes |
| Agente não conecta ao manager | Problema de certificado ou porta bloqueada | Confirme certificados e liberação da porta 1514 | Hardening do Wazuh: regras, alertas e tuning para ambientes |
| Instâncias do Orion não recebem requisições | Balanceador de carga mal configurado | Revise a configuração do NGINX ou Service Kubernetes | Horizontalizando o Orion Context Broker e agentes IoT |
| Dados inconsistentes entre instâncias | MongoDB não está em replica set | Reconfigure o MongoDB para replica set | Horizontalizando o Orion Context Broker e agentes IoT |
| Latência alta mesmo com múltiplas instâncias | Gargalo no MongoDB ou falta de recursos | Aumente recursos do MongoDB ou faça sharding | Horizontalizando o Orion Context Broker e agentes IoT |
| Eventos do Auditd não aparecem no dashboard | O agent não está coletando o arquivo correto ou o serviço está parado | Verifique se /var/log/audit/audit.log existe, se o agent está rodando e revise a configuração <localfile>. | Implantando Wazuh e Auditd: do agent ao dashboard em ambient |
| Agent não conecta ao manager | Firewall bloqueando portas ou endereço IP incorreto | Confirme se as portas 1514/udp e 55000/tcp estão liberadas e o IP está correto no ossec.conf. | Implantando Wazuh e Auditd: do agent ao dashboard em ambient |
| Regras do Auditd não geram eventos | Sintaxe incorreta ou regras não aplicadas | Revise a sintaxe em /etc/audit/rules.d/audit.rules e reinicie o auditd. | Implantando Wazuh e Auditd: do agent ao dashboard em ambient |
| Alertas de movimentação lateral continuam | Regras Wazuh insuficientes ou políticas OPA não aplicadas corretamente | Revise regras customizadas e políticas Rego, aplique novamente | Incidente real: resposta a ataque direcionado em infraestrut |
| Dispositivos IoT continuam vulneráveis | Firmware não atualizado ou senhas padrão mantidas | Aplique atualizações e troque credenciais imediatamente | Incidente real: resposta a ataque direcionado em infraestrut |
| Microserviços não se comunicam após ajuste OPA | Política restritiva demais | Ajuste regras Rego para permitir apenas fluxos legítimos | Incidente real: resposta a ataque direcionado em infraestrut |
| Prometheus não inicia ou sai imediatamente | Erro de sintaxe no prometheus.yml | Valide a configuração com o comando de check-config do Prometheus | Infraestrutura como código: docker-compose e além |
| Grafana não salva dashboards | Volume não persistente ou permissões erradas | Verifique o volume grafana_data e permissões do diretório | Infraestrutura como código: docker-compose e além |
| Atualização não aplica mudanças | docker-compose.yml não foi salvo ou commitado | Confirme alterações no arquivo e reinicie com docker-compose up -d | Infraestrutura como código: docker-compose e além |
| Nó não aparece como 'Ready' no kubectl | Problemas de rede, CNI não instalado ou CRI-O não iniciado | Verifique status do crio e logs do kubelet; reinstale o CNI | Instalando Kubernetes com CRI-O: do bare metal à nuvem |
| Erro 'swap is enabled' no kubeadm init | Swap não foi desabilitado | Execute 'swapoff -a' e remova swap do /etc/fstab | Instalando Kubernetes com CRI-O: do bare metal à nuvem |
| kubeadm não encontra o CRI-O socket | CRI-O não instalado ou não iniciado | Verifique 'systemctl status crio' e o caminho do socket | Instalando Kubernetes com CRI-O: do bare metal à nuvem |
| Orion não inicia ou encerra imediatamente | Conexão com o MongoDB falhou ou porta 1026 já está em uso | Verifique se o MongoDB está rodando e se a porta 1026 está livre | Instalando o Orion Context Broker em ambiente Linux |
| Erro 400 ou 500 ao criar entidade | JSON malformado ou MongoDB indisponível | Valide o JSON e confira logs do Orion e do MongoDB | Instalando o Orion Context Broker em ambiente Linux |
| Não recebe resposta no curl | Firewall bloqueando porta ou Orion não está escutando | Libere a porta 1026 e verifique o status do serviço | Instalando o Orion Context Broker em ambiente Linux |
| Node-RED não recebe eventos do Context Broker | Endpoint ou porta incorretos, ou subscription não criada | Verifique configuração do nó Orion in e se o Context Broker está acessível | Integração com sistemas de automação urbana (ex: Node-RED) |
| Alerta não chega ao sistema externo | Erro na configuração do nó http request ou endpoint externo fora do ar | Revise URL e autenticação do nó http request | Integração com sistemas de automação urbana (ex: Node-RED) |
| Atualização de entidade não ocorre | Permissões insuficientes ou erro na configuração do Orion out | Confirme credenciais e formato dos dados enviados | Integração com sistemas de automação urbana (ex: Node-RED) |
| Fluxo não dispara em evento esperado | Regra do nó switch mal configurada | Ajuste condição de comparação no nó switch | Integração com sistemas de automação urbana (ex: Node-RED) |
| Dados não aparecem no Orion após integração | Erro no mapeamento ou na transformação dos dados | Revise scripts/adaptadores e valide cada campo transformado | Integração com sistemas legados: desafios e soluções |
| Atributos com valores errados ou ausentes | Conversão de tipos ou nomes de campos incorretos | Ajuste o mapeamento e teste com exemplos reais | Integração com sistemas legados: desafios e soluções |
| Sincronização atrasada ou incompleta | Jobs de atualização mal configurados ou polling com intervalo muito alto | Reduza o intervalo ou otimize triggers e webhooks | Integração com sistemas legados: desafios e soluções |
| Sidecar não recebe mensagens MQTT | Broker MQTT inacessível ou variáveis de ambiente incorretas | Verifique conectividade de rede e valores das variáveis | Integração de dispositivos legados via adaptadores e sidecar |
| Entidades não aparecem no broker NGSI | Erro de autenticação ou endpoint incorreto | Confirme o endpoint NGSI e permissões de acesso | Integração de dispositivos legados via adaptadores e sidecar |
| Pod reiniciando em loop | Exceção não tratada no adaptador | Revise logs e trate falhas de conexão no código | Integração de dispositivos legados via adaptadores e sidecar |
| Orion retorna erro 500 ao criar entidade | MongoDB não acessível ou mal configurado | Verifique variáveis ORION_MONGO_HOST e logs do pod Orion | Integração de gateways IoT e NGSI com Kubernetes |
| Gateway não conecta ao Orion | Service Kubernetes não exposto corretamente | Confirme endereço DNS e tipo do Service | Integração de gateways IoT e NGSI com Kubernetes |
| Pods Orion reiniciando em loop | Probes configurados de forma agressiva ou MongoDB indisponível | Ajuste initialDelaySeconds e verifique status do MongoDB | Integração de gateways IoT e NGSI com Kubernetes |
| API aceita requisições sem token | Validação OAuth2 não implementada ou mal configurada | Reveja a configuração de autenticação da API e o middleware responsável. | Integração ponta a ponta: Wazuh + OPA + OAuth2 em APIs e sen |
| OPA sempre responde deny | Política mal escrita ou input incompleto | Revise a política Rego e os campos enviados no input. | Integração ponta a ponta: Wazuh + OPA + OAuth2 em APIs e sen |
| Logs não aparecem no Wazuh | Caminho de log ou formato incompatível | Ajuste o caminho no arquivo de configuração do Wazuh e valide o formato syslog. | Integração ponta a ponta: Wazuh + OPA + OAuth2 em APIs e sen |
| Usuário não consegue listar pods no namespace | Role ou RoleBinding ausente ou incorreto | Verifique e corrija Role e RoleBinding no namespace | Isolamento de workloads: namespaces, RBAC e policies |
| Pods conseguem se comunicar entre namespaces sem restrição | Network Policy não aplicada ou mal configurada | Revise e aplique Network Policies restritivas | Isolamento de workloads: namespaces, RBAC e policies |
| Recursos criados no namespace errado | Comando kubectl sem parâmetro -n ou --namespace | Sempre especifique o namespace ao criar recursos | Isolamento de workloads: namespaces, RBAC e policies |
| Broker não responde na porta 9090 | Service não exposto corretamente ou deployment com erro de imagem | Verifique logs do pod com 'kubectl logs' e a configuração do Service | Kubernetes e NGSI-LD: interoperabilidade semântica para smar |
| Erro 400 ao criar entidade | Payload JSON-LD malformado ou contexto ausente | Valide o JSON com ferramentas online e confira o '@context' | Kubernetes e NGSI-LD: interoperabilidade semântica para smar |
| Entidades não aparecem nas consultas | Banco de dados do broker não persistente ou falha de configuração | Reveja o volume persistente e variáveis de ambiente do deployment | Kubernetes e NGSI-LD: interoperabilidade semântica para smar |
| Pods não são agendados nos edge nodes | Labels ou taints incorretos | Revise os labels/taints aplicados e ajuste as tolerations dos pods | Kubernetes no edge: microclusters e 5G em cidades inteligent |
| Sincronização de dados falha após perda de conexão 5G | Buffer local insuficiente ou agente de sincronização mal configurado | Aumente o buffer local e revise a configuração do agente | Kubernetes no edge: microclusters e 5G em cidades inteligent |
| Cluster edge fica isolado após atualização | Dependência de control plane externo | Garanta que o control plane local seja autônomo e revise a topologia | Kubernetes no edge: microclusters e 5G em cidades inteligent |
| Pods ficam em estado 'ContainerCreating' indefinidamente | O kubelet não está conseguindo se comunicar com o runtime CRI-O. | Verifique se o CRI-O está rodando ('systemctl status crio') e se o caminho do socket está correto na configuração. | Kubernetes, CRI-O e Docker: diferenças práticas para IoT |
| Erro 'container runtime is down' | O serviço CRI-O não está ativo ou falhou ao iniciar. | Reinicie o serviço CRI-O e verifique logs em /var/log/crio/crio.log. | Kubernetes, CRI-O e Docker: diferenças práticas para IoT |
| Pods não sobem após alteração do runtime | Configuração do kubelet inválida ou incompatível. | Revise o arquivo config.yaml e consulte a documentação oficial para sintaxe correta. | Kubernetes, CRI-O e Docker: diferenças práticas para IoT |
| Pod reinicia continuamente | Liveness probe está muito agressiva ou falha ao checar hardware | Ajuste initialDelaySeconds e failureThreshold; valide o script da probe | Liveness, readiness e probes customizadas para IoT |
| Pod nunca fica 'Ready' | Readiness probe depende de recurso externo indisponível | Teste conectividade e ajuste timeoutSeconds | Liveness, readiness e probes customizadas para IoT |
| Probes demoram a responder | Execução de script lenta ou hardware com latência alta | Otimize o script ou aumente timeoutSeconds | Liveness, readiness e probes customizadas para IoT |
| Logs não aparecem no destino | Parser incorreto ou volume não montado | Verifique se o parser 'cri' está configurado e volumes corretos montados no DaemonSet | Logs, tracing e troubleshooting distribuído |
| Jaeger não coleta traces | Aplicação não instrumentada ou endpoint incorreto | Confirme a configuração do agente Jaeger e a instrumentação da aplicação | Logs, tracing e troubleshooting distribuído |
| Traces incompletos | Nem todos os serviços estão instrumentados | Instrumente todos os microserviços do fluxo | Logs, tracing e troubleshooting distribuído |
| Latência alta no Jaeger UI | Backend de armazenamento lento | Ajuste recursos do Jaeger ou use backend mais performático | Logs, tracing e troubleshooting distribuído |
| Pods ficam em CrashLoopBackOff após update | Nova imagem com erro de configuração ou dependência ausente | Revise logs com 'kubectl logs', corrija a imagem e faça rollback se necessário | Manutenção preditiva e atualização sem downtime |
| Rollout fica travado em 'progressing' | Readiness probe não está passando nos novos pods | Ajuste a configuração da probe e reimplante | Manutenção preditiva e atualização sem downtime |
| Serviço apresenta alta latência após update | Nova versão consome mais recursos ou introduz bug | Monitore métricas, escale recursos ou faça rollback | Manutenção preditiva e atualização sem downtime |
| Endpoint aparece como DOWN no Prometheus | IP ou porta incorretos, firewall bloqueando ou serviço não exposto | Revise IP, porta e regras de firewall; teste conexão manualmente | Mapeando sensores, serviços e pontos de coleta |
| Dados não atualizam na frequência esperada | scrape_interval muito alto ou problemas de rede | Ajuste o scrape_interval e verifique latência da rede | Mapeando sensores, serviços e pontos de coleta |
| Métricas ausentes ou incompletas | Exporters mal configurados ou endpoints errados | Revise configuração dos exporters e paths no prometheus.yml | Mapeando sensores, serviços e pontos de coleta |
| Pods não escalam mesmo com alta carga | HPA mal configurado ou métricas não disponíveis | Verifique logs do HPA e se o Metrics Server está rodando | Mobilidade urbana: orquestração de serviços críticos |
| Alertas não são disparados | Regras de alerta ausentes ou Alertmanager não configurado | Revise as regras e integração do Alertmanager | Mobilidade urbana: orquestração de serviços críticos |
| Pods caem após alguns minutos | Readiness/liveness probes configuradas incorretamente | Ajuste os parâmetros das probes conforme a documentação | Mobilidade urbana: orquestração de serviços críticos |
| Atributos não aparecem na consulta | JSON enviado com erro de sintaxe ou atributo fora do padrão NGSI | Valide o JSON e revise os nomes e tipos dos atributos segundo a documentação FIWARE | Modelando entidades urbanas: sensores, veículos, infraestrut |
| Relacionamento não é reconhecido | Tipo do atributo não definido como 'Relationship' | Corrija o tipo para 'Relationship' no JSON | Modelando entidades urbanas: sensores, veículos, infraestrut |
| Entidade não é criada | ID duplicado ou endpoint do Orion errado | Verifique se o ID é único e o Orion está acessível | Modelando entidades urbanas: sensores, veículos, infraestrut |
| Alertas de falha sem motivo aparente | Intervalo de heartbeat muito curto ou rede instável | Ajuste o intervalo de heartbeat e verifique a qualidade da rede | Monitoramento de sensores e conectividade urbana |
| Sensores não aparecem nos relatórios | Erro de cadastro ou configuração de monitoramento | Revise a lista de sensores e os parâmetros de monitoramento | Monitoramento de sensores e conectividade urbana |
| Falha ao criar subscription no Orion | Sintaxe incorreta ou endpoint de notificação inválido | Valide o JSON e o endpoint informado | Monitoramento de sensores e conectividade urbana |
| Métricas não aparecem no endpoint /metrics | ORION_METRICS não habilitado ou porta bloqueada | Reinicie o Orion com ORION_METRICS=true e verifique firewall | Monitorando o Orion Context Broker e agentes IoT |
| Prometheus não coleta métricas do Orion | Configuração incorreta do target ou hostname não resolvido | Ajuste o endereço em prometheus.yml e reinicie Prometheus | Monitorando o Orion Context Broker e agentes IoT |
| Logs não aparecem | Container não está configurado para saída padrão ou log driver incorreto | Verifique configuração do container e do orquestrador | Monitorando o Orion Context Broker e agentes IoT |
| Alertas não são enviados | Alertmanager não configurado ou regras ausentes | Configure Alertmanager e defina regras para métricas críticas | Monitorando o Orion Context Broker e agentes IoT |
| Métricas não aparecem no Grafana | Exporter não está rodando ou endpoint /metrics inacessível | Verifique logs do exporter e conectividade de rede | Monitorando tráfego e mobilidade urbana em tempo real |
| Alertas não são disparados mesmo com tráfego alto | Regras de alerta mal configuradas ou limites inadequados | Revise a configuração das regras em alerts.yml e ajuste os limites | Monitorando tráfego e mobilidade urbana em tempo real |
| Dados de sensores atrasados ou inconsistentes | Intervalo de coleta muito longo ou falha no sensor | Reduza o scrape_interval e cheque a integridade dos sensores | Monitorando tráfego e mobilidade urbana em tempo real |
| Deployment federado não aparece em um cluster membro | Cluster não foi adicionado corretamente à federation ou permissões insuficientes | Rever configuração do kubeconfig e permissões RBAC; reexecutar 'kubefedctl join' | Multi-cluster e federated Kubernetes para cidades inteligent |
| Delay excessivo na replicação de objetos | Problemas de conectividade ou sobrecarga do controlador federation | Verificar logs do KubeFed, checar latência de rede e recursos do cluster host | Multi-cluster e federated Kubernetes para cidades inteligent |
| Falha ao federar Secrets | Secrets não são suportados nativamente por federation sem configuração extra | Consulte a documentação sobre federation de Secrets e considere usar ferramentas externas | Multi-cluster e federated Kubernetes para cidades inteligent |
| Ingress não roteia para o serviço | Service ou backend não está acessível, ou erro no path/host do Ingress | Verifique se o Service existe, está com os labels corretos e se o Ingress Controller está rodando | Networking para IoT: serviços, ingress e roteamento |
| Serviço NodePort não responde externamente | Firewall bloqueando a porta ou serviço não exposto em todos os nós | Libere a porta no firewall e confira se o NodePort está correto | Networking para IoT: serviços, ingress e roteamento |
| TLS não funciona no Ingress | Certificado inválido ou configuração ausente | Reveja o secret de TLS e a configuração do Ingress | Networking para IoT: serviços, ingress e roteamento |
| API REST não responde | Ingress ou Service mal configurado | Revise as regras de Ingress e o selector do Service | NGSI brokers e APIs REST: interoperabilidade entre domínios |
| Erro 404 ao acessar rota de versão | Versionamento de API não implementado corretamente | Verifique as rotas e headers aceitos pelo broker | NGSI brokers e APIs REST: interoperabilidade entre domínios |
| Dados inconsistentes entre domínios | Falta de versionamento ou incompatibilidade de formato | Implemente testes automatizados e negocie formatos via headers | NGSI brokers e APIs REST: interoperabilidade entre domínios |
| Atributos aparecem como desconhecidos na aplicação | Contexto JSON-LD não foi carregado corretamente | Revise o campo @context e o acesso ao arquivo de contexto | NGSI-LD e semântica: interoperabilidade além do básico |
| Dados não interoperam entre sistemas | URIs de contexto divergentes ou não padronizadas | Padronize os contextos e revise as ontologias utilizadas | NGSI-LD e semântica: interoperabilidade além do básico |
| Erro 400 ao publicar entidade | Formato JSON-LD inválido ou campo obrigatório ausente | Valide o JSON-LD e consulte a documentação oficial | NGSI-LD e semântica: interoperabilidade além do básico |
| Pods ficam em estado Pending mesmo após escalar HPA | Não há nodes disponíveis ou recursos suficientes no node pool. | Aumente o número de nodes ou ajuste requests/limits dos pods. | Node pools e escalonamento horizontal: quando e como aplicar |
| Cluster Autoscaler não adiciona nodes | Permissões insuficientes ou limites/quota atingidos no provedor. | Revise permissões e quotas no ambiente de infraestrutura. | Node pools e escalonamento horizontal: quando e como aplicar |
| Pods críticos caem em nodes errados | nodeSelector ou affinity mal configurados. | Revise as labels dos nodes e a configuração dos deployments. | Node pools e escalonamento horizontal: quando e como aplicar |
| Eventos anômalos não disparam resposta automática | Script de IA não está configurado corretamente no Wazuh ou política OPA não está sendo aplicada. | Revise o ossec.conf e o arquivo de política OPA. | O futuro: IA, automação avançada e o papel do open source na |
| Dados pessoais acessíveis por usuários não autorizados | Política de privacidade OPA ausente ou mal configurada. | Ajuste a política privacy.rego para restringir acesso. | O futuro: IA, automação avançada e o papel do open source na |
| Logs não aparecem em formato aberto | Configuração de exportação de logs incompatível. | Ajuste para JSON ou YAML conforme a documentação. | O futuro: IA, automação avançada e o papel do open source na |
| Não encontra métricas de um sensor no Prometheus | Sensor não está exportando no endpoint esperado ou firewall bloqueando | Verifique o endpoint e regras de firewall | O que é Prometheus, Grafana e por que são padrão aberto |
| Dashboard do Grafana não exibe dados | Fonte de dados não configurada corretamente | Revise a configuração da fonte de dados no Grafana | O que é Prometheus, Grafana e por que são padrão aberto |
| Erro de permissão ao modificar dashboard | Usuário sem permissão adequada | Ajuste as permissões de usuário no Grafana | O que é Prometheus, Grafana e por que são padrão aberto |
| OPA retorna erro 400 ao avaliar política | Formato do input inválido | Valide o JSON enviado e a estrutura esperada pela política | OPA e OAuth2: implementação prática de políticas dinâmicas e |
| Política não é recarregada após alteração | OPA não está rodando com --watch ou política não foi atualizada via API | Reinicie o OPA ou use o endpoint de atualização | OPA e OAuth2: implementação prática de políticas dinâmicas e |
| Tokens OAuth2 são rejeitados mesmo válidos | Assinatura do JWT não foi validada antes de chegar ao OPA | Implemente validação do JWT na API antes de enviar ao OPA | OPA e OAuth2: implementação prática de políticas dinâmicas e |
| OPA não carrega o bundle novo | Campo 'revision' ausente ou formato do bundle inválido | Revise o .manifest e gere o bundle novamente | OPA na prática: versionamento, rollback e auditoria de polít |
| Rollback não reverteu decisão | Bundle antigo não foi publicado corretamente | Confirme publicação e reinicie o OPA | OPA na prática: versionamento, rollback e auditoria de polít |
| Logs de decisão não aparecem no coletor | Configuração de 'decision_logs' incorreta | Cheque URL e credenciais do serviço de logs | OPA na prática: versionamento, rollback e auditoria de polít |
| Backup restaurado não tem efeito | Arquivos restaurados no diretório errado | Verifique caminho e permissões | OPA na prática: versionamento, rollback e auditoria de polít |
| Operador não reage a eventos do CRD | Permissões RBAC insuficientes ou erro no controlador | Revise regras RBAC e logs do operador | Operadores Kubernetes: automação além do básico |
| Pods não reiniciam após falha | LabelSelector incorreto ou erro de permissão | Confirme labels e permissões de ServiceAccount | Operadores Kubernetes: automação além do básico |
| Operador crashlooping | Erro de código ou dependências ausentes | Verifique logs detalhados e dependências na imagem | Operadores Kubernetes: automação além do básico |
| Não recebe notificações | Endpoint de notificação inacessível ou mal configurado | Verifique o URL e se o serviço está ouvindo na porta correta | Orion Context Broker: o cérebro do contexto urbano |
| Erro 400 ao criar entidade | Payload JSON malformado | Valide o JSON e os tipos de atributos | Orion Context Broker: o cérebro do contexto urbano |
| Atualização não aparece | Entidade ou atributo não existem | Confirme o ID da entidade e o nome do atributo | Orion Context Broker: o cérebro do contexto urbano |
| Pods não atualizam após mudança no ConfigMap | O nome do ConfigMap não mudou; pods só recarregam se o nome referenciado mudar. | Crie um novo ConfigMap com nome versionado e atualize o Deployment. | Padronização de manifests e versionamento de configuração |
| Configuração antiga ainda em uso após update | Deployment não foi atualizado para apontar para o novo ConfigMap/Secret. | Edite o Deployment para referenciar a versão correta e aplique novamente. | Padronização de manifests e versionamento de configuração |
| Configuração sensível exposta no repositório | Secrets foram versionados em texto puro. | Use ferramentas de criptografia como Sealed Secrets ou SOPS antes de commitar. | Padronização de manifests e versionamento de configuração |
| Erro de validação no schema | Atributo ausente, nome incorreto ou tipo incompatível | Revise a documentação do modelo e ajuste o payload | Padronização de modelos de dados: por que seguir o FIWARE Da |
| Dados não reconhecidos por aplicativos FIWARE | Uso de atributos não padronizados ou alteração de nomes padrão | Mantenha os nomes e tipos originais do modelo | Padronização de modelos de dados: por que seguir o FIWARE Da |
| Quebra de integração após atualização do modelo | Mudança de versão sem ajuste do payload | Sempre referencie e teste com a versão correta do modelo | Padronização de modelos de dados: por que seguir o FIWARE Da |
| Dados não aparecem no Context Broker | Erro no mapeamento de atributos ou falha de autenticação | Revise o arquivo devices.json e as credenciais de acesso | Parâmetros essenciais do IoT Agent para integração com senso |
| Valores distorcidos nos atributos | Transformação de dados incorreta ou unidade incompatível | Ajuste a expressão de transformação e valide o payload de entrada | Parâmetros essenciais do IoT Agent para integração com senso |
| IoT Agent não recebe dados do sensor | Problema de rede ou protocolo incompatível | Verifique conectividade e compatibilidade do protocolo | Parâmetros essenciais do IoT Agent para integração com senso |
| OPA sempre responde 'allow: false' | Input enviado não corresponde ao esperado pela política | Revise o formato do input e ajuste a política Rego | Planejamento de políticas: do OPA ao controle de acesso gran |
| Tokens OAuth2 não são reconhecidos | Token malformado ou chave pública ausente | Valide o token antes de enviar ao OPA e confira a configuração do IdP | Planejamento de políticas: do OPA ao controle de acesso gran |
| Mudanças de política não têm efeito | OPA não foi recarregado ou política não foi versionada corretamente | Recarregue o OPA e valide o versionamento no repositório | Planejamento de políticas: do OPA ao controle de acesso gran |
| Latência alta em horários de pico | Saturação do link ou roteador subdimensionado | Reforce a capacidade do backbone ou otimize o roteamento | Planejando a rede: conectividade, latência e redundância |
| Alertas falsos de indisponibilidade | Configuração incorreta de triggers ou intervalos muito curtos | Ajuste os parâmetros de monitoramento para evitar falsos positivos | Planejando a rede: conectividade, latência e redundância |
| Falha de failover não ocorre | Rotas de backup não configuradas corretamente | Revise as métricas das rotas e teste o failover manualmente | Planejando a rede: conectividade, latência e redundância |
| Dados não aparecem na API | Falha na publicação ou na configuração do Context Broker | Revise o endpoint e os logs do Orion Context Broker | Por que cidades inteligentes precisam de conectividade e dad |
| Sensores não enviam dados | Problemas de conectividade de rede | Teste a conexão física e lógica dos sensores | Por que cidades inteligentes precisam de conectividade e dad |
| Dados sensíveis expostos | Falta de anonimização ou erro de configuração | Implemente filtros e revise as políticas de publicação | Por que cidades inteligentes precisam de conectividade e dad |
| Métrica não aparece no Prometheus | Endpoint /metrics não está exposto ou Prometheus não está configurado para coletar desse alvo | Verifique a configuração do scrape no prometheus.yml e se o serviço está acessível | Por que métricas são diferentes de logs e traces |
| Logs não aparecem na análise | Logs não estão sendo enviados para a ferramenta de análise | Confirme o caminho e formato dos logs e a integração com a ferramenta escolhida | Por que métricas são diferentes de logs e traces |
| Traces incompletos | Instrumentação parcial dos serviços | Garanta que todos os serviços estejam instrumentados para tracing | Por que métricas são diferentes de logs e traces |
| Buracos em séries temporais | Scraping falhou por timeout ou endpoint instável | Aumente timeout ou corrija o exportador | Por que métricas somem: debug de scraping e storage |
| Sem métricas novas de um host | Target está DOWN | Verifique rede e serviço do exportador | Por que métricas somem: debug de scraping e storage |
| Métricas antigas sumiram | Retenção ou disco insuficiente | Ajuste a flag de retenção e amplie o storage | Por que métricas somem: debug de scraping e storage |
| Logs mostram 'write failed' | Disco cheio | Libere espaço ou aumente o volume de dados | Por que métricas somem: debug de scraping e storage |
| Erros HTTP 500 no endpoint | Exportador com falha interna | Reinicie ou atualize o exportador | Por que métricas somem: debug de scraping e storage |
| Erro de integração com SIEM externo | Configuração incorreta do endereço ou porta Syslog | Revise o bloco <syslog_output> no ossec.conf e reinicie o serviço | Por que open source? Garantias técnicas e limitações de ferr |
| Alertas não aparecem no dashboard | Problema de permissão ou falha no agente | Verifique logs em /var/ossec/logs/ossec.log e permissões do agente | Por que open source? Garantias técnicas e limitações de ferr |
| Política OPA não bloqueia acesso indevido | Erro de sintaxe ou lógica em Rego | Valide a política com 'opa eval' e revise a documentação | Por que open source? Garantias técnicas e limitações de ferr |
| Dispositivos não reaparecem após falha de energia | Falta de automação no processo de reconexão | Implemente health checks e auto-healing via orquestração | Por que orquestrar IoT em cidades: desafios e oportunidades |
| Atualizações de firmware causam downtime prolongado | Processo manual e sem rollback | Use atualização rolling com orquestração e readiness probes | Por que orquestrar IoT em cidades: desafios e oportunidades |
| Logs dispersos e difíceis de auditar | Integrações manuais e falta de centralização | Centralize logs e eventos via ferramentas nativas do orquestrador | Por que orquestrar IoT em cidades: desafios e oportunidades |
| Dados pessoais aparecem em APIs públicas | Falta de minimização ou anonimização insuficiente | Revise o modelo de dados e aplique anonimização adequada | Privacidade e anonimização de dados urbanos |
| Logs não estão sendo gerados | Configuração incorreta do Orion Context Broker | Verifique variáveis LOGLEVEL e LOGFILE | Privacidade e anonimização de dados urbanos |
| Alertas de acesso não disparam | Monitoramento mal configurado | Revise regras de auditoria e integração com SIEM | Privacidade e anonimização de dados urbanos |
| Eventos do auditd não aparecem no Wazuh | Módulo de auditoria não habilitado no agente Wazuh | Habilite o módulo 'audit' em /var/ossec/etc/ossec.conf e reinicie o agente | Projeto de monitoramento: eventos críticos, compliance e det |
| Alertas em excesso (falsos positivos) | Regras muito amplas ou baseline mal definido | Ajuste as regras e refine o baseline de comportamento | Projeto de monitoramento: eventos críticos, compliance e det |
| Logs de auditoria sumindo após reboot | auditd não configurado para persistência | Configure auditd para salvar logs em disco e garantir rotação adequada | Projeto de monitoramento: eventos críticos, compliance e det |
| Logs dos dispositivos não aparecem no Wazuh | Configuração incorreta do syslog ou firewall bloqueando porta 514 | Revise /etc/rsyslog.conf e regras de firewall; teste conectividade com 'nc -vz wazuh-server 514' | Projeto real: implantação de Wazuh e OPA em rede de fibra de |
| Decisões OPA lentas | OPA sem cache local ou políticas muito complexas | Implemente bundles locais e otimize as regras Rego | Projeto real: implantação de Wazuh e OPA em rede de fibra de |
| Alertas do Wazuh não acionam políticas OPA | Webhook mal configurado ou endpoint OPA indisponível | Verifique logs do Wazuh e status do OPA com 'curl http://localhost:8181/health' | Projeto real: implantação de Wazuh e OPA em rede de fibra de |
| Dashboards do Grafana não mostram métricas IoT | ServiceMonitor ausente ou endpoint /metrics inacessível | Verifique labels do Service e conectividade do endpoint | Prometheus e Grafana: monitoramento de IoT em Kubernetes |
| Alertas não disparam mesmo com falha simulada | PrometheusRule mal configurada ou não aplicada | Revise sintaxe e namespace do recurso PrometheusRule | Prometheus e Grafana: monitoramento de IoT em Kubernetes |
| Não consigo acessar o Grafana via port-forward | Nome do serviço incorreto ou pod não pronto | Confirme nome do serviço com 'kubectl get svc -n monitoring' e status dos pods | Prometheus e Grafana: monitoramento de IoT em Kubernetes |
| Painel não mostra dados em tempo real | Fonte de dados streaming não configurada corretamente | Revise a configuração do painel e da fonte de dados | Prometheus e Grafana: recursos avançados e roadmap |
| Alertas não disparam | Expressão de alerta ou regra mal definida | Revise a sintaxe e teste a expressão no Prometheus | Prometheus e Grafana: recursos avançados e roadmap |
| Recording rules não aparecem | Arquivo de rules não incluído no prometheus.yml | Adicione o caminho correto em 'rule_files' e reinicie o Prometheus | Prometheus e Grafana: recursos avançados e roadmap |
| Target aparece como DOWN | Endereço incorreto ou porta fechada | Verifique IP, porta e firewall do sensor | Prometheus.yml: targets, jobs e relabeling na prática |
| Prometheus não inicia após alteração | Erro de sintaxe ou indentação no YAML | Rode 'promtool check config' e corrija os erros apontados | Prometheus.yml: targets, jobs e relabeling na prática |
| Sensores de teste aparecem nos dashboards | Relabeling para filtragem não está configurado corretamente | Revise as regras de relabel_configs e teste com regex apropriada | Prometheus.yml: targets, jobs e relabeling na prática |
| Acesso negado ao Prometheus mesmo de IP autorizado | Regra de firewall incorreta ou ordem das regras errada | Revise as regras do firewall e a ordem de aplicação | Protegendo endpoints e dados sensíveis |
| Certificado TLS inválido ou erro de conexão segura | Certificado expirado ou mal configurado no proxy | Renove o certificado e corrija o caminho nos arquivos de configuração | Protegendo endpoints e dados sensíveis |
| Exporter não responde localmente | Porta ou interface incorreta no parâmetro --web.listen-address | Ajuste o parâmetro para 127.0.0.1 e a porta correta | Protegendo endpoints e dados sensíveis |
| Prometheus consumindo RAM excessiva | Cardinalidade alta demais | Reduza labels dinâmicos ou divida a carga entre instâncias | Quantos Prometheus, quanto storage e qual intervalo de scrap |
| Storage enchendo rapidamente | Intervalo de scrape muito curto ou retenção longa | Aumente o intervalo de scrape ou reduza a retenção | Quantos Prometheus, quanto storage e qual intervalo de scrap |
| Consultas muito lentas | Volume de séries acima do ideal para uma instância | Implemente federation ou divida por domínios | Quantos Prometheus, quanto storage e qual intervalo de scrap |
| Pods de coleta entram em CrashLoopBackOff | Liveness probe mal configurada ou overload de eventos | Ajuste o intervalo das probes e aumente o número de réplicas via HPA | Redes urbanas de sensores: lições aprendidas em produção |
| Latência alta nas filas de eventos | Poucos pods de processamento ou gargalo no armazenamento | Escale horizontalmente os pods e verifique IOPS do PVC | Redes urbanas de sensores: lições aprendidas em produção |
| Dados de sensores sumindo ou corrompidos | Falha no armazenamento persistente ou payload inválido | Implemente validação de payload e backups regulares dos PVCs | Redes urbanas de sensores: lições aprendidas em produção |
| Não recebe notificações no endpoint | URL do endpoint incorreta ou indisponível | Corrija a URL e teste com curl | Regras automáticas usando subscriptions e notificações NGSI |
| Notificações chegam mas ação não executa | Erro no código do endpoint receptor | Revise logs e trate exceções | Regras automáticas usando subscriptions e notificações NGSI |
| Muitas notificações em sequência | Falta de throttling na subscription | Adicione ou ajuste o parâmetro throttling | Regras automáticas usando subscriptions e notificações NGSI |
| Subscription não dispara | Condição de filtro não corresponde aos dados | Revise o campo condition e os valores enviados | Regras automáticas usando subscriptions e notificações NGSI |
| Novo pod não entra em Running | Falta de recursos no cluster ou erro de configuração na imagem/container | Verifique recursos disponíveis com 'kubectl describe node' e logs do pod com 'kubectl logs NOME_DO_POD' | Resiliência na prática: simulação e resposta a falhas |
| Pods não são realocados após falha de nó | Affinity/anti-affinity ou taints impedindo agendamento | Revise as configurações de tolerations e affinities no deployment | Resiliência na prática: simulação e resposta a falhas |
| Tempo de recuperação maior que o SLO | Probes mal configuradas ou cluster subdimensionado | Ajuste liveness/readiness probes e avalie a capacidade do cluster | Resiliência na prática: simulação e resposta a falhas |
| A resposta automática não executa | Permissões incorretas no script ou erro de sintaxe no ossec.conf | Verifique permissões (chmod +x) e valide o XML do ossec.conf | Respostas automáticas a incidentes: playbooks com Wazuh e OP |
| Ação executada em eventos errados | rules_id mal configurado ou política OPA genérica demais | Revise o rules_id e as condições da política Rego | Respostas automáticas a incidentes: playbooks com Wazuh e OP |
| OPA não responde ao script | OPA não está rodando ou endpoint incorreto | Confirme se o OPA está ativo e o endpoint correto | Respostas automáticas a incidentes: playbooks com Wazuh e OP |
| Tráfego entre pods aparece em texto claro | TLS não está habilitado ou mal configurado | Reveja a configuração de TLS nas aplicações ou sidecars | Segurança de dados em trânsito e repouso para IoT |
| Volumes persistentes não mostram criptografia ativa | Provisionador de storage não suporta ou não está configurado para criptografia | Habilite a opção de criptografia no provisionador ou configure LUKS manualmente | Segurança de dados em trânsito e repouso para IoT |
| Secrets continuam legíveis no etcd após ativar EncryptionConfiguration | kube-apiserver não foi reiniciado corretamente ou flag não foi aplicada | Verifique a configuração do serviço kube-apiserver e reinicie pelo método correto | Segurança de dados em trânsito e repouso para IoT |
| OPA não inicia no container | Permissões do volume de políticas incorretas ou usuário sem acesso | Ajuste permissões do diretório para o UID usado no container | Segurança do OPA e Wazuh: isolamento, permissões e atualizaç |
| Agente Wazuh falha ao iniciar | Usuário 'wazuh' não existe ou falta permissão | Crie o usuário e grupo 'wazuh' e ajuste permissões dos diretórios | Segurança do OPA e Wazuh: isolamento, permissões e atualizaç |
| FIM não gera alertas | Diretórios não incluídos na configuração ou modo realtime ausente | Revise o bloco <syscheck> e adicione realtime="yes" | Segurança do OPA e Wazuh: isolamento, permissões e atualizaç |
| Dados de um bairro não aparecem no Prometheus central | Configuração de federation errada ou firewall bloqueando o acesso ao /federate | Revise o scrape_config do Prometheus central e libere a porta 9090 entre as instâncias | Sharding e federation: Prometheus para cidades inteiras |
| Métricas duplicadas ou inconsistentes | Targets configurados em mais de um shard | Garanta que cada target só está em um scrape_config de uma instância | Sharding e federation: Prometheus para cidades inteiras |
| Queries federadas lentas | Instância central sobrecarregada ou volume de métricas muito alto | Ajuste filtros match[] para federar apenas métricas necessárias | Sharding e federation: Prometheus para cidades inteiras |
| OWASP ZAP não encontra vulnerabilidades conhecidas | Configuração incorreta do alvo ou escaneamento superficial | Revise o escopo e as opções do ZAP; execute escaneamento completo | Testes recorrentes: simulação de ataques e validação contínu |
| OPA retorna falha em teste de política | Erro na lógica da política ou no arquivo de teste | Revise a política Rego e os testes; consulte a documentação | Testes recorrentes: simulação de ataques e validação contínu |
| Wazuh não gera alerta para evento simulado | Regra mal configurada ou agente não reportando | Verifique regras, logs do agente e conectividade | Testes recorrentes: simulação de ataques e validação contínu |
| Logs de auditoria não aparecem no Wazuh | Agente mal configurado ou Auditd não está rodando | Reinicie o Auditd e revise a configuração do agente Wazuh | Threat modeling prático: ameaças reais e controles arquitetu |
| Alertas em excesso (falso positivo) | Regras de auditoria muito amplas | Ajuste as regras para monitorar apenas arquivos críticos | Threat modeling prático: ameaças reais e controles arquitetu |
| Serviço essencial parou após hardening | Desabilitação de serviço necessário | Revise a lista de serviços e reabilite o que for crítico | Threat modeling prático: ameaças reais e controles arquitetu |
| Eventos de auditoria perdidos | Buffer do Auditd pequeno demais para a carga | Aumente o backlog_limit e monitore o uso de RAM | TLS/SSL e Auditd em larga escala: impactos de desempenho e m |
| Latência alta nas APIs TLS | Cipher suite lento ou CPU saturada | Use cipher suites modernos e monitore o uso de CPU | TLS/SSL e Auditd em larga escala: impactos de desempenho e m |
| Logs de auditoria atrasados | Flush síncrono ou disco lento | Ajuste flush para INCREMENTAL_ASYNC e use discos mais rápidos | TLS/SSL e Auditd em larga escala: impactos de desempenho e m |
| Sensores travando ao ativar TLS | Hardware insuficiente para criptografia | Reduza tamanho das chaves ou otimize o software | TLS/SSL e Auditd em larga escala: impactos de desempenho e m |
| O navegador alerta sobre conexão insegura | Certificado expirado, autoassinado ou cadeia incompleta | Renove o certificado e garanta a cadeia completa no servidor | TLS/SSL sem brechas: configuração segura para APIs, dashboar |
| Ferramenta de teste mostra TLS 1.0 ou SSLv3 habilitado | Configuração de protocolo não restrita corretamente | Revise ssl_protocols ou SSLProtocol e reinicie o serviço | TLS/SSL sem brechas: configuração segura para APIs, dashboar |
| API recusa conexões de agentes | Agente não confia na CA do servidor | Adicione o certificado da CA ao trust store do agente | TLS/SSL sem brechas: configuração segura para APIs, dashboar |
| Alertas do Wazuh não aparecem para acessos suspeitos | Logs da aplicação não estão sendo enviados corretamente ao agente | Revise a configuração de log forwarding e o parser do Wazuh | Zero Trust e cidades inteligentes: o que já é possível com o |
| OPA permite requisições indevidas | Política Rego mal definida ou input incompleto | Revise a lógica da política e os dados enviados ao OPA | Zero Trust e cidades inteligentes: o que já é possível com o |
| Dispositivos IoT não aparecem no monitoramento | Limitações do hardware ou ausência de agente | Implemente coleta via gateway ou syslog externo | Zero Trust e cidades inteligentes: o que já é possível com o |
