troubleshooting

Use isto se

Resolva rapidamente problemas comuns de ingestão, autenticação e taxa de transferência com um fluxo de solução de problemas repetível.

Audience: Administradores de locatários, equipes de DevOps e operadores de scannerTypical time: 10-15 minutos

Antes de começar

Colete IDs de trabalhos com falha, carimbos de data/hora, tipo de scanner e contexto de destino.
Confirme o status da chave de API e os valores das variáveis de ambiente usados pelo scanner.
Valide o formato de saída do scanner antes de executar novamente a ingestão.

Passo 1

A maioria das falhas de ingestão são problemas de credenciais ou permissões, portanto valide-as primeiro.

Confirme se a chave de API está ativa, com escopo correto e não expirada.
Verifique o URL da API, o contexto do espaço de trabalho e os valores das variáveis de ambiente.
Confirme as permissões do usuário para quaisquer ações acionadas pela IU.

Como é o sucesso

Confirme as permissões do usuário para quaisquer ações acionadas pela IU.

Passo 2

Cargas malformadas e metadados ausentes geralmente causam atrasos na ingestão ou registros ignorados.

Valide o formato de saída do scanner antes do envio.
Inclua chaves de desduplicação estáveis para verificações recorrentes.
Use detalhes de status do trabalho para identificar erros de análise, validação ou processamento.

Como é o sucesso

Use detalhes de status do trabalho para identificar erros de análise, validação ou processamento.

Passo 3

Opere dentro dos limites conhecidos e escale com contexto completo quando os problemas persistirem.

Distribua grandes varreduras ao longo do tempo para evitar picos de ingestão.
Use nova tentativa com espera exponencial para falhas transitórias de rede.
Escale falhas recorrentes com ID do espaço de trabalho, IDs de trabalho e carimbos de data/hora.

Como é o sucesso

Escale falhas recorrentes com ID do espaço de trabalho, IDs de trabalho e carimbos de data/hora.

A categoria de causa raiz é identificada (auth, payload ou throughput).
O tíquete de escalonamento inclui todos os diagnósticos necessários para uma triagem de suporte rápida.