troubleshooting

Usa questa guida se

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

Destinatari: Amministratori tenant, team DevOps e operatori scannerTempo stimato: 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.

Passo 1

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.

Criteri di successo

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

Passo 2

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.

Criteri di successo

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

Passo 3

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.

Criteri di successo

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

Root viene identificata la categoria della causa (autenticazione, payload o throughput).
E include tutta la diagnostica necessaria per un supporto rapido triage.