387 sintomas catalogados
Cada sintoma com causa provável e correção, ligado à lição da trilha Telecom que explica o porquê. Descreva o sintoma para filtrar.
| Sintoma | Causa provável | Correção | Lição |
|---|---|---|---|
| Script não executa ao disparar trigger | Permissões incorretas ou caminho errado do script | Ajuste permissões e confirme o caminho em /usr/lib/zabbix/externalscripts/ | Ações automáticas: scripts, notificações e self-healing |
| Notificação não chega ao destinatário | Configuração errada de media type ou usuário sem canal associado | Revise configurações em Administration > Media types e Users | Ações automáticas: scripts, notificações e self-healing |
| Script executa mas não resolve o problema | Comando do script inadequado ou OID SNMP incorreto | Teste o script manualmente e consulte a documentação do fabricante | Ações automáticas: scripts, notificações e self-healing |
| Alerta não chega por e-mail | SMTP bloqueado ou credenciais incorretas | Revise configurações do módulo mail e teste envio manual. | Alertas automatizados: quando e como acionar equipes em caso |
| Webhook não recebe alerta | Endpoint HTTP inacessível ou erro de autenticação | Teste o endpoint com curl e ajuste parâmetros do módulo uri. | Alertas automatizados: quando e como acionar equipes em caso |
| Alertas duplicados em curto intervalo | Falta de controle de repetição | Implemente lógica para evitar reenvio imediato (ex: arquivo de lock temporário). | Alertas automatizados: quando e como acionar equipes em caso |
| Standby não sincroniza com o primário | Configuração incorreta de wal_level ou acesso de rede bloqueado | Revise postgresql.conf e pg_hba.conf, teste conectividade entre os servidores | Alta disponibilidade e recuperação de desastres |
| NetBox não sobe após failover | Variáveis de ambiente ou volumes inconsistentes no Docker Compose | Verifique docker-compose.yml e paths de volumes | Alta disponibilidade e recuperação de desastres |
| Backup corrompido ou incompleto | Espaço em disco insuficiente ou interrupção durante o backup | Monitore espaço livre e valide backups com restaurações periódicas | Alta disponibilidade e recuperação de desastres |
| ONU não aparece na lista da OLT | Problema físico na fibra, fusão mal feita ou ONU incompatível | Verifique a fibra, refaça a fusão e confirme a compatibilidade da ONU | Ativação de OLTs e ONUs com ferramentas abertas |
| Potência óptica fora do padrão | Perda excessiva na fibra ou splitters, conector sujo | Limpe conectores, revise o caminho óptico e refaça medições | Ativação de OLTs e ONUs com ferramentas abertas |
| ONU ativa mas sem navegação | VLAN ou perfil de serviço incorreto | Reveja a configuração de VLAN e QoS na OLT | Ativação de OLTs e ONUs com ferramentas abertas |
| Equipamento não responde após migração | Firmware incompatível ou erro de configuração aplicada | Execute o playbook de rollback imediatamente e valide o backup. | Automação de migração em massa: como evitar downtime em rede |
| Backup não encontrado para rollback | Falha na tarefa de backup ou caminho incorreto | Verifique logs do Ansible e corrija o caminho do backup antes de repetir a migração. | Automação de migração em massa: como evitar downtime em rede |
| Migração para no meio do lote | Timeout de conexão ou erro de autenticação | Revise as credenciais e aumente o timeout no playbook. | Automação de migração em massa: como evitar downtime em rede |
| ONU não aparece provisionada | Número de série ou porta PON incorretos | Revise as variáveis e repita o playbook | Automação de provisionamento: Ansible na prática |
| Erro de autenticação SSH | Credenciais ou IP da OLT errados | Ajuste o inventário e teste conexão manualmente | Automação de provisionamento: Ansible na prática |
| Serviço não ativa após provisionamento | Perfil de serviço ou VLAN não configurados corretamente | Verifique comandos enviados e ajuste o playbook | Automação de provisionamento: Ansible na prática |
| ONT não aparece registrada após execução do playbook | Serial ou porta incorreta no YAML | Revise o arquivo YAML e valide o serial/porta na OLT | Automação declarativa e infra-as-code: o que já é possível h |
| Erro de autenticação SSH no Ansible | Credenciais inválidas ou ACL bloqueando acesso | Atualize as credenciais e revise as ACLs da OLT | Automação declarativa e infra-as-code: o que já é possível h |
| Mudanças não aplicadas, mas playbook executa sem erro | Comando enviado não é idempotente ou não há verificação de estado | Implemente coleta e comparação de configuração antes de aplicar | Automação declarativa e infra-as-code: o que já é possível h |
| Inventário sobrescrito ou hosts sumindo | Falta de git pull antes de editar | Sempre faça git pull antes de editar arquivos compartilhados | Automação distribuída: múltiplos operadores, múltiplos sites |
| Conflito de merge ao tentar push | Alterações concorrentes no mesmo arquivo | Resolva manualmente os conflitos, teste e faça commit | Automação distribuída: múltiplos operadores, múltiplos sites |
| Playbook falha por host inexistente | Inventário desatualizado ou branch errada | Confirme que está na branch correta e sincronize inventários | Automação distribuída: múltiplos operadores, múltiplos sites |
| Branches divergentes sem merge | Branches antigas não integradas à main | Faça merge frequente e revise branches antigas | Automação distribuída: múltiplos operadores, múltiplos sites |
| Playbook não executa após evento | Endpoint HTTP não está rodando ou erro de permissão | Reinicie o serviço Flask e verifique permissões de execução | Automação reativa: respondendo a eventos de rede em tempo re |
| Playbook roda múltiplas vezes para o mesmo evento | Falta de controle de idempotência ou deduplicação | Implemente locks ou checagem de eventos já tratados | Automação reativa: respondendo a eventos de rede em tempo re |
| Resposta lenta após evento | Endpoint sobrecarregado ou playbook pesado | Otimizar código do endpoint e modularizar playbooks | Automação reativa: respondendo a eventos de rede em tempo re |
| Script retorna erro 401 Unauthorized | Token de API inválido ou ausente. | Gere um novo token e atualize o script. | Automatizando o inventário: scripts Python e API |
| Erro 400 Bad Request ao importar ativo | Payload JSON malformado ou campo obrigatório ausente. | Revise o formato dos dados e os campos exigidos pela API. | Automatizando o inventário: scripts Python e API |
| Ativos não aparecem no NetBox após importação | Script não executou corretamente ou endpoint incorreto. | Verifique logs do script e URL da API. | Automatizando o inventário: scripts Python e API |
| ONU não registra na OLT | Potência óptica fora do padrão ou conector sujo | Limpar conectores e medir potência com OTDR | Camadas de rede em GPON e XGS-PON: físico, lógico e de servi |
| Cliente recebe menos banda que o contratado | T-CONT configurado com banda inferior ao perfil de serviço | Ajustar banda do T-CONT conforme perfil | Camadas de rede em GPON e XGS-PON: físico, lógico e de servi |
| Perda intermitente de conexão | Reflexão excessiva ou atenuação variável na fibra | Reinspecionar e substituir trechos de fibra ou conectores | Camadas de rede em GPON e XGS-PON: físico, lógico e de servi |
| Usuários relatam lentidão em horários de pico | Oversubscription excessivo ou banda provisionada acima da capacidade física | Reduza o split ou ajuste os planos de banda | Capacidade de banda: limites práticos em GPON e XGS-PON |
| Serviços críticos (VoIP, IPTV) com falhas | Provisionamento inadequado de T-CONTs e GEM Ports | Reconfigure os perfis de banda com prioridade para serviços sensíveis | Capacidade de banda: limites práticos em GPON e XGS-PON |
| OLT reporta erros de congestionamento | Capacidade excedida na porta | Redistribua usuários entre portas ou migre para XGS-PON | Capacidade de banda: limites práticos em GPON e XGS-PON |
| Métricas não aparecem no Prometheus | snmp_exporter mal configurado ou OIDs incorretos | Revise o arquivo de configuração do snmp_exporter e teste os OIDs manualmente. | Coleta automatizada de métricas e alarmes |
| Alertas não são enviados | Regras de alerta ausentes ou Alertmanager não configurado | Verifique a configuração do Alertmanager e simule condições de alarme. | Coleta automatizada de métricas e alarmes |
| Coleta SNMP muito lenta ou falha | Excesso de queries ou OLT sobrecarregada | Reduza a frequência de coleta e limite o número de OIDs por consulta. | Coleta automatizada de métricas e alarmes |
| Saída vazia ou incompleta nos arquivos de status | Comando incorreto ou permissões insuficientes no dispositivo | Revise o comando e as credenciais SSH usadas pelo Ansible | Coleta automatizada de status e métricas: health check de OL |
| Erro de parsing no script Python | Padrão de regex incompatível com a saída do comando | Ajuste a expressão regular conforme a saída real do equipamento | Coleta automatizada de status e métricas: health check de OL |
| Relatório não é atualizado após execução do playbook | Task de geração de relatório não está agregando dados corretamente | Verifique o uso de 'mode: a' no módulo copy e a lógica de agregação | Coleta automatizada de status e métricas: health check de OL |
| Timeout ao conectar via Ansible | Timeout baixo ou OLT sobrecarregada | Aumente o timeout no ansible.cfg ou reduza forks | Como Ansible se conecta e executa em equipamentos ópticos: t |
| Erro de autenticação | Chave SSH não instalada ou senha incorreta | Reinstale a chave ou corrija a senha no inventário | Como Ansible se conecta e executa em equipamentos ópticos: t |
| Comando não reconhecido na OLT | CLI proprietário não suportado pelo SSH padrão | Use Netmiko ou módulos específicos de rede | Como Ansible se conecta e executa em equipamentos ópticos: t |
| Inventário demora minutos para carregar | Fonte de dados lenta ou script ineficiente | Otimize a consulta ou use cache | Como dimensionar inventários e variáveis para milhares de ON |
| Variáveis não aplicadas corretamente | Estrutura de group_vars/host_vars inconsistente | Reveja a hierarquia e nomes de arquivos | Como dimensionar inventários e variáveis para milhares de ON |
| Hosts ausentes em grupos | Script dinâmico não está gerando grupos corretamente | Ajuste o script para incluir o campo de agrupamento | Como dimensionar inventários e variáveis para milhares de ON |
| Erro de parsing YAML | Arquivo mal formatado | Valide com yamllint antes de rodar | Como dimensionar inventários e variáveis para milhares de ON |
| Itens SNMP retornam 'Not supported' | OID incorreto ou equipamento não responde SNMP. | Verifique o OID na documentação e teste SNMP com snmpwalk. | Como o Zabbix enxerga uma rede óptica: hosts, itens e trigge |
| Triggers não disparam mesmo com valores fora do normal | Expressão da trigger errada ou item sem coleta recente. | Revise a expressão e o intervalo de coleta do item. | Como o Zabbix enxerga uma rede óptica: hosts, itens e trigge |
| Valores de potência óptica aparecem como zero ou nulo | SNMP community incorreta ou permissão insuficiente. | Ajuste a SNMP community no equipamento e no Zabbix. | Como o Zabbix enxerga uma rede óptica: hosts, itens e trigge |
| O playbook não detecta desvios mesmo quando há não conformidade. | Regex ou comando de verificação incorreto. | Revise o comando e a expressão usada para checar o parâmetro. | Compliance automatizado: garantindo aderência a padrões e po |
| Correção é aplicada em equipamentos já conformes. | Condição 'when' mal configurada. | Ajuste a lógica condicional para evitar mudanças desnecessárias. | Compliance automatizado: garantindo aderência a padrões e po |
| Relatório não é gerado ou está vazio. | Task de exportação com caminho ou permissão errada. | Verifique o destino do arquivo e permissões de escrita. | Compliance automatizado: garantindo aderência a padrões e po |
| Erro 500 ao acessar a interface | Falha de conexão com PostgreSQL ou erro no Django | Verifique logs do NetBox e status do banco | Componentes do NetBox: de PostgreSQL ao Python |
| Imagens anexadas não aparecem | Permissões incorretas no diretório media/ | Ajuste permissões com 'chown' e 'chmod' | Componentes do NetBox: de PostgreSQL ao Python |
| Erro 502 Bad Gateway | Gunicorn parado ou socket inacessível | Reinicie o serviço Gunicorn e confira configuração do Nginx | Componentes do NetBox: de PostgreSQL ao Python |
| Backup falha com erro de permissão | Usuário sem permissão de escrita no destino | Execute backup como usuário correto ou ajuste permissões | Componentes do NetBox: de PostgreSQL ao Python |
| Timeout ou sem resposta SNMP | Firewall bloqueando porta UDP 161 ou credenciais incorretas | Libere porta 161 e revise community/user e senhas | Conectando OLTs e switches ópticos via SNMP e Netconf |
| SNMPv3 falha com 'usmStatsWrongDigests' | Senha ou algoritmo de autenticação incorretos | Confirme algoritmo e senha usados no equipamento e no Zabbix | Conectando OLTs e switches ópticos via SNMP e Netconf |
| Netconf retorna erro de autenticação | Usuário ou senha inválidos | Verifique usuário, senha e permissões Netconf | Conectando OLTs e switches ópticos via SNMP e Netconf |
| Não consigo acessar o painel administrativo após criar o superusuário. | Usuário criado com e-mail ou senha inválidos, ou serviço NetBox não iniciado. | Recrie o superusuário e verifique se o serviço está rodando com 'systemctl status netbox'. | Configuração inicial: usuários, permissões e customizações |
| Permissões não aplicam corretamente aos grupos. | Permissões associadas ao usuário, não ao grupo, ou modelo incorreto selecionado. | Revise a associação das permissões e confira o modelo selecionado. | Configuração inicial: usuários, permissões e customizações |
| Campos customizados não aparecem nos formulários. | Campo não associado ao modelo correto ou cache do navegador. | Edite o campo e associe ao modelo certo. Limpe o cache do navegador. | Configuração inicial: usuários, permissões e customizações |
| Retorno HTTP 401 Unauthorized | Token inválido ou ausente, credenciais erradas | Revise autenticação e headers, gere novo token | Consumindo APIs de OSS/BSS: integração de automação com sist |
| Status 400 Bad Request | Campos obrigatórios ausentes ou formato do JSON incorreto | Valide o schema da API e revise o corpo enviado | Consumindo APIs de OSS/BSS: integração de automação com sist |
| Erro de parsing JSON | Resposta da API não está em JSON válido | Use return_content: yes e trate manualmente | Consumindo APIs de OSS/BSS: integração de automação com sist |
| Timeout na requisição | Endpoint incorreto ou indisponível | Confirme URL e conectividade de rede | Consumindo APIs de OSS/BSS: integração de automação com sist |
| Usuário não autorizado consegue executar playbooks | Permissões de diretório ou grupo mal configuradas | Revise permissões com 'ls -l' e ajuste com chmod/chown | Controle de acesso e auditoria: quem pode automatizar o quê |
| Logs do Ansible não são gerados | log_path não definido corretamente ou permissões do diretório de logs insuficientes | Verifique o ansible.cfg e permissões em /var/log/ansible | Controle de acesso e auditoria: quem pode automatizar o quê |
| Alterações em playbooks não aparecem no histórico | Playbooks não versionados com git | Adicione e faça commit dos arquivos após cada alteração | Controle de acesso e auditoria: quem pode automatizar o quê |
| ONU não volta ao status Online após reset | Configuração incompleta ou falha física | Reaplique a configuração padrão e verifique conectividade física | Correção automática: playbooks que resolvem problemas sem in |
| Comando de reset não executa | Prompt de comando diferente ou comando incorreto | Ajuste o parâmetro expect_string e revise o comando conforme documentação do fabricante | Correção automática: playbooks que resolvem problemas sem in |
| Playbook falha na limpeza de cache | Comando não suportado pelo equipamento | Consulte a documentação do fabricante e ajuste o playbook para o comando correto | Correção automática: playbooks que resolvem problemas sem in |
| Gráfico não exibe dados | Item SNMP mal configurado ou OID incorreto | Verifique OID e credenciais SNMP; consulte a documentação do fabricante | Dashboards ópticos: gráficos, mapas e telas customizadas |
| Mapa não muda de cor ao disparar trigger | Trigger não vinculada ao elemento do mapa | Edite o mapa e vincule corretamente cada trigger ao host | Dashboards ópticos: gráficos, mapas e telas customizadas |
| Dashboard não atualiza em tempo real | Intervalo de atualização do widget ou item muito alto | Reduza o update interval dos itens e widgets | Dashboards ópticos: gráficos, mapas e telas customizadas |
| Página não carrega ou erro 502 | NetBox não inicializou corretamente ou porta bloqueada | Verifique logs do NetBox e liberação da porta 8080 no firewall | Deploy do NetBox: Docker, Compose e além |
| Erro de autenticação no login | SUPERUSER_PASSWORD incorreta ou não definida | Recrie o container com variáveis corretas no .env | Deploy do NetBox: Docker, Compose e além |
| Erro de conexão ao banco | DB_HOST ou DB_PASSWORD incorretos | Ajuste variáveis no .env e reinicie os serviços | Deploy do NetBox: Docker, Compose e além |
| Hosts não aparecem após discovery. | Range de IP ou SNMP community incorretos. | Revise o range de IP e a configuração SNMP dos equipamentos. | Descoberta automática de OLTs e ONUs via SNMP e Netconf |
| Campos de inventário não são preenchidos. | Macros não configuradas corretamente na action. | Ajuste as macros e teste o discovery manualmente. | Descoberta automática de OLTs e ONUs via SNMP e Netconf |
| Script externo retorna erro. | Permissões ou dependências ausentes no servidor. | Verifique permissões de execução e instale bibliotecas necessárias. | Descoberta automática de OLTs e ONUs via SNMP e Netconf |
| Alertas de ONU disparam mesmo com OLT offline | Dependência de triggers não configurada corretamente | Reveja as dependências nas triggers das ONUs | Desenhando o mapa de monitoramento: topologia e dependências |
| Mapa de rede não muda cor ao ocorrer falha | Trigger não associada ao link ou ao host no mapa | Configure a trigger correta no elemento do mapa | Desenhando o mapa de monitoramento: topologia e dependências |
| Hosts não aparecem no mapa | Host não cadastrado ou não adicionado ao mapa | Adicione o host manualmente no editor de mapas | Desenhando o mapa de monitoramento: topologia e dependências |
| Playbook não coleta logs | Comando incompatível com o equipamento ou falta de permissão SSH | Confirme comandos suportados e permissões de acesso | Diagnóstico automatizado: identificando causas de falha com |
| Arquivos de incidente vazios | Filtro de erro mal configurado | Revise expressões regulares e lógica de filtragem | Diagnóstico automatizado: identificando causas de falha com |
| Logs não são salvos no destino | Caminho inexistente ou permissão insuficiente no servidor | Crie diretórios e ajuste permissões antes de rodar o playbook | Diagnóstico automatizado: identificando causas de falha com |
| ONU não sincroniza | Sem sinal óptico ou ONU não provisionada | Verifique fibra, conectores e reprovisione a ONU | Diagnóstico de falhas em OLT, splitter e ONU |
| LOS em várias ONUs | Falha no splitter principal ou porta PON da OLT | Teste splitter e porta PON; substitua o defeituoso | Diagnóstico de falhas em OLT, splitter e ONU |
| Baixa potência óptica | Conector sujo ou emenda ruim | Limpe conectores e refaça emendas | Diagnóstico de falhas em OLT, splitter e ONU |
| Reinicializações frequentes da ONU | Firmware instável ou alimentação ruim | Atualize firmware e verifique fonte | Diagnóstico de falhas em OLT, splitter e ONU |
| Degradação de throughput | Ruído óptico ou sobrecarga | Reduza split ratio ou revise passivos | Diagnóstico de falhas em OLT, splitter e ONU |
| Sinal óptico baixo ou inexistente em clientes distantes | Split ratio excessivo ou perdas subestimadas | Reduza o split ou otimize a rota óptica | Distribuição e split ratio: como decidir e o que não fazer |
| Oscilação ou queda frequente de ONUs | Margem de potência insuficiente ou splitters em cascata demais | Recalcule as perdas e redivida os splits | Distribuição e split ratio: como decidir e o que não fazer |
| Impossibilidade de expansão sem troca de splitters | Projeto inicial sem previsão de crescimento | Reserve portas e fibras para expansão já no projeto | Distribuição e split ratio: como decidir e o que não fazer |
| Proxy aparece como offline | Conexão de rede ou configuração incorreta | Verifique firewall, parâmetros Server e Hostname no zabbix_proxy.conf | Distribuindo proxies: quando e como dividir a carga |
| Fila de coleta do proxy muito alta | Proxy sobrecarregado ou hardware insuficiente | Redistribua hosts para outros proxies ou aumente recursos do proxy | Distribuindo proxies: quando e como dividir a carga |
| Dados de hosts não aparecem no server | Proxy não está enviando dados ou há erro de autenticação | Cheque logs do proxy e do server para mensagens de erro | Distribuindo proxies: quando e como dividir a carga |
| Fibra sem identificação em campo | Etiqueta ausente ou ilegível | Reetiquetar conforme padrão e atualizar sistema | Documentação, etiquetas e rastreabilidade de fibras |
| Registro digital não bate com conexão física | Alteração não documentada | Corrigir registro e reforçar procedimento de atualização | Documentação, etiquetas e rastreabilidade de fibras |
| Histórico de eventos incompleto | Falta de registro após manutenção | Treinar equipe e revisar processos | Documentação, etiquetas e rastreabilidade de fibras |
| Circuito não aparece na visualização | Terminações de fibra não associadas corretamente | Revise as associações em Connections e ajuste as terminações | Documentando conexões ópticas: cabos, fibras e circuitos |
| Fibra aparece desconectada | Falta de terminação em um dos extremos | Adicione a terminação faltante e vincule à porta correta | Documentando conexões ópticas: cabos, fibras e circuitos |
| Topo logia incompleta no diagrama | Cabos ou portas não cadastrados | Cadastre todos os cabos e portas ópticas envolvidos | Documentando conexões ópticas: cabos, fibras e circuitos |
| Elemento físico não aparece na topologia | Faltou criar ou relacionar o objeto no NetBox | Revise o inventário e adicione o elemento ausente | Documentando uma rede FTTx real: lições do campo |
| Conexão lógica não corresponde à realidade | Erro de mapeamento ou nomenclatura inconsistente | Padronize nomes e revise as ligações | Documentando uma rede FTTx real: lições do campo |
| Dados divergentes entre campo e NetBox | Inventário desatualizado | Atualize imediatamente após intervenções | Documentando uma rede FTTx real: lições do campo |
| Usuário não consegue editar dispositivo | Permissão 'change_device' ausente | Atribuir permissão ao grupo do usuário | Erros frequentes: causas e soluções práticas |
| API retorna 401 Unauthorized | Token inválido ou expirado | Gerar novo token e atualizar integração | Erros frequentes: causas e soluções práticas |
| Cadastro de dispositivo não aparece | Falha de commit no banco | Verificar logs, recadastrar e checar integridade do banco | Erros frequentes: causas e soluções práticas |
| Consultas muito lentas | Falta de índices ou parâmetros de memória baixos | Crie índices adequados e aumente shared_buffers/work_mem | Escalando o inventário: limites e boas práticas |
| Backup muito demorado | Banco grande demais para o hardware atual | Implemente backup incremental ou aumente recursos | Escalando o inventário: limites e boas práticas |
| Erro de espaço em disco | Crescimento não planejado do banco | Aumente partição de dados e revise política de retenção | Escalando o inventário: limites e boas práticas |
| Playbook não encontra variáveis | Variáveis mal posicionadas ou nome de arquivo errado em group_vars/host_vars | Revise nomes e caminhos dos arquivos de variáveis | Estruturando um repositório de automação para GPON/XGS-PON: |
| Arquivo sensível foi versionado por engano | .gitignore ausente ou mal configurado | Adicione o padrão correto ao .gitignore e remova o arquivo do Git | Estruturando um repositório de automação para GPON/XGS-PON: |
| Configuração gerada com valores errados | Templates Jinja2 com variáveis não definidas | Verifique se todas as variáveis usadas no template estão definidas nos arquivos de variáveis | Estruturando um repositório de automação para GPON/XGS-PON: |
| Pods em CrashLoopBackOff | Configuração incorreta ou falta de recursos no cluster | Revise os logs dos pods com 'kubectl logs' e ajuste recursos ou configurações | Ferramentas abertas de próxima geração para PON |
| Não consegue acessar a API REST do VOLTHA | Serviço não exposto ou erro de configuração de rede | Verifique os serviços expostos com 'kubectl get svc -n voltha' e ajuste o acesso | Ferramentas abertas de próxima geração para PON |
| OLT não aparece na lista de dispositivos | Driver OpenOLT não configurado ou OLT incompatível | Confirme a compatibilidade do hardware e revise a configuração do driver | Ferramentas abertas de próxima geração para PON |
| Sinal óptico muito baixo na ONT | Atenuação excessiva por emendas, conectores sujos ou curvatura excessiva | Limpe conectores, refaça emendas e corrija curvas | Fibra óptica: física, tipos e limitações reais |
| Intermitência no link | Microdobras ou raio de curvatura abaixo do mínimo | Reinstale a fibra respeitando o raio mínimo | Fibra óptica: física, tipos e limitações reais |
| Perda total de sinal após splitter | Splitter incompatível ou excesso de splits em cascata | Reduza o número de splits ou troque por modelo adequado | Fibra óptica: física, tipos e limitações reais |
| Dados não aparecem no dashboard | Erro de configuração SNMP ou OID incorreto | Revise a configuração do item e valide o OID com snmpwalk | Fluxo de dados ópticos: do OLT ao dashboard |
| Valores atrasados ou faltando | Banco MySQL sobrecarregado ou coleta lenta | Otimize índices do MySQL e reduza o intervalo de coleta | Fluxo de dados ópticos: do OLT ao dashboard |
| Alarmes não disparam | Trigger mal configurada ou thresholds errados | Ajuste as triggers conforme o valor real de operação | Fluxo de dados ópticos: do OLT ao dashboard |
| Perda elevada após fusão | Clivagem ruim ou sujeira na fibra | Refaça a limpeza e a clivagem, repita a fusão | Fusão, conectorização e certificação óptica: o que não pode |
| Reflexo alto no OTDR | Conector mal montado ou polimento inadequado | Remonte ou repolir o conector | Fusão, conectorização e certificação óptica: o que não pode |
| Sem continuidade no VFL | Fibra rompida ou má fusão | Inspecione o ponto de fusão e refaça se necessário | Fusão, conectorização e certificação óptica: o que não pode |
| Perda total acima do limite | Vários pontos de má fusão ou conectores sujos | Refaça fusões e limpe todos os conectores | Fusão, conectorização e certificação óptica: o que não pode |
| ONU não provisiona | Incompatibilidade OMCI ou configuração incorreta | Verifique logs do OpenOMCI e compatibilidade da ONU com o padrão G.988 | Gerenciamento centralizado: OpenOLT, OpenONU e OpenOMCI |
| Métricas não aparecem no monitoramento | API REST do OpenOLT não está ativa | Confirme se o serviço está rodando e a porta está liberada | Gerenciamento centralizado: OpenOLT, OpenONU e OpenOMCI |
| Falha de comunicação com OLT | Endereço IP ou credenciais incorretas | Revise o arquivo de configuração do OpenOLT | Gerenciamento centralizado: OpenOLT, OpenONU e OpenOMCI |
| Recursos avançados indisponíveis | Limitação do stack aberto ou do hardware | Consulte a documentação do projeto e do fabricante | Gerenciamento centralizado: OpenOLT, OpenONU e OpenOMCI |
| Backup não é salvo ou arquivo está vazio | Comando de extração incorreto ou permissão insuficiente | Revise o comando CLI e as permissões do usuário SSH | Gerenciamento de backup e restore de configurações ópticas c |
| Restore falha com erro de autenticação | Usuário sem permissão para restore ou método de upload não suportado | Ajuste permissões do usuário e valide método de restore suportado | Gerenciamento de backup e restore de configurações ópticas c |
| Hashes não batem após restore | Arquivo corrompido na transferência ou restore parcial | Refaça o backup, revise procedimentos de transferência e restore | Gerenciamento de backup e restore de configurações ópticas c |
| ONU cadastrada não aparece como online | Serial incorreto ou não provisionada corretamente na OLT | Verifique serial, reprovisione e confira logs da OLT | Gerenciamento de grandes volumes de ONUs |
| Inventário externo desatualizado | Falha na sincronização automática | Revise scripts de sincronização e agendamento | Gerenciamento de grandes volumes de ONUs |
| Alarme de potência óptica fora do padrão | Problema físico na fibra ou conector | Realize inspeção óptica e medições com OTDR | Gerenciamento de grandes volumes de ONUs |
| Execução do playbook trava ou demora excessivamente | forks alto demais para a capacidade do servidor ou dos equipamentos | Reduza o valor de forks e aumente o serial | Gerenciando concorrência e limites de execução: forks, seria |
| Equipamentos recusam conexões SSH/SNMP | Limite de sessões simultâneas foi excedido | Diminua forks e serial, insira pausas | Gerenciando concorrência e limites de execução: forks, seria |
| Links de gerenciamento saturados | Muitos backups ou upgrades simultâneos | Aumente o intervalo entre lotes e reduza o paralelismo | Gerenciando concorrência e limites de execução: forks, seria |
| Falhas intermitentes em tarefas | Sobrecarga temporária dos equipamentos | Implemente throttling com pause e serial | Gerenciando concorrência e limites de execução: forks, seria |
| Playbook trava ou demora muito para terminar | forks alto demais para a capacidade do servidor | Reduza o valor de forks e monitore novamente | Gerenciando milhares de dispositivos: performance, limites e |
| Muitos hosts falham por timeout | timeout baixo demais para a latência da rede | Aumente o timeout gradualmente até encontrar o ponto ideal | Gerenciando milhares de dispositivos: performance, limites e |
| Erro de parsing no inventário | Arquivos de inventário mal formatados ou muito grandes | Reparta o inventário e valide o formato de cada arquivo | Gerenciando milhares de dispositivos: performance, limites e |
| Alertas não chegam para o operador de plantão | Horário de atendimento mal configurado no User Media | Ajuste o campo 'When active' para cobrir o turno correto | Gestão de alertas: da centralização ao rodízio de plantão |
| Alertas duplicados para vários operadores | Action configurada para múltiplos grupos ou usuários individuais | Revise as Operations da Action para enviar apenas ao grupo desejado | Gestão de alertas: da centralização ao rodízio de plantão |
| Triggers disparam em excesso | Limiar muito baixo ou condição mal definida | Ajuste o limiar ou use funções como avg(), min(), max() para suavizar | Gestão de alertas: da centralização ao rodízio de plantão |
| Alterações não aparecem no changelog | Possível cache do navegador ou erro na configuração de logging | Limpe o cache e revise configurações em extras/object-changes | Gestão de mudanças e versionamento do inventário |
| Rollback falha com erro de permissão | Usuário do banco sem permissão de restauração | Conceda permissão adequada ao usuário no PostgreSQL | Gestão de mudanças e versionamento do inventário |
| Integração ITSM não executa mudanças | Token de API inválido ou endpoint incorreto | Gere novo token e confira URL da API | Gestão de mudanças e versionamento do inventário |
| Usuário não consegue acessar determinada funcionalidade | Permissão não atribuída ao grupo ou usuário | Revise as permissões do grupo e do usuário | Gestão de usuários, grupos e permissões |
| Usuário consegue editar objetos que deveria apenas visualizar | Permissões excessivas atribuídas | Remova permissões 'change' e 'add' do grupo ou usuário | Gestão de usuários, grupos e permissões |
| Token de API não permite operações esperadas | Token associado a usuário sem as permissões necessárias | Verifique permissões do usuário e gere novo token se necessário | Gestão de usuários, grupos e permissões |
| ONU não autentica na OLT | Configuração OMCI incompatível ou erro de serial | Revise o provisionamento OMCI e o cadastro do serial da ONU. | GPON e XGS-PON segundo a ITU-T: padrões e topologias |
| Sinal óptico baixo nas ONUs | Divisão excessiva ou conectores sujos | Reduza o número de divisões ou limpe os conectores. | GPON e XGS-PON segundo a ITU-T: padrões e topologias |
| Banda entregue abaixo do contratado | Divisão acima do limite ou perda óptica excessiva | Redimensione os splitters e refaça a medição óptica. | GPON e XGS-PON segundo a ITU-T: padrões e topologias |
| Interface web inacessível mesmo de IP autorizado | Erro na configuração de restrição de IP ou firewall bloqueando acesso | Revise as regras do servidor web e firewall, teste com 'curl' localmente | Hardening do Zabbix Server e Proxy: acessos, logs e firewall |
| Zabbix Server não inicia | Permissões excessivamente restritivas nos arquivos de configuração | Permita leitura ao usuário zabbix (chmod 640), confira o dono do arquivo | Hardening do Zabbix Server e Proxy: acessos, logs e firewall |
| Portas 10051/10050 visíveis para toda a internet | Firewall não configurado corretamente ou regras aplicadas na ordem errada | Reordene as regras do firewall, use 'iptables -L -n' para depurar | Hardening do Zabbix Server e Proxy: acessos, logs e firewall |
| Logs do Zabbix vazios | Permissões erradas no diretório de logs | Ajuste para 750 e garanta que o usuário zabbix tenha acesso | Hardening do Zabbix Server e Proxy: acessos, logs e firewall |
| Itens SNMP retornam 'Timeout' ou 'No Such Object' | OID incorreto ou SNMP desabilitado na OLT | Confirme OID com snmpwalk e habilite SNMP no equipamento | Implantação em rede FTTH: do zero ao NOC operando |
| Alarmes de potência óptica acionam sem motivo | Limite de trigger inadequado ou ruído na medição | Ajuste o trigger com base em valores reais e use histerese | Implantação em rede FTTH: do zero ao NOC operando |
| Discovery de ONUs não encontra todos os dispositivos | OID de discovery incompleto ou polling insuficiente | Revise o OID e aumente o intervalo de polling | Implantação em rede FTTH: do zero ao NOC operando |
| Zabbix sobrecarrega a OLT com requisições | Intervalo de coleta muito curto | Aumente o intervalo de coleta SNMP | Implantação em rede FTTH: do zero ao NOC operando |
| Perda óptica acima do esperado em um trecho | Conector sujo ou emenda malfeita | Limpar conectores e refazer emendas | Implantação FTTx em área urbana: desafios e soluções |
| Impossibilidade de lançar cabo em poste planejado | Poste saturado ou restrição legal | Redesenhar rota e solicitar autorização adicional | Implantação FTTx em área urbana: desafios e soluções |
| Atraso no cronograma de obra | Licenças não liberadas ou interferências não mapeadas | Negociar prioridades com órgãos públicos e ajustar planejamento | Implantação FTTx em área urbana: desafios e soluções |
| Falha ao rodar 'ansible -m ping' | Chave SSH não copiada ou permissões erradas | Revise o ssh-copy-id e chmod nos arquivos de chave | Instalando Ansible e dependências para automação de redes óp |
| Erro 'ModuleNotFoundError: No module named netmiko' | Netmiko não instalado no Python usado | Instale Netmiko com o pip correto e cheque o PATH | Instalando Ansible e dependências para automação de redes óp |
| Permissão negada ao conectar por SSH | Usuário ou senha incorretos, ou SSH desabilitado no destino | Revise usuário, permissões e status do serviço SSH | Instalando Ansible e dependências para automação de redes óp |
| O serviço zabbix-server não inicia | Banco de dados inacessível ou senha errada | Verifique as credenciais e a conectividade com o banco | Instalando Zabbix Server, Proxy e Agent em Linux |
| Frontend web exibe erro de conexão ao banco | Configuração incorreta no arquivo de frontend | Edite o arquivo de configuração do frontend e ajuste as credenciais | Instalando Zabbix Server, Proxy e Agent em Linux |
| Agent não responde ao zabbix_get | Firewall bloqueando porta 10050/TCP | Libere a porta no firewall ou ajuste o parâmetro ListenPort | Instalando Zabbix Server, Proxy e Agent em Linux |
| Hosts aparecem duplicados no Zabbix | Script de sincronização não verifica existência prévia do host. | Implemente checagem via API antes de criar hosts. | Integração com OSS/BSS: como evitar retrabalho e alarmes dup |
| Alarmes continuam duplicados | Triggers ou actions não consideram status do host ou contexto do evento. | Refine as triggers e actions para filtrar por status e criticidade. | Integração com OSS/BSS: como evitar retrabalho e alarmes dup |
| OSS/BSS recebe alarmes de equipamentos desativados | Sincronização de inventário falha ou campo de status ignorado. | Corrija o script para remover/desabilitar hosts desativados. | Integração com OSS/BSS: como evitar retrabalho e alarmes dup |
| OSS não mostra todas as ONUs conectadas | MIB SNMP incompleta ou filtro incorreto na consulta | Revise a MIB usada e ajuste a consulta SNMP para cobrir todas as tabelas relevantes | Integração com OSS/BSS: padrões e APIs abertas |
| Provisionamento remoto via TR-069 falha | ACS não acessível ou ONU sem suporte completo ao protocolo | Verifique logs do ACS e firmware da ONU; atualize se necessário | Integração com OSS/BSS: padrões e APIs abertas |
| Dados divergentes entre OSS e OLT | Mudanças manuais não sincronizadas | Implemente reconciliação periódica entre OSS e equipamentos | Integração com OSS/BSS: padrões e APIs abertas |
| Erro 400 ao criar dispositivo | Campo obrigatório ausente ou valor inválido (ex: site inexistente) | Verifique se todos os campos obrigatórios estão corretos e se o site existe no NetBox | Integração NetBox + sistemas legados: superando obstáculos |
| Dispositivo duplicado após sincronização | Falta de verificação prévia de existência | Implemente filtro por serial ou hostname antes de criar | Integração NetBox + sistemas legados: superando obstáculos |
| Dados divergentes entre sistemas após integração | Regras de precedência não definidas ou script não cobre todos os campos | Defina sistema mestre e revise o mapeamento de campos | Integração NetBox + sistemas legados: superando obstáculos |
| Relatório aponta erro inexistente | Script com lógica errada ou filtro inadequado | Revise o script, valide os filtros e teste em ambiente de homologação | Integridade do inventário: validação e consistência |
| Equipamento não aparece em relatório | Permissões insuficientes ou erro de escopo no script | Ajuste permissões e revise a query | Integridade do inventário: validação e consistência |
| Alteração não registrada no histórico | Atualização feita fora da interface ou API oficial | Sempre use métodos suportados pelo NetBox para alterações | Integridade do inventário: validação e consistência |
| Não encontro um cabo no inventário | Cadastro incompleto ou desatualizado | Revise o mapeamento físico e atualize o inventário | Inventário em redes ópticas: por que o caos custa caro |
| Conexão lógica não bate com o físico | Erro de documentação ou mudança não registrada | Audite as conexões em campo e corrija os registros | Inventário em redes ópticas: por que o caos custa caro |
| Dados divergentes entre sistemas | Falta de centralização | Unifique a documentação em uma única ferramenta | Inventário em redes ópticas: por que o caos custa caro |
| Auditoria aponta ativos sem rastreio | Inventário incompleto | Mapeie e registre todos os ativos faltantes | Inventário em redes ópticas: por que o caos custa caro |
| Equipamento não aparece no Zabbix | IP ou hostname errado no inventário | Corrija o CSV e reimporte o host | Inventário óptico: o que e como monitorar |
| Dados SNMP não coletados | OID incorreto ou SNMP community inválida | Confirme OID e community, teste com snmpwalk | Inventário óptico: o que e como monitorar |
| Alertas em excesso para ativos de baixa prioridade | Priorização mal definida | Revise a classificação dos ativos e ajuste triggers | Inventário óptico: o que e como monitorar |
| Falha de conexão SSH | IP ou usuário incorreto no inventário | Revise ansible_host e ansible_user. | Inventário, módulos e playbooks: como o Ansible organiza a a |
| Erro de autenticação | Senha errada ou método de autenticação incompatível | Atualize ansible_password ou configure chave SSH. | Inventário, módulos e playbooks: como o Ansible organiza a a |
| Módulo não encontrado | Coleção Ansible.netcommon ausente | Instale com 'ansible-galaxy collection install ansible.netcommon'. | Inventário, módulos e playbooks: como o Ansible organiza a a |
| ONU conecta mas não navega | VLAN incorreta ou não atribuída | Revise o cadastro da ONU e a configuração da VLAN | Isolamento de tráfego e autenticação de ONUs |
| ONU não autentica | Serial ou MAC divergente do cadastro | Verifique e corrija o serial/MAC cadastrado | Isolamento de tráfego e autenticação de ONUs |
| Clientes recebem tráfego de outros | Isolamento de porta não ativado | Ative port-isolate na interface GPON/XGS-PON | Isolamento de tráfego e autenticação de ONUs |
| ONU aparece como desconhecida | Cadastro ausente ou erro de digitação | Atualize o cadastro e reinicie a ONU | Isolamento de tráfego e autenticação de ONUs |
| Itens ficam 'not supported' após atualização | OID mudou ou permissões SNMP/Netconf alteradas | Atualize OIDs e revise credenciais nos equipamentos | Logs do Zabbix, SNMP e Netconf: onde procurar e o que signif |
| Logs mostram 'Timeout' em SNMP | Firewall, ACL ou equipamento lento | Verifique regras de firewall e desempenho do equipamento | Logs do Zabbix, SNMP e Netconf: onde procurar e o que signif |
| Netconf reporta 'session closed unexpectedly' | Timeout ou erro de autenticação | Revise usuário, senha e permissões Netconf | Logs do Zabbix, SNMP e Netconf: onde procurar e o que signif |
| Lentidão ao listar dispositivos | Query SQL sem índice ou tabela inflada | Crie índice após analisar com EXPLAIN, limpe dados obsoletos. | Logs e diagnóstico avançado: indo além do óbvio |
| Erro 500 em endpoint API | Exceção não tratada no Django | Analise stack trace no log, corrija configuração ou reporte bug. | Logs e diagnóstico avançado: indo além do óbvio |
| Timeout em integração externa | Latência de rede ou throttling no proxy | Trace requisições, ajuste timeout ou revise proxy. | Logs e diagnóstico avançado: indo além do óbvio |
| ONU não volta após atualização | Firmware incompatível ou processo interrompido | Reinstale firmware compatível via modo de recuperação | Manutenção preventiva e atualização de firmware |
| Alarme de baixa potência óptica | Conector sujo ou fibra danificada | Inspecione, limpe e, se necessário, substitua o componente | Manutenção preventiva e atualização de firmware |
| Configuração perdida após atualização | Backup não restaurado corretamente | Restaure o backup antes de operar em produção | Manutenção preventiva e atualização de firmware |
| Potência RX fora da faixa | Atenuação excessiva, sujeira ou rompimento de fibra | Inspecione conectores, limpe fibras e meça atenuação ponto a ponto | Métricas essenciais: potência, BER e status óptico |
| BER elevado mesmo com potência adequada | Reflexão, ruído óptico ou má qualidade de fibra | Verifique conectores, emendas e fontes de ruído | Métricas essenciais: potência, BER e status óptico |
| Alarme LOS constante | Falha total no enlace óptico | Teste continuidade da fibra e substitua trechos danificados | Métricas essenciais: potência, BER e status óptico |
| Status óptico intermitente | Conector mal encaixado ou fibra instável | Reencaixe conectores e estabilize cabos | Métricas essenciais: potência, BER e status óptico |
| Buscas por dispositivos demoram vários segundos | Falta de índice nos campos filtrados | Crie índices nos campos usados nos filtros | Modelagem de dados: evitando armadilhas de performance |
| Registros duplicados de dispositivos | Falta de constraint de unicidade | Adicione constraints UNIQUE nos campos críticos | Modelagem de dados: evitando armadilhas de performance |
| Erros de integridade referencial ao importar dados | Dados referenciam registros inexistentes | Valide existência dos relacionamentos antes de importar | Modelagem de dados: evitando armadilhas de performance |
| Banco cresce rápido e fica lento | Acúmulo de dados obsoletos | Implemente políticas de limpeza e arquivamento | Modelagem de dados: evitando armadilhas de performance |
| Dispositivo não aparece com o role correto | Role não cadastrado ou não atribuído ao device | Cadastre o Device Role e edite o dispositivo para associar | Modelando dispositivos ópticos: tipos, roles e templates |
| Campos ópticos não aparecem no formulário | Custom Field não associado ao objeto Device | Edite o Custom Field e associe ao modelo correto | Modelando dispositivos ópticos: tipos, roles e templates |
| Erro ao importar CSV | Device Type ou Role inexistente ou nome incorreto | Verifique nomes exatos e cadastre previamente | Modelando dispositivos ópticos: tipos, roles e templates |
| Trace não mostra o caminho completo | Conexão física ausente ou mal configurada | Revise cables e terminations entre devices. | Modelando redes FTTx: entidades e relações essenciais |
| Device não aparece no rack | Device não foi associado corretamente ao rack | Edite o device e selecione o rack correto. | Modelando redes FTTx: entidades e relações essenciais |
| Não é possível criar cable entre portas | Interfaces não compatíveis ou não criadas | Verifique se as interfaces existem e estão corretas nos device types. | Modelando redes FTTx: entidades e relações essenciais |
| Variáveis não são aplicadas corretamente | Variáveis definidas em vars/ em vez de defaults/ | Mova variáveis sobrescrevíveis para defaults/main.yml | Modularização com roles: como evitar playbooks monolíticos e |
| Task não executa para determinado modelo | Condição de include_tasks mal definida | Revise a lógica de seleção de tasks e valores de variáveis | Modularização com roles: como evitar playbooks monolíticos e |
| Configuração gerada com sintaxe errada | Template Jinja2 não cobre todos os casos de fabricante | Inclua condicionais para todos os modelos suportados | Modularização com roles: como evitar playbooks monolíticos e |
| Dispositivo não aparece no LibreNMS | SNMP desabilitado ou bloqueado por firewall | Habilite SNMP e ajuste regras de firewall | Monitoramento contínuo com LibreNMS e Grafana |
| Métricas de potência não são coletadas | MIB não suportada ou community incorreta | Verifique suporte SNMP do equipamento e ajuste a configuração | Monitoramento contínuo com LibreNMS e Grafana |
| Alertas não chegam por e-mail | Configuração SMTP incorreta | Revise parâmetros SMTP e teste envio manual | Monitoramento contínuo com LibreNMS e Grafana |
| Dashboards do Grafana sem dados | Integração mal configurada | Revise a conexão do plugin LibreNMS Data Source | Monitoramento contínuo com LibreNMS e Grafana |
| NetBox não responde na porta 8000 | Serviço parado ou erro de configuração | Reinicie o serviço e verifique logs de erro | Monitorando o NetBox: métricas essenciais e alertas |
| Alertas de uso de disco mesmo após limpeza | Tabelas de PostgreSQL não liberaram espaço | Execute VACUUM FULL nas tabelas grandes | Monitorando o NetBox: métricas essenciais e alertas |
| Muitos erros 500 no log | Falha de integração ou banco indisponível | Verifique conectividade com PostgreSQL e revise integrações | Monitorando o NetBox: métricas essenciais e alertas |
| Alertas de conexão excedida no PostgreSQL | Limite de conexões muito baixo | Ajuste max_connections conforme recomendado na documentação | Monitorando o NetBox: métricas essenciais e alertas |
| Banco de dados crescendo sem parar | Housekeeping desativado ou mal configurado | Ative e ajuste o housekeeping no zabbix_server.conf | MySQL e storage: quanto espaço o histórico óptico consome |
| Consultas e gráficos lentos | Histórico excessivo, tabelas grandes demais | Reduza a retenção e otimize índices | MySQL e storage: quanto espaço o histórico óptico consome |
| Housekeeping trava o banco | MaxHousekeeperDelete muito alto | Reduza o valor e aumente a frequência | MySQL e storage: quanto espaço o histórico óptico consome |
| Plugin não aparece no menu | Plugin não listado em PLUGINS ou erro de instalação | Revise o configuration.py e reinstale o plugin | NetBox e redes ópticas: além do inventário |
| Erro 403 ao acessar API | Token de autenticação inválido ou permissões insuficientes | Gere novo token e ajuste permissões do usuário | NetBox e redes ópticas: além do inventário |
| Topologia não mostra conexões | Dados de conexões incompletos no inventário | Revise e complete os cabos e terminais no NetBox | NetBox e redes ópticas: além do inventário |
| Respostas HTTP lentas após ajuste de workers | Workers demais estão causando swap ou sobrecarga de CPU. | Reduza o número de workers e monitore novamente. | NetBox em larga escala: tuning e balanceamento |
| Erros de conexão ao banco | max_connections do PostgreSQL insuficiente. | Aumente max_connections e reinicie o serviço. | NetBox em larga escala: tuning e balanceamento |
| Redis começa a swapar ou trava | maxmemory mal configurado ou falta de política de descarte. | Ajuste maxmemory e defina política allkeys-lru. | NetBox em larga escala: tuning e balanceamento |
| Instância NetBox cai sob carga alta | Falta de balanceamento de carga ou workers insuficientes. | Implemente balanceador e aumente workers conforme capacidade. | NetBox em larga escala: tuning e balanceamento |
| Device não aparece no site correto | Associação incorreta do campo 'site' no cadastro | Edite o device e selecione o site correto | NetBox: domínio público para inventário e topologia |
| Cable não conecta portas esperadas | IDs de terminação errados ou tipos incompatíveis | Verifique os IDs das interfaces e o tipo do cable | NetBox: domínio público para inventário e topologia |
| Erro de permissão ao usar API | Token de autenticação inválido ou ausente | Gere um novo token e inclua no header Authorization | NetBox: domínio público para inventário e topologia |
| O item retorna valor nulo ou erro | Script Python falhou ao conectar ou extrair valor | Verifique logs do script e conectividade SSH com o equipamento | Netconf e modelos YANG: monitorando além do SNMP |
| Permissão negada ao rodar o script | Permissões incorretas no arquivo ou usuário do Zabbix | Ajuste permissões e teste manualmente com o mesmo usuário | Netconf e modelos YANG: monitorando além do SNMP |
| Valores inconsistentes entre Zabbix e CLI do equipamento | Filtro YANG incorreto ou modelo desatualizado | Revise o filtro XML e consulte a documentação do modelo YANG implementado | Netconf e modelos YANG: monitorando além do SNMP |
| ONU não registra na OLT | Serial number incorreto ou incompatibilidade de perfil | Verifique o serial e o perfil configurado; ajuste conforme documentação | NG-PON2, 25G PON e além: o que muda nos próximos anos |
| Throughput abaixo do esperado | Atenuação excessiva ou interferência espectral | Meça o orçamento óptico e revise filtros WDM | NG-PON2, 25G PON e além: o que muda nos próximos anos |
| Falha de coexistência com GPON/XGS-PON | Sobreposição de comprimentos de onda | Replaneje o espectro e ajuste filtros | NG-PON2, 25G PON e além: o que muda nos próximos anos |
| Playbook não executa após evento | Integração entre sistema de eventos e Ansible falhou | Verifique logs do handler e se o evento está sendo recebido corretamente | O futuro da automação: integração de IA, auto-remediação e p |
| Ação corretiva causa falha em outro serviço | Playbook sem validação de dependências | Inclua checagens e condições no playbook para evitar efeitos colaterais | O futuro da automação: integração de IA, auto-remediação e p |
| Modelo de IA sugere ações erradas | Dados de treinamento insuficientes ou enviesados | Reavalie o dataset e os critérios de avaliação do modelo | O futuro da automação: integração de IA, auto-remediação e p |
| Erro de autenticação SSH | Usuário ou senha incorretos no inventário | Verifique e corrija as credenciais | O que é Ansible e por que ele domina a automação de redes |
| Módulo não encontrado | Coleção Ansible não instalada | Instale com 'ansible-galaxy collection install cisco.ios' | O que é Ansible e por que ele domina a automação de redes |
| Tarefa sempre marcada como 'changed' | Módulo não implementa idempotência corretamente | Consulte a documentação do módulo e atualize se necessário | O que é Ansible e por que ele domina a automação de redes |
| ONU não aparece online | Serial number não cadastrado ou perda óptica excessiva | Verifique cadastro na OLT e medições de potência óptica | OLT, splitter e ONU: funções e fluxos de dados na prática |
| Baixa velocidade de upstream | Divisão excessiva no splitter ou DBA mal configurado | Reduza a divisão ou ajuste parâmetros de DBA na OLT | OLT, splitter e ONU: funções e fluxos de dados na prática |
| Desconexões intermitentes | Conectores sujos ou mal encaixados | Limpe e reconecte todos os conectores ópticos | OLT, splitter e ONU: funções e fluxos de dados na prática |
| Sinal óptico abaixo do esperado na ONU/ONT | Perda excessiva por sujeira ou má conexão | Limpe conectores, refaça fusões e verifique splitters | Orçamento de potência: cálculo e impacto no alcance |
| Variação grande entre cálculo e medição real | Erro na contagem de elementos ou uso de valores de perda inadequados | Revise o projeto e confira datasheets e padrões | Orçamento de potência: cálculo e impacto no alcance |
| ONU/ONT não sincroniza mesmo com potência dentro do limite | Margem de segurança insuficiente para compensar variações ambientais | Aumente a margem e reavalie o split ratio | Orçamento de potência: cálculo e impacto no alcance |
| Task falha com rc diferente de 0 | Erro no script Python ou parâmetros incorretos | Revise o script e os argumentos passados | Orquestração com Python: quando e como estender Ansible além |
| Saída do script não aparece no debug | Script não imprime em stdout ou erro de permissão | Garanta que o script usa print() e tem permissão de execução | Orquestração com Python: quando e como estender Ansible além |
| Script não encontrado no host remoto | Módulo command usado em vez de script, ou caminho incorreto | Use o módulo script e verifique o caminho do arquivo | Orquestração com Python: quando e como estender Ansible além |
| Logs ausentes ou incompletos | Script não implementa logging adequado | Implemente logging no script Python com arquivo dedicado | Orquestração com Python: quando e como estender Ansible além |
| Variável de saída vazia | Script não retorna saída esperada ou erro de encoding | Garanta que o script retorna JSON ou texto legível | Orquestração com Python: quando e como estender Ansible além |
| Rollback não executa após falha de teste | Bloco rescue não implementado corretamente ou erro fora do bloco block | Garanta que todas as tarefas críticas estejam dentro de block/rescue | Orquestração ponta a ponta: provisionamento, configuração e |
| Handler não dispara mesmo após alteração | notify ausente ou nome do handler incorreto | Verifique se notify está presente e o nome do handler bate com a notificação | Orquestração ponta a ponta: provisionamento, configuração e |
| Testes pós-configuração passam mesmo com erro real | failed_when mal configurado ou comando de teste inadequado | Ajuste o failed_when e revise o comando de teste para cobrir o caso real | Orquestração ponta a ponta: provisionamento, configuração e |
| OTDR não mostra eventos após splitter | Razão de split alta ou range insuficiente | Aumente a potência do pulso e verifique se o range cobre todo o enlace | OTDR: leitura, interpretação e limitações |
| Eventos próximos aparecem como um só | Largura de pulso excessiva | Reduza a largura do pulso para aumentar a resolução | OTDR: leitura, interpretação e limitações |
| Traço plano após poucos metros | Quebra de fibra ou conector desconectado | Inspecione fisicamente o enlace e reconecte se necessário | OTDR: leitura, interpretação e limitações |
| Ativos com nomes diferentes para o mesmo local | Padrão de nomenclatura não seguido ou não documentado | Revisar e renomear ativos conforme o padrão | Padronização de nomenclatura e documentação |
| Campos obrigatórios em branco | Cadastro incompleto ou falta de validação | Atualizar registros e reforçar rotina de revisão | Padronização de nomenclatura e documentação |
| Tags inconsistentes ou duplicadas | Falta de lista padronizada de tags | Padronizar e revisar todas as tags existentes | Padronização de nomenclatura e documentação |
| ansible-lint retorna erro de indentação | Uso de tabs ou espaços inconsistentes | Corrija a indentação para 2 espaços, sem tabs | Padronização de playbooks: estilo, nomeação e documentação q |
| Variáveis sobrescrevendo valores inesperados | Nomes genéricos ou repetidos entre roles | Renomeie variáveis com prefixos de contexto | Padronização de playbooks: estilo, nomeação e documentação q |
| Dificuldade em entender propósito de uma task | Nome ou documentação insuficiente | Renomeie a task e adicione comentário explicativo | Padronização de playbooks: estilo, nomeação e documentação q |
| Ativo não aparece no site correto | Associação incorreta ao criar o device | Edite o device e selecione o site correto. | Planejamento do inventário: da OLT ao assinante |
| Conexão óptica não aparece no diagrama | Interfaces não cadastradas ou cabo não criado | Revise as interfaces e crie o cabo entre elas. | Planejamento do inventário: da OLT ao assinante |
| Nomes duplicados ou confusos | Falta de padrão ou erro manual | Reveja o padrão de nomenclatura e corrija os nomes. | Planejamento do inventário: da OLT ao assinante |
| Configuração divergente após automação | Playbook ou script com parâmetros diferentes para cada equipamento | Revisar variáveis e inventário do Ansible para garantir padronização | Por que automatizar operações em redes ópticas: limites do m |
| Falha ao aplicar configuração em alguns switches | Modelos ou versões de firmware diferentes | Ajustar playbooks para tratar diferenças de sintaxe | Por que automatizar operações em redes ópticas: limites do m |
| Rollback não funciona | Backups não estavam atualizados | Automatizar backup antes de qualquer alteração | Por que automatizar operações em redes ópticas: limites do m |
| Execução lenta dos scripts | Execução sequencial em vez de paralela | Configurar forks no Ansible para paralelismo | Por que automatizar operações em redes ópticas: limites do m |
| Não recebe alertas de falha | Triggers mal configuradas ou ausência de coleta SNMP | Revise as triggers e teste a coleta SNMP manualmente | Por que monitorar redes ópticas: falhas, SLA e visibilidade |
| Dados de potência óptica não aparecem | OID SNMP incorreto ou permissão insuficiente | Consulte a documentação do fabricante e ajuste a comunidade SNMP | Por que monitorar redes ópticas: falhas, SLA e visibilidade |
| Alertas de falso positivo | Limiares de trigger muito sensíveis | Ajuste os valores de trigger conforme recomendação do fabricante | Por que monitorar redes ópticas: falhas, SLA e visibilidade |
| Playbook falha ao conectar na OLT | Chave SSH ausente ou permissões incorretas | Verifique o caminho e permissões do arquivo de chave SSH | Primeiro playbook real: provisionando uma ONU remotamente po |
| ONU não aparece como Online | Comando de adição falhou ou parâmetros errados | Revise serial, slot, pon e onu_id; repita o comando manualmente | Primeiro playbook real: provisionando uma ONU remotamente po |
| Erro de sintaxe no playbook | YAML mal formatado | Valide o arquivo com 'yamllint' ou consulte yaml.org/spec | Primeiro playbook real: provisionando uma ONU remotamente po |
| Cliente sem acesso à internet, mas IPTV funciona | VLAN de internet não mapeada corretamente na ONU | Revisar mapeamento de VLAN na ONU e OLT | Profiles, VLANs e QoS: configurando serviços em GPON/XGS-PON |
| Vazamento de tráfego entre clientes | VLANs configuradas de forma global em vez de por porta | Isolar VLANs por porta lógica conforme OMCI | Profiles, VLANs e QoS: configurando serviços em GPON/XGS-PON |
| VoIP com latência alta | QoS não aplicada ou prioridade baixa para VLAN de voz | Ajustar prioridade de QoS para a VLAN correspondente | Profiles, VLANs e QoS: configurando serviços em GPON/XGS-PON |
| ONU não sincroniza após expansão | Perda óptica excessiva por splitters ou conectores | Recalcule o orçamento de potência e reduza perdas | Projetando para expansão: splitters, fibras e OLTs |
| Porta OLT cheia, sem possibilidade de ativar mais clientes | Falta de planejamento de slots ou placas | Adicione nova placa ou distribua clientes em outra OLT | Projetando para expansão: splitters, fibras e OLTs |
| Falta de fibras disponíveis para novos splitters | Não reserva de fibras escuras no projeto inicial | Reveja o cabeamento ou planeje expansão física | Projetando para expansão: splitters, fibras e OLTs |
| Confusão na identificação de fibras após expansão | Documentação desatualizada | Atualize mapas e etiquetas imediatamente | Projetando para expansão: splitters, fibras e OLTs |
| Backup falha com erro de permissão | Usuário do cron ou do comando não tem acesso à pasta de backup | Ajuste permissões da pasta /var/backups para o usuário responsável | Protegendo dados críticos: backups e criptografia |
| HTTPS não sobe no Nginx | Certificado ou chave inválidos ou caminho incorreto | Cheque caminhos, permissões e validade do certificado | Protegendo dados críticos: backups e criptografia |
| Restauração falha com erro de conexão | Banco de destino não existe ou credenciais erradas | Crie o banco antes e valide usuário/senha | Protegendo dados críticos: backups e criptografia |
| Erro 'Decryption failed' | Senha do Vault incorreta ou arquivo corrompido | Verifique a senha e o estado do arquivo Vault. | Protegendo segredos com Ansible Vault: do básico ao uso em p |
| Playbook pede senha mas não aceita | Arquivo de senha com permissões erradas ou conteúdo inválido | Corrija permissões (chmod 600) e revise o conteúdo. | Protegendo segredos com Ansible Vault: do básico ao uso em p |
| Variável sensível vazia no destino | Variável não foi carregada corretamente do Vault | Confirme o caminho em vars_files e o nome da variável. | Protegendo segredos com Ansible Vault: do básico ao uso em p |
| ONU não aparece na lista da OLT | Serial ou porta incorretos no inventário | Verifique e corrija os dados no arquivo YAML/CSV. | Provisionamento automatizado: scripts e templates livres |
| Erro de autenticação SSH | Usuário ou senha inválidos no playbook | Atualize as credenciais no arquivo de variáveis. | Provisionamento automatizado: scripts e templates livres |
| Comando não reconhecido na OLT | Template incompatível com o modelo da OLT | Consulte a documentação da OLT e ajuste o template. | Provisionamento automatizado: scripts e templates livres |
| Trigger nunca dispara mesmo com valor crítico | Expressão lógica invertida ou threshold incorreto | Corrija a expressão da trigger para refletir a condição real | Quando o Zabbix não alerta: triggers, permissões e traps |
| Usuário não recebe alerta | Permissão insuficiente ou mídia desativada | Adicione o usuário ao grupo correto e ative a mídia | Quando o Zabbix não alerta: triggers, permissões e traps |
| SNMP trap não gera evento | snmptrapd não está recebendo ou processando traps | Revise configuração do snmptrapd e permissões do arquivo de traps | Quando o Zabbix não alerta: triggers, permissões e traps |
| Coleta atrasada ou dados faltando | Proxy sobrecarregado ou intervalo de coleta curto demais | Reduza o número de hosts por proxy ou aumente o intervalo de coleta | Quantos hosts, quantos proxies? O cálculo que evita gargalo |
| Proxy desconectando do server | Problema de rede ou configuração incorreta do Server | Verifique IP e porta no arquivo de configuração e conectividade | Quantos hosts, quantos proxies? O cálculo que evita gargalo |
| Alto uso de CPU/RAM no server | Itens ou hosts demais para o hardware disponível | Adicione proxies, otimize queries ou aumente recursos do server | Quantos hosts, quantos proxies? O cálculo que evita gargalo |
| Porta OLT esgotada antes do previsto | Reserva insuficiente ou crescimento acima do planejado | Revisar projeções e aumentar a margem de reserva | Reserva de portas, fibras e splitters: estratégias para cres |
| Saturação de splitters em determinada região | Falta de splitters reserva ou dimensionamento inadequado | Instalar splitters adicionais e revisar a estratégia de reserva | Reserva de portas, fibras e splitters: estratégias para cres |
| Potência óptica insuficiente na ONU após expansão | Excesso de splitters ou fibras sem ajuste no orçamento de potência | Reduzir split ratio ou otimizar a rota óptica | Reserva de portas, fibras e splitters: estratégias para cres |
| ONU não volta a registrar após correção física | Provisionamento inconsistente ou ONU travada | Reprovisionar a ONU na OLT | Resolução de falhas críticas: do OTDR ao provisionamento |
| LOS em todas as ONUs de uma porta | Rompimento de fibra ou desconexão na OLT | Verificar cabeamento e testar com OTDR | Resolução de falhas críticas: do OTDR ao provisionamento |
| BER elevado em uma ONU específica | Conector sujo ou macrocurvatura no drop | Limpar conectores e reposicionar cabo | Resolução de falhas críticas: do OTDR ao provisionamento |
| Erro 401 Unauthorized | Token ausente ou inválido | Verifique o header Authorization e gere novo token se necessário | REST API do NetBox: lendo e escrevendo dados |
| Erro 403 Forbidden | Permissões insuficientes para o usuário | Ajuste as permissões do usuário ou grupo no NetBox | REST API do NetBox: lendo e escrevendo dados |
| Erro 400 Bad Request ao criar dispositivo | IDs de device_type, device_role ou site inválidos | Confirme os IDs consultando os endpoints correspondentes | REST API do NetBox: lendo e escrevendo dados |
| Retorno vazio ao filtrar dispositivos | Filtro com ID inexistente ou sem dispositivos cadastrados | Verifique se o ID está correto e se há objetos cadastrados | REST API do NetBox: lendo e escrevendo dados |
| Recebe 'Not authorized' ao chamar métodos da API | Token auth inválido ou expirado | Refaça o login via user.login e atualize o token | REST API do Zabbix: automação e integração bidirecional |
| Eventos não aparecem na consulta problem.get | Parâmetros de filtro inadequados ou falta de permissões | Revise os parâmetros e permissões do usuário API | REST API do Zabbix: automação e integração bidirecional |
| Comentários não são registrados no evento | ID de evento incorreto ou erro de sintaxe na requisição | Confirme o eventid e valide a estrutura JSON | REST API do Zabbix: automação e integração bidirecional |
| Valores de RSSI, SNR ou noise floor não aparecem no Zabbix | OID incorreto ou SNMP não habilitado no equipamento | Verifique OIDs na MIB e habilite SNMP no dispositivo | RSSI, SNR e noise floor: os três números que explicam quase |
| Valores de noise floor estão sempre iguais | Equipamento não suporta leitura de noise floor via SNMP | Confirme suporte na documentação do fabricante | RSSI, SNR e noise floor: os três números que explicam quase |
| Alertas falsos de SNR baixo | Limiares mal configurados ou ruído temporário | Ajuste os limites e use triggers com histerese | RSSI, SNR e noise floor: os três números que explicam quase |
| Webhook não dispara ação no OSS/BSS | Payload URL incorreta ou endpoint não acessível | Verifique o endereço e a disponibilidade do endpoint receptor | Sincronizando NetBox com sistemas OSS/BSS |
| Dados divergentes entre NetBox e OSS/BSS | Falha na reconciliação ou evento perdido | Reveja logs, rode script de reconciliação manualmente | Sincronizando NetBox com sistemas OSS/BSS |
| Campos obrigatórios ausentes no payload | Mapeamento incompleto entre sistemas | Atualize o script ou webhook para incluir todos os campos necessários | Sincronizando NetBox com sistemas OSS/BSS |
| snmpwalk retorna 'authenticationFailure' | Senha de autenticação ou criptografia incorreta | Revise as senhas e o tipo de hash configurados | SNMP seguro: configurando SNMPv3 em OLTs e switches |
| snmpwalk não retorna dados | Usuário sem permissão ou VACM mal configurado | Ajuste o controle de acesso para garantir permissão de leitura | SNMP seguro: configurando SNMPv3 em OLTs e switches |
| snmpwalk com SNMPv2c ainda retorna dados | SNMPv2c não foi desabilitado | Desabilite SNMPv2c no equipamento ou bloqueie no firewall | SNMP seguro: configurando SNMPv3 em OLTs e switches |
| Dados aparecem legíveis no tcpdump | Criptografia não está ativa (authNoPriv) | Configure o usuário para authPriv e revise as senhas | SNMP seguro: configurando SNMPv3 em OLTs e switches |
| Configuração não é aplicada ao dispositivo | Erro de autenticação SSH ou device_type incorreto | Revise usuário, senha e device_type no inventário | Templates Jinja2: configurando perfis de serviço e VLANs em |
| Arquivo de configuração gerado está vazio | Variáveis ausentes ou nomeadas incorretamente | Cheque o inventário YAML e o template Jinja2 | Templates Jinja2: configurando perfis de serviço e VLANs em |
| Comandos não são aceitos pelo dispositivo | Sintaxe incompatível com o modelo do equipamento | Ajuste o template para a sintaxe correta do fabricante | Templates Jinja2: configurando perfis de serviço e VLANs em |
| Validação retorna VLAN inexistente | Deploy falhou ou variáveis incorretas | Reaplique o playbook e revise os parâmetros | Templates Jinja2: configurando perfis de serviço e VLANs em |
| Template importado não aparece no Zabbix | XML inválido ou incompatível com versão do Zabbix | Valide o XML e consulte a documentação para compatibilidade de versão | Templates reutilizáveis e versionamento: não repita o erro d |
| Triggers duplicadas após importação | Templates com nomes iguais em diferentes locais | Renomeie templates para evitar colisão de nomes | Templates reutilizáveis e versionamento: não repita o erro d |
| Itens SNMP não coletam dados | OIDs errados para o modelo ou fabricante | Revise OIDs e compare com MIB oficial do fabricante | Templates reutilizáveis e versionamento: não repita o erro d |
| Itens retornam 'Not Supported' | OID incorreto ou MIB não instalada | Verifique OID, instale MIB e teste com snmpwalk | Templates SNMP para OLT: do MIB ao trigger |
| Valores incoerentes (ex: 0 ou -999) | OID errado ou equipamento não suporta o parâmetro | Confirme OID na documentação, teste com snmpwalk | Templates SNMP para OLT: do MIB ao trigger |
| Triggers nunca disparam | Thresholds mal configurados ou item não coleta dados | Revise triggers e valide coleta dos itens | Templates SNMP para OLT: do MIB ao trigger |
| Validação aponta muitos falsos positivos | Modelo de IA mal treinado ou dados de entrada inconsistentes | Revise o dataset e ajuste o modelo de classificação | Tendências: automação, IA e o futuro do inventário |
| Webhooks não disparam | Erro de configuração no NetBox ou endpoint de destino indisponível | Verifique logs do NetBox e a URL do webhook | Tendências: automação, IA e o futuro do inventário |
| Provisionamento automático falha em alguns casos | Scripts não contemplam todos os cenários de equipamentos | Amplie os testes e trate exceções específicas | Tendências: automação, IA e o futuro do inventário |
| O comando 'molecule test' falha na etapa de converge | Erro no playbook ou dependências ausentes | Revise o playbook e instale dependências necessárias | Testes automatizados de playbooks: garantindo que nada quebr |
| Teste de idempotência falha | Tarefa não idempotente (muda estado a cada execução) | Ajuste a tarefa para garantir idempotência | Testes automatizados de playbooks: garantindo que nada quebr |
| Falha ao validar resultado esperado no verify.yml | Condição de verificação incorreta ou serviço/configuração não aplicada | Corrija a lógica do teste e revise o playbook | Testes automatizados de playbooks: garantindo que nada quebr |
| O path não aparece completo no 'Trace' | Conexão física ausente ou mal cadastrada | Revise as conexões entre fibras e portas ópticas. | Topologia FTTx: representando rotas e caminhos ópticos |
| Cliente não aparece associado à fibra correta | Associação do circuito feita na fibra errada | Corrija o vínculo do circuito no cadastro da fibra. | Topologia FTTx: representando rotas e caminhos ópticos |
| Rotas alternativas não são exibidas | Paths secundários não cadastrados ou incompletos | Adicione todas as conexões físicas alternativas no NetBox. | Topologia FTTx: representando rotas e caminhos ópticos |
| Alertas em excesso mesmo após ajuste | Thresholds muito rígidos ou triggers sem lógica composta | Revisar thresholds e adicionar condições temporais (ex: count()) | Triggers inteligentes: evitando alertas falsos e ruído |
| Alertas de ONU mesmo com OLT offline | Dependências de triggers não configuradas corretamente | Verificar e corrigir dependências no frontend | Triggers inteligentes: evitando alertas falsos e ruído |
| Trigger nunca dispara, mesmo em falha real | Threshold alto demais ou expressão lógica incorreta | Testar valores e revisar a lógica da trigger | Triggers inteligentes: evitando alertas falsos e ruído |
| Triggers atrasadas ou não processadas | CacheSize insuficiente | Aumente CacheSize e monitore o uso | Tuning de performance: cache, histórico e housekeeping |
| Housekeeping trava o banco por minutos | Frequência ou threads inadequados | Aumente HousekeepingFrequency ou HousekeeperThreads | Tuning de performance: cache, histórico e housekeeping |
| MySQL com uso de disco elevado | innodb_buffer_pool_size baixo | Aumente o buffer pool e monitore o swap | Tuning de performance: cache, histórico e housekeeping |
| Zabbix Server reiniciando por falta de memória | CacheSize ou buffer pool exagerados | Reduza os valores e ajuste gradualmente | Tuning de performance: cache, histórico e housekeeping |
| ONU não registra após ativar whitelisting | Serial number não cadastrado ou erro de digitação | Confirme SN físico da ONU e recadastre corretamente | Vulnerabilidades em GPON/XGS-PON: ataques e mitigação |
| Alertas frequentes de falha de autenticação | Tentativas de spoofing ou ONU defeituosa | Investigue logs, bloqueie SN suspeitos | Vulnerabilidades em GPON/XGS-PON: ataques e mitigação |
| Queda repentina de potência óptica | Possível tap ou rompimento parcial da fibra | Inspecione fisicamente o enlace e use OTDR | Vulnerabilidades em GPON/XGS-PON: ataques e mitigação |
| Logs não chegam ao servidor | Configuração incorreta de syslog ou firewall bloqueando tráfego | Revise IP do servidor e regras de firewall | Vulnerabilidades em GPON/XGS-PON: ataques e mitigação |
| Webhook não dispara | Configuração incorreta de objeto ou evento, ou webhook desabilitado. | Revise os filtros do webhook e certifique-se de que está habilitado. | Webhooks e eventos: reações automáticas no NetBox |
| Status HTTP 500 no log | Erro no endpoint de destino (ex: servidor Flask fora do ar). | Verifique logs do endpoint e garanta que ele aceite requisições do NetBox. | Webhooks e eventos: reações automáticas no NetBox |
| Payload incompleto ou inesperado | Mudança na estrutura do objeto ou versão do NetBox. | Consulte a documentação para o modelo de payload atualizado. | Webhooks e eventos: reações automáticas no NetBox |
| Trigger dispara sem motivo aparente | Dados históricos inconsistentes ou thresholds mal calibrados | Revise a qualidade dos dados e ajuste os parâmetros da função anomaly.detect() | Zabbix 6.x e além: novidades, tendências e integração com IA |
| Exportação via API retorna erro | Token de autenticação inválido ou permissões insuficientes | Gere um novo token e revise as permissões do usuário na API | Zabbix 6.x e além: novidades, tendências e integração com IA |
| Script externo não retorna score | Falha na comunicação entre Zabbix e o script ou erro no script Python | Teste o script isoladamente e verifique logs de execução | Zabbix 6.x e além: novidades, tendências e integração com IA |
| Alertas não chegam ao OSS/BSS | Erro na URL do webhook ou payload incompatível | Verifique logs do Zabbix e ajuste a configuração do Media Type | Zabbix e OSS/BSS: notificações e workflow em tempo real |
| Inventário desatualizado no OSS/BSS | API do OSS/BSS não está recebendo ou processando os dados | Confirme autenticação e formato do JSON enviado | Zabbix e OSS/BSS: notificações e workflow em tempo real |
| Equipe de campo não recebe notificação | Ação do Zabbix não está associada ao grupo ou canal correto | Revise condições da ação e destino do Media Type | Zabbix e OSS/BSS: notificações e workflow em tempo real |
| Agent aparece como indisponível | Firewall bloqueando porta 10050 ou configuração incorreta de Server no agent | Libere a porta e revise o zabbix_agentd.conf | Zabbix Server, Proxy e Agent: quem faz o quê |
| Proxy não sincroniza com o Server | Credenciais do banco ou IP do Server incorretos | Ajuste zabbix_proxy.conf e reinicie o serviço | Zabbix Server, Proxy e Agent: quem faz o quê |
| Dados atrasados no dashboard | Proxy sem conexão estável com o Server | Verifique conectividade de rede e logs do proxy | Zabbix Server, Proxy e Agent: quem faz o quê |
