387 sintomas catalogados
Cada sintoma com causa provável e correção, ligado à lição da trilha ISPs que explica o porquê. Descreva o sintoma para filtrar.
| Sintoma | Causa provável | Correção | Lição |
|---|---|---|---|
| Webhook não dispara | Evento não corresponde ao tipo configurado ou endpoint inacessível | Revise o tipo de objeto e teste o endpoint manualmente | Ajustando webhooks, scripts e notificações |
| E-mail não chega | Configuração SMTP incorreta ou bloqueio no servidor | Verifique netbox/netbox/configuration.py e teste conexão SMTP | Ajustando webhooks, scripts e notificações |
| Script customizado não aparece no admin | Permissões ou caminho do arquivo incorretos | Confirme permissões e localização em netbox/netbox/scripts/ | Ajustando webhooks, scripts e notificações |
| Validação customizada não executa | Plugin não carregado ou erro de implementação | Revise logs do NetBox e consulte a documentação de plugins | Ajustando webhooks, scripts e notificações |
| Relatórios não são gerados | Permissões insuficientes ou erro no caminho de destino | Ajuste permissões e verifique o diretório configurado | Alertas e relatórios automatizados de compliance |
| Alertas não chegam | Configuração incorreta de email ou webhook | Revise parâmetros do módulo mail ou uri | Alertas e relatórios automatizados de compliance |
| Relatórios vazios | Playbook não está coletando dados corretamente | Cheque os registradores (register) e variáveis usadas | Alertas e relatórios automatizados de compliance |
| Exportação para API falha | Problema de autenticação ou endpoint incorreto | Consulte a documentação da API e ajuste headers e URL | Alertas e relatórios automatizados de compliance |
| Alerta dispara o tempo todo | Threshold dinâmico mal calibrado ou janela de média curta | Aumente a janela de análise ou ajuste o multiplicador do desvio padrão | Alertas inteligentes: thresholds dinâmicos e detecção de ano |
| Alertas nunca disparam | Threshold muito alto ou função errada | Reduza o fator de comparação ou revise a sintaxe da regra | Alertas inteligentes: thresholds dinâmicos e detecção de ano |
| Prometheus lento ou travando | Regras muito pesadas ou janelas muito longas | Otimize as queries e reduza o tempo das janelas | Alertas inteligentes: thresholds dinâmicos e detecção de ano |
| Alertas duplicados para o mesmo evento | Falta de agrupamento por labels | Use 'by (interface)' ou labels relevantes para agrupar | Alertas inteligentes: thresholds dinâmicos e detecção de ano |
| Dificuldade para entender a regra | Sintaxe PromQL complexa | Consulte a documentação oficial e simplifique a expressão | Alertas inteligentes: thresholds dinâmicos e detecção de ano |
| O script não é executado após o alerta. | Webhook não está rodando ou endpoint incorreto no Alertmanager. | Verifique se o webhook está ativo e se a URL está correta no alertmanager.yml. | Alertas que acionam scripts: do Prometheus ao shell |
| O script executa repetidamente sem resolver o problema. | Serviço não sobe após reinício ou alerta permanece firing. | Inclua checagens no script e ajuste as condições de firing/resolved nos alertas. | Alertas que acionam scripts: do Prometheus ao shell |
| Permissão negada ao executar o script. | Script sem permissão de execução ou usuário do webhook sem privilégios. | Dê permissão de execução ao script e ajuste o usuário do serviço webhook. | Alertas que acionam scripts: do Prometheus ao shell |
| Sessão BGP sobe e cai frequentemente | Flapping por instabilidade física ou timers incompatíveis | Verifique conectividade física, ajuste timers e monitore logs | Alertas, logs e análise de eventos BGP |
| Logs não aparecem no arquivo configurado | Permissões ou configuração incorreta de logging | Cheque permissões do arquivo e comandos de log no FRR | Alertas, logs e análise de eventos BGP |
| Alertas SNMP não chegam ao NMS | SNMP não habilitado ou firewall bloqueando traps | Confirme configuração SNMP e libere portas no firewall | Alertas, logs e análise de eventos BGP |
| Muitos alertas irrelevantes | Nível de log muito baixo ou filtros ausentes | Ajuste níveis de log e filtros no syslog | Alertas, logs e análise de eventos BGP |
| Alertas não chegam por e-mail | Configuração SMTP incorreta ou bloqueio do servidor | Revise smarthost, credenciais e portas; teste envio manual. | Alertmanager plugado: notificações por e-mail, Slack e webho |
| Slack não recebe notificações | Webhook inválido ou canal incorreto | Verifique a URL do webhook e permissões do canal. | Alertmanager plugado: notificações por e-mail, Slack e webho |
| Webhook não aciona automação | Endpoint offline ou erro de autenticação | Teste o endpoint com curl e revise logs do serviço receptor. | Alertmanager plugado: notificações por e-mail, Slack e webho |
| Sessão BGP em estado Idle ou Active | Erro de configuração de neighbor, AS ou falha física | Verifique IP, AS e conectividade física; ajuste conforme necessário | Analisando falhas em sessões BGP e perda de prefixos |
| Prefixos esperados não aparecem na tabela BGP | Filtro ou prefix-list bloqueando anúncios | Revise e ajuste filtros; teste com um prefix-list mais permissivo | Analisando falhas em sessões BGP e perda de prefixos |
| Sessão cai frequentemente | Timers desajustados ou perda de keepalive | Ajuste timers para valores compatíveis nos dois lados | Analisando falhas em sessões BGP e perda de prefixos |
| Módulo não encontrado ao rodar o playbook | Collection não instalada ou não declarada em collections: | Instale a collection correta e adicione-a ao playbook. | Ansible Collections para redes: o que há de novo e útil |
| Erro de autenticação no equipamento | Credenciais incorretas ou não informadas no inventário | Revise o inventário e as variáveis de conexão. | Ansible Collections para redes: o que há de novo e útil |
| Comando não suportado pelo módulo | Firmware do equipamento desatualizado ou parâmetro incompatível | Consulte a documentação da collection e atualize o firmware se necessário. | Ansible Collections para redes: o que há de novo e útil |
| Prefixos não aparecem em looking glass | Configuração BGP incorreta ou prefixos não registrados no IRR | Revise configuração e cadastre corretamente no IRR | ASN, blocos IP e registro: o que define sua rede na Internet |
| Peers rejeitam sessão BGP | ASN não registrado ou uso de ASN privado | Solicite ASN público e registre no IRR | ASN, blocos IP e registro: o que define sua rede na Internet |
| Blocos IP não roteados na Internet | Blocos não alocados oficialmente ou mal registrados | Solicite blocos ao LACNIC e registre corretamente | ASN, blocos IP e registro: o que define sua rede na Internet |
| Sessão BGP não sobe (Idle) | ASN ou IP do peer incorretos, firewall bloqueando porta TCP 179. | Verifique ASN/IP e libere TCP 179 no firewall. | Ativando BGP e anunciando seu primeiro prefixo |
| Prefixos não aparecem em advertised-routes | Prefixo não existe na tabela de roteamento local. | Adicione rota estática ou garanta que a rota seja aprendida localmente. | Ativando BGP e anunciando seu primeiro prefixo |
| Sessão cai após alguns minutos | Keepalive ou hold timer incompatíveis. | Ajuste timers para valores compatíveis com o peer (consulte a documentação). | Ativando BGP e anunciando seu primeiro prefixo |
| Prefixo IPv6 não é anunciado | Address-family ipv6 não ativada para o peer. | Confirme ativação com 'neighbor <ipv6> activate' em ipv6 unicast. | Ativando BGP e anunciando seu primeiro prefixo |
| Campo customizado não aparece no objeto | Campo não associado ao content type correto | Edite o campo e associe ao modelo desejado | Atributos customizados e extensibilidade |
| Erro ao salvar campo customizado | Tipo de dado incompatível ou valor obrigatório não preenchido | Verifique o tipo e se o campo é required | Atributos customizados e extensibilidade |
| Templates não sugerem interfaces | Template incompleto ou mal importado | Revise o YAML ou os campos do template | Atributos customizados e extensibilidade |
| Tenants não aparecem na lista | Tenant não cadastrado ou filtro incorreto | Cadastre o tenant e revise os filtros de busca | Atributos customizados e extensibilidade |
| Prometheus não inicia após atualização | Mudança de formato do banco TSDB ou flag depreciada | Consulte as notas de versão e ajuste as flags no systemd ou no arquivo de configuração | Atualizações e backup: mantendo o monitoramento confiável |
| Dashboards sumiram no Grafana após restauração | Backup incompleto ou corrupção do banco | Restaure backup anterior e valide integridade do arquivo grafana.db | Atualizações e backup: mantendo o monitoramento confiável |
| Histórico de métricas ausente | Backup do TSDB não foi feito com Prometheus parado | Refaça backup com serviço parado e restaure novamente | Atualizações e backup: mantendo o monitoramento confiável |
| Alterações não aparecem no changelog. | Mudança feita diretamente no banco ou bug no ORM. | Sempre use a interface ou API do NetBox para alterar dados. | Auditoria de alterações e rastreabilidade de ativos |
| Logs antigos sumiram. | Política de rotação ou limpeza automática de logs. | Ajuste a retenção de logs no sistema operacional e no Django. | Auditoria de alterações e rastreabilidade de ativos |
| Usuário não identificado nas alterações. | Mudança feita via API token genérico ou script sem autenticação adequada. | Utilize tokens individuais e autenticação forte. | Auditoria de alterações e rastreabilidade de ativos |
| O status do job 'prometheus' aparece como DOWN | Configuração errada do target ou Prometheus não está escutando na porta correta | Verifique o endereço e porta no scrape_configs, reinicie o serviço | Auto-monitoramento: Prometheus vigiando Prometheus |
| Alertas não são disparados mesmo com falha | Regras de alerta mal configuradas ou Alertmanager indisponível | Revise as regras e o status do Alertmanager | Auto-monitoramento: Prometheus vigiando Prometheus |
| Dashboards do Grafana mostram lacunas nos gráficos | Problemas de coleta ou sobrecarga no Prometheus | Monitore o scrape_duration_seconds e ajuste intervalos de coleta | Auto-monitoramento: Prometheus vigiando Prometheus |
| Dispositivo não responde após reboot | Firmware incompatível ou erro na imagem | Acesse via console físico e restaure o firmware anterior manualmente | Automação de atualização de firmware em massa: estudo de cas |
| Playbook falha no upload do firmware | Permissões insuficientes ou caminho incorreto | Verifique credenciais e caminhos nos parâmetros do módulo net_copy | Automação de atualização de firmware em massa: estudo de cas |
| Versão do firmware não atualiza | Comando de atualização não executou corretamente ou arquivo corrompido | Valide a integridade do arquivo e revise a sintaxe do comando | Automação de atualização de firmware em massa: estudo de cas |
| Playbook não é disparado após alerta | Script receptor ou webhook mal configurado | Revise o caminho do script, permissões e logs do sistema de monitoramento | Automação integrada: disparando ações via Zabbix ou Promethe |
| Playbook executa múltiplas vezes para o mesmo alerta | Falta de controle de concorrência ou lock | Implemente mecanismo de lock ou checagem de estado antes de agir | Automação integrada: disparando ações via Zabbix ou Promethe |
| Playbook executa mas não corrige o problema | Ação corretiva inadequada ou variáveis mal passadas | Revise o playbook, argumentos e valide o estado antes/depois da execução | Automação integrada: disparando ações via Zabbix ou Promethe |
| Script Python não aparece na interface | Arquivo salvo em diretório errado ou permissões inadequadas. | Salve em 'netbox/extras/scripts/' e ajuste permissões. | Automatizando cadastros e atualizações com scripts e API |
| Erro 400 ao cadastrar via API | IDs de device_type, device_role ou site inexistentes. | Consulte a API para obter os IDs corretos antes do POST. | Automatizando cadastros e atualizações com scripts e API |
| Webhook não dispara | Endpoint inacessível ou configuração de evento incorreta. | Verifique URL, método e eventos configurados. | Automatizando cadastros e atualizações com scripts e API |
| Task do Ansible falha com 'module not found' | Coleção 'netbox.netbox' não instalada. | Instale com 'ansible-galaxy collection install netbox.netbox'. | Automatizando cadastros e atualizações com scripts e API |
| Sessão BGP não sobe após playbook | Erro de configuração de ASN ou IP do vizinho | Revise variáveis e comandos do playbook. | Automatizando configuração e provisionamento BGP com Ansible |
| Comando vtysh não encontrado | FRRouting não instalado ou PATH incorreto | Verifique instalação e caminhos do FRRouting. | Automatizando configuração e provisionamento BGP com Ansible |
| Erro de permissão ao rodar playbook | Usuário sem sudo ou become configurado | Ajuste permissões ou configure become no playbook. | Automatizando configuração e provisionamento BGP com Ansible |
| Backup falha com erro de permissão | Usuário postgres sem permissão de escrita no diretório de destino | Ajuste permissões do diretório ou execute como root/sudo | Backup, criptografia e restauração de dados |
| Restauração retorna erro de versão do dump | Versão do pg_restore diferente da usada no pg_dump | Use sempre a mesma versão de PostgreSQL para backup e restauração | Backup, criptografia e restauração de dados |
| NetBox não inicia após restauração | Banco restaurado incompleto ou com dados corrompidos | Verifique logs, refaça o backup/restauração e valide integridade | Backup, criptografia e restauração de dados |
| Regra FlowSpec não é aplicada | Peer FlowSpec não ativado ou configuração incorreta | Revise 'neighbor ... activate' e a sintaxe das regras | BGP FlowSpec, BMP e recursos avançados no FRRouting |
| BMP não envia dados ao coletor | Firewall bloqueando porta BMP ou IP do coletor incorreto | Verifique conectividade e portas liberadas | BGP FlowSpec, BMP e recursos avançados no FRRouting |
| Sessão BGP cai após ativar FlowSpec | Incompatibilidade de capabilities ou erro de configuração | Confirme suporte FlowSpec nos dois lados e revise logs | BGP FlowSpec, BMP e recursos avançados no FRRouting |
| Clientes sem acesso à internet | Esgotamento de portas no CGNAT ou erro de roteamento | Aumente o pool de IPs públicos ou ajuste o balanceamento de sessões | CGNAT e BGP: integração e desafios de escala |
| Prefixos privados anunciados no BGP | Falta de filtro adequado | Revise prefix-lists e route-maps | CGNAT e BGP: integração e desafios de escala |
| Sessões NAT quebrando | Roteamento assimétrico | Implemente PBR ou ajuste o roteamento para garantir simetria | CGNAT e BGP: integração e desafios de escala |
| Logs de NAT ausentes | Configuração de logging incompleta | Habilite e teste o logging detalhado no CGNAT | CGNAT e BGP: integração e desafios de escala |
| Rotas IPv6 não aparecem na tabela BGP | Address-family IPv6 não ativada ou sessão BGPv6 inativa | Confirme configuração do neighbor IPv6 e estado da sessão | Coexistência com OSPF, IS-IS e ativação de IPv6 |
| Loops de roteamento internos | Redistribuição sem filtros entre OSPF/BGP | Implemente route-maps para limitar redistribuição | Coexistência com OSPF, IS-IS e ativação de IPv6 |
| Prefixos internos anunciados para a Internet | Falta de prefix-list ou filtro em redistribuição | Aplique prefix-list adequada na saída BGP | Coexistência com OSPF, IS-IS e ativação de IPv6 |
| Playbook não conecta ao equipamento | Credenciais ou permissões SSH incorretas | Revise usuário, senha e permissões no inventário | Coleta de métricas: playbooks para health check e inventário |
| Métricas não aparecem no Prometheus | Arquivo não está no caminho lido pelo node_exporter | Ajuste o destino do arquivo e reinicie o node_exporter | Coleta de métricas: playbooks para health check e inventário |
| Logs coletados estão vazios | Filtro do comando muito restritivo | Revise o comando e amplie o filtro para capturar eventos relevantes | Coleta de métricas: playbooks para health check e inventário |
| Erro 'Permission denied' ao rodar playbook | Chave SSH ausente ou permissão incorreta | Reinstale a chave SSH com 'ssh-copy-id' e ajuste permissões do ~/.ssh | Componentes de uma arquitetura Ansible em ISPs: do controlad |
| Inventário não reflete novos dispositivos | Inventário estático desatualizado | Migre para inventário dinâmico ou atualize manualmente | Componentes de uma arquitetura Ansible em ISPs: do controlad |
| Falha ao descriptografar variáveis | Senha do Vault incorreta | Confirme a senha e tente novamente | Componentes de uma arquitetura Ansible em ISPs: do controlad |
| Timeout ao conectar a dispositivos | Firewall bloqueando porta SSH | Libere a porta 22 entre controlador e dispositivos | Componentes de uma arquitetura Ansible em ISPs: do controlad |
| API REST retorna 500 Internal Server Error | Falha na comunicação com o banco de dados | Verifique logs do NetBox e status do PostgreSQL | Componentes internos: Django, PostgreSQL e a API REST |
| Admin do Django não carrega | Problema de autenticação ou migração pendente | Cheque usuários e rode 'python3 manage.py migrate' | Componentes internos: Django, PostgreSQL e a API REST |
| curl na API retorna 403 Forbidden | Token inválido ou permissões insuficientes | Revise permissões do token no Django admin | Componentes internos: Django, PostgreSQL e a API REST |
| Backup do PostgreSQL falha | Usuário sem permissão ou banco offline | Confirme permissões e status do serviço PostgreSQL | Componentes internos: Django, PostgreSQL e a API REST |
| Sessão BGP não sobe | Firewall bloqueando porta TCP 179 ou configuração de IP/ASN incorreta | Verifique conectividade, portas e ASN nos dois lados | Configurando múltiplos peers, filtros e políticas de roteame |
| Rotas inválidas sendo recebidas | Prefix-list ou route-map ausente ou mal aplicado | Revise aplicação dos filtros no neighbor correto | Configurando múltiplos peers, filtros e políticas de roteame |
| Peer recebe rotas demais | Prefix-list de saída não está restritiva | Ajuste prefix-list de saída para anunciar só seus blocos | Configurando múltiplos peers, filtros e políticas de roteame |
| 401 Unauthorized nas requisições | Token inválido, expirado ou ausente | Gere novo token e revise o header Authorization | Consumindo e alimentando a API REST do NetBox |
| 400 Bad Request ao criar objeto | Campos obrigatórios ausentes ou valores inválidos | Consulte a documentação do endpoint e ajuste o JSON | Consumindo e alimentando a API REST do NetBox |
| 404 Not Found em endpoints conhecidos | URL incorreta ou endpoint não disponível na versão instalada | Verifique a versão do NetBox e a URL usada | Consumindo e alimentando a API REST do NetBox |
| Sessões BGP caindo frequentemente | Sobrecarga de CPU/RAM ou timers mal configurados | Ajuste timers, revise peer-groups, aumente recursos | Crescendo o número de peers, sessões e prefixos sem perder e |
| Prefixos não propagam após upgrade | Graceful Restart não suportado pelo peer ou erro de configuração | Confirme suporte do peer e revise configuração | Crescendo o número de peers, sessões e prefixos sem perder e |
| Alto uso de CPU em bgpd | Excesso de prefixos ou políticas complexas | Divida sessões, otimize políticas, considere upgrade de hardware | Crescendo o número de peers, sessões e prefixos sem perder e |
| Alertas continuam disparando após upgrade | Thresholds não foram ajustados para a nova capacidade | Atualize as regras de alerta para refletir a capacidade ampliada | Crescimento de tráfego e upgrade proativo: decisão baseada e |
| Dashboards não mostram tendência clara | Intervalo de dados insuficiente ou query PromQL inadequada | Amplie o período analisado e revise as queries | Crescimento de tráfego e upgrade proativo: decisão baseada e |
| Dados de pico não batem com o tráfego real | Coleta SNMP com intervalo muito longo | Reduza o scrape_interval no Prometheus para maior precisão | Crescimento de tráfego e upgrade proativo: decisão baseada e |
| Painéis não exibem dados após importar template | Datasource Prometheus não selecionado ou queries incompatíveis | Edite cada painel e selecione o datasource correto; ajuste queries conforme suas métricas | Dashboards Grafana: do template ao painel customizado para I |
| Variáveis não listam POPs corretamente | Regex ou label_values mal configurados | Revise a query da variável e teste a expressão regular | Dashboards Grafana: do template ao painel customizado para I |
| Erro ao compartilhar snapshot | Permissões insuficientes ou política de snapshots desabilitada | Peça permissão de admin ou habilite snapshots nas configurações do Grafana | Dashboards Grafana: do template ao painel customizado para I |
| Dashboard em branco | Fonte de dados Prometheus inacessível | Corrija endereço/porta e teste conexão | Dashboards quebrados e alertas mudos: conserto rápido em pro |
| Alertas não chegam | Rotas ou receivers errados no Alertmanager | Ajuste configuração e reinicie serviço | Dashboards quebrados e alertas mudos: conserto rápido em pro |
| Erro de permissão ao restaurar dashboard | Permissões do arquivo grafana.db incorretas | Ajuste permissões com chown grafana:grafana | Dashboards quebrados e alertas mudos: conserto rápido em pro |
| Playbook não mostra diferenças em --diff | Módulo ou recurso não suporta diff | Consulte a documentação do módulo e use módulos compatíveis | Debug eficiente: ansible-playbook --check, --diff e logs det |
| Logs não são salvos em arquivo | log_path não configurado corretamente | Ajuste o caminho em ansible.cfg e garanta permissão de escrita | Debug eficiente: ansible-playbook --check, --diff e logs det |
| Rollback não executa após falha | Condição 'when' mal definida ou variável não existe | Revise a lógica condicional e nomes de variáveis | Debug eficiente: ansible-playbook --check, --diff e logs det |
| Erros de autenticação em módulos de rede | Credenciais incorretas ou SSH bloqueado | Atualize variáveis de autenticação e teste conectividade SSH | Debug eficiente: ansible-playbook --check, --diff e logs det |
| Erro 500 ao acessar página de Prefix | Exceção não tratada no backend | Verificar logs do Django para stack trace e buscar issue correspondente | Debugging avançado: logs, queries e suporte à comunidade |
| Dados inconsistentes após importação | Importação manual malformada | Consultar banco via SQL e corrigir registros | Debugging avançado: logs, queries e suporte à comunidade |
| Operação travada (timeout) | Lock no banco de dados | Verificar locks ativos no PostgreSQL e liberar se necessário | Debugging avançado: logs, queries e suporte à comunidade |
| Métricas SNMP não aparecem no Prometheus | OIDs incorretos ou falha de comunicação SNMP | Verifique a comunidade SNMP, OIDs e conectividade de rede | Definindo o que monitorar: KPIs críticos para ISPs |
| Latência sempre zero ou muito alta | Configuração errada do blackbox_exporter ou firewall bloqueando ICMP | Ajuste o módulo ICMP e libere ICMP nos alvos | Definindo o que monitorar: KPIs críticos para ISPs |
| Alertas em excesso para equipamentos pouco críticos | Priorização de alertas mal definida | Reveja a matriz de criticidade e ajuste as regras de alerta | Definindo o que monitorar: KPIs críticos para ISPs |
| Prefixos não aparecem na tabela BGP | Filtro de importação muito restritivo ou erro em prefix-list | Revise e ajuste a prefix-list e route-map | Definindo políticas de peering, trânsito e filtros |
| Prefixos indesejados sendo anunciados | Falta de filtro de exportação ou erro em route-map | Implemente ou corrija o filtro de exportação | Definindo políticas de peering, trânsito e filtros |
| Sessão BGP cai após aplicar filtros | Erro de sintaxe ou conflito em route-map | Verifique logs e corrija a configuração | Definindo políticas de peering, trânsito e filtros |
| Timeout ao conectar | Porta SSH bloqueada ou dispositivo fora do ar | Liberar porta no firewall ou ligar o dispositivo | Diagnóstico de falhas em conexões SSH e Netmiko |
| Permission denied | Senha ou chave SSH incorreta | Corrigir credenciais e permissões de arquivos | Diagnóstico de falhas em conexões SSH e Netmiko |
| NetmikoTimeoutException | Rede inacessível ou device_type errado | Verificar conectividade e device_type | Diagnóstico de falhas em conexões SSH e Netmiko |
| NetmikoAuthenticationException | Usuário ou senha inválidos | Revisar credenciais no inventário | Diagnóstico de falhas em conexões SSH e Netmiko |
| Prompt not found em Netmiko | device_type incompatível | Ajustar device_type conforme documentação | Diagnóstico de falhas em conexões SSH e Netmiko |
| Sessão BGP cai frequentemente | Falta de recursos (CPU/RAM) ou perda de conectividade física | Aumente recursos ou revise links físicos | Dimensionando hardware e links para BGP em ISPs |
| Alto uso de CPU após receber rotas | Full-table sem hardware suficiente | Reduza rotas recebidas ou aumente a CPU | Dimensionando hardware e links para BGP em ISPs |
| Rotas não aparecem na tabela | Filtros excessivos ou configuração incorreta | Revise prefix-lists e route-maps | Dimensionando hardware e links para BGP em ISPs |
| Consultas lentas no NetBox | shared_buffers ou work_mem insuficientes | Aumente os parâmetros e reinicie o PostgreSQL | Dimensionando PostgreSQL e recursos de hardware |
| Disco cheio rapidamente | Backups armazenados no mesmo disco do banco | Configure destino externo para backups | Dimensionando PostgreSQL e recursos de hardware |
| Erro de conexão ao iniciar réplica | max_wal_senders baixo ou hot_standby desativado | Ajuste os parâmetros no postgresql.conf | Dimensionando PostgreSQL e recursos de hardware |
| Exporters aparecem como 'down' no Prometheus | Firewall bloqueando porta, exporter travado ou endereço incorreto | Verifique firewall, reinicie o exporter e corrija o endereço no prometheus.yml | Distribuição de exporters e balanceamento de carga |
| scrape_duration_seconds muito alto | Exporter sobrecarregado ou rede lenta | Aumente recursos do host, distribua targets ou otimize a rede | Distribuição de exporters e balanceamento de carga |
| Dados duplicados no Grafana | Redundância mal configurada, labels iguais para instâncias diferentes | Adicione labels únicos para cada exporter ou replica | Distribuição de exporters e balanceamento de carga |
| Prometheus consumindo muita CPU | Targets demais em uma única instância | Divida os targets entre mais instâncias Prometheus | Distribuição de exporters e balanceamento de carga |
| Prefixo filtrado por parceiros | Registro no IRR desatualizado ou ausente | Atualize o objeto route no IRR imediatamente | Documentação viva: como manter registros e conformidade |
| Mudança de configuração sem registro | Falta de versionamento ou controle de acesso | Implemente git e restrinja permissões de alteração | Documentação viva: como manter registros e conformidade |
| Divergência entre IRR e configuração | Processo de revisão falho ou inexistente | Estabeleça auditorias periódicas e checklist de revisão | Documentação viva: como manter registros e conformidade |
| Perda de histórico após incidente | Backups automatizados ausentes | Configure Oxidized ou RANCID para backups diários | Documentação viva: como manter registros e conformidade |
| Usuário não consegue logar após migração de autenticação | Configuração LDAP incorreta ou serviço não reiniciado | Revisar configuration.py e reiniciar o serviço NetBox | Erros frequentes na operação e como resolver |
| Usuário loga mas não vê dispositivos | Permissões insuficientes no grupo | Ajustar permissões via Django Admin ou shell | Erros frequentes na operação e como resolver |
| Importação CSV falha com erro de campo obrigatório | Arquivo sem cabeçalho ou campo obrigatório ausente | Adicionar campos obrigatórios ao arquivo CSV | Erros frequentes na operação e como resolver |
| Métricas SNMP ausentes ou com gaps | Timeout de scraping ou excesso de targets por exporter | Reduza o número de targets por exporter ou aumente o intervalo de scraping | Exporters SNMP: limites, escalabilidade e boas escolhas |
| CPU do exporter alta | Consultas SNMP lentas ou muitos OIDs por target | Otimize os módulos SNMP para coletar apenas OIDs necessários | Exporters SNMP: limites, escalabilidade e boas escolhas |
| Exporter não responde em determinada porta | Porta bloqueada por firewall ou processo não iniciado | Verifique firewall e status do processo snmp_exporter | Exporters SNMP: limites, escalabilidade e boas escolhas |
| Alertas de erro mas tráfego normal | Erro falso positivo ou counter não resetado | Zere counters se possível ou ajuste thresholds. | Falha de backbone detectada por métricas: um estudo de caso |
| Counters de erro não sobem, mas ifOperStatus flappa | Problema físico intermitente | Inspecione conectores, SFPs e cabos. | Falha de backbone detectada por métricas: um estudo de caso |
| Dashboards não mostram counters esperados | Configuração SNMP ou Prometheus incompleta | Revise snmp_exporter.yml e targets. | Falha de backbone detectada por métricas: um estudo de caso |
| Métricas não aparecem no Prometheus pai | Erro na configuração do scrape_config ou bloqueio de rede | Revise o prometheus.yml e teste conectividade HTTP entre pai e filhas | Federando Prometheus: monitorando milhares de alvos sem dor |
| Uso de memória alto no Prometheus pai | Federation de muitas séries sem filtro | Ajuste o parâmetro 'match[]' para federar apenas métricas essenciais | Federando Prometheus: monitorando milhares de alvos sem dor |
| Latência alta nas métricas federadas | Intervalos de scrape longos ou sobrecarga nas filhas | Reduza scrape_interval ou otimize as instâncias filhas | Federando Prometheus: monitorando milhares de alvos sem dor |
| Métricas SNMP não aparecem no Prometheus | SNMP Exporter não consegue consultar o equipamento (firewall, comunidade errada, ACL restritiva) | Verifique SNMP com snmpwalk manualmente e ajuste permissões e comunidade | Fluxo de dados: da coleta SNMP ao alerta no Grafana |
| Alertas não chegam no Alertmanager | Configuração de alerting ou rules incorreta no Prometheus | Cheque logs do Prometheus e sintaxe dos arquivos de rules | Fluxo de dados: da coleta SNMP ao alerta no Grafana |
| Dashboards do Grafana sem dados | Query PromQL errada ou fonte de dados Prometheus não conectada | Teste queries no Prometheus e reconfigure a fonte no Grafana | Fluxo de dados: da coleta SNMP ao alerta no Grafana |
| Falha de autenticação SSH | Chave SSH incorreta ou não instalada no equipamento | Verifique se a chave pública está no 'authorized_keys' do usuário alvo. | Fluxos seguros: SSH, Netmiko e segregação de ambientes |
| Playbook afeta hosts errados | Inventário incorreto selecionado | Confirme o arquivo de inventário passado na linha de comando. | Fluxos seguros: SSH, Netmiko e segregação de ambientes |
| Netmiko retorna erro de conexão | Equipamento não suporta SSH ou credenciais erradas | Teste conexão manual com 'ssh usuario@equipamento' e ajuste variáveis do Ansible. | Fluxos seguros: SSH, Netmiko e segregação de ambientes |
| Rotas BGP não aparecem no kernel | bgpd não está comunicando com zebra ou zebra não está rodando | Reinicie zebra e bgpd; verifique logs de erro | FRRouting: arquitetura, processos e integração com o kernel |
| Sessões BGP caindo frequentemente | bgpd instável ou problemas de rede | Verifique logs do bgpd e conectividade IP | FRRouting: arquitetura, processos e integração com o kernel |
| Rotas somem após restart do zebra | Rotas dinâmicas não persistem sem zebra | Garanta alta disponibilidade ou minimize downtime do zebra | FRRouting: arquitetura, processos e integração com o kernel |
| Erro 'Decryption failed' | Senha do Vault incorreta ou arquivo corrompido | Confirme a senha e verifique a integridade do arquivo | Gerenciamento de segredos: Ansible Vault e práticas seguras |
| Playbook não encontra variáveis do Vault | Arquivo Vault não incluído em vars_files | Adicione o arquivo Vault em vars_files do playbook | Gerenciamento de segredos: Ansible Vault e práticas seguras |
| Senha do Vault exposta em logs | Uso de --vault-password-file mal protegido | Restrinja permissões do arquivo de senha (chmod 600) | Gerenciamento de segredos: Ansible Vault e práticas seguras |
| Sessão BGP cai após receber muitas rotas | Limite de maximum-prefix atingido | Aumente o limite ou revise filtros de prefixos | Gerenciando blocos IP e tabelas de rota em grande escala |
| Rotas específicas não aparecem na tabela | Agregação excessiva ou filtro restritivo | Revise comandos aggregate-address e prefix-list | Gerenciando blocos IP e tabelas de rota em grande escala |
| Alto consumo de memória no FRRouting | Excesso de rotas não agregadas | Implemente agregação e revise filtros | Gerenciando blocos IP e tabelas de rota em grande escala |
| Playbook executa em hosts de outros sites | Inventário ou flag --limit configurados incorretamente | Revise o inventário e o parâmetro --limit; garanta que cada grupo está correto | Gerenciando centenas de sites: estratégias de segmentação e |
| Usuário consegue rodar playbook em todos os sites | Permissões de arquivos ou sudoers mal configuradas | Restrinja permissões nos diretórios e revise regras no sudoers usando visudo | Gerenciando centenas de sites: estratégias de segmentação e |
| Configurações globais sobrescrevem customizações locais | Ordem de precedência de variáveis mal planejada | Revise a hierarquia de group_vars e host_vars; ajuste para preservar customizações | Gerenciando centenas de sites: estratégias de segmentação e |
| Busca demora mais de 10 segundos | Filtros insuficientes ou paginação desativada | Aplique filtros mais restritivos e reduza o PAGINATE_COUNT. | Gerenciando múltiplos sites e grandes inventários |
| Interface trava ao exportar ativos | Exportação sem filtros em inventário grande | Exporte por lotes, filtrando por site ou tipo. | Gerenciando múltiplos sites e grandes inventários |
| Campos customizados não aparecem em filtros | Campo não indexado ou mal configurado | Revise a configuração dos custom fields e associe corretamente ao modelo. | Gerenciando múltiplos sites e grandes inventários |
| Rollback não restaura configuração | Backup não foi salvo corretamente | Revise a task de backup e teste antes da mudança | Gestão de mudanças: controle de impacto e rollback seguro |
| Mudança afeta todos os hosts de uma vez | Falta do parâmetro serial | Adicione serial ao playbook | Gestão de mudanças: controle de impacto e rollback seguro |
| Logs ausentes ou incompletos | log_path não configurado ou sem permissão de escrita | Ajuste ansible.cfg e permissões do diretório de logs | Gestão de mudanças: controle de impacto e rollback seguro |
| Consultas ao inventário lentas | Falta de índices ou excesso de dados não particionados | Crie índices adicionais e considere particionamento no PostgreSQL | Governança de ativos em larga escala: o futuro com NetBox |
| Webhooks não disparam | Configuração incorreta ou endpoint externo indisponível | Revise a configuração e monitore logs do NetBox e do destino | Governança de ativos em larga escala: o futuro com NetBox |
| Dados inconsistentes após importação em massa | Falha transacional ou script mal implementado | Implemente rollback e validação pós-importação | Governança de ativos em larga escala: o futuro com NetBox |
| Erro 'Datasource is not working' ao adicionar Prometheus | URL incorreta ou Prometheus não está acessível | Verifique se o Prometheus está rodando e se o endpoint está correto | Grafana na prática: instalação e conexão com Prometheus |
| Não consigo acessar o Grafana na porta 3000 | Firewall bloqueando ou serviço não iniciado | Libere a porta 3000 e verifique o status do serviço com systemctl status grafana-server | Grafana na prática: instalação e conexão com Prometheus |
| Dashboard sem dados ou gráficos vazios | Consulta PromQL errada ou Prometheus sem métricas coletadas | Ajuste a consulta e confirme se o Prometheus está coletando métricas | Grafana na prática: instalação e conexão com Prometheus |
| Serviço SSH não reinicia | Nome do serviço incorreto (sshd vs ssh) | Verifique o nome correto com 'systemctl status sshd' ou 'systemctl status ssh'. | Hardening automatizado: firewall, SSH e atualizações crítica |
| Firewall não bloqueia portas extras | Política padrão da zona não está em 'drop' ou 'reject' | Configure a política padrão da zona com 'firewall-cmd --set-default-zone=public' e ajuste para 'drop' se necessário. | Hardening automatizado: firewall, SSH e atualizações crítica |
| Atualizações não aplicam | Cache de pacotes desatualizado | Adicione tarefa para 'update_cache: yes' antes da atualização. | Hardening automatizado: firewall, SSH e atualizações crítica |
| Auditoria SSH falha mesmo com configuração correta | Regex não cobre espaços ou comentários | Ajuste a expressão regular para ignorar comentários e espaços extras. | Hardening automatizado: firewall, SSH e atualizações crítica |
| Erro de certificado inválido ao acessar Prometheus ou Grafana | Certificado autoassinado ou hostname diferente do CN | Use certificado válido e gere com o hostname correto | HTTPS e autenticação: blindando Prometheus, Grafana e export |
| Não solicita autenticação ao acessar Prometheus | Proxy reverso não configurado ou .htpasswd ausente | Revise configuração do Nginx e gere o arquivo .htpasswd | HTTPS e autenticação: blindando Prometheus, Grafana e export |
| Acesso negado mesmo de IP permitido | Regra do firewall incorreta ou ordem errada | Verifique a ordem das regras e o IP de origem | HTTPS e autenticação: blindando Prometheus, Grafana e export |
| Tarefas sempre reportam changed=1 | Uso de módulos não idempotentes ou comandos shell/command sem controle de estado | Substitua por módulos idempotentes ou use parâmetros creates/removes | Idempotência real: garantindo que playbooks sejam sempre seg |
| Arquivo de configuração com linhas duplicadas | Uso de shell para adicionar linhas sem checagem | Troque por lineinfile | Idempotência real: garantindo que playbooks sejam sempre seg |
| Configuração de rede duplicada | Comandos CLI enviados sem verificar estado atual | Use módulos de rede com checagem de estado | Idempotência real: garantindo que playbooks sejam sempre seg |
| Ativos importados não aparecem na interface | Campos obrigatórios ausentes ou erro de relacionamento (site, device type) | Revise os dados de entrada e valide IDs referenciados | Implantação do NetBox em um ISP regional: desafios e soluçõe |
| Duplicidade de dispositivos após importação | Falta de padronização nos nomes ou múltiplos registros para o mesmo ativo | Padronize nomes e use scripts de deduplicação antes de importar | Implantação do NetBox em um ISP regional: desafios e soluçõe |
| Erro 400 ao usar a API | Formato de payload inválido ou campo obrigatório ausente | Consulte a documentação da API e ajuste o JSON enviado | Implantação do NetBox em um ISP regional: desafios e soluçõe |
| Rotas não recebem a comunidade esperada | Route-map não está aplicado corretamente ou sintaxe incorreta | Revise a aplicação dos route-maps e a sintaxe dos comandos | Implementando políticas de comunidade e manipulação de atrib |
| Alteração de local-preference não afeta a escolha de saída | Route-map aplicado na direção errada (out em vez de in) | Corrija a direção do route-map para 'in' no neighbor correto | Implementando políticas de comunidade e manipulação de atrib |
| MED não influencia o peer | Peer ignora o atributo MED ou há múltiplos AS_PATHs diferentes | Confirme a política do peer e se as rotas têm mesmo AS de origem | Implementando políticas de comunidade e manipulação de atrib |
| Rotas marcadas como blackhole ainda são anunciadas externamente | Falta de filtro para comunidades no-export | Implemente filtro para impedir exportação de rotas com essa comunidade | Implementando políticas de comunidade e manipulação de atrib |
| Rotas inválidas ainda aparecem na tabela de roteamento | Route-map não aplicado corretamente ou sintaxe incorreta. | Revise a aplicação do route-map ao vizinho e a ordem das regras. | Implementando RPKI e validação de origem |
| FRR não conecta ao validador RPKI | Firewall bloqueando porta 3323 ou IP incorreto. | Verifique regras de firewall e IP do validador na configuração. | Implementando RPKI e validação de origem |
| Todas as rotas aparecem como 'notfound' | Validador não está baixando ROAs ou conexão falhou. | Cheque logs do validador e conectividade de rede. | Implementando RPKI e validação de origem |
| Alerta de versão não suportada para 'match rpki' | Versão do FRR antiga. | Atualize o FRRouting para versão compatível. | Implementando RPKI e validação de origem |
| Tráfego destinado ao seu prefixo não chega | Possível hijack ou erro de anúncio | Verifique prefix-lists e anúncios em Looking Glasses | Incidentes clássicos: prefix hijack, leaks e lições aprendid |
| Recebe muitas rotas inesperadas de um peer | Falta de filtro ou leak no peer | Ajuste prefix-lists e configure maximum-prefix | Incidentes clássicos: prefix hijack, leaks e lições aprendid |
| Loop de roteamento detectado | Leak de prefixos entre peers | Reveja políticas de exportação/importação BGP | Incidentes clássicos: prefix hijack, leaks e lições aprendid |
| Terraform falha ao aplicar mudanças | Estado inconsistente ou credenciais inválidas | Verifique o state file e as variáveis de ambiente. | Infraestrutura como Código em ISPs: integração com Terraform |
| Ansible não encontra hosts | Inventário não gerado corretamente pelo Terraform | Cheque o output e o arquivo hosts. | Infraestrutura como Código em ISPs: integração com Terraform |
| Pipeline GitOps para em erro | Dependências ou permissões faltando | Revise as permissões do runner e os arquivos de configuração. | Infraestrutura como Código em ISPs: integração com Terraform |
| Importação CSV falha com erro de campo inválido | Cabeçalho ou valor incompatível com o modelo do NetBox | Revise o CSV, ajuste os nomes dos campos e valores conforme a documentação | Inicializando o inventário: importação e primeiros cadastros |
| Dispositivo aparece sem rack ou site | Relacionamento não definido ou campo ausente no CSV | Inclua as colunas obrigatórias e relacione corretamente na importação | Inicializando o inventário: importação e primeiros cadastros |
| IPs não aparecem associados a interfaces | Campo de interface não preenchido ou erro de nome | Garanta que o nome da interface no CSV coincida exatamente com o cadastrado no NetBox | Inicializando o inventário: importação e primeiros cadastros |
| O serviço frr não inicia. | Erro de configuração nos arquivos em /etc/frr/ ou falta de permissão. | Revise logs em /var/log/frr/ e permissões dos arquivos. | Instalando FRRouting: do kernel ao serviço BGP |
| bgpd não aparece como ativo. | O daemon bgpd está desabilitado no arquivo /etc/frr/daemons. | Edite o arquivo e coloque 'bgpd=yes', depois reinicie o serviço. | Instalando FRRouting: do kernel ao serviço BGP |
| O Linux não encaminha pacotes entre interfaces. | ip_forward desativado no kernel. | Ative com 'sudo sysctl -w net.ipv4.ip_forward=1' e ajuste o sysctl.conf. | Instalando FRRouting: do kernel ao serviço BGP |
| Erro ao carregar módulo VRF. | Kernel antigo ou módulo não compilado. | Atualize o kernel ou recompile com suporte a VRF. | Instalando FRRouting: do kernel ao serviço BGP |
| Erro de conexão ao banco de dados | Usuário, senha ou host incorretos na configuração | Verifique o arquivo configuration.py e as permissões do PostgreSQL | Instalando NetBox em ambiente Linux seguro |
| Permissão negada ao rodar comandos manage.py | Usuário do sistema sem acesso ao diretório do NetBox | Ajuste permissões com chown para o usuário netbox | Instalando NetBox em ambiente Linux seguro |
| Página web não carrega ou erro 500 | Migrations não aplicadas ou dependências ausentes | Reaplique 'python3 netbox/manage.py migrate' e revise dependências | Instalando NetBox em ambiente Linux seguro |
| O Prometheus não coleta do SNMP Exporter | Porta 9116 bloqueada ou endereço errado no prometheus.yml | Verifique firewall e ajuste o target para o endereço correto. | Instalando Prometheus, SNMP Exporter e Alertmanager: do zero |
| Alertas não chegam no Alertmanager | Configuração errada do alertmanager.yml ou Prometheus não aponta para o Alertmanager | Revise os caminhos de configuração e reinicie os serviços. | Instalando Prometheus, SNMP Exporter e Alertmanager: do zero |
| SNMP Exporter não retorna métricas | Dispositivo SNMP inacessível ou comunidade SNMP incorreta | Teste acesso SNMP com snmpwalk e ajuste community/target. | Instalando Prometheus, SNMP Exporter e Alertmanager: do zero |
| NMS não detecta o roteador via SNMP | SNMP daemon não está rodando ou firewall bloqueando porta 161 | Verifique o status do snmpd e libere a porta no firewall | Integração com sistemas de gestão e orquestração |
| Falha na conexão Netconf | Netconf não habilitado ou porta errada | Confirme configuração no frr.conf e reinicie o serviço | Integração com sistemas de gestão e orquestração |
| Dados BGP não aparecem no NMS | MIB BGP não suportada ou não carregada | Consulte a documentação do NMS e do FRR para suporte à BGP4-MIB | Integração com sistemas de gestão e orquestração |
| Dispositivo não aparece no monitoramento | Erro no script de geração de targets ou status incorreto no NetBox | Verifique se o dispositivo está com status 'active' no NetBox e revise os logs do script. | Integração do NetBox com automação e monitoramento em produç |
| Provisionamento falha para alguns equipamentos | Dados incompletos ou inconsistentes no NetBox | Valide os campos obrigatórios no NetBox antes de rodar a automação. | Integração do NetBox com automação e monitoramento em produç |
| API do NetBox retorna erro 403 | Token de API inválido ou permissões insuficientes | Gere um novo token e atribua as permissões corretas ao usuário. | Integração do NetBox com automação e monitoramento em produç |
| Sessão BGP não sobe | Endereço IP ou ASN incorreto, porta bloqueada ou erro de configuração. | Confira IPs, ASN e conectividade física. Revise a configuração. | Integrando BGP com IX públicos e privados |
| Rotas não são recebidas do route server | Política de filtragem excessiva ou erro no route-map. | Revise prefix-lists e route-maps aplicados à sessão. | Integrando BGP com IX públicos e privados |
| Peers reclamam de anúncios indevidos | Prefixos de terceiros ou privados sendo anunciados. | Ajuste prefix-lists e route-maps para anunciar apenas seus prefixos. | Integrando BGP com IX públicos e privados |
| Oscilações frequentes na sessão BGP | Problemas físicos na interface ou instabilidade de energia. | Verifique cabos, portas e condições elétricas. | Integrando BGP com IX públicos e privados |
| O comando 'ansible-inventory --list' retorna erro de permissão. | O script de inventário não tem permissão de execução. | Dê permissão de execução: chmod +x inventory_db.py | Inventário dinâmico: integração com bancos de dados e APIs |
| Hosts não aparecem no inventário. | Consulta ao banco/API está errada ou não retorna hosts ativos. | Revise a query e os filtros de ativo. | Inventário dinâmico: integração com bancos de dados e APIs |
| Erro de importação de biblioteca no script. | Dependência Python não instalada. | Instale com pip install pymysql, pymongo ou requests conforme o caso. | Inventário dinâmico: integração com bancos de dados e APIs |
| Playbook trava ou demora demais | forks alto demais para o hardware ou inventário muito grande | Reduza forks ou particione o inventário | Inventários grandes: limites práticos e técnicas de particio |
| Conexões SSH recusadas | Dispositivo de rede limita conexões simultâneas | Reduza serial e forks, use conexões persistentes | Inventários grandes: limites práticos e técnicas de particio |
| Inventário não reflete estado real | Inventário estático desatualizado | Implemente inventário dinâmico | Inventários grandes: limites práticos e técnicas de particio |
| Usuário não consegue acessar dashboards no Grafana. | Role atribuída incorretamente ou permissões de pasta restritas. | Revise o role do usuário e permissões de pasta em Configuration > Folders. | Isolamento e least privilege: separando funções e acessos |
| Exporters acessíveis de qualquer rede. | Firewall ou ACLs não configurados corretamente. | Ajuste regras de firewall para limitar acesso aos IPs do Prometheus. | Isolamento e least privilege: separando funções e acessos |
| Logs de auditoria não aparecem. | Configuração de log desabilitada no grafana.ini. | Ative logging em [log] e reinicie o serviço Grafana. | Isolamento e least privilege: separando funções e acessos |
| Processos automatizados não resolvem incidentes recorrentes | Levantamento de requisitos incompleto ou enviesado | Revisite o mapeamento junto ao time operacional | Levantamento de requisitos: o que automatizar em um ISP |
| Automação de tarefas pouco relevantes | Priorização baseada em opinião, não em dados | Use métricas de impacto e frequência para priorizar | Levantamento de requisitos: o que automatizar em um ISP |
| Falta de adesão da equipe técnica | Processos automatizados não refletem a realidade operacional | Inclua o time na validação dos requisitos | Levantamento de requisitos: o que automatizar em um ISP |
| Rotas legítimas sendo rejeitadas | Prefix-list ou ROA desatualizado | Atualize prefix-lists e ROAs no IRR e RPKI | MANRS para ISPs: filtragem, validação e cooperação |
| FRRouting não conecta ao cache RPKI | IP ou porta do servidor incorretos, firewall bloqueando | Verifique IP, porta e regras de firewall | MANRS para ISPs: filtragem, validação e cooperação |
| Anúncios inválidos ainda passam | Route-map não aplicado corretamente ao peer | Revise aplicação do route-map na configuração BGP | MANRS para ISPs: filtragem, validação e cooperação |
| Ativo não aparece na API após cadastro | Cache do navegador ou atraso na replicação | Atualize a página, limpe o cache e verifique logs do NetBox | Mapeando o fluxo de informação: do cadastro ao provisionamen |
| Erro 403 ao usar a API REST | Token de autenticação inválido ou permissões insuficientes | Verifique o token e as permissões do usuário | Mapeando o fluxo de informação: do cadastro ao provisionamen |
| Relacionamentos de portas não aparecem | Portas não cadastradas ou não associadas corretamente | Revise o cadastro das interfaces e conexões físicas | Mapeando o fluxo de informação: do cadastro ao provisionamen |
| Peer BGP IPv6 não sobe | Política de neighbor ou filtro ausente na address-family ipv6 | Revise a configuração e ative o neighbor na família correta | Migração para IPv6 e upgrades de BGP em produção |
| Perda de prefixos após upgrade | Sintaxe incompatível ou comandos depreciados | Consulte a documentação da nova versão e ajuste a configuração | Migração para IPv6 e upgrades de BGP em produção |
| Rollback não restaura sessões | Backup incompleto ou pacote antigo ausente | Garanta backups completos e mantenha os pacotes das versões anteriores | Migração para IPv6 e upgrades de BGP em produção |
| Playbook falha ao encontrar variável | Variável não definida no escopo correto | Verifique se a variável está em group_vars, host_vars ou passada via extra-vars | Modelagem de playbooks: estrutura, modularidade e reuso |
| Arquivo de configuração gerado incorretamente | Erro no template Jinja2 | Valide a sintaxe do template e se as variáveis estão corretas | Modelagem de playbooks: estrutura, modularidade e reuso |
| Role não executa tasks | main.yml ausente ou com erro de indentação | Confirme a existência e a indentação correta do arquivo tasks/main.yml | Modelagem de playbooks: estrutura, modularidade e reuso |
| Dispositivo não aparece no rack | Rack ou site não foi corretamente selecionado ao cadastrar o dispositivo. | Edite o dispositivo e vincule ao rack e site corretos. | Modelando sua rede: sites, racks, dispositivos e conexões |
| Interface não aceita conexão | Tipo de interface incompatível ou interface já conectada. | Verifique o tipo e o status da interface antes de conectar. | Modelando sua rede: sites, racks, dispositivos e conexões |
| Conexão física não aparece no mapa | Conexão não foi salva ou falta permissão. | Salve a conexão e revise permissões de usuário. | Modelando sua rede: sites, racks, dispositivos e conexões |
| Métricas de CPU não aparecem no Grafana | node_exporter não está rodando ou firewall bloqueando porta 9100 | Verifique status do node_exporter com 'systemctl status prometheus-node-exporter' e libere a porta no firewall | Monitorando saúde do NetBox: métricas e alertas |
| Prometheus não coleta métricas do postgres_exporter | postgres_exporter não está configurado corretamente ou não tem permissão no banco | Revise as credenciais e permissões do usuário do postgres_exporter e reinicie o serviço | Monitorando saúde do NetBox: métricas e alertas |
| Alertas não são disparados mesmo com CPU alta | Expressão da regra de alerta está errada ou o job_name não corresponde ao exportador | Ajuste a expressão e verifique o nome correto do job no Prometheus | Monitorando saúde do NetBox: métricas e alertas |
| Sessão BGP não aparece como Established | Problema de conectividade ou configuração de autenticação | Verifique ACLs, senhas e reachability do peer | Monitorando sessões BGP e tabelas de roteamento |
| Logs não registram eventos BGP | Logging desativado ou caminho incorreto | Ajuste a configuração de log no bgpd.conf | Monitorando sessões BGP e tabelas de roteamento |
| Métricas SNMP não aparecem | Agente SNMP não está rodando ou MIB não carregada | Reinicie o snmpd e verifique permissões | Monitorando sessões BGP e tabelas de roteamento |
| Dashboards do Grafana vazios | Prometheus não está coletando do frr_exporter | Revise endpoints e permissões de scraping | Monitorando sessões BGP e tabelas de roteamento |
| Playbooks falham após failover | Inventário ou variáveis desatualizadas no novo líder | Sincronize diretórios e arquivos antes de promover o nó | Multiplicando controladores: Ansible em clusters e alta disp |
| Execuções concorrentes sobrescrevem arquivos | Falta de controle de concorrência no armazenamento compartilhado | Implemente locks ou use 'serial' nos playbooks | Multiplicando controladores: Ansible em clusters e alta disp |
| Logs inconsistentes entre controladores | Centralização de logs mal configurada | Reveja configuração do rsyslog ou ELK | Multiplicando controladores: Ansible em clusters e alta disp |
| Failover não ocorre | Keepalived ou Pacemaker não monitorando corretamente | Ajuste scripts de checagem e permissões | Multiplicando controladores: Ansible em clusters e alta disp |
| Métricas duplicadas ou ausentes nos dashboards | Naming inconsistente ou labels divergentes | Padronize nomes e labels conforme a tabela definida | Naming, labels e organização: o segredo para dashboards útei |
| Queries lentas ou falhando | Cardinalidade alta por labels únicos | Remova labels únicos dos targets | Naming, labels e organização: o segredo para dashboards útei |
| Alertas disparando para alvos errados | Labels mal definidos ou queries genéricas | Revise labels e condições das regras | Naming, labels e organização: o segredo para dashboards útei |
| Inventário do Ansible não mostra todos os dispositivos. | Filtro incorreto ou dados desatualizados no NetBox. | Revise filtros e atualize o cadastro no NetBox. | NetBox como fonte de verdade para automação de configuração |
| Falha de autenticação ao acessar a API. | Token inválido ou expirado. | Gere um novo token no NetBox e atualize a configuração. | NetBox como fonte de verdade para automação de configuração |
| Divergência entre configuração aplicada e dados do NetBox. | Mudanças feitas fora do fluxo de automação. | Padronize processos para garantir que toda alteração passe pelo NetBox. | NetBox como fonte de verdade para automação de configuração |
| Plugin não aparece no menu | Não foi adicionado à lista PLUGINS no configuration.py | Edite configuration.py e inclua o nome do plugin em PLUGINS, depois reinicie o NetBox. | NetBox e o ecossistema open source: plugins e contribuições |
| Erro de versão ao instalar plugin | Incompatibilidade entre versão do NetBox e do plugin | Verifique o pyproject.toml do plugin e atualize NetBox ou escolha versão compatível. | NetBox e o ecossistema open source: plugins e contribuições |
| Função do plugin não executa | Dependências do plugin não instaladas | Consulte a documentação do plugin e instale dependências faltantes via pip. | NetBox e o ecossistema open source: plugins e contribuições |
| Equipamento não aparece na busca | Cadastro incompleto ou erro de digitação | Revise os campos obrigatórios e corrija nomes ou localizações | NetBox: o que é, para que serve e onde não usar |
| API retorna erro 403 | Token inválido ou permissões insuficientes | Gere novo token e ajuste as permissões do usuário | NetBox: o que é, para que serve e onde não usar |
| Dados divergentes entre NetBox e realidade | Falta de atualização após mudanças físicas | Implemente processo de atualização pós-mudança | NetBox: o que é, para que serve e onde não usar |
| Rotas válidas estão sendo descartadas | ROA ausente ou configuração incorreta do validador RPKI | Verifique ROAs no RIR e a configuração do servidor RPKI no FRR | O futuro do roteamento: RPKI, automação e desafios globais |
| Sessão BGP não sobe após ativar MD5 | Senha incompatível entre os peers | Confirme que ambos os lados usam exatamente a mesma senha | O futuro do roteamento: RPKI, automação e desafios globais |
| Automação não executa comandos no FRR | Permissões insuficientes ou erro no script | Teste o comando manualmente, revise permissões e logs do sistema | O futuro do roteamento: RPKI, automação e desafios globais |
| Falha de conexão SSH | Chave SSH ausente ou permissão incorreta | Verifique permissões e distribua as chaves públicas corretamente | O que é Ansible e por que ele domina a automação de redes ab |
| Erro 'module not found' | Módulo Ansible não instalado | Instale o módulo com 'ansible-galaxy collection install' | O que é Ansible e por que ele domina a automação de redes ab |
| Saída inesperada do comando | Driver Netmiko incompatível | Consulte a documentação do Netmiko para suporte ao equipamento | O que é Ansible e por que ele domina a automação de redes ab |
| Métricas não aparecem no Prometheus | Endpoint OpenMetrics inacessível ou formato inválido | Verifique se o serviço está rodando e se o formato segue o padrão OpenMetrics. | OpenMetrics, OpenTelemetry e o futuro do monitoramento ISP |
| OpenTelemetry Collector não exporta para Prometheus | Configuração de pipeline incorreta | Revise a configuração do Collector, especialmente receivers e exporters. | OpenMetrics, OpenTelemetry e o futuro do monitoramento ISP |
| Dados duplicados ou inconsistentes | Scraping de múltiplos endpoints com labels iguais | Ajuste os labels para garantir unicidade das séries temporais. | OpenMetrics, OpenTelemetry e o futuro do monitoramento ISP |
| Ativos com nomes diferentes para o mesmo equipamento | Falta de padrão de nomenclatura | Unifique nomes e documente a ação | Padronização de nomenclatura, roles e documentação |
| Roles ou tags duplicadas (ex: 'core' e 'Core') | Cadastro sem controle de lista | Padronize e remova duplicadas | Padronização de nomenclatura, roles e documentação |
| Campos livres com informações divergentes | Ausência de custom fields estruturados | Implemente choices e revise os dados | Padronização de nomenclatura, roles e documentação |
| ansible-lint retorna muitos avisos | Playbook fora do padrão ou uso excessivo de módulos genéricos | Refatore tasks para usar módulos específicos e siga as recomendações do lint | Padronização de playbooks: linting, revisão e documentação |
| Equipe não entende o propósito de uma task | Falta de documentação inline ou nomes pouco descritivos | Adicione campos name claros e comentários explicativos | Padronização de playbooks: linting, revisão e documentação |
| Erro ao aplicar playbook após merge | Alteração não revisada ou conflito não resolvido | Implemente revisão obrigatória e teste antes de aplicar em produção | Padronização de playbooks: linting, revisão e documentação |
| Consultas lentas mesmo após particionamento | Índices não otimizados ou partições mal definidas | Recrie índices nas partições e ajuste faixas de particionamento | Particionamento, sharding e limites de expansão |
| Erro ao inserir dados em tabela particionada | Valores fora do range definido nas partições | Crie partições cobrindo todos os valores possíveis | Particionamento, sharding e limites de expansão |
| NetBox não reconhece dados após particionamento | Migração incompleta ou views não atualizadas | Revise a migração e atualize views/materialized views se necessário | Particionamento, sharding e limites de expansão |
| Playbook trava ou demora muito | Forks baixos ou timeout insuficiente | Aumente forks e timeout gradualmente | Performance do Ansible: forks, serial e tuning realista |
| Controlador fica lento ou trava | Forks altos demais para o hardware | Reduza forks e monitore recursos | Performance do Ansible: forks, serial e tuning realista |
| Muitos hosts falham ao mesmo tempo | Serial baixo em mudanças críticas | Aumente serial para reduzir paralelismo | Performance do Ansible: forks, serial e tuning realista |
| Conexões SSH caem | Limite de arquivos abertos atingido | Aumente ulimit ou reduza forks | Performance do Ansible: forks, serial e tuning realista |
| Usuário não consegue ver ou editar objetos que deveria | Permissão não atribuída corretamente ao grupo ou usuário. | Revise as permissões do grupo no Admin > Groups > [grupo] > Permissions. | Personalizando permissões, grupos e acessos |
| Usuário consegue acessar objetos de outros times | Permissão excessiva ou ausência de filtros em Object Permissions. | Ajuste os filtros em Object Permissions para restringir o acesso. | Personalizando permissões, grupos e acessos |
| Alterações não aparecem no changelog | Ação realizada fora da interface do NetBox ou por conta compartilhada. | Garanta que todas as ações sejam feitas via interface e por usuários individuais. | Personalizando permissões, grupos e acessos |
| Pipeline falha no lint | Playbook com erro de sintaxe ou uso de módulos depreciados | Corrija os erros apontados pelo ansible-lint e faça novo commit | Pipelines de execução: integração com Git e testes automatiz |
| Execução em ambiente de teste falha | Inventário de teste desatualizado ou ambiente inconsistente | Atualize o inventário e valide se o ambiente de teste reflete a produção | Pipelines de execução: integração com Git e testes automatiz |
| Rollback não executa após falha | Pipeline sem stage de rollback ou handler mal configurado | Inclua stage de rollback no CI/CD e handlers nos playbooks | Pipelines de execução: integração com Git e testes automatiz |
| NetBox indisponível após falha do primário | Standby não foi promovido corretamente | Verifique logs do PostgreSQL e promova manualmente o standby | Planejamento de alta disponibilidade e redundância |
| Arquivos media inconsistentes entre instâncias | Armazenamento não compartilhado corretamente | Monte diretório via NFS ou outro sistema distribuído | Planejamento de alta disponibilidade e redundância |
| HAProxy não remove instância web com erro | Health check mal configurado | Ajuste a configuração de health check do HAProxy | Planejamento de alta disponibilidade e redundância |
| Prometheus lento ou travando | Número excessivo de séries temporais ou scraping muito frequente | Reduza labels dinâmicos, aumente scrape_interval ou faça sharding | Planejamento de coleta: frequência, granularidade e retenção |
| Dados antigos sumindo antes do esperado | Retenção configurada menor que o desejado ou falta de espaço em disco | Ajuste --storage.tsdb.retention.time e monitore espaço em disco | Planejamento de coleta: frequência, granularidade e retenção |
| Falhas de coleta em targets específicos | Intervalo de scraping muito curto para o hardware do target | Aumente o scrape_interval desse target | Planejamento de coleta: frequência, granularidade e retenção |
| Prefixo não aparece nas tabelas globais | Prefixo pequeno demais ou não documentado no IRR | Agregue prefixos e registre corretamente no IRR | Planejando ASN, blocos IP e políticas de roteamento |
| ASN rejeitado por upstream | ASN privado usado em anúncios públicos | Solicite e use ASN público | Planejando ASN, blocos IP e políticas de roteamento |
| Clientes não recebem IPv6 | Falta de planejamento ou configuração de sub-redes | Replaneje e configure sub-redes IPv6 conforme RFC 6177 | Planejando ASN, blocos IP e políticas de roteamento |
| Sessão BGP não sobe | ASN ou IP do vizinho incorreto | Verifique configuração dos neighbors e ASN | Por que BGP é a espinha dorsal da Internet e como ele decide |
| Prefixos não são anunciados | Falta de comando 'network' ou filtro bloqueando | Confirme comandos 'network' e prefix-list | Por que BGP é a espinha dorsal da Internet e como ele decide |
| Rotas indesejadas recebidas | Filtros de entrada ausentes ou mal configurados | Ajuste prefix-list e route-maps de entrada | Por que BGP é a espinha dorsal da Internet e como ele decide |
| Dados divergentes entre planilhas | Falta de padronização e controle de versões | Centralize o inventário e defina padrões de nomenclatura. | Por que inventário de rede falha sem governança |
| Equipamentos sumindo do inventário | Atualizações manuais e falta de trilha de auditoria | Implemente logs automáticos de alteração. | Por que inventário de rede falha sem governança |
| Dificuldade em responder auditorias | Histórico incompleto ou inexistente | Adote sistema com registro de mudanças. | Por que inventário de rede falha sem governança |
| Playbook não executa em todos os switches | Inventário incompleto ou credenciais incorretas | Revise o arquivo de inventário e as variáveis de autenticação | Por que ISPs precisam de automação: riscos e ganhos concreto |
| Configuração não é aplicada corretamente | Comando incompatível com o modelo do equipamento | Adapte o playbook para cada modelo; consulte a documentação do Ansible | Por que ISPs precisam de automação: riscos e ganhos concreto |
| Rollback falha após erro | Faltou definir estado anterior no playbook | Implemente tarefas de rollback explícitas | Por que ISPs precisam de automação: riscos e ganhos concreto |
| Alertas não disparam mesmo com degradação | Thresholds mal definidos ou coleta de métricas insuficiente | Reveja os thresholds e aumente a frequência de coleta | Por que métricas superam logs: o que importa no monitorament |
| Painéis de métricas vazios | Erro na configuração do Prometheus ou exporters | Verifique targets e conectividade SNMP/Node Exporter | Por que métricas superam logs: o que importa no monitorament |
| Consumo excessivo de disco | Coleta de logs detalhados demais | Reduza a verbosidade dos logs e priorize métricas | Por que métricas superam logs: o que importa no monitorament |
| Métricas de banda não batem com o tráfego real | Erro de unidade ou coleta em interface errada | Confirme a configuração SNMP e as unidades das métricas | Por que métricas superam logs: o que importa no monitorament |
| Falha de autenticação SSH | Senha ou chave SSH incorreta | Revise credenciais e teste acesso manual via ssh | Primeiro playbook: configuração segura de roteadores via Net |
| Comando não reconhecido pelo roteador | Sistema operacional do roteador não suportado ou comando incompatível | Consulte a documentação do fabricante e ajuste os comandos | Primeiro playbook: configuração segura de roteadores via Net |
| Playbook executa mas não altera configuração | Condição de idempotência mal definida | Revise os comandos de checagem e os 'when' das tarefas | Primeiro playbook: configuração segura de roteadores via Net |
| Usuário não consegue logar no Grafana | Erro de bind DN ou senha no ldap.toml | Verifique credenciais e permissões no LDAP | Prometheus e Grafana com autenticação externa: LDAP e OAuth2 |
| Permissões erradas após login | Mapeamento de grupos incorreto | Ajuste a seção group_mappings no ldap.toml | Prometheus e Grafana com autenticação externa: LDAP e OAuth2 |
| Prometheus acessível sem autenticação | Proxy reverso mal configurado | Revise regras de proxy e autenticação no NGINX | Prometheus e Grafana com autenticação externa: LDAP e OAuth2 |
| Erro 502 Bad Gateway no acesso ao Prometheus | Proxy não consegue se conectar ao backend | Verifique endereço e porta do Prometheus no proxy | Prometheus e Grafana com autenticação externa: LDAP e OAuth2 |
| Alvos não aparecem no Prometheus após atualização do arquivo file_sd | Formato JSON inválido ou permissão de leitura insuficiente. | Valide o JSON e ajuste permissões do arquivo. | Prometheus e Grafana em 2024: novidades e recursos avançados |
| Dashboards do Grafana não mostram variáveis dinâmicas | Query da variável está incorreta ou datasource não configurado. | Revise a query e teste a conexão do datasource. | Prometheus e Grafana em 2024: novidades e recursos avançados |
| Falha ao enviar métricas via remote_write | URL do backend incorreta ou backend indisponível. | Teste a conectividade e revise a URL no arquivo de configuração. | Prometheus e Grafana em 2024: novidades e recursos avançados |
| O Prometheus não coleta métricas SNMP. | snmp_exporter não está rodando ou porta 9116 bloqueada. | Verifique se o serviço está ativo e a porta liberada no firewall. | Prometheus, Grafana e SNMP: o trio essencial para ISPs moder |
| No Grafana, dashboards aparecem vazios. | Fonte de dados Prometheus mal configurada. | Revise o endereço e as permissões da fonte de dados no Grafana. | Prometheus, Grafana e SNMP: o trio essencial para ISPs moder |
| Alertas não são enviados pelo Alertmanager. | Configuração de rota de alerta ou canal de notificação incorreta. | Cheque o arquivo de configuração do Alertmanager e teste o envio manual. | Prometheus, Grafana e SNMP: o trio essencial para ISPs moder |
| Os alvos SNMP aparecem como DOWN na interface do Prometheus | SNMP Exporter fora do ar, firewall bloqueando porta SNMP ou erro de autenticação SNMP. | Verifique se o SNMP Exporter está rodando, portas abertas e credenciais corretas. | Prometheus.yml sem mistério: configurando alvos SNMP e regra |
| Erro de sintaxe ao iniciar o Prometheus | Indentação errada ou campos fora do padrão YAML. | Revise o prometheus.yml e valide com promtool. | Prometheus.yml sem mistério: configurando alvos SNMP e regra |
| Métricas SNMP não aparecem no Prometheus | Módulo SNMP incorreto ou equipamento não suporta o módulo escolhido. | Consulte a documentação do SNMP Exporter e ajuste o módulo. | Prometheus.yml sem mistério: configurando alvos SNMP e regra |
| Erro de certificado inválido ao acessar via HTTPS | Certificado expirado ou domínio errado | Renove o certificado e confira o CN/SAN | Protegendo o acesso: HTTPS, autenticação e logs |
| Usuários LDAP não conseguem logar | Configuração LDAP incorreta ou servidor LDAP fora do ar | Revise AUTH_LDAP_SERVER_URI e teste conectividade LDAP | Protegendo o acesso: HTTPS, autenticação e logs |
| Logs não aparecem em /var/log/netbox/netbox.log | Permissões de arquivo ou configuração LOGGING errada | Ajuste permissões e revise o bloco LOGGING | Protegendo o acesso: HTTPS, autenticação e logs |
| Sessão BGP não sobe após configurar MD5 | Senhas diferentes entre os peers | Verifique e alinhe as senhas em ambos os lados | Protegendo sessões BGP: autenticação, TTL, MD5 |
| Sessão BGP cai após ativar TTL Security Hack | Peer não está diretamente conectado ou valor de hops inadequado | Ajuste o valor de hops conforme a topologia real | Protegendo sessões BGP: autenticação, TTL, MD5 |
| Prefixos não são anunciados ao peer | Prefix-list restritiva ou mal configurada | Revise as regras da prefix-list e route-maps aplicados | Protegendo sessões BGP: autenticação, TTL, MD5 |
| Dashboard não aparece no Grafana | Arquivo JSON está malformado ou no diretório errado | Valide o JSON e confira o caminho em provisioning | Provisionando dashboards e regras: Grafana e Prometheus as c |
| Alertas não disparam no Prometheus | Erro de sintaxe no YAML ou serviço não recarregado | Cheque logs do Prometheus e recarregue o serviço | Provisionando dashboards e regras: Grafana e Prometheus as c |
| Mudança não refletida após deploy | Cache do navegador ou serviço não reiniciado | Limpe cache e reinicie/recarregue serviços | Provisionando dashboards e regras: Grafana e Prometheus as c |
| Métricas SNMP sumiram do dashboard | SNMP exporter parado ou falha de rede | Reinicie o exporter e teste conectividade com snmpwalk | Quando o Prometheus não coleta: debug prático de scraping SN |
| Erro de timeout nos logs | Firewall bloqueando UDP 161 | Libere a porta no firewall e teste com nc | Quando o Prometheus não coleta: debug prático de scraping SN |
| Erro de autenticação SNMP | Community string errada ou permissão insuficiente | Corrija a community ou permissões no equipamento | Quando o Prometheus não coleta: debug prático de scraping SN |
| Dados ausentes ou gaps nos gráficos | CPU saturada ou scrape_interval muito baixo | Aumente o scrape_interval ou distribua a carga | Quantos Prometheus você aguenta? CPU, RAM e disco na prática |
| Prometheus travando ou reiniciando | RAM insuficiente para o número de séries | Reduza a quantidade de séries ou aumente a RAM | Quantos Prometheus você aguenta? CPU, RAM e disco na prática |
| Disco enche rapidamente | Retenção alta ou scrape_interval baixo | Reduza a retenção ou aumente o intervalo de coleta | Quantos Prometheus você aguenta? CPU, RAM e disco na prática |
| Prefixos desaparecem e reaparecem rapidamente | Flap de rota por instabilidade de link ou peer | Ativar flap damping e investigar estabilidade física | Resolução de loops, flaps e problemas de convergência |
| Rotas com AS_PATH repetido | Loop de rota entre peers | Corrigir configuração de vizinhança e filtros | Resolução de loops, flaps e problemas de convergência |
| Convergência lenta após falha | Timers altos ou scan-time elevado | Reduzir timers e scan-time com cautela | Resolução de loops, flaps e problemas de convergência |
| Playbook não bloqueia IPs | SSH não habilitado ou credenciais incorretas | Verifique acesso SSH e credenciais no inventory | Resposta orquestrada a ataque DDoS: da detecção à mitigação |
| IPs não aparecem na address-list | Sintaxe do comando ou permissão insuficiente | Revise comando e permissões do usuário no Mikrotik | Resposta orquestrada a ataque DDoS: da detecção à mitigação |
| E-mail de notificação não enviado | SMTP bloqueado ou configuração errada | Teste envio manual e ajuste parâmetros do módulo mail | Resposta orquestrada a ataque DDoS: da detecção à mitigação |
| Playbook não executa ação no switch | Credenciais SSH incorretas ou permissão insuficiente. | Verifique usuário, senha e privilégios no switch. | Respostas orquestradas a incidentes: playbooks para mitigaçã |
| Regra de firewall não aparece após execução | Playbook rodou sem privilégio root. | Use become: true no playbook. | Respostas orquestradas a incidentes: playbooks para mitigaçã |
| Notificação não chega por e-mail | Configuração de SMTP incorreta no Ansible ou bloqueio de saída. | Revise parâmetros do módulo mail e conectividade SMTP. | Respostas orquestradas a incidentes: playbooks para mitigaçã |
| Dispositivo aparece no NetBox, mas não existe fisicamente. | Inventário desatualizado ou remoção física não registrada. | Atualize o status do dispositivo no NetBox para 'offline' ou 'retirado'. | Rotinas de revisão, auditoria e atualização do inventário |
| Alterações não aparecem nos logs de auditoria. | Mudanças feitas fora do NetBox ou por usuários sem permissão adequada. | Padronize o uso do NetBox para todas as alterações e revise permissões de acesso. | Rotinas de revisão, auditoria e atualização do inventário |
| API REST retorna erro 403. | Token de autenticação inválido ou permissões insuficientes. | Revise o token e as permissões do usuário na API. | Rotinas de revisão, auditoria e atualização do inventário |
| Dispositivo removido do NetBox ainda aparece no monitoramento | Falta de automação na remoção do NMS | Implemente script que remova hosts do NMS ao excluir do NetBox | Sincronizando NetBox com sistemas de monitoramento e NMS |
| Atualização via API REST retorna erro 403 | Token sem permissão de escrita | Ajuste permissões do token conforme documentação oficial | Sincronizando NetBox com sistemas de monitoramento e NMS |
| Dispositivo novo não aparece no monitoramento | Script de exportação não está rodando periodicamente | Configure agendamento (cron ou similar) para exportação automática | Sincronizando NetBox com sistemas de monitoramento e NMS |
| Campos divergentes entre NetBox e NMS | Falta de sincronização bidirecional ou erro em script | Revise lógica de atualização e valide campos críticos | Sincronizando NetBox com sistemas de monitoramento e NMS |
| Métricas de um POP não aparecem no Grafana | Falha de comunicação entre o Prometheus central e o POP | Verifique conectividade de rede e configuração de scrape_configs | Topologias de monitoramento: centralizado, federado e distri |
| Dados com atraso ou gaps | Latência alta ou sobrecarga no Prometheus central | Implemente federação ou aumente recursos do servidor | Topologias de monitoramento: centralizado, federado e distri |
| Prometheus reinicia frequentemente | Falta de memória ou configuração inadequada | Ajuste limites de retenção e recursos do sistema | Topologias de monitoramento: centralizado, federado e distri |
| Sessão BGP não sobe | ASN ou IP do neighbor incorreto | Confirme ASN e IP nos dois lados e reinicie a sessão | Topologias de rede ISP: single-homed, multi-homed, IX e upst |
| Rotas não são aprendidas do IX | Route-map ou filtro bloqueando anúncios | Revise prefix-lists e route-maps aplicados ao neighbor do IX | Topologias de rede ISP: single-homed, multi-homed, IX e upst |
| Tráfego sai pelo upstream errado | Métricas BGP (local-pref, MED) mal configuradas | Ajuste as métricas e reinicie a sessão se necessário | Topologias de rede ISP: single-homed, multi-homed, IX e upst |
| Arquivo gerado com valores em branco | Variável não definida ou nome incorreto no template | Cheque nomes de variáveis em host_vars, group_vars e no template | Variáveis, facts e templates: personalizando configurações e |
| Fact não disponível no template | gather_facts está desabilitado no playbook | Adicione gather_facts: yes ao playbook | Variáveis, facts e templates: personalizando configurações e |
| Override via -e não funciona | Nome da variável no -e diferente do template | Use o mesmo nome de variável em ambos | Variáveis, facts e templates: personalizando configurações e |
| Handler não executa mesmo após mudança | Task não notificou handler corretamente | Confirme o parâmetro 'notify' e se houve alteração real | Workflows orquestrados: dependências, handlers e callbacks |
| Callback não dispara | Plugin não ativado no ansible.cfg | Inclua o plugin em 'callback_whitelist' e revise dependências | Workflows orquestrados: dependências, handlers e callbacks |
| Task executa sempre, mesmo sem mudança | Módulo não detecta idempotência | Use módulos que suportam 'check_mode' e idempotência, ou ajuste 'changed_when' | Workflows orquestrados: dependências, handlers e callbacks |
