BLACKSHIELD

Guide public

Dépannage et limites de la plateforme

Résolvez rapidement les problèmes courants d’ingestion, d’authentification et de débit grâce à un flux de dépannage reproductible. Audience: Administrateurs locataires, équipes DevOps et opérateurs de scanner. Temps moyen de mise en place: 10-15 minutes.

troubleshooting

Use this if

Résolvez rapidement les problèmes courants d’ingestion, d’authentification et de débit grâce à un flux de dépannage reproductible.

Audience
Administrateurs locataires, équipes DevOps et opérateurs de scanner
Typical time
10-15 minutes

Avant de commencer

  • Collectez les ID de tâche défaillante, les horodatages, le type de scanner et le contexte cible.
  • Confirmer l'état de la clé API et les valeurs des variables d'environnement utilisées par le scanner.
  • Valider le format de sortie du scanner avant de réexécuter l'ingestion.

Guide walkthrough

Étape 1

Vérifiez d'abord l'authentification et l'accès

La plupart des échecs d'ingestion sont des problèmes d'informations d'identification ou d'autorisation, alors validez-les. d'abord.

  • Confirmez que la clé API est active, correctement définie et non expiré.
  • Vérifiez l'URL de l'API, le contexte de l'espace de travail et les valeurs des variables d'environnement.
  • Confirmez les autorisations utilisateur pour toute action déclenchée par l'interface utilisateur.

What success looks like

Confirmez les autorisations utilisateur pour toute action déclenchée par l'interface utilisateur.

Étape 2

Valider le format de charge utile et les métadonnées

Les charges utiles mal formées et les métadonnées manquantes entraînent souvent des retards d'ingestion ou sont ignorées records.

  • Valider le format de sortie du scanner avant soumission.
  • Inclure des clés de déduplication stables pour les analyses récurrentes.
  • Utilisez les détails de l'état de la tâche pour identifier l'analyse, la validation ou erreurs de traitement.

What success looks like

Utilisez les détails de l'état de la tâche pour identifier l'analyse, la validation ou erreurs de traitement.

Étape 3

Ajuster le débit et l'escalade

Opérez dans les limites connues et faites remonter le problème avec un contexte complet lorsque les problèmes persistent.

  • Répartissez les analyses volumineuses dans le temps pour éviter l'ingestion. Spikes.
  • Utilisez de nouvelles tentatives avec une interruption exponentielle pour les pannes réseau transitoires.
  • Escaladez les échecs récurrents avec l'ID de l'espace de travail, les ID de tâche et les horodatages.

What success looks like

Escaladez les échecs récurrents avec l'ID de l'espace de travail, les ID de tâche et les horodatages.

What success looks like

  • La catégorie de cause première est identifiée (authentification, charge utile ou débit).
  • Le ticket d’escalade comprend tous les diagnostics requis pour un tri rapide du support.
Dépannage et limites de la plateforme | BlackShield Docs