BLACKSHIELD

Guida pubblica

Risoluzione dei problemi e limiti della piattaforma

Risolvi l'acquisizione comune, autenticazione e problemi di throughput rapidamente con un flusso di risoluzione dei problemi ripetibile. Pubblico: Amministratori tenant, team DevOps e operatori scanner. Tempo medio di configurazione: 10-15 minuti.

troubleshooting

Use this if

Risolvi l'acquisizione comune, autenticazione e problemi di throughput rapidamente con un flusso di risoluzione dei problemi ripetibile.

Audience
Amministratori tenant, team DevOps e operatori scanner
Typical time
10-15 minuti

Prima di iniziare

  • Raccogli ID lavoro non riusciti, timestamp, tipo di scanner e contesto di destinazione.
  • Conferma lo stato della chiave API e i valori delle variabili di ambiente utilizzati dallo scanner.
  • Convalida formato di output dello scanner prima eseguire nuovamente l'acquisizione.

Guide walkthrough

Passo 1

Controlla prima l'autenticazione e l'accesso

La maggior parte degli errori di acquisizione sono problemi di credenziali o autorizzazioni, quindi convalidali first.

  • Conferma che la chiave API è attiva, con ambito corretto e non scaduto.
  • Verificare l'URL dell'API, il contesto dell'area di lavoro e i valori delle variabili di ambiente.
  • Conferma le autorizzazioni utente per qualsiasi azione attivata dall'interfaccia utente.

What success looks like

Conferma le autorizzazioni utente per qualsiasi azione attivata dall'interfaccia utente.

Passo 2

Convalida formato payload e metadati

I payload non validi e i metadati mancanti spesso causano ritardi di acquisizione o vengono saltati record.

  • Convalidare il formato di output dello scanner prima dell'invio.
  • Includi chiavi di deduplicazione stabili per scansioni ricorrenti.
  • Utilizza i dettagli sullo stato del processo per identificare errori di analisi, convalida o elaborazione.

What success looks like

Utilizza i dettagli sullo stato del processo per identificare errori di analisi, convalida o elaborazione.

Passo 3

Ottimizzare il throughput e l'escalation

Operare entro limiti noti ed eseguire l'escalation con il contesto completo quando i problemi persistono.

  • Distribuisci scansioni di grandi dimensioni nel tempo per evitare l'importazione picchi.
  • Utilizza nuovi tentativi con backoff esponenziale per errori di rete temporanei.
  • Escala gli errori ricorrenti con ID area di lavoro, ID lavoro e timestamp.

What success looks like

Escala gli errori ricorrenti con ID area di lavoro, ID lavoro e timestamp.

What success looks like

  • Root viene identificata la categoria della causa (autenticazione, payload o throughput).
  • E include tutta la diagnostica necessaria per un supporto rapido triage.
Risoluzione dei problemi e limiti della piattaforma | BlackShield Docs