BLACKSHIELD

Guía pública

Resolución de problemas y límites de la plataforma

Resolver la ingestión común, problemas de autenticación y rendimiento rápidamente con un flujo de solución de problemas repetible. Audiencia: Administradores de inquilinos, equipos de DevOps y operadores de escáner. Tiempo típico de configuración: 10-15 minutos.

Antes de comenzar

  • Recopile los ID de los trabajos fallidos, las marcas de tiempo, el tipo de escáner y el contexto de destino.
  • Confirmar el estado de la clave API y los valores de las variables de entorno utilizados por el escáner.
  • Validar el formato de salida del escáner antes de volver a ejecutar la ingesta.

Paso a paso

Paso 1

Verifique la autenticación y el acceso primero

La mayoría de las fallas de ingesta son problemas de credenciales o permisos, así que valídelos primero.

  • Confirme que la clave API está activa, tiene el alcance correcto y no caducado.
  • Verifique la URL de la API, el contexto del espacio de trabajo y los valores de las variables de entorno.
  • Confirme los permisos de usuario para cualquier acción activada por la interfaz de usuario.

Paso 2

Validar el formato de carga útil y los metadatos

Las cargas útiles con formato incorrecto y los metadatos faltantes a menudo provocan retrasos en la ingestión o se omiten registros.

  • Validar la salida del escáner formato antes del envío.
  • Incluir claves de deduplicación estables para análisis recurrentes.
  • Use los detalles del estado del trabajo para identificar el análisis, la validación o el procesamiento errores.

Paso 3

Ajustar el rendimiento y el escalamiento

Operar dentro de límites conocidos y escalar con contexto completo cuando los problemas persisten.

  • Distribuya análisis grandes a lo largo del tiempo para evitar la ingestión Spikes.
  • Use el reintento con retroceso exponencial para fallas transitorias de la red.
  • Eescalar fallas recurrentes con ID de espacio de trabajo, ID de trabajo y marcas de tiempo.

Comprobaciones de éxito

  • Se identifica la categoría de causa raíz (autenticación, carga útil o rendimiento).
  • EEl ticket de escalación incluye todos los diagnósticos necesarios para un soporte rápido triage.
Resolución de problemas y límites de la plataforma | Docs de BlackShield