BLACKSHIELD

Guia público

Resolução de problemas e limites da plataforma

Resolva rapidamente problemas comuns de ingestão, autenticação e taxa de transferência com um fluxo de solução de problemas repetível. Público: Administradores de locatários, equipes de DevOps e operadores de scanner. Tempo típico de configuração: 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 a passo

Passo 1

Verifique a autenticação e o acesso primeiro

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.

Passo 2

Validar formato de carga útil e metadados

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.

Passo 3

Ajuste a taxa de transferência e o escalonamento

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.

Verificações de sucesso

  • 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.
Resolução de problemas e limites da plataforma | Documentação BlackShield