Indagine intelligente sugli incidenti

Che cos'è l'analisi intelligente degli incidenti?

Vantaggi chiave

Come funziona un'indagine intelligente

Quando si avvia un'indagine, Instana esegue un'analisi completa dell'incidente attraverso un processo automatizzato in più fasi. Mentre l'indagine è in corso, è possibile continuare a utilizzare l'applicazione Instana ed esaminare il contesto infrastrutturale dell'incidente.

Prerequisiti e primi passi

Avvio di un'indagine :

Quando il sistema software presenta un problema o subisce un'interruzione, è possibile aprire l'incidente corrispondente dalla dashboard "Eventi" di Instana per avviare le indagini relative all'incidente.

Metodo 1: Pagina "Incidenti"

È possibile chiudere la finestra dell'analisi in corso per far sì che l'analisi venga eseguita in background. È possibile continuare a lavorare mentre il processo è in esecuzione in background, ad esempio per continuare ad analizzare il contesto dell'applicazione e dell'infrastruttura e i sintomi dell'incidente.

Metodo 2: Interfaccia di chat con intelligenza artificiale

1. Dal menu " Instana ", selezionare Eventi > Incidenti.
2. Fai clic sul pulsante fluttuante dell'assistente AI nell'angolo in basso a destra della pagina.
3. Digita una richiesta in linguaggio naturale che faccia riferimento all'ID dell'incidente. Ad esempio:

   Investigate incident <incident-id>

   L'ID <incident-id> dell'incidente è Instana, visibile nella pagina URL e nei payload degli avvisi.
4. L'assistente AI invia la richiesta di indagine e mostra in tempo reale i passaggi del ragionamento e i risultati direttamente nella finestra della chat.

Requisito : le opzioni relative alla funzione "Chat con IA" devono essere attivate. Per ulteriori informazioni, consultare la pagina dell'assistente AI Instana.

Metodo 3: REST API

Il eventId è l'ID dell'incidente di Instana visibile nella pagina " URL " e nei payload degli avvisi.

• Avviare un'indagine

  curl -X POST "https://<your-instana-host>/api/automated-investigation/trigger/<eventId>" \
    -H "Authorization: apiToken <YOUR_API_TOKEN>" \
    -H "Content-Type: application/json"

  Poiché un'indagine può richiedere diversi minuti per essere completata, l'endpoint di trigger restituisce 202 Accepted inizialmente un valore mentre l'indagine viene eseguita in background. Il corpo della risposta include anche un pollEndpoint campo che indica esattamente dove cercare i risultati:

  {
    "message": "Agentic investigation started successfully",
    "eventId": "<eventId>",
    "status": "triggered",
    "pollEndpoint": "/api/automated-investigation/incidents/<eventId>"
  }

• Verificare se l'indagine è stata completata
  L'indagine viene archiviata solo una volta completata integralmente. Utilizza il seguente approccio in due fasi per attendere i risultati senza dover recuperare l'intero payload ad ogni controllo:

  1. Sondaggio da completare (semplice, senza corpo del risultato)

     Questo passaggio chiama exists periodicamente l'endpoint finché non 200 OK restituisce un valore. Viene restituito 200 OK quando l'indagine è in corso o è stata completata, oppure 404 Not Found se l'indagine non esiste affatto.

     curl -o /dev/null -w "%{http_code}" \
       "https://<your-instana-host>/api/automated-investigation/incidents/<eventId>/exists" \
       -H "Authorization: apiToken <YOUR_API_TOKEN>"

  2. Recupera i risultati completi (una sola volta, al termine dell'operazione)

     Quando sei pronto a leggere i risultati, chiama l'endpoint principale. Restituisce 200 OK il documento completo dell'indagine quando questa è terminata e archiviata, oppure 404 Not Found se l'indagine non è ancora terminata.

     curl -X GET "https://<your-instana-host>/api/automated-investigation/incidents/<eventId>" \
       -H "Authorization: apiToken <YOUR_API_TOKEN>"

     Una 404 risposta proveniente dall'endpoint dei risultati indica che l'indagine non è ancora terminata. Continuare a inviare richieste e riprovare dopo una breve pausa.

• Risposte di errore

  Stato HTTP	Significato	Azione
  202 Accepted	L'indagine è stata avviata con esito positivo.	Avviare il rilevamento dei risultati.
  409 Conflict	È già in corso un'indagine su questo episodio.	Interroga invece i risultati già disponibili.
  429 Too Many Requests	Limite frequenza API superato.	Riprova dopo un breve intervallo.
  503 Service Unavailable	È stato raggiunto il numero massimo di indagini simultanee.	Riprova dopo un breve intervallo.

• Attivazione automatica tramite le azioni automatizzate

  Invece di richiamare manualmente l' API, è possibile configurare un'azione automatizzata in modo che le indagini vengano avviate automaticamente ogni volta che viene aperto un Application Smart Alert corrispondente.

  1. Dal menu " Instana ", vai su Impostazioni > Automazione > Azioni automatiche.
  2. Crea un'azione di tipo HTTP con la seguente configurazione:
     • Metodo: POST
     • URL: https://<your-instana-host>/api/automated-investigation/trigger/@@eventId@@
     • Intestazione: Authorization: apiToken <YOUR_API_TOKEN>
     • Intestazione: Content-Type: application/json
  3. Dal menu “ Instana ”, vai su Impostazioni > Automazione > Criteri.
  4. Crea una politica che abbia come ambito lo Smart Alert dell'applicazione in questione. Quindi, associare l'azione creata al punto 2 e impostare l'azione in modo che si attivi all 'apertura dell'incidente.

  Quando viene aperto un incidente, Instana chiama automaticamente il trigger API e avvia l'indagine in background. I risultati sono disponibili nella vista degli incidenti man mano che vengono trasmessi in tempo reale.

Metodo 4: Generare un'azione dalle "Azioni consigliate"

Per ulteriori informazioni sulla generazione di azioni tramite IA, consulta la sezione "Generazione di azioni tramite IA".

Fasi dell'indagine

1. Approfondimenti iniziali

   In primo luogo, i processi investigativi gettano le basi dell'indagine raccogliendo i dettagli dell'incidente, i dati relativi alle probabili cause alla radice con i punteggi di integrità, gli eventi correlati, i modelli iniziali di errore di tracciamento e le relazioni topologiche.

2. Analisi degli eventi di cambiamento

   Successivamente, le procedure investigative esaminano le modifiche apportate al sistema in un intervallo di tempo che va da 60 minuti prima dell'inizio dell'incidente a 20 minuti dopo l'inizio dell'incidente. I processi analizzano fino a 200 eventi di modifica, tra cui implementazioni, configurazioni e operazioni di ridimensionamento, per individuare tempistiche sospette.

3. Analisi delle entità

   L'agente esegue una chiamata allo strumento per raccogliere dati su un'entità di interesse e sulle entità circostanti. Viene quindi effettuata un'analisi completa su sei categorie di entità (entità principale, chiamanti del servizio, chiamati del servizio, entità padre dell'infrastruttura, entità figlio dell'infrastruttura e altre dipendenze dell'infrastruttura) attraverso la raccolta di registri di tracciamento, messaggi di errore, eventi e metriche per ciascuna entità.

4. Report finale

   Infine, i processi di indagine sintetizzano tutti i risultati in un rapporto completo che include l'identificazione delle cause alla radice, le condizioni di guasto, la visualizzazione della catena di propagazione del guasto, le prove raccolte, la classificazione dei componenti, i suggerimenti per la risoluzione e la correlazione temporale. Il processo nel suo complesso è concepito per essere non invasivo e funzionare in modo asincrono, in modo da consentirti di continuare a lavorare mentre sono in corso le indagini e le analisi. I risultati vengono trasmessi in tempo reale non appena disponibili, offrendoti una visione immediata dello stato di avanzamento dell'indagine.

Raccolta Dati e Analisi

Viene effettuata una raccolta completa dei dati su più livelli del sistema, acquisendo informazioni da ciascun componente della catena di propagazione del guasto. I dati vengono raccolti in batch e trasmessi in modo asincrono ai processi di backend per fornire informazioni in tempo reale man mano che l'indagine procede.

Ambito dell'indagine e categorie di soggetti

Risultati dell'indagine

L'analisi intelligente degli incidenti fornisce un'analisi completa che comprende:

Intervallo di tempo dell'analisi

L'indagine analizza i dati di sistema a partire da 60 minuti prima dell'inizio dell'incidente, fornendo un quadro completo degli eventi e dei cambiamenti che hanno portato al problema. Durante un'indagine, l' Instana e raccoglie i dati in lotti da tutte le entità interessate e utilizza processi di backend per analizzarli in modo asincrono. Questo approccio è pensato per fornire risultati in tempi rapidi senza richiedere una correlazione manuale dei dati e per limitare il carico aggiuntivo sui sistemi monitorati.

Domande frequenti (FAQ, Frequently Asked Questions)

Come posso accedere manualmente alla pagina relativa a un incidente con una causa principale probabile per avviare un'indagine?

Requisiti: l'incidente deve trattarsi di un "Application Smart Alert" per il quale sia stata identificata una probabile causa principale.

Posso condurre più indagini contemporaneamente?

Sì, è possibile condurre indagini su diversi incidenti contemporaneamente. Ogni indagine opera in modo indipendente e mantiene il proprio stato. Il limite predefinito è di 10 indagini simultanee. Quando viene raggiunto tale limite, l'interfaccia utente mette in coda le richieste successive e l' REST API e restituisce 503 Service Unavailable. Per aumentare il limite, invia una richiesta di assistenza.

Esistono limiti di frequenz API i sull'endpoint di trigger?

Sì. Per i limiti standard applicabili, consultare Instana API rate limits. Quando il limite viene superato, la funzione ` API ` restituisce 429 Too Many Requests

Cosa succede se chiudo il browser durante un'indagine?

Le indagini proseguono in sottofondo. Quando torni alla pagina dell'incidente, puoi riprendere a visualizzare i risultati dell'indagine. Il sistema memorizza nella cache lo stato delle indagini, in modo da consentirti di ricollegarti alle indagini in corso.

Posso esportare i risultati dell'indagine?

I risultati delle indagini vengono archiviati e sono consultabili dalla pagina dedicata all'incidente. Il fascicolo completo dell'indagine, comprensivo di tutte le conclusioni e le prove, viene conservato per riferimento futuro.

E se l'indagine non individuasse la causa principale?

Se l'indagine non riesce a individuare con certezza la causa principale, fornisce tutte le prove raccolte, le catene di propagazione dei guasti e le classificazioni dei componenti per aiutarti a indagare manualmente sull'incidente. I dati consolidati e l'analisi basata sull'intelligenza artificiale possono aiutarti a risolvere i problemi in modo più efficiente. Per ulteriori informazioni sull'analisi delle cause alla radice per Instana, consultare la sezione "Analisi delle cause alla radice".

Posso avviare un'indagine dall'interfaccia della chat con l'IA?

Sì, puoi utilizzare l'assistente AI disponibile nelle pagine "Eventi" e "Incidenti" per avviare un'indagine. Dall'assistente è possibile digitare una richiesta in linguaggio naturale, come ad Investigate incident <incident-id> esempio, direttamente nel pannello della chat. L'assistente avvia quindi un'indagine e ti trasmette i risultati in tempo reale. Per ulteriori informazioni, consultare il Metodo 2: Interfaccia della chat con IA.

È possibile avviare un'indagine automaticamente senza cliccare su "Esegui indagine"?

Sì. È possibile configurare un'azione automatizzata in modo che le indagini vengano avviate automaticamente ogni volta che viene visualizzato uno Smart Alert relativo a un'applicazione corrispondente. Per ulteriori informazioni, consulta la sezione "Attivazione automatica tramite azioni automatizzate".

È possibile avviare un'indagine da un sistema esterno o da uno script?

Sì, l'endpoint POST /api/automated-investigation/trigger/{eventId} può essere richiamato da qualsiasi sistema esterno per avviare un'indagine, purché si disponga di un token valido Instana API. 202 AcceptedInizialmente, l'indagine giunge a una conclusione. Poiché l'indagine viene eseguita in modo asincrono in background, eseguire il polling GET /api/automated-investigation/incidents/{eventId}/exists fino a quando 200 OK non viene restituito. Quindi, recupera i risultati completi con GET /api/automated-investigation/incidents/{eventId}. Per la procedura completa passo dopo passo e l'elenco degli errori, consultare il Metodo 3: REST API.