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.

troubleshooting

Úsalo si

Resolver la ingestión común, problemas de autenticación y rendimiento rápidamente con un flujo de solución de problemas repetible.

Audience
Administradores de inquilinos, equipos de DevOps y operadores de escáner
Typical time
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.

Guide walkthrough

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.

Cómo se ve el éxito

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.

Cómo se ve el éxito

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.

Cómo se ve el éxito

Eescalar fallas recurrentes con ID de espacio de trabajo, ID de trabajo y marcas de tiempo.

Cómo se ve el é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