BLACKSHIELD

Öffentlicher Leitfaden

Fehlerbehebung und Plattformgrenzen

Beheben Sie häufig auftretende Aufnahme-, Authentifizierungs- und Durchsatzprobleme schnell mit einem wiederholbaren Fehlerbehebungsablauf. Zielgruppe: Mandantenadministratoren, DevOps-Teams und Scannerbetreiber. Typische Einrichtungszeit: 10-15 Minuten.

Bevor Sie beginnen

  • Erfassen Sie fehlgeschlagene Job-IDs, Zeitstempel, Scannertyp und Zielkontext.
  • Bestätigen Sie den API-Schlüsselstatus und die vom Scanner verwendeten Umgebungsvariablenwerte.
  • Scanner-Ausgabeformat vor der erneuten Ausführung validieren Aufnahme.

Schritt für Schritt

Schritt 1

Überprüfen Sie zunächst die Authentifizierung und den Zugriff

Bei den meisten Aufnahmefehlern handelt es sich um Anmeldedaten- oder Berechtigungsprobleme. Überprüfen Sie diese daher zunächst.

  • Bestätigen Sie, dass der API-Schlüssel aktiv ist, den korrekten Gültigkeitsbereich hat und nicht abgelaufen.
  • Überprüfen Sie die API-URL, den Arbeitsbereichskontext und die Umgebungsvariablenwerte.
  • Bestätigen Sie Benutzerberechtigungen für alle durch die Benutzeroberfläche ausgelösten Aktionen.

Schritt 2

Nutzlastformat und Metadaten validieren

Fehlerhafte Nutzlasten und fehlende Metadaten führen häufig zu Verzögerungen bei der Aufnahme oder zum Überspringen von Datensätzen.

  • Validieren Sie das Ausgabeformat des Scanners vor der Übermittlung.
  • Integrieren Sie stabile Deduplizierungsschlüssel für wiederkehrende Scans.
  • Verwenden Sie Jobstatusdetails, um Identifizieren Sie Analyse-, Validierungs- oder Verarbeitungsfehler.

Schritt 3

Optimieren Sie Durchsatz und Eskalation

Arbeiten Sie innerhalb bekannter Grenzen und eskalieren Sie mit vollständigem Kontext, wenn Probleme weiterhin bestehen.

  • Verteilen Sie große Scans über einen längeren Zeitraum, um Aufnahmespitzen zu vermeiden.
  • Verwenden Sie Wiederholungsversuche mit exponentiellem Backoff für vorübergehende Netzwerkausfälle.
  • Eskalieren Sie wiederkehrende Fehler mit Workspace-ID, Job-IDs und Zeitstempeln.

Erfolgskontrollen

  • Root-Ursachenkategorie wurde identifiziert (Authentifizierung, Nutzlast oder Durchsatz).
  • Das Eskalationsticket umfasst alle erforderlichen Diagnosen für eine schnelle Support-Einstufung.
Fehlerbehebung und Plattformgrenzen | BlackShield Docs