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.

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.

Étapes

É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.

É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.

É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.

Vérifications de réussite

  • 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