Usa un AWS Management Console

AWS Management Console Se desideri, usa un'interfaccia utente grafica (GUI) che richieda una codifica minima. Gli utenti che non conoscono X-Ray possono iniziare rapidamente a utilizzare visualizzazioni predefinite ed eseguire attività di base. È possibile effettuare le seguenti operazioni direttamente dalla console:

• Abilita X-Ray.

• Visualizza riepiloghi di alto livello delle prestazioni della tua applicazione.

• Controlla lo stato di salute delle tue applicazioni.

• Identifica gli errori di alto livello.

• Visualizza i riepiloghi di base delle tracce.

Puoi utilizzare la CloudWatch console Amazon all'indirizzo https://console.aws.amazon.com/cloudwatch/ o la console X-Ray all'indirizzo https://console.aws.amazon.com/xray/home per interagire con X-Ray.

Usa la CloudWatch console Amazon

La CloudWatch console include una nuova funzionalità X-Ray riprogettata dalla console X-Ray per renderla più facile da usare. Se si utilizza la CloudWatch console, è possibile visualizzare CloudWatch log e metriche insieme ai dati di tracciamento X-Ray. Utilizza la CloudWatch console per visualizzare e analizzare i dati, tra cui:

• Tracce a raggi X: visualizza, analizza e filtra le tracce associate all'applicazione mentre soddisfa una richiesta. Utilizzate queste tracce per trovare latenze elevate, eseguire il debug degli errori e ottimizzare il flusso di lavoro delle applicazioni. Visualizza una mappa di tracciamento e una mappa dei servizi per visualizzare le rappresentazioni visive del flusso di lavoro dell'applicazione.

• Registri: visualizza, analizza e filtra i log prodotti dall'applicazione. Utilizza i log per risolvere gli errori e configurare il monitoraggio in base a valori di log specifici.

• Metriche: misura e monitora le prestazioni delle applicazioni utilizzando le metriche emesse dalle tue risorse o crea metriche personalizzate. Visualizza queste metriche in grafici e diagrammi.

• Monitoraggio delle reti e dell'infrastruttura: monitora le principali reti per rilevare eventuali interruzioni e lo stato e le prestazioni dell'infrastruttura, incluse applicazioni containerizzate, altri AWS servizi e client.

• Tutte le funzionalità della console X-Ray elencate nella seguente sezione Utilizzare la console X-Ray.

Per ulteriori informazioni sulla CloudWatch console, consulta la sezione Guida introduttiva ad Amazon CloudWatch.

Accedi alla CloudWatch console Amazon all'indirizzo https://console.aws.amazon.com/cloudwatch/.

Usa la console X-Ray

La console X-Ray offre la tracciabilità distribuita per le richieste delle applicazioni. Usa la console X-Ray se desideri un'esperienza di console più semplice o non desideri aggiornare il codice dell'applicazione. AWS non sta più sviluppando la console X-Ray. La console X-Ray contiene le seguenti funzionalità per le applicazioni strumentate:

• Approfondimenti: rileva automaticamente le anomalie nelle prestazioni dell'applicazione e individua le cause sottostanti. Gli approfondimenti sono inclusi nella CloudWatch console sotto Insights. Per ulteriori informazioni, vedere Use X-Ray Insights in. Esplora la console X-Ray

• Mappa dei servizi: visualizza una struttura grafica dell'applicazione e le sue connessioni con client, risorse, servizi e dipendenze.

• Tracce: visualizza una panoramica delle tracce generate dall'applicazione mentre soddisfa una richiesta. Utilizza i dati di traccia per comprendere le prestazioni dell'applicazione rispetto a metriche di base, tra cui i tempi di HTTP risposta e risposta.

• Analisi: interpreta, esplora e analizza i dati di traccia utilizzando grafici per la distribuzione dei tempi di risposta.

• Configurazione: crea tracce personalizzate per modificare le configurazioni predefinite per quanto segue:

  • Campionamento: crea una regola che definisca la frequenza con cui campionare l'applicazione per le informazioni di traccia. Per ulteriori informazioni, consulta Configurare le regole di campionamento in. Esplora la console X-Ray

  • Crittografia: crittografa i dati inattivi utilizzando una chiave che puoi controllare o disabilitare. AWS Key Management Service

  • Gruppi: utilizza un'espressione di filtro per definire un gruppo di tracce con una caratteristica comune come il nome di un URL o un tempo di risposta. Per ulteriori informazioni, consulta Configurare i gruppi.

Accedere alla console X-Ray all'indirizzo https://console.aws.amazon.com/xray/home.

Esplora la console X-Ray

Usa la console X-Ray per visualizzare una mappa dei servizi e delle tracce associate per le richieste servite dalle tue applicazioni e per configurare gruppi e regole di campionamento che influiscono sul modo in cui le tracce vengono inviate a X-Ray.

Nota

La mappa e la mappa del servizio X-Ray sono state combinate nella CloudWatch ServiceLens mappa di tracciamento X-Ray all'interno della console Amazon. CloudWatch Apri la CloudWatchconsole e scegli Trace Map in X-Ray Traces dal riquadro di navigazione a sinistra.

CloudWatch ora include Application Signals, che può scoprire e monitorare i servizi applicativi, i client, i canali Synthetics e le dipendenze dei servizi. Utilizza Application Signals per visualizzare un elenco o una mappa visiva dei tuoi servizi, visualizzare i parametri di integrità in base agli obiettivi del livello di servizio (SLO) e approfondire le tracce X-Ray correlate per una risoluzione dei problemi più dettagliata.

La pagina principale della console X-Ray è la mappa di traccia, che è una rappresentazione visiva del grafico del servizio JSON generato da X-Ray a partire dai dati di traccia generati dalle applicazioni. La mappa è composta da nodi di servizio per ogni applicazione che elabora richieste nel tuo account, nodi client a monte che rappresentano le origini delle richieste e nodi di servizio a valle che rappresentano i servizi e le risorse web utilizzate da un'applicazione durante l'elaborazione della richiesta. Sono disponibili pagine aggiuntive per visualizzare le tracce e i dettagli delle tracce e configurare gruppi e regole di campionamento.

Visualizza l'esperienza della console per X-Ray e confrontala con la CloudWatch console nelle sezioni seguenti.

Usa la mappa di tracciamento a raggi X

Visualizza la mappa di tracciamento X-Ray per identificare i servizi in cui si verificano errori, le connessioni con latenza elevata o le tracce delle richieste che non hanno avuto esito positivo.

Nota

CloudWatch ora include Application Signals, in grado di rilevare e monitorare i servizi applicativi, i client, i synthetics canary e le dipendenze dei servizi. Utilizza Application Signals per visualizzare un elenco o una mappa visiva dei tuoi servizi, visualizzare i parametri di integrità in base agli obiettivi del livello di servizio (SLO) e approfondire le tracce X-Ray correlate per una risoluzione dei problemi più dettagliata.

La mappa e la mappa del servizio X-Ray vengono combinate nella CloudWatch ServiceLens mappa di tracciamento X-Ray all'interno della console Amazon. CloudWatch Apri la CloudWatchconsole e scegli Trace Map in X-Ray Traces dal riquadro di navigazione a sinistra.

Visualizzazione della mappa di tracciamento

La mappa di traccia è una rappresentazione visiva dei dati di traccia generati dalle tue applicazioni. La mappa mostra i nodi di servizio che soddisfano le richieste, i nodi client upstream che rappresentano le origini delle richieste e i nodi di servizio downstream che rappresentano i servizi e le risorse Web utilizzati da un'applicazione durante l'elaborazione di una richiesta.

La mappa di traccia mostra una vista connessa delle tracce tra applicazioni basate su eventi che utilizzano Amazon SQS e Lambda. Per ulteriori informazioni, consulta la seguente sezione sulle applicazioni basate sugli eventi di Trace. La mappa di tracciamento supporta anche il tracciamento tra account, che consente di visualizzare i nodi di più account in un'unica mappa.

CloudWatch console

Per visualizzare la mappa di tracciamento nella console CloudWatch

1. Apri la CloudWatch console. Scegli Trace Map nella sezione X-Ray Traces nel riquadro di navigazione a sinistra.

   

2. Scegliere un nodo di servizio per visualizzare le richieste per tale nodo o un collegamento tra due nodi per visualizzare le richieste che sono passate attraverso tale connessione.

3. Sotto la mappa di traccia vengono visualizzate informazioni aggiuntive, incluse le schede per le metriche, gli avvisi e la distribuzione dei tempi di risposta. Nella scheda Metriche, seleziona un intervallo all'interno di ciascun grafico per visualizzare maggiori dettagli oppure scegli le opzioni Guasti o Errori per filtrare le tracce. Nella scheda Distribuzione del tempo di risposta, seleziona un intervallo all'interno del grafico per filtrare le tracce in base al tempo di risposta.

   

4. Visualizza le tracce scegliendo Visualizza le tracce oppure, se è stato applicato un filtro, scegli Visualizza le tracce filtrate.

5. Scegli Visualizza registri per visualizzare i CloudWatch log associati al nodo selezionato. Non tutti i nodi della mappa di traccia supportano la visualizzazione dei log. Per ulteriori informazioni, consulta CloudWatch i log di risoluzione dei problemi.

La mappa di tracciamento indica i problemi all'interno di ciascun nodo delineandoli con colori:

• Rosso per i malfunzionamenti del server (errori serie 500)

• Giallo per gli errori client (errori serie 400)

• Viola per gli errori di superamento dei limiti (429 Too Many Requests)

Se la mappa di tracciamento è grande, usa i controlli sullo schermo o il mouse per ingrandire e rimpicciolire e spostare la mappa.

X-Ray console

Per visualizzare la mappa dei servizi

1. Apri la console X-Ray. La mappa dei servizi viene visualizzata per impostazione predefinita. Puoi anche scegliere Service Map dal riquadro di navigazione a sinistra.

   

2. Scegliere un nodo di servizio per visualizzare le richieste per tale nodo o un collegamento tra due nodi per visualizzare le richieste che sono passate attraverso tale connessione.

3. Utilizza un istogramma di distribuzione delle risposte per filtrare le tracce in base alla durata e seleziona i codici di stato per i quali desideri visualizzare le tracce. Quindi scegliere View traces (Visualizza tracciamenti) per aprire l'elenco dei tracciamenti con l'espressione filtro applicata. Per ulteriori informazioni sugli istogrammi di distribuzione, vedere. Usa istogrammi di latenza

   

La mappa del servizio indica lo stato di salute di ogni nodo colorandolo in base al rapporto delle chiamate concluse con successo rispetto a errori e malfunzionamenti:

• Verde per le chiamate concluse con successo

• Rosso per i malfunzionamenti del server (errori serie 500)

• Giallo per gli errori client (errori serie 400)

• Viola per gli errori di superamento dei limiti (429 Too Many Requests)

Se la mappa dei servizi è ampia, usa i controlli sullo schermo o il mouse per ingrandire e rimpicciolire e spostare la mappa.

Nota

La mappa di tracciamento a raggi X può visualizzare fino a 10.000 nodi. In rari scenari in cui il numero totale di nodi di servizio supera questo limite, è possibile che venga visualizzato un errore e non sia possibile visualizzare una mappa di traccia completa nella console.

Filtraggio della mappa di traccia per gruppo

Utilizzando un'espressione di filtro, è possibile definire criteri in base ai quali includere le tracce all'interno di un gruppo. Per ulteriori informazioni sulle espressioni di filtro, consulta Utilizzare le espressioni di filtro. Successivamente, utilizza i passaggi seguenti per visualizzare quel gruppo specifico nella mappa di traccia.

CloudWatch console

Scegli il nome di un gruppo dal filtro di gruppo in alto a sinistra della mappa di traccia.

X-Ray console

Scegliere un nome di gruppo dal menu a discesa a sinistra della barra di ricerca.

La mappa dei servizi verrà ora filtrata per visualizzare le tracce che corrispondono all'espressione del filtro del gruppo selezionato.

Traccia la legenda e le opzioni della mappa

La mappa di tracciamento include una legenda e diverse opzioni per personalizzare la visualizzazione della mappa.

CloudWatch console

Scegli il menu a discesa Legenda e opzioni in alto a destra della mappa. Scegli cosa visualizzare all'interno dei nodi, tra cui:

• Le metriche mostrano il tempo di risposta medio e il numero di tracce inviate al minuto nell'intervallo di tempo scelto.

• Nodes visualizza l'icona del servizio all'interno di ogni nodo.

Scegli impostazioni aggiuntive della mappa dal riquadro Preferenze, a cui puoi accedere tramite l'icona a forma di ingranaggio in alto a destra della mappa. Queste impostazioni includono la selezione della metrica utilizzata per determinare la dimensione di ciascun nodo e quali canarini devono essere visualizzati sulla mappa.

X-Ray console

Visualizza la legenda della mappa dei servizi scegliendo il link Legenda della mappa in alto a destra della mappa. Le opzioni della mappa dei servizi possono essere scelte in basso a destra nella mappa di traccia, tra cui:

• Service Icons alterna la visualizzazione all'interno di ciascun nodo, visualizzando l'icona del servizio o il tempo di risposta medio e il numero di tracce inviate al minuto durante l'intervallo di tempo scelto.

• Dimensionamento dei nodi: Nessuno imposta tutti i nodi alla stessa dimensione.

• Dimensionamento dei nodi: Health ridimensiona i nodi in base al numero di richieste interessate, inclusi errori, guasti o richieste limitate.

• Dimensionamento dei nodi: il traffico ridimensiona i nodi in base al numero totale di richieste.

Visualizza le tracce e i dettagli delle tracce

Usa la pagina Traces nella console X-Ray per trovare le tracce tramite URL, codice di risposta o altri dati dal riepilogo della traccia. Dopo aver selezionato una traccia dall'elenco delle tracce, la pagina dei dettagli della traccia visualizza una mappa dei nodi di servizio associati alla traccia selezionata e una sequenza temporale dei segmenti di traccia.

Visualizzazione dei tracciamenti

CloudWatch console

Per visualizzare le tracce nella console CloudWatch

1. Accedere AWS Management Console e aprire la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

2. Nel riquadro di navigazione a sinistra, scegli Tracce a raggi X, quindi scegli Tracce. Puoi filtrare per gruppo o inserire un'espressione di filtro, che filtra le tracce visualizzate nella sezione Tracce nella parte inferiore della pagina. Per ulteriori informazioni, consulta Utilizzare le espressioni di filtro.

   In alternativa, è possibile utilizzare la mappa dei servizi per accedere a un nodo di servizio specifico e quindi visualizzare le tracce. Verrà aperta la pagina Traces con una query già applicata.

3. Perfeziona la tua query nella sezione Query refiners. Per filtrare le tracce in base a un attributo comune, scegliete un'opzione dalla freccia rivolta verso il basso accanto a Refine query per. Le opzioni sono le seguenti:

   • Nodo: filtra le tracce per nodo di servizio.

   • ARN della risorsa: filtra le tracce in base a una risorsa associata a una traccia. Esempi di queste risorse includono un'istanza Amazon Elastic Compute Cloud (Amazon EC2), AWS Lambda una funzione o una tabella. Amazon DynamoDB

   • Utente: filtra le tracce con un ID utente.

   • Messaggio relativo alla causa principale dell'errore: filtra le tracce in base alla causa principale dell'errore.

   • URL: filtra le tracce in base a un percorso URL utilizzato dall'applicazione.

   • Codice di stato HTTP: filtra le tracce in base al codice di stato HTTP restituito dall'applicazione. È possibile specificare un codice di risposta personalizzato o selezionare una delle seguenti opzioni:

     • 200— La richiesta è andata a buon fine.

     • 401— Nella richiesta mancavano credenziali di autenticazione valide.

     • 403— La richiesta non aveva autorizzazioni valide.

     • 404— Il server non è riuscito a trovare la risorsa richiesta.

     • 500— Il server ha rilevato una condizione imprevista e ha generato un errore interno.

   Scegliete una o più voci, quindi scegliete Aggiungi alla query per aggiungerle all'espressione di filtro nella parte superiore della pagina.

4. Per trovare una singola traccia, inserisci un ID di traccia direttamente nel campo della query. È possibile utilizzare il formato X-Ray o il formato World Wide Web Consortium (W3C). Ad esempio, una traccia creata utilizzando AWS Distro for è in formato W3C. OpenTelemetry

   Nota

   Quando si interrogano tracce create con un ID di traccia in formato W3C, la console visualizza la traccia corrispondente in formato X-Ray. Per esempio, se si esegue una query per 4efaaf4d1e8720b39541901950019ee5 in formato W3C, la console visualizza l'equivalente X-Ray:. 1-4efaaf4d-1e8720b39541901950019ee5

5. Scegli Esegui query in qualsiasi momento per visualizzare un elenco di tracce corrispondenti nella sezione Tracce nella parte inferiore della pagina.

6. Per visualizzare la pagina dei dettagli di traccia per una singola traccia, seleziona un ID di traccia dall'elenco.

   L'immagine seguente mostra una mappa di Trace contenente i nodi di servizio associati alla traccia e gli spigoli tra i nodi che rappresentano il percorso seguito dai segmenti che compongono la traccia. Un riepilogo di Trace segue la Trace Map. Il riepilogo contiene informazioni su un'GEToperazione di esempio, il relativo codice di risposta, la durata dell'esecuzione della traccia e l'età della richiesta. La cronologia dei segmenti segue il riepilogo della traccia che mostra la durata dei segmenti e dei sottosegmenti di traccia.

   

   Se disponi di un'applicazione basata sugli eventi che utilizza Amazon SQS e Lambda, puoi visualizzare una vista connessa delle tracce per ogni richiesta nella mappa di Trace. Nella mappa, le tracce dei produttori di messaggi sono collegate alle tracce dei AWS Lambda consumatori e vengono visualizzate come un bordo tratteggiato. Per ulteriori informazioni sulle applicazioni basate sugli eventi, consulta. Traccia le applicazioni basate sugli eventi

   Le pagine Traces e Trace details supportano anche il tracciamento tra account, che può elencare le tracce di più account nell'elenco delle tracce e all'interno di un'unica mappa di traccia. Per ulteriori informazioni, consulta Tracciamento tra account.

X-Ray console

Per visualizzare le tracce nella console X-Ray

1. Apri la pagina Traces nella console X-Ray. Il pannello di panoramica di Trace mostra un elenco di tracce raggruppate in base a funzionalità comuni, tra cui Error root cause, resourceARN e. InstanceId

2. Per selezionare una funzionalità comune per visualizzare un insieme raggruppato di tracce, espandi la freccia rivolta verso il basso accanto a Raggruppa per. L'illustrazione seguente mostra una panoramica delle tracce raggruppate per URL per e un elenco delle tracce associate. AWS X-Ray applicazione di esempio

   

3. Scegli l'ID di una traccia per visualizzarla nell'elenco Trace. Puoi anche scegliere Mappa dei servizi nel riquadro di navigazione per visualizzare le tracce per un nodo di servizio specifico. Quindi puoi visualizzare le tracce associate a quel nodo.

   La scheda Cronologia mostra il flusso di richieste per la traccia e include quanto segue:

   • Una mappa del percorso per ogni segmento della traccia.

   • Quanto tempo ha impiegato il segmento a raggiungere un nodo nella mappa di traccia.

   • Quante richieste sono state fatte al nodo nella mappa di traccia.

   L'illustrazione seguente mostra un esempio di Trace Map associata a una GET richiesta effettuata a un'applicazione di esempio. Le frecce mostrano il percorso seguito da ogni segmento per completare la richiesta. I nodi di servizio mostrano il numero di richieste effettuate durante la GET richiesta.

   

   Per ulteriori informazioni sulla scheda Cronologia, consultate la seguente sezione Esplorazione della cronologia di traccia.

   La scheda Dati grezzi mostra le informazioni sulla traccia e sui segmenti e sottosegmenti che la compongono, in formato. JSON Queste informazioni possono includere quanto segue:

   • Timestamp

   • ID univoci

   • Risorse associate al segmento o al sottosegmento

   • La fonte o l'origine del segmento o del sottosegmento

   • Informazioni aggiuntive sulla richiesta all'applicazione, ad esempio la risposta a una richiesta HTTP

Esplorazione della sequenza temporale di tracciamento

La sezione Cronologia mostra una gerarchia di segmenti e sottosegmenti accanto a una barra orizzontale che corrisponde al tempo impiegato per completare le attività. La prima voce nell'elenco è il segmento, che rappresenta tutti i dati registrati tramite il servizio per una singola richiesta. I sottosegmenti sono rientrati ed elencati dopo il segmento. Le colonne contengono informazioni su ogni segmento.

CloudWatch console

Nella CloudWatch console, la cronologia dei segmenti fornisce le seguenti informazioni:

• La prima colonna: elenca i segmenti e i sottosegmenti nella traccia selezionata.

• La colonna Stato del segmento: elenca il risultato dello stato di ogni segmento e sottosegmento.

• La colonna Codice di risposta: elenca un codice di stato della risposta HTTP a una richiesta del browser effettuata dal segmento o dal sottosegmento, se disponibile.

• La colonna Durata: elenca la durata del segmento o del sottosegmento.

• La colonna Hosted in: elenca lo spazio dei nomi o l'ambiente in cui viene eseguito il segmento o il sottosegmento, se applicabile. Per ulteriori informazioni, consulta https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AppSignals-StandardMetrics.html#AppSignals-StandardMetrics-Dimensions.

• L'ultima colonna: mostra le barre orizzontali che corrispondono alla durata di esecuzione del segmento o del sottosegmento, in relazione agli altri segmenti o sottosegmenti della timeline.

Per raggruppare l'elenco di segmenti e sottosegmenti per nodo di servizio, attiva Raggruppa per nodi.

X-Ray console

Nella pagina dei dettagli di traccia, scegli la scheda Cronologia per visualizzare la sequenza temporale di ogni segmento e sottosegmento che compone una traccia.

Nella console X-Ray, la Timeline fornisce le seguenti informazioni:

• La colonna Nome: elenca i nomi dei segmenti e dei sottosegmenti nella traccia.

• La colonna Res.: elenca un codice di stato della risposta HTTP a una richiesta del browser effettuata dal segmento o dal sottosegmento, se disponibile.

• La colonna Durata: elenca la durata del segmento o del sottosegmento.

• La colonna Stato: elenca il risultato dello stato del segmento o del sottosegmento.

• L'ultima colonna: mostra le barre orizzontali che corrispondono alla durata di esecuzione del segmento o del sottosegmento, in relazione agli altri segmenti o sottosegmenti della timeline.

Per visualizzare i dati di traccia non elaborati utilizzati dalla console per generare la timeline, scegli la scheda Dati grezzi. I dati grezzi mostrano le informazioni sulla traccia e sui segmenti e sottosegmenti che la compongono nel formato. JSON Queste informazioni possono includere quanto segue:

• Timestamp

• ID univoci

• Risorse associate al segmento o al sottosegmento

• La fonte o l'origine del segmento o del sottosegmento

• Informazioni aggiuntive sulla richiesta all'applicazione, ad esempio la risposta a una richiesta HTTP.

Quando si utilizza un AWS SDK strumentato o un SQL client per effettuare chiamate a risorse esterneHTTP, l'SDK X-Ray registra automaticamente i sottosegmenti. Puoi anche usare X-Ray SDK per registrare sottosegmenti personalizzati per qualsiasi funzione o blocco di codice. I sottosegmenti aggiuntivi che vengono registrati mentre un sottosegmento personalizzato è aperto diventano figli del sottosegmento personalizzato.

Visualizzazione dei dettagli del segmento

Dalla timeline di traccia, scegliete il nome di un segmento per visualizzarne i dettagli.

Il pannello dei dettagli del segmento mostra le schede Panoramica, Risorse, Annotazioni, Metadati, Eccezioni e SQL. Si applica quanto segue:

• La scheda Overview (Panoramica) mostra le informazioni su richiesta e risposta. Le informazioni includono il nome, l'ora di inizio, l'ora di fine, la durata, l'URL della richiesta, l'operazione della richiesta, il codice di risposta alla richiesta ed eventuali errori e guasti.

• La scheda Risorse per un segmento mostra le informazioni dell'SDK X-Ray e sulle AWS risorse che eseguono l'applicazione. Utilizza i plug-in Amazon EC2 o Amazon ECS per l'SDK X-Ray per registrare informazioni sulle risorse specifiche del servizio. AWS Elastic BeanstalkPer ulteriori informazioni sui plugin, consulta la sezione Plugin di servizio in. Configurazione dell'X-Ray SDK per Java

• Le schede rimanenti mostrano le annotazioni, i metadati e le eccezioni registrate per il segmento. Le eccezioni vengono acquisite automaticamente quando vengono generate da una richiesta strumentata. Le annotazioni e i metadati contengono informazioni aggiuntive registrate utilizzando le operazioni fornite da X-Ray SDK. Per aggiungere annotazioni o metadati ai tuoi segmenti, usa l'SDK X-Ray. Per ulteriori informazioni, consulta il link specifico per la lingua riportato in Strumentazione dell'applicazione con SDK in. AWS X-Ray Strumenta la tua candidatura per AWS X-Ray

Visualizzazione dei dettagli del sottosegmento

Dalla timeline di tracciamento, scegli il nome di un sottosegmento per visualizzarne i dettagli:

• La scheda Panoramica contiene informazioni sulla richiesta e sulla risposta. Ciò include il nome, l'ora di inizio, l'ora di fine, la durata, la richiestaURL, l'operazione della richiesta, il codice di risposta alla richiesta ed eventuali errori e guasti. Per i sottosegmenti generati dai client analizzati, la scheda Overview (Panoramica) contiene informazioni sulla richiesta e la risposta dal punto di vista dell'applicazione.

• La scheda Risorse per un sottosegmento mostra i dettagli sulle AWS risorse utilizzate per eseguire il sottosegmento. Ad esempio, la scheda delle risorse può includere una AWS Lambda funzione ARN, informazioni su una tabella DynamoDB, qualsiasi operazione chiamata e l'ID della richiesta.

• Le schede rimanenti mostrano le annotazioni, i metadati e le eccezioni registrate sul sottosegmento. Le eccezioni vengono acquisite automaticamente quando vengono generate da una richiesta strumentata. Le annotazioni e i metadati contengono informazioni aggiuntive registrate utilizzando le operazioni fornite da X-Ray SDK. Usa l'SDK X-Ray per aggiungere annotazioni o metadati ai tuoi segmenti. Per ulteriori informazioni, consulta il link specifico per la lingua elencato in Strumentazione dell'applicazione con SDK in. AWS X-Ray Strumenta la tua candidatura per AWS X-Ray

Nel caso di sottosegmenti personalizzati, la scheda Overview (Panoramica) mostra il nome del sottosegmento, che è possibile impostare per specificare l'area del codice o della funzione che memorizza. Per ulteriori informazioni, consulta il link specifico per la lingua riportato in Strumentazione dell'applicazione con SDK in. AWS X-Ray Generazione di sottosegmenti personalizzati con X-Ray SDK for Java

L'immagine seguente mostra la scheda Panoramica per un sottosegmento personalizzato. La panoramica contiene l'ID del sottosegmento, l'ID principale, il nome, l'ora di inizio e di fine, la durata, lo stato e gli errori o gli errori.

La scheda Metadati per un sottosegmento personalizzato contiene informazioni in JSON formato sulle risorse utilizzate da quel sottosegmento.

Usa le espressioni di filtro

Utilizza le espressioni di filtro per visualizzare una o più tracce per una richiesta, un servizio, una connessione tra due servizi (un edge) o richieste che soddisfano una condizione. X-Ray fornisce un linguaggio di espressione di filtro per filtrare richieste, servizi e bordi in base ai dati nelle intestazioni delle richieste, allo stato della risposta e ai campi indicizzati sui segmenti originali.

Quando scegli un periodo di tempo per le tracce da visualizzare nella console X-Ray, potresti ottenere più risultati di quelli che la console può visualizzare. Nell'angolo in alto a destra, la console mostra il numero di tracciamenti individuati e se sono disponibili ulteriori tracciamenti. È possibile utilizzare un'espressione di filtro per restringere i risultati alle sole tracce che si desidera trovare.

Filtraggio dei dettagli delle espressioni

Quando si sceglie un nodo nella mappa di traccia, la console crea un'espressione di filtro in base al nome di servizio del nodo e ai tipi di errore presenti in base alla selezione effettuata. Per individuare tracciamenti che mostrano problemi di prestazioni o che riguardano richieste specifiche, puoi modificare l'espressione generata dalla console oppure crearne una tua. Se aggiungi annotazioni con X-Ray SDK, puoi anche filtrare in base alla presenza di una chiave di annotazione o al valore di una chiave.

Nota

Se scegli un intervallo di tempo relativo nella mappa di traccia e scegli un nodo, la console converte l'intervallo di tempo in un'ora di inizio e di fine assolute. Per garantire che i tracciamenti relativi al nodo vengano visualizzati tra risultati di ricerca, e per evitare la scansione dei periodi di tempo in cui il nodo non era attivo, l'intervallo di tempo include solo i periodi durante i quali il nodo ha inviato dei tracciamenti. Se desideri eseguire una ricerca rispetto all'ora corrente, puoi ripristinare l'intervallo di tempo relativo nella pagina dei tracciamenti ed eseguire nuovamente la scansione.

Se vengono ancora restituiti più risultati di quanti la console possa visualizzare, la console mostra quanti tracciamenti soddisfano il filtro e di quanti è stata eseguita la scansione. La percentuale visualizzata è la percentuale dell'intervallo di tempo selezionato di cui è stata eseguita la scansione. Restringi ulteriormente l'espressione filtro, oppure scegli un intervallo di tempo più breve, in modo da visualizzare tra i risultati tutti i tracciamenti corrispondenti al filtro.

Per disporre prima dei risultati più recenti, la console avvia la scansione partendo dal termine dell'intervallo di tempo e procedendo in senso cronologico inverso. In caso di un numero elevato di tracciamenti, la console suddivide l'intervallo di tempo in blocchi ed esegue le scansioni in parallelo. La barra di avanzamento mostra le porzioni dell'intervallo di tempo relativamente alle quali è stata eseguita la scansione.

Usa le espressioni di filtro con i gruppi

I gruppi costituiscono una raccolta di tracciamenti definiti da un'espressione di filtro. Puoi utilizzare i gruppi per generare grafici di servizio aggiuntivi e fornire CloudWatch metriche Amazon.

I gruppi sono identificati dal nome o da un Amazon Resource Name (ARN) e contengono un'espressione di filtro. Il servizio confronta i tracciamenti in entrata con l'espressione e le memorizza di conseguenza.

È possibile creare e modificare i gruppi utilizzando il menu a discesa a sinistra della barra di ricerca delle espressioni filtro.

Nota

Se il servizio rileva un errore nel qualificare un gruppo, tale gruppo non viene più incluso nell'elaborazione dei tracciamenti in entrata e viene registrata un parametro di errore.

Per ulteriori informazioni sui gruppi, consulta. Configura i gruppi

Sintassi delle espressioni filtro

Le espressioni filtro possono contenere una parola chiave, un operatore unario o binario e un valore per il confronto.

keyword operator value

Sono disponibili diversi operatori per diversi tipi di parola chiave. Ad esempio, responsetime è una parola chiave numerica e può essere confrontata con operatori correlati a numeri.

Esempio — richieste in cui il tempo di risposta è stato superiore a 5 secondi

responsetime > 5

Puoi combinare più espressioni in un'espressione composta mediante gli operatori AND o OR.

Esempio — richieste la cui durata totale era di 5-8 secondi

duration >= 5 AND duration <= 8

Le parole chiave e gli operatori semplici individuano problemi solo a livello di tracciamento. Se si verifica un errore a valle, ma è gestito direttamente dall'applicazione e non viene restituito all'utente, una ricerca per error non lo individuerà.

Per trovare tracce con problemi a valle, puoi utilizzare le parole chiave complesse e. service() edge() Queste parole chiave ti permettono di applicare un'espressione filtro a tutti i nodi a valle, a un singolo nodo a valle o ad un collegamento tra due nodi. Per ulteriori informazioni su queste parole chiave, consulta la seguente sezione Parole chiave complesse. Per una maggiore granularità, puoi filtrare servizi ed edge per tipo con la funzione id(). Per ulteriori informazioni, consulta la seguente sezione sulla funzione id.

Parole chiave booleane

I valori delle parole chiave booleane sono true o false. Utilizza queste parole chiave per individuare i tracciamenti che hanno generato errori.

Parole chiave booleane

• ok— Il codice di stato della risposta era 2XX Success.

• error— Il codice di stato della risposta era 4XX Client Error.

• throttle— Il codice di stato della risposta era 429 Too Many Requests.

• fault— Il codice di stato della risposta era 5XX Server Error.

• partial— La richiesta ha segmenti incompleti.

• inferred— La richiesta ha segmenti dedotti.

• first— L'elemento è il primo di un elenco enumerato.

• last— L'elemento è l'ultimo di un elenco enumerato.

• remote— L'entità della causa principale è remota.

• root— Il servizio è il punto di ingresso o il segmento principale di una traccia.

Gli operatori booleani individuano i segmenti in cui la chiave specificata è true o false.

Operatori booleani

• nessuno: l'espressione è vera se la parola chiave è vera.

• !— L'espressione è vera se la parola chiave è falsa.

• =, != — Confronta il valore della parola chiave con la stringa true orfalse. Questi operatori agiscono allo stesso modo degli altri operatori, ma sono più espliciti.

Esempio — lo stato della risposta è 2XX OK

ok

Esempio — lo stato della risposta non è 2XX OK

!ok

Esempio — lo stato della risposta non è 2XX OK

ok = false

Esempio — l'ultima traccia di errore enumerata ha il nome di errore «deserializza»

rootcause.fault.entity { last and name = "deserialize" }

Esempio — richieste con segmenti remoti in cui la copertura è maggiore di 0,7 e il nome del servizio è «trace»

rootcause.responsetime.entity { remote and coverage > 0.7 and name = "traces" }

Esempio — richieste con segmenti dedotti in cui il tipo di servizio è «aws:DynamoDB»

rootcause.fault.service { inferred and name = traces and type = "AWS::DynamoDB" }

Esempio — richieste che hanno come radice un segmento con il nome «data-plane»

service("data-plane") {root = true and fault = true}

Parole chiave numeriche

Utilizzare le parole chiave numeriche per ricercare le richieste con un tempo di risposta, una durata o un codice di stato della risposta specifici.

Parole chiave numeriche

• responsetime— Tempo impiegato dal server per inviare una risposta.

• duration— Durata totale della richiesta, incluse tutte le chiamate downstream.

• http.status— Codice di stato della risposta.

• index— Posizione di un elemento in un elenco enumerato.

• coverage— Percentuale decimale del tempo di risposta dell'entità rispetto al tempo di risposta del segmento principale. Applicabile solo per le entità causa principale del tempo di risposta.

Operatori numerici

Le parole chiave numeriche utilizzano gli operatori di uguaglianza e di confronto standard.

• =, != — La parola chiave è uguale o diversa da un valore numerico.

• <,<=,>, >= — La parola chiave è minore o maggiore di un valore numerico.

Esempio — lo stato della risposta non è 200 OK

http.status != 200

Esempio — richiesta in cui la durata totale era di 5—8 secondi

duration >= 5 AND duration <= 8

Esempio — richieste completate con successo in meno di 3 secondi, comprese tutte le chiamate a valle

ok !partial duration <3

Esempio — entità di elenco enumerato con un indice maggiore di 5

rootcause.fault.service { index > 5 }

Esempio — richieste in cui l'ultima entità con copertura è superiore a 0,8

rootcause.responsetime.entity { last and coverage > 0.8 }

Parole chiave stringa

Le parole chiave stringa permettono di trovare i tracciamenti con testo specifico all'interno delle intestazioni della richiesta o con specifici ID utente.

Parole chiave stringa

• http.url— URL della richiesta.

• http.method— Metodo di richiesta.

• http.useragent— Richiedere la stringa dell'agente utente.

• http.clientip— Indirizzo IP del richiedente.

• user— Valore del campo utente su qualsiasi segmento della traccia.

• name— Il nome di un servizio o di un'eccezione.

• type— Tipo di servizio.

• message— Messaggio di eccezione.

• availabilityzone— Valore del campo availabilityzone su qualsiasi segmento della traccia.

• instance.id— Valore del campo ID dell'istanza su qualsiasi segmento della traccia.

• resource.arn— Valore del campo ARN della risorsa su qualsiasi segmento della traccia.

Gli operatori di stringa selezionano valori che sono uguali a, o contengono, un testo specifico. I valori devono essere sempre specificati tra virgolette.

Operatori di stringa

• =, != — La parola chiave è uguale o diversa da un valore numerico.

• CONTAINS— La parola chiave contiene una stringa specifica.

• BEGINSWITH, ENDSWITH — La parola chiave inizia o termina con una stringa specifica.

Esempio — filtro http.url

http.url CONTAINS "/api/game/"

Per verificare se un campo esiste all'interno di un tracciamento, indipendentemente dal suo valore, verificare se contiene la stringa vuota.

Esempio — filtro utente

Trova tutti i tracciamenti contenenti ID degli utenti.

user CONTAINS ""

Esempio — seleziona le tracce con una causa principale dell'errore che include un servizio denominato «Auth»

rootcause.fault.service { name = "Auth" }

Esempio — seleziona le tracce con una root cause del tempo di risposta il cui ultimo servizio ha un tipo di DynamoDB

rootcause.responsetime.service { last and type = "AWS::DynamoDB" }

Esempio — seleziona le tracce con una causa principale di errore la cui ultima eccezione è il messaggio «accesso negato per account_id: 1234567890"

rootcause.fault.exception { last and message = "Access Denied for account_id: 1234567890" 

Parole chiave complesse

Le parole chiave complesse permettono di selezionare le richieste in base a nome del servizio, nome edge o valore dell'annotazione. Per servizi e collegamenti, puoi specificare un ulteriore espressione filtro che si applica al servizio o al collegamento. Per le annotazioni, puoi filtrare in base al valore di un'annotazione con una specifica chiave utilizzando operatori booleani, numerici o stringa.

Parole chiave complesse

• annotation.key— Valore di un'annotazione con chiave di campo. Il valore di un'annotazione può essere un valore booleano, numerico o stringa, perciò puoi usare un operatore di confronto di uno qualsiasi di questi tipi. È possibile utilizzare questa parola chiave in combinazione con la edge parola chiave service o.

• edge(source, destination) {filter}— Connessione tra origine e destinazione dei servizi. Le parentesi graffe opzionali possono contenere un'espressione filtro che si applica ai segmenti della connessione.

• group.name / group.arn— Il valore dell'espressione di filtro di un gruppo, a cui fa riferimento il nome del gruppo o l'ARN del gruppo.

• json— Oggetto della causa principale JSON. Vedi Acquisizione di dati da AWS X-Ray per i passaggi per creare entità JSON a livello di codice.

• service(name) {filter}— Servizio con nome e nome. Le parentesi graffe opzionali possono contenere un'espressione filtro che si applica ai segmenti creati dal servizio.

Utilizza la parola chiave service per trovare le tracce delle richieste che raggiungono un determinato nodo sulla mappa di tracciamento.

Gli operatori di parole chiave complesse trovano i segmenti in cui è stata impostata o non è stata impostata la chiave specificata.

Operatori di parole chiave complessi

• nessuno: l'espressione è vera se la parola chiave è impostata. Se la parola chiave è di tipo booleano, restituirà il valore booleano.

• !— L'espressione è vera se la parola chiave non è impostata. Se la parola chiave è di tipo booleano, restituirà il valore booleano.

• =, != — Confronta il valore della parola chiave.

• edge(source, destination) {filter}— Connessione tra origine e destinazione dei servizi. Le parentesi graffe opzionali possono contenere un'espressione filtro che si applica ai segmenti della connessione.

• annotation.key— Valore di un'annotazione con chiave di campo. Il valore di un'annotazione può essere un valore booleano, numerico o stringa, perciò puoi usare un operatore di confronto di uno qualsiasi di questi tipi. È possibile utilizzare questa parola chiave in combinazione con la edge parola chiave service o.

• json— Oggetto della causa principale JSON. Vedi Acquisizione di dati da AWS X-Ray per i passaggi per creare entità JSON a livello di codice.

Utilizza la parola chiave service per trovare le tracce delle richieste che raggiungono un determinato nodo sulla mappa di tracciamento.

Esempio — Filtro di servizio

Richieste che includevano una chiamata a api.example.com e che si sono concluse con un malfunzionamento (errore serie 500).

service("api.example.com") { fault }

Puoi escludere il nome del servizio per applicare un'espressione filtro a tutti i nodi della tua mappa del servizio.

Esempio — filtro di servizio

Richieste che hanno causato un errore in qualsiasi punto della mappa di tracciamento.

service() { fault }

La parola chiave edge applica un'espressione filtro a una connessione tra due nodi.

Esempio — filtro perimetrale

Richiesta in cui il servizio api.example.com ha eseguito una chiamata verso backend.example.com che si è conclusa con un errore.

edge("api.example.com", "backend.example.com") { error }

Puoi inoltre utilizzare l'operatore ! con le parole chiave service ed edge per escludere un servizio o un collegamento dai risultati di un'altra espressione filtro.

Esempio — filtro di servizio e richiesta

Richiesta in cui l'URL inizia con http://api.example.com/ e contiene /v2/ ma non raggiunge un servizio denominato api.example.com.

http.url BEGINSWITH "http://api.example.com/" AND http.url CONTAINS "/v2/" AND !service("api.example.com")

Esempio — filtro del servizio e del tempo di risposta

Trova le tracce dove http url è impostato e il tempo di risposta è superiore a 2 secondi.

http.url AND responseTime > 2

Per le annotazioni, puoi richiamare tutte le tracce in cui annotation.key è impostato o utilizzare gli operatori di confronto che corrispondono al tipo di valore.

Esempio — annotazione con valore di stringa

Richieste con un'annotazione denominata gameid con valore stringa "817DL6VO".

annotation.gameid = "817DL6VO"

Esempio — l'annotazione è impostata

Richieste con un'annotazione denominata age set.

annotation.age

Esempio — l'annotazione non è impostata

Richieste senza un'annotazione denominata age set.

!annotation.age

Esempio — annotazione con valore numerico

Richieste con annotazione age con valore numerico maggiore di 29.

annotation.age > 29

Esempio — annotazione in combinazione con service o edge

service { annotation.request_id = "917DL6VO" }

edge { source.annotation.request_id = "916DL6VO" }

edge { destination.annotation.request_id = "918DL6VO" }

Esempio — gruppo con utente

Richiede in cui le tracce soddisfano il filtro di high_response_time gruppo (ad esempioresponseTime > 3) e l'utente si chiama Alice.

group.name = "high_response_time" AND user = "alice"

Esempio — JSON con entità root cause

Le richieste con entità causa principale corrispondenti.

rootcause.json = #[{ "Services": [ { "Name": "GetWeatherData", "EntityPath": [{ "Name": "GetWeatherData" }, { "Name": "get_temperature" } ] }, { "Name": "GetTemperature", "EntityPath": [ { "Name": "GetTemperature" } ] } ] }]

funzione id

Quando indichi un nome di servizio per le parole chiave service o edge, ottieni risultati per tutti i nodi con tale nome. Per una maggiore precisione del filtraggio, puoi utilizzare la funzione id per specificare un tipo di servizio in aggiunta ad un nome per distinguere tra nodi con lo stesso nome.

Utilizza la account.id funzione per specificare un particolare account per il servizio, quando visualizzi le tracce di più account in un account di monitoraggio.

id(name: "service-name", type:"service::type", account.id:"account-ID")

Puoi utilizzare la funzione id al posto di un nome di servizio nei filtri service ed edge.

service(id(name: "service-name", type:"service::type")) { filter }

edge(id(name: "service-one", type:"service::type"), id(name: "service-two", type:"service::type")) { filter }

Ad esempio, AWS Lambda le funzioni generano due nodi nella mappa di traccia: uno per la chiamata della funzione e uno per il servizio Lambda. I due nodi hanno lo stesso nome ma appartengono a tipi diversi. Un filtro sul servizio standard troverà i tracciamenti relativi a entrambi.

Esempio — filtro di servizio

Richieste che includono un errore su qualsiasi servizio denominato random-name.

service("function-name") { error }

Utilizza la funzione id per restringere la ricerca a errori sulla funzione stessa, escludendo gli errori del servizio.

Esempio — filtro di servizio con funzione id

Richieste che includono un errore su un servizio denominato random-name di tipo AWS::Lambda::Function.

service(id(name: "random-name", type: "AWS::Lambda::Function")) { error }

Per ricercare i nodi in base al tipo, puoi anche omettere completamente il nome.

Esempio — filtro di servizio con funzione id e tipo di servizio

Richieste che includono un errore su un servizio di tipo AWS::Lambda::Function.

service(id(type: "AWS::Lambda::Function")) { error }

Per cercare i nodi per un particolare Account AWS, specifica un ID di account.

Esempio — filtro di servizio con funzione id e ID account

Richieste che includono un servizio all'interno di un ID account specificoAWS::Lambda::Function.

service(id(account.id: "account-id"))

Tracciamento tra account

AWS X-Ray supporta l'osservabilità tra account, consentendoti di monitorare e risolvere i problemi delle applicazioni che si estendono su più account all'interno di uno stesso. Regione AWS Puoi cercare, visualizzare e analizzare senza interruzioni le tue metriche, i log e le tracce in tutti gli account collegati come se stessi operando in un unico account. Ciò fornisce una visione completa delle richieste che viaggiano su più account. È possibile visualizzare le tracce tra account nella mappa di tracciamento X-Ray e le pagine delle tracce all'interno della CloudWatch console.

I dati di osservabilità condivisi possono includere uno dei seguenti tipi di telemetria:

• Metriche in Amazon CloudWatch

• Gruppi di log in Amazon CloudWatch Logs

• Tracce in AWS X-Ray

• Applicazioni in Amazon CloudWatch Application Insights

Configura l'osservabilità tra account

Per attivare l'osservabilità tra più account, configura uno o più account di AWS monitoraggio e collegali a più account di origine. Un account di monitoraggio è una centrale in Account AWS grado di visualizzare e interagire con i dati di osservabilità generati dagli account di origine. Un account di origine è un individuo Account AWS che genera dati di osservabilità per le risorse che contiene.

Gli account di origine condividono i dati di osservabilità con gli account di monitoraggio. Le tracce vengono copiate da ciascun account di origine su un massimo di cinque account di monitoraggio. Le copie delle tracce dagli account di origine al primo account di monitoraggio sono gratuite. Le copie delle tracce inviate ad account di monitoraggio aggiuntivi vengono addebitate a ciascun account di origine, in base alla tariffa standard. Per ulteriori informazioni, consulta AWS X-Ray i prezzi e i CloudWatch prezzi di Amazon.

Per creare collegamenti tra gli account di monitoraggio e gli account di origine, utilizza la CloudWatch console o i nuovi comandi di Observability Access Manager nell'API AWS CLI and. Per ulteriori informazioni, consulta osservabilità CloudWatch tra account.

Nota

Le tracce a raggi X vengono fatturate nel Account AWS luogo in cui vengono ricevute. Se una richiesta campionata riguarda più di un servizio Account AWS, ogni account registra una traccia separata e tutte le tracce condividono lo stesso ID di traccia. Per ulteriori informazioni sui prezzi osservabili su più account, consulta i prezzi e AWS X-Ray i prezzi di Amazon CloudWatch .

Visualizzazione delle tracce tra account

Le tracce tra account vengono visualizzate nell'account di monitoraggio. Ogni account di origine visualizza solo le tracce locali per quell'account specifico. Le sezioni seguenti presuppongono che tu abbia effettuato l'accesso all'account di monitoraggio e che tu abbia aperto la CloudWatch console Amazon. Sia sulla mappa di tracciamento che sulla pagina delle tracce, nell'angolo in alto a destra viene visualizzato un badge dell'account di monitoraggio.

Mappa di tracciamento

Nella CloudWatch console, scegli Trace Map in X-Ray Traces dal riquadro di navigazione a sinistra. Per impostazione predefinita, la mappa di tracciamento mostra i nodi per tutti gli account di origine che inviano le tracce all'account di monitoraggio e i nodi per l'account di monitoraggio stesso. Sulla mappa di traccia, scegli Filtri in alto a sinistra per filtrare la mappa di traccia utilizzando il menu a discesa Account. Dopo aver applicato un filtro di account, i nodi di servizio degli account che non corrispondono al filtro corrente vengono visualizzati in grigio.

Quando si sceglie un nodo di servizio, il riquadro dei dettagli del nodo include l'ID e l'etichetta dell'account del servizio.

Nell'angolo in alto a destra della mappa di traccia, scegli Visualizzazione elenco per visualizzare un elenco di nodi di servizio. L'elenco dei nodi di servizio include i servizi dell'account di monitoraggio e tutti gli account di origine configurati. Filtra l'elenco dei nodi in base all'etichetta dell'account o all'ID dell'account scegliendoli dal filtro Nodi.

Tracce

Visualizza i dettagli di tracciamento per le tracce che si estendono su più account aprendo la CloudWatch console dall'account di monitoraggio e selezionando Tracce in Tracce a raggi X nel riquadro di navigazione a sinistra. È inoltre possibile aprire questa pagina selezionando un nodo nella X-Ray Trace Map, quindi scegliendo Visualizza tracce dal riquadro dei dettagli del nodo.

La pagina Traces supporta l'interrogazione per ID account. Per iniziare, inserisci una query che includa uno o più ID account. Per ulteriori informazioni sulle interrogazioni, vedere. Usa le espressioni di filtro Le seguenti interrogazioni di esempio per le tracce che sono passate attraverso l'ID di account X o Y:

service(id(account.id:"X")) OR service(id(account.id:"Y"))

Perfeziona la tua richiesta per account. Seleziona uno o più account dall'elenco e scegli Aggiungi alla query.

Dettagli di tracciamento

Visualizza i dettagli di una traccia selezionandola dall'elenco Tracce nella parte inferiore della pagina Tracce. Vengono visualizzati i dettagli di Trace, inclusa una mappa dei dettagli di traccia con i nodi di servizio di tutti gli account attraversati dalla traccia. Scegli un nodo di servizio specifico per visualizzare l'account corrispondente.

La sezione Cronologia dei segmenti mostra i dettagli dell'account per ogni segmento della sequenza temporale.

Traccia le applicazioni basate sugli eventi

AWS X-Ray supporta il tracciamento di applicazioni basate su eventi utilizzando Amazon SQS e. AWS Lambda Usa la CloudWatch console per visualizzare una vista connessa di ogni richiesta mentre viene messa in coda con Amazon SQS ed elaborata da una o più funzioni Lambda. Le tracce dei produttori di messaggi upstream vengono automaticamente collegate alle tracce dei nodi consumer Lambda a valle, creando una end-to-end visualizzazione dell'applicazione.

Nota

Ogni segmento di traccia può essere collegato a un massimo di 20 tracce, mentre una traccia può includere un massimo di 100 link. In alcuni scenari, il collegamento di tracce aggiuntive può comportare il superamento della dimensione massima del documento di traccia, causando una traccia potenzialmente incompleta. Ciò può accadere, ad esempio, quando una funzione Lambda con tracciamento abilitato invia molti messaggi SQS a una coda in un'unica chiamata. Se si verifica questo problema, è disponibile una soluzione di mitigazione che utilizza gli X-Ray SDK. Per ulteriori informazioni, consulta X-Ray SDK per Java, Node.js,Python, Go o.NET.

Visualizza le tracce collegate nella mappa di tracciamento

Utilizza la pagina Trace Map all'interno della CloudWatchconsole per visualizzare una mappa di traccia con le tracce dei produttori di messaggi collegate alle tracce dei consumatori Lambda. Questi collegamenti vengono visualizzati con un bordo tratteggiato che collega il nodo Amazon SQS e i nodi consumer Lambda downstream.

Seleziona un bordo tratteggiato per visualizzare un istogramma dell'età degli eventi ricevuti, che mappa la diffusione dell'età dell'evento quando viene ricevuto dai consumatori. L'età viene calcolata ogni volta che viene ricevuto un evento.

Visualizza i dettagli della traccia collegata

Visualizza i dettagli di tracciamento inviati da un produttore di messaggi, da una coda Amazon SQS o da un consumatore Lambda:

1. Usa la Trace Map per selezionare un produttore di messaggi, un nodo consumer Amazon SQS o Lambda.

2. Scegli Visualizza tracce dal riquadro dei dettagli del nodo per visualizzare un elenco di tracce. Puoi anche accedere direttamente alla pagina Traces all'interno della CloudWatch console.

3. Scegli una traccia specifica dall'elenco per aprire la pagina dei dettagli della traccia. La pagina dei dettagli della traccia visualizza un messaggio quando la traccia selezionata fa parte di un set di tracce collegato.

   

La mappa dei dettagli della traccia mostra la traccia corrente, insieme alle tracce collegate a monte e a valle, ognuna delle quali è contenuta in un riquadro che indica i limiti di ciascuna traccia. Se la traccia attualmente selezionata è collegata a più tracce a monte o a valle, i nodi all'interno delle tracce collegate a monte o a valle vengono impilati e viene visualizzato il pulsante Seleziona traccia.

Sotto la mappa dei dettagli della traccia, viene visualizzata una sequenza temporale dei segmenti di traccia, incluse le tracce collegate a monte e a valle. Se sono presenti più tracce collegate a monte o a valle, i relativi dettagli del segmento non possono essere visualizzati. Per visualizzare i dettagli del segmento per una singola traccia all'interno di un insieme di tracce collegate, selezionate una singola traccia come descritto nella sezione seguente.

Seleziona una singola traccia all'interno di un insieme di tracce collegate

Filtra un set di tracce collegato a una singola traccia per visualizzare i dettagli del segmento nella timeline.

1. Scegli Seleziona traccia sotto le tracce collegate sulla mappa dei dettagli della traccia. Viene visualizzato un elenco di tracce.

   

2. Seleziona il pulsante di opzione accanto a una traccia per visualizzarla all'interno della mappa dei dettagli della traccia.

3. Scegliete Annulla la selezione della traccia per visualizzare l'intero set di tracce collegate.

   

Usa istogrammi di latenza

Quando si seleziona un nodo o un bordo su una mappa di traccia, la console X-Ray mostra un istogramma di distribuzione della latenza.

Latenza

La latenza è la quantità di tempo compresa tra il momento in cui una richiesta inizia e quello in cui viene completata. Un istogramma mostra una distribuzione di latenze. Mostra la durata sull'asse delle X e la percentuale di richieste che corrispondono a ciascuna durata sull'asse delle Y.

Questo istogramma mostra un servizio che completa la maggior parte delle richieste in meno di 300 ms. Una piccola percentuale di richieste richiedere fino a 2 secondi e alcuni valori erratici richiedono più tempo.

Interpretazione dei dettagli del servizio

Gli istogrammi del servizio e del collegamento forniscono una rappresentazione visiva della latenza dal punto di vista di un servizio o di un richiedente.

• Scegliete un nodo di servizio facendo clic sul cerchio. X-Ray mostra un istogramma per le richieste servite dal servizio. Le latenze sono quelle registrate dal servizio e non includono la latenza di rete tra il servizio e il richiedente.

• Scegliete uno spigolo facendo clic sulla linea o sulla punta della freccia dello spigolo tra due servizi. X-Ray mostra un istogramma per le richieste del richiedente che sono state servite dal servizio downstream. Le latenze sono quelle registrate dal richiedente e includono la latenza di rete tra i due servizi.

Per interpretare il pannello dell'istogramma dei Service details (Dettagli del servizio), puoi cercare i valori che differiscono maggiormente dalla gran parte dei valori nell'istogramma. Questi valori erratici possono essere visualizzati come picchi o punte nell'istogramma, ed è possibile visualizzare i tracciamenti relativi ad una specifica area per analizzare il problema.

Per visualizzare i tracciamenti filtrati per la latenza, seleziona un intervallo sull'istogramma. Fai clic sul punto in cui desideri avviare la selezione e trascina da sinistra verso destra per evidenziare un intervallo di latenze da includere nel filtro dei tracciamenti.

Dopo aver selezionato un intervallo, puoi scegliere Zoom per visualizzare solo quella parte di istogramma e restringere la selezione.

Una volta impostata l'area di interesse, scegli View traces (Visualizza tracciamenti).

Usa X-Ray Insights

AWS X-Ray analizza continuamente i dati di traccia presenti nel tuo account per identificare problemi emergenti nelle tue applicazioni. Quando le percentuali di errore superano l'intervallo previsto, crea una panoramica che registra il problema e ne monitora l'impatto fino alla sua risoluzione. Con Insights, puoi:

• Identifica l'area dell'applicazione in cui si verificano i problemi, la causa principale del problema e l'impatto associato. L'analisi dell'impatto fornita da Insights consente di determinare la gravità e la priorità di un problema.

• Ricevi notifiche man mano che il problema cambia nel tempo. Le notifiche Insights possono essere integrate con la tua soluzione di monitoraggio e avviso utilizzando Amazon EventBridge. Questa integrazione consente di inviare e-mail o avvisi automatici in base alla gravità del problema.

La console X-Ray identifica i nodi con incidenti in corso nella mappa di tracciamento. Per visualizzare un riepilogo delle informazioni, scegli il nodo interessato. Puoi anche visualizzare e filtrare Insights scegliendo Insights dal riquadro di navigazione a sinistra.

X-Ray crea informazioni dettagliate quando rileva un'anomalia in uno o più nodi della mappa dei servizi. Il servizio utilizza modelli statistici per prevedere i tassi di errore previsti dei servizi dell'applicazione. Nell'esempio precedente, l'anomalia è un aumento dei guasti da. AWS Elastic Beanstalk Il server Elastic Beanstalk ha registrato diversi timeout delle chiamate API, che hanno causato un'anomalia nei nodi downstream.

Abilita Insights nella console X-Ray

Insights deve essere abilitato per ogni gruppo con cui desideri utilizzare le funzionalità di Insights. Puoi abilitare gli approfondimenti dalla pagina Gruppi.

1. Apri la console X-Ray.

2. Seleziona un gruppo esistente o creane uno nuovo scegliendo Crea gruppo, quindi seleziona Abilita Insights. Per ulteriori informazioni sulla configurazione dei gruppi nella console X-Ray, vedere. Configura i gruppi

3. Nel riquadro di navigazione a sinistra, scegli Insights, quindi scegli un approfondimento da visualizzare.

   

Nota

X-Ray utilizza GetInsightSummaries, GetInsight GetInsightEvents, e le operazioni GetInsightImpactGraph API per recuperare i dati dagli approfondimenti. Per visualizzare gli approfondimenti, utilizza la policy gestita da AWSXrayReadOnlyAccess IAM o aggiungi la seguente policy personalizzata al tuo ruolo IAM:

          {
             "Version": "2012-10-17",
             "Statement": [
                 {
                     "Effect": "Allow",
                     "Action": [
                         "xray:GetInsightSummaries",
                         "xray:GetInsight",
                         "xray:GetInsightEvents",
                         "xray:GetInsightImpactGraph"
                     ],
                     "Resource": [
                         "*"
                     ]
                 }
             ]
         }
      

Per ulteriori informazioni, consulta Come AWS X-Ray funziona con IAM.

Abilita le notifiche di approfondimenti

Con le notifiche di approfondimenti, viene creata una notifica per ogni evento di approfondimento, ad esempio quando un approfondimento viene creato, cambia in modo significativo o viene chiuso. I clienti possono ricevere queste notifiche tramite Amazon EventBridge Events e utilizzare regole condizionali per intraprendere azioni come la notifica SNS, la chiamata Lambda, la pubblicazione di messaggi in una coda SQS o uno qualsiasi dei target supportati. EventBridge Le notifiche Insights vengono emesse con la massima diligenza possibile, ma non sono garantite. Per ulteriori informazioni sugli obiettivi, consulta Amazon EventBridge Targets.

Puoi abilitare le notifiche di Insights per qualsiasi gruppo abilitato a Insights dalla pagina Gruppi.

Per abilitare le notifiche per un gruppo X-Ray

1. Apri la console X-Ray.

2. Seleziona un gruppo esistente o creane uno nuovo scegliendo Crea gruppo, assicurati che sia selezionato Enable Insights, quindi seleziona Abilita notifiche. Per ulteriori informazioni sulla configurazione dei gruppi nella console X-Ray, vedere. Configura i gruppi

Per configurare le regole EventBridge condizionali di Amazon

1. Apri la EventBridge console Amazon.

2. Vai a Regole nella barra di navigazione a sinistra e scegli Crea regola.

3. Fornisci un nome e una descrizione per la regola.

4. Scegli Modello di evento, quindi scegli Modello personalizzato. Fornisci uno schema contenente "source": [ "aws.xray" ] e"detail-type": [ "AWS X-Ray Insight Update" ]. Di seguito sono riportati alcuni esempi di modelli possibili.

   • Schema di eventi per abbinare tutti gli eventi in arrivo da X-Ray Insights:

     {
     "source": [ "aws.xray" ],
     "detail-type": [ "AWS X-Ray Insight Update" ]
     }

   • Schema di eventi che corrisponda a uno specifico state e: category

              
     {
     "source": [ "aws.xray" ],
     "detail-type": [ "AWS X-Ray Insight Update" ],
     "detail": {
             "State": [ "ACTIVE" ],
             "Category": [ "FAULT" ]
       }
     }
                 

5. Seleziona e configura i target che desideri richiamare quando un evento corrisponde a questa regola.

6. (Facoltativo) Fornisci tag per identificare e selezionare più facilmente questa regola.

7. Scegli Crea.

Nota

Le notifiche X-Ray Insights inviano eventi ad Amazon EventBridge, che attualmente non supporta le chiavi gestite dai clienti. Per ulteriori informazioni, consulta Protezione dei dati in AWS X-Ray.

Panoramica di Insight

La pagina di panoramica per un approfondimento tenta di rispondere a tre domande chiave:

• Qual è il problema di fondo?

• Qual è la causa principale?

• Qual è l'impatto?

La sezione Servizi anomali mostra una sequenza temporale per ogni servizio che illustra la variazione delle percentuali di guasto durante l'incidente. La sequenza temporale mostra il numero di tracce con guasti sovrapposti su una banda continua che indica il numero previsto di guasti in base alla quantità di traffico registrata. La durata dell'analisi viene visualizzata nella finestra Incidente. La finestra incidente inizia quando X-Ray osserva che la metrica diventa anomala e persiste mentre l'analisi è attiva.

L'esempio seguente mostra un aumento dei guasti che hanno causato un incidente:

La sezione Root Cause mostra una mappa di traccia incentrata sul servizio della causa principale e sul percorso interessato. È possibile nascondere i nodi non interessati selezionando l'icona a forma di occhio in alto a destra nella mappa della causa principale. Il servizio root cause è il nodo più a valle in cui X-Ray ha identificato un'anomalia. Può rappresentare un servizio strumentato dall'utente o un servizio esterno richiamato dal servizio con un client dotato di strumentazione. Ad esempio, se chiami Amazon DynamoDB con un client SDK AWS strumentato, un aumento degli errori causati da DynamoDB si traduce in un'analisi approfondita con DynamoDB come causa principale.

Per approfondire la causa principale, seleziona Visualizza i dettagli della causa principale nel grafico della causa principale. Puoi utilizzare la pagina Analytics per esaminare la causa principale e i messaggi correlati. Per ulteriori informazioni, consulta Interagisci con la console Analytics.

I guasti che continuano a monte della mappa possono avere un impatto su più nodi e causare anomalie multiple. Se un errore viene passato all'utente che ha effettuato la richiesta, il risultato è un errore del client. Si tratta di un errore nel nodo principale della mappa di traccia. Il grafico Impact fornisce una cronologia dell'esperienza del cliente per l'intero gruppo. Questa esperienza viene calcolata in base alle percentuali dei seguenti stati: Fault, Error, Throttle e Okay.

Questo esempio mostra un aumento delle tracce con un guasto al nodo principale durante il periodo di un incidente. Gli incidenti nei servizi downstream non sempre corrispondono a un aumento degli errori dei client.

Scegliendo Analyze insight si apre la console di X-Ray Analytics in una finestra in cui è possibile approfondire l'insieme di tracce che causano l'analisi. Per ulteriori informazioni, consulta Interagisci con la console Analytics.

Comprendere l'impatto

AWS X-Ray misura l'impatto causato da un problema in corso nell'ambito della generazione di approfondimenti e notifiche. L'impatto viene misurato in due modi:

• Impatto sul gruppo X-Ray. Per ulteriori informazioni, vedere Configurare i gruppi

• Impatto sul servizio root cause

Questo impatto è determinato dalla percentuale di richieste non riuscite o che causano un errore entro un determinato periodo di tempo. Questa analisi dell'impatto consente di determinare la gravità e la priorità del problema in base allo scenario specifico. Questo impatto è disponibile come parte dell'esperienza da console, oltre alle notifiche di approfondimenti.

Deduplicazione

AWS X-Ray insights deduplica i problemi su più microservizi. Utilizza il rilevamento delle anomalie per determinare il servizio che è la causa principale di un problema, determina se altri servizi correlati presentano un comportamento anomalo dovuto alla stessa causa principale e registra il risultato come un'unica analisi.

Esamina lo stato di avanzamento di un'analisi

X-Ray rivaluta periodicamente gli approfondimenti fino a quando non vengono risolti e registra ogni modifica intermedia importante come notifica, che può essere inviata come evento Amazon. EventBridge Ciò consente di creare processi e flussi di lavoro per determinare in che modo il problema è cambiato nel tempo e di intraprendere le azioni appropriate, come l'invio di un'e-mail o l'integrazione con un sistema di avviso utilizzando. EventBridge

È possibile esaminare gli eventi relativi agli incidenti nella cronologia degli impatti nella pagina Inspect. Per impostazione predefinita, la cronologia mostra il servizio più interessato fino a quando non si sceglie un servizio diverso.

Per visualizzare una mappa di tracciamento e i grafici di un evento, sceglili dalla timeline dell'impatto. La mappa di tracciamento mostra i servizi dell'applicazione interessati dall'incidente. Nella sezione Analisi dell'impatto, i grafici mostrano le tempistiche dei guasti per il nodo selezionato e per i client del gruppo.

Per dare un'occhiata più approfondita alle tracce coinvolte in un incidente, scegli Analizza evento nella pagina Inspect. Puoi utilizzare la pagina Analytics per rifinire l'elenco delle tracce e identificare gli utenti interessati. Per ulteriori informazioni, consulta Interagisci con la console Analytics.

Interagisci con la console Analytics

La console AWS X-Ray Analytics è uno strumento interattivo per interpretare i dati di traccia per comprendere rapidamente le prestazioni dell'applicazione e dei servizi sottostanti. La console consente di esplorare, analizzare e visualizzare i tracciamenti tramite tempo di risposta interattivo e grafici di serie temporali.

Quando si effettuano selezioni nella console di analisi, la console crea dei filtri per riflettere il sottoinsieme selezionato di tutti i tracciamenti. È possibile definire il set di dati attivo con filtri sempre più granulari facendo clic sui grafici e i pannelli di parametri e campi associati con il set di tracciamenti corrente.

Caratteristiche della console

La console X-Ray Analytics utilizza le seguenti funzionalità chiave per raggruppare, filtrare, confrontare e quantificare i dati di traccia.

Funzionalità

Funzionalità	Descrizione
Groups (Gruppi)	Il gruppo selezionato inizialmente è Default. Per modificare il gruppo recuperato, selezionare un gruppo diverso dal menu a destra della barra di ricerca dell’espressione di filtro principale. Per ulteriori informazioni sui gruppi, consulta Configurare i gruppi.
Retrieved traces (Tracciamenti recuperati)	Per impostazione predefinita, la console di analisi genera grafici in base a tutti i tracciamenti nel gruppo selezionato. I tracciamenti recuperati rappresentano tutti i tracciamenti nel set di lavoro. Puoi trovare il conteggio dei tracciamenti in questo riquadro. Le espressioni di filtro applicate alla barra di ricerca principale definiscono e aggiornano i tracciamenti recuperati.
Show in charts/Hide from charts (Mostra in grafici/Nascondi da grafici)	Un elemento di attivazione/disattivazione per confrontare il gruppo attivo rispetto ai tracciamenti recuperati. Per confrontare i dati relativi al gruppo rispetto a tutti i filtri attivi, scegliere Show in charts (Mostra in grafici). Per rimuovere questa visualizzazione dai grafici, scegliere Hide from charts (Nascondi da grafici).
Filtered trace set A (Set di tracciamenti filtrato A)	Attraverso le interazioni con i grafici e le tabelle, applica i filtri per creare i criteri per il set di tracce filtrato A. Man mano che i filtri vengono applicati, il numero di tracce applicabili e la percentuale di tracce recuperate rispetto al totale vengono calcolati all'interno di questo riquadro. I filtri sono inseriti come tag all'interno del riquadro Filtered trace set A (Set di tracce filtrate A e possono anche essere rimossi dal riquadro.
Refine (Definisci)	Questa funzione aggiorna il set di tracce recuperate in base ai filtri applicati al set di tracce A. Il perfezionamento del set di tracce recuperate aggiorna il working set di tutte le tracce recuperate in base ai filtri per il set di tracce A. Il working set di tracce recuperate è un sottoinsieme campionato di tutte le tracce nel gruppo.
Filtered trace set B (Set di tracciamenti filtrato B)	Una volta creato, il set di tracce filtrato B è una copia del set di tracce filtrato A. Per confrontare i due set di tracce, effettuate nuove selezioni di filtri da applicare al set di tracce B, mentre il set di tracce A rimane fisso. Quando i filtri vengono applicati, il numero di tracciamenti applicabili e la percentuale di tracciamenti dal totale recuperati sono calcolati all'interno di questo riquadro. I filtri sono inseriti come tag all'interno del riquadro Filtered trace set B (Set di tracce filtrate B) e possono anche essere rimossi dal riquadro.
Response Time Root Cause Entity Paths (Percorsi di entità causa principale del tempo di risposta)	Una tabella dei percorsi delle entità registrate. X-Ray determina quale percorso della traccia è la causa più probabile del tempo di risposta. Il formato indica una gerarchia di entità incontrate che termina in una causa principale del tempo di risposta. Utilizza queste righe per filtrare gli errori ricorrenti del tempo di risposta. Per ulteriori informazioni sulla personalizzazione di un filtro della causa principale e sull'acquisizione dei dati tramite l'API, consulta la sezione Recupero e perfezionamento dell'analisi della causa principale in. Acquisizione di dati da X-Ray
Delta (�)	Una colonna che viene aggiunta alle tabelle di parametri quando sia il set di tracce A che il set di tracce B sono attivi. La colonna del Delta calcola la differenza nella percentuale di tracce tra il set di tracce A e il set di tracce B.

Distribuzione del tempo di risposta

La console X-Ray Analytics genera due grafici principali per aiutarti a visualizzare le tracce: la distribuzione del tempo di risposta e l'attività delle serie temporali. In questa sezione e nella seguente sono forniti esempi di ognuno e le informazioni di base per leggere i grafici.

Di seguito sono elencati i colori associati al grafico della linea temporale di risposta (il grafico delle serie temporali impiega la stessa combinazione di colori):

• Tutte le tracce del gruppo: grigie

• Tracce recuperate: arancione

• Set di tracce filtrate A — verde

• Set di tracce filtrate B — blu

Esempio — Distribuzione del tempo di risposta

La distribuzione del tempo di risposta è un grafico che mostra il numero di tracciamenti con un determinato tempo di risposta. Fare clic e trascinare per effettuare selezioni all'interno della distribuzione del tempo di risposta. Questa operazione seleziona e crea un filtro sul set di tracciamenti di lavoro denominato responseTime per tutti i tracciamenti all'interno di un determinato tempo di risposta.

Attività delle serie temporali

Il grafico dell’attività di serie temporali mostra il numero di tracciamenti in un determinato intervallo di tempo. Gli indicatori di colore rispecchiano i colore del grafico a linee della distribuzione del tempo di risposta. Più è scuro e pieno il blocco di colore all’interno della serie dell’attività, più sono i tracciamenti rappresentati in quel determinato momento.

Esempio — Attività delle serie temporali

Fare clic e trascinare per effettuare selezioni all'interno del grafico di attività delle serie temporali. Questa operazione seleziona e crea un filtro denominato timerange sul set di tracciamenti di lavoro per tutti i tracciamenti all'interno di uno specifico intervallo di tempo.

Esempi di flussi di lavoro

Gli esempi seguenti mostrano casi d'uso comuni per la console X-Ray Analytics. Ogni esempio illustra una funzione chiave dell'esperienza della console. Come gruppo, gli esempi seguono un flusso di lavoro di risoluzione dei problemi di base. La procedura illustra come individuare i nodi non integri e quindi come interagire con la console di Analytics per generare automaticamente query comparative. Una volta ristretto l'ambito attraverso le query, sarà possibile visualizzare finalmente i dettagli delle tracce di interesse per determinare cosa sta danneggiando lo stato del servizio.

Osservare gli errori sul grafico di servizio

La mappa di traccia indica lo stato di salute di ogni nodo colorandolo in base al rapporto tra chiamate riuscite ed errori e guasti. Quando viene visualizzata una percentuale di rosso sul nodo, è segnalato un errore. Usa la console X-Ray Analytics per analizzarlo.

Per ulteriori informazioni su come leggere la mappa di tracciamento, vedere Utilizzare la mappa di tracciamento a raggi X..

Identificare i picchi del tempo di risposta

Utilizzando la distribuzione del tempo di risposta, è possibile osservare i picchi nel tempo di risposta. Selezionando questo picco nel tempo di risposta, le tabelle sotto i grafici si aggiorneranno per esporre tutti i parametri associati, come i codici di stato.

Quando si fa clic e si trascina, X-Ray seleziona e crea un filtro. Viene mostrato in un'ombreggiatura grigia sulla parte superiore delle righe del grafico. È ora possibile trascinare l'ombreggiatura a sinistra e destra lungo la distribuzione per aggiornare la selezione e il filtro.

Visualizzare tutti le tracce contrassegnate con un codice di stato

È possibile esaminare i dettagli dei tracciamenti all'interno del picco selezionato utilizzando le tabelle di parametri sotto ai grafici. Facendo clic su una riga nella tabella HTTP STATUS CODE, viene creato automaticamente un filtro sul set di dati di lavoro. Ad esempio, è possibile visualizzare tutti i tracciamenti del codice di stato 500. In questo modo viene creato un tag di filtro nel riquadro del set di tracciamenti denominato http.status.

Visualizzare tutti gli elementi in un sottogruppo e associati a un utente

Analizzare il set di errori in base a utente, URL, causa principale del tempo di risposta o altri attributi predefiniti. Ad esempio, per filtrare ulteriormente il set di tracciamenti con un codice di stato 500, selezionare una riga dalla tabella USERS. Questo crea due tag di filtro nel riquadro del set di tracciamenti: http.status, come indicato in precedenza, e user.

Confrontare due set di tracce con criteri diversi

Confrontare i diversi utenti e le relative richieste POST per trovare altre discrepanze e correlazioni. Applicare il primo set di filtri. Questi sono definiti da una linea blu nella distribuzione del tempo di risposta. Quindi selezionare Compare (Confronta). Inizialmente, questo crea una copia dei filtri nel set di tracciamenti A.

Per procedere, definire un nuovo set di filtri da applicare al set di tracciamenti B. Questo secondo set è rappresentato da una linea verde. L'esempio seguente mostra le diverse linee in base allo schema di colori blu e verde.

Identificare un tracciamento rilevante e visualizzare i dettagli

Quando si delimita l’ambito usando i filtri della console, l’elenco dei tracciamenti sotto le tabelle di parametri diventa più significativo. La tabella dell’elenco delle tracce unisce le informazioni su URL, USER e STATUS CODE in un'unica visualizzazione. Per informazioni più approfondite, selezionare una riga di questa tabella per aprire la pagina dei dettagli del tracciamento e visualizzare la sequenza temporale e i dati non elaborati.

Configura i gruppi

I gruppi costituiscono una raccolta di tracciamenti definiti da un'espressione di filtro. Puoi utilizzare i gruppi per generare grafici di servizio aggiuntivi e fornire CloudWatch metriche Amazon. Puoi utilizzare la AWS X-Ray console o l'API X-Ray per creare e gestire gruppi per i tuoi servizi. Questo argomento descrive come creare e gestire gruppi utilizzando la console X-Ray. Per informazioni su come gestire i gruppi utilizzando l'API X-Ray, vedere. Configurazione delle impostazioni di campionamento, gruppi e crittografia con l'API X-Ray

È possibile creare gruppi di tracce per mappe di traccia, tracce o analisi. Quando crei un gruppo, il gruppo diventa disponibile come filtro nel menu a discesa del gruppo su tutte e tre le pagine: Trace Map, Traces e Analytics.

I gruppi sono identificati dal nome o da un Amazon Resource Name (ARN) e contengono un'espressione di filtro. Il servizio confronta i tracciamenti in entrata con l'espressione e le memorizza di conseguenza. Per ulteriori informazioni su come creare un'espressione di filtro, vedereUsa le espressioni di filtro.

L'aggiornamento dell'espressione di filtro di un gruppo non modifica i dati già registrati. L'aggiornamento si applica solo per le successive tracce. Ciò può comportare un grafo unito delle espressioni nuove e vecchie. Per evitare ciò, eliminate un gruppo corrente e createne uno nuovo.

Nota

I gruppi sono fatturati per il numero di tracce recuperate corrispondenti all'espressione di filtro. Per ulteriori informazioni, consultare Prezzi di AWS X-Ray.

Creazione di un gruppo

Nota

Ora puoi configurare i gruppi X-Ray direttamente dalla console Amazon CloudWatch . È inoltre possibile continuare a utilizzare la console X-Ray.

CloudWatch console

1. Accedi AWS Management Console e apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

2. Scegli Impostazioni nel riquadro di navigazione a sinistra.

3. Scegli Visualizza impostazioni in Gruppi all'interno della sezione Tracce X-Ray.

4. Scegli Crea gruppo sopra l'elenco dei gruppi.

5. Nella pagina Crea gruppo, inserisci un nome per il gruppo. Il nome di un gruppo può avere un massimo di 32 caratteri e contenere caratteri alfanumerici e trattini. I nomi dei gruppi distinguono tra maiuscole e minuscole

6. Immettere un'espressione di filtro. Per ulteriori informazioni su come creare un'espressione di filtro, vedereUsa le espressioni di filtro. Nell'esempio seguente, il gruppo filtra le tracce di errore provenienti dal servizio api.example.com e le richieste al servizio in cui il tempo di risposta è stato maggiore o uguale a cinque secondi.

   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5

7. In Insights, abilita o disabilita l'accesso a Insights per il gruppo. Per ulteriori informazioni sulle informazioni dettagliate, consulta Usa X-Ray Insights.

   

8. In Tag, scegli Aggiungi nuovo tag per inserire una chiave di tag e, facoltativamente, un valore per il tag. Continua ad aggiungere altri tag se lo desideri. Le chiavi dei tag devono essere uniche. Per eliminare un tag, scegli Rimuovi sotto ogni tag. Per ulteriori informazioni sui tag, consulta Etichettatura delle regole e dei gruppi di campionamento a raggi X.

   

9. Seleziona Crea gruppo.

X-Ray console

1. Accedere AWS Management Console e aprire la console X-Ray all'indirizzo https://console.aws.amazon.com/xray/home.

2. Apri la pagina Crea gruppo dalla pagina Gruppi nel riquadro di navigazione a sinistra o dal menu di gruppo in una delle seguenti pagine: Trace Map, Traces e Analytics.

3. Nella pagina Crea gruppo, inserisci un nome per il gruppo. Il nome di un gruppo può avere un massimo di 32 caratteri e contenere caratteri alfanumerici e trattini. I nomi dei gruppi distinguono tra maiuscole e minuscole

4. Immettere un'espressione di filtro. Per ulteriori informazioni su come creare un'espressione di filtro, vedereUsa le espressioni di filtro. Nell'esempio seguente, il gruppo filtra le tracce di errore provenienti dal servizio api.example.com e le richieste al servizio in cui il tempo di risposta è stato maggiore o uguale a cinque secondi.

   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5

5. In Insights, abilita o disabilita l'accesso a Insights per il gruppo. Per ulteriori informazioni sulle informazioni dettagliate, consulta Usa X-Ray Insights.

   

6. In Tag, inserisci una chiave di tag e, facoltativamente, un valore del tag. Quando aggiungi un tag, viene visualizzata una nuova riga in cui inserire un altro tag. Le chiavi dei tag devono essere uniche. Per eliminare un tag, scegli X alla fine della riga del tag. Per ulteriori informazioni sui tag, consulta Etichettatura delle regole e dei gruppi di campionamento a raggi X.

   

7. Seleziona Crea gruppo.

Applica un gruppo

CloudWatch console

1. Accedi AWS Management Console e apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

2. Apri una delle seguenti pagine dal riquadro di navigazione sotto Tracce X-Ray:

   • Mappa di tracciamento

   • Tracce

3. Immettete il nome di un gruppo nel filtro di gruppo Filtra per X-Ray. I dati mostrati nella pagina vengono modificati in base all'espressione di filtro impostata nel gruppo.

X-Ray console

1. Accedere AWS Management Console e aprire la console X-Ray all'indirizzo https://console.aws.amazon.com/xray/home.

2. Apri una delle seguenti pagine dal pannello di navigazione:

   • Mappa di tracciamento

   • Tracce

   • Analisi

3. Nel menu del gruppo, scegli il gruppo in cui hai creatoCreazione di un gruppo. I dati mostrati nella pagina vengono modificati in base all'espressione di filtro impostata nel gruppo.

Modifica un gruppo

CloudWatch console

1. Accedi AWS Management Console e apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

2. Scegli Impostazioni nel riquadro di navigazione a sinistra.

3. Scegli Visualizza impostazioni in Gruppi all'interno della sezione Tracce X-Ray.

4. Scegliete un gruppo dalla sezione Gruppi, quindi scegliete Modifica.

5. Sebbene non sia possibile rinominare un gruppo, è possibile aggiornare l'espressione del filtro. Per ulteriori informazioni su come creare un'espressione di filtro, consultaUsa le espressioni di filtro. Nell'esempio seguente, il gruppo filtra le tracce di errore provenienti dal servizioapi.example.com, in cui è contenuto l'indirizzo URL della richiestaexample/game, e il tempo di risposta per le richieste è stato maggiore o uguale a cinque secondi.

   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5

6. In Insights, abilita o disabilita l'accesso a Insights per il gruppo. Per ulteriori informazioni sulle informazioni dettagliate, consulta Usa X-Ray Insights.

   

7. In Tag, scegli Aggiungi nuovo tag per inserire una chiave di tag e, facoltativamente, un valore per il tag. Continua ad aggiungere altri tag se lo desideri. Le chiavi dei tag devono essere uniche. Per eliminare un tag, scegli Rimuovi sotto ogni tag. Per ulteriori informazioni sui tag, consulta Etichettatura delle regole e dei gruppi di campionamento a raggi X.

   

8. Quando hai finito di aggiornare il gruppo, scegli Aggiorna gruppo.

X-Ray console

1. Accedere AWS Management Console e aprire la console X-Ray all'indirizzo https://console.aws.amazon.com/xray/home.

2. Effettua una delle seguenti operazioni per aprire la pagina Modifica gruppo.

   1. Nella pagina Gruppi, scegli il nome di un gruppo per modificarlo.

   2. Nel menu del gruppo in una delle pagine seguenti, posiziona il puntatore su un gruppo, quindi scegli Modifica.

      • Traccia la mappa

      • Tracce

      • Analisi

3. Sebbene non sia possibile rinominare un gruppo, è possibile aggiornare l'espressione del filtro. Per ulteriori informazioni su come creare un'espressione di filtro, consultaUsa le espressioni di filtro. Nell'esempio seguente, il gruppo filtra le tracce di errore provenienti dal servizioapi.example.com, in cui è contenuto l'indirizzo URL della richiestaexample/game, e il tempo di risposta per le richieste è stato maggiore o uguale a cinque secondi.

   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5

4. In Insights, abilita o disabilita gli approfondimenti e le notifiche di approfondimenti per il gruppo. Per ulteriori informazioni sulle informazioni dettagliate, consulta Usa X-Ray Insights.

   

5. In Tag, modifica le chiavi e i valori dei tag. Le chiavi dei tag devono essere uniche. I valori dei tag sono facoltativi; puoi eliminarli, se lo desideri. Per eliminare un tag, scegli X alla fine della riga del tag. Per ulteriori informazioni sui tag, consulta Etichettatura delle regole e dei gruppi di campionamento a raggi X.

   

6. Quando hai finito di aggiornare il gruppo, scegli Aggiorna gruppo.

Clonare un gruppo

La clonazione di un gruppo crea un nuovo gruppo con l'espressione di filtro e i tag di un gruppo esistente. Quando clonate un gruppo, il nuovo gruppo ha lo stesso nome del gruppo da cui è stato clonato, con l'-cloneaggiunta del nome.

CloudWatch console

1. Accedi AWS Management Console e apri la console all'indirizzo https://console.aws.amazon.com/cloudwatch/. CloudWatch

2. Scegli Impostazioni nel riquadro di navigazione a sinistra.

3. Scegli Visualizza impostazioni in Gruppi all'interno della sezione Tracce X-Ray.

4. Scegli un gruppo dalla sezione Gruppi, quindi scegli Clona.

5. Nella pagina Crea gruppo, il nome del gruppo è -clonegroup-name. Facoltativamente, inserisci un nuovo nome per il gruppo. Il nome di un gruppo può avere un massimo di 32 caratteri e contenere caratteri alfanumerici e trattini. I nomi dei gruppi distinguono tra maiuscole e minuscole

6. È possibile mantenere l'espressione di filtro dal gruppo esistente o, facoltativamente, immettere una nuova espressione di filtro. Per ulteriori informazioni su come creare un'espressione di filtro, vedereUsa le espressioni di filtro. Nell'esempio seguente, il gruppo filtra le tracce di errore provenienti dal servizio api.example.com e le richieste al servizio in cui il tempo di risposta è stato maggiore o uguale a cinque secondi.

   service("api.example.com") { fault = true OR responsetime >= 5 }

7. In Tag, modificate le chiavi e i valori dei tag, se necessario. Le chiavi dei tag devono essere uniche. I valori dei tag sono facoltativi; puoi eliminarli se lo desideri. Per eliminare un tag, scegli X alla fine della riga del tag. Per ulteriori informazioni sui tag, consulta Etichettatura delle regole e dei gruppi di campionamento a raggi X.

8. Seleziona Crea gruppo.

X-Ray console

1. Accedere AWS Management Console e aprire la console X-Ray all'indirizzo https://console.aws.amazon.com/xray/home.

2. Apri la pagina Gruppi dal riquadro di navigazione a sinistra e scegli il nome del gruppo che desideri clonare.

3. Scegli il gruppo Clone dal menu Azioni.

4. Nella pagina Crea gruppo, il nome del gruppo è -clonegroup-name. Facoltativamente, inserisci un nuovo nome per il gruppo. Il nome di un gruppo può avere un massimo di 32 caratteri e contenere caratteri alfanumerici e trattini. I nomi dei gruppi distinguono tra maiuscole e minuscole

5. È possibile mantenere l'espressione di filtro dal gruppo esistente o, facoltativamente, immettere una nuova espressione di filtro. Per ulteriori informazioni su come creare un'espressione di filtro, vedereUsa le espressioni di filtro. Nell'esempio seguente, il gruppo filtra le tracce di errore provenienti dal servizio api.example.com e le richieste al servizio in cui il tempo di risposta è stato maggiore o uguale a cinque secondi.

   service("api.example.com") { fault = true OR responsetime >= 5 }

6. In Tag, modificate le chiavi e i valori dei tag, se necessario. Le chiavi dei tag devono essere uniche. I valori dei tag sono facoltativi; puoi eliminarli se lo desideri. Per eliminare un tag, scegli X alla fine della riga del tag. Per ulteriori informazioni sui tag, consulta Etichettatura delle regole e dei gruppi di campionamento a raggi X.

7. Seleziona Crea gruppo.

Eliminazione di un gruppo

Segui i passaggi descritti in questa sezione per eliminare un gruppo. Non puoi eliminare il gruppo predefinito.

CloudWatch console

1. Accedi AWS Management Console e apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

2. Scegli Impostazioni nel riquadro di navigazione a sinistra.

3. Scegli Visualizza impostazioni in Gruppi all'interno della sezione Tracce X-Ray.

4. Scegliete un gruppo dalla sezione Gruppi, quindi scegliete Elimina.

5. Quando ti viene richiesto di confermare, scegli Elimina.

X-Ray console

1. Accedere AWS Management Console e aprire la console X-Ray all'indirizzo https://console.aws.amazon.com/xray/home.

2. Apri la pagina Gruppi dal riquadro di navigazione a sinistra e scegli il nome del gruppo che desideri eliminare.

3. Nel menu Azioni, scegli Elimina gruppo.

4. Quando ti viene richiesto di confermare, scegli Elimina.

Visualizza le metriche di gruppo in Amazon CloudWatch

Dopo la creazione di un gruppo, le tracce in entrata vengono confrontate con l'espressione del filtro del gruppo mentre vengono archiviate nel servizio X-Ray. Le metriche relative al numero di tracce che soddisfano ogni criterio vengono pubblicate su Amazon CloudWatch ogni minuto. Scegliendo Visualizza metrica nella pagina Modifica gruppo si apre la CloudWatch console alla pagina Metrica. Per ulteriori informazioni su come utilizzare i CloudWatch parametri, consulta Using Amazon CloudWatch Metrics nella Amazon CloudWatch User Guide.

CloudWatch console

1. Accedi AWS Management Console e apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

2. Scegli Impostazioni nel riquadro di navigazione a sinistra.

3. Scegli Visualizza impostazioni in Gruppi all'interno della sezione Tracce X-Ray.

4. Scegliete un gruppo dalla sezione Gruppi, quindi scegliete Modifica.

5. Nella pagina Modifica gruppo, scegli Visualizza metrica.

   La pagina Metriche della CloudWatch console si apre in una nuova scheda.

X-Ray console

1. Accedere AWS Management Console e aprire la console X-Ray all'indirizzo https://console.aws.amazon.com/xray/home.

2. Apri la pagina Gruppi dal riquadro di navigazione a sinistra, quindi scegli il nome del gruppo di cui desideri visualizzare le metriche.

3. Nella pagina Modifica gruppo, scegli Visualizza metrica.

   La pagina Metriche della CloudWatch console si apre in una nuova scheda.

Configura le regole di campionamento

Puoi utilizzare la AWS X-Ray console per configurare le regole di campionamento per i tuoi servizi. X-Ray SDK e Servizi AWS che supportano il tracciamento attivo con configurazione di campionamento utilizzano regole di campionamento per determinare quali richieste registrare.

Configura le regole di campionamento

Puoi configurare il campionamento per i seguenti casi d'uso:

• API Gateway Entrypoint: API Gateway supporta il campionamento e il tracciamento attivo. Per abilitare il tracciamento attivo su una fase API, consultare Supporto di tracciamento attivo di Amazon API Gateway per AWS X-Ray.

• AWS AppSync— AWS AppSync supporta il campionamento e il tracciamento attivo. Per abilitare il tracciamento attivo sulle AWS AppSync richieste, vedere Tracciamento con AWS X-Ray.

• Instrument X-Ray SDK su piattaforme di elaborazione: quando si utilizzano piattaforme di elaborazione come Amazon EC2, Amazon ECS AWS Elastic Beanstalk o, il campionamento è supportato se l'applicazione è stata strumentata con l'SDK X-Ray più recente.

Personalizzazione delle regole di campionamento

Personalizzando le regole di campionamento, puoi controllare la quantità di dati che registri. È inoltre possibile modificare il comportamento di campionamento senza modificare o ridistribuire il codice. Le regole di campionamento indicano all'X-Ray SDK quante richieste registrare per una serie di criteri. Per impostazione predefinita, X-Ray SDK registra la prima richiesta ricevuta all'inizio di ogni secondo e il cinque percento di eventuali richieste aggiuntive. Una richiesta al secondo è la riserva. In questo modo viene registrata almeno una traccia al secondo, purché il servizio soddisfi le richieste. Cinque percento è la percentuale di richieste aggiuntive oltre la dimensione della riserva che vengono campionate.

Puoi configurare l'SDK X-Ray per leggere le regole di campionamento da un documento JSON incluso nel codice. Tuttavia, quando esegui più istanze del servizio, ogni istanza esegue il campionamento in modo indipendente. Ciò fa sì che la percentuale globale di richieste campionate aumenti perché tutte le riserve delle istanze sono cumulate insieme in modo efficace. Inoltre, per aggiornare le regole di campionamento locali, è necessario ridistribuire il codice.

Definendo le regole di campionamento nella console X-Ray e configurando l'SDK per leggere le regole dal servizio X-Ray, puoi evitare entrambi questi problemi. Il servizio gestisce la riserva per ciascuna regola e assegna delle quote ad ogni istanza del servizio per distribuire la riserva in modo uniforme, in base al numero di istanze in esecuzione. Il limite del serbatoio viene calcolato in base alle regole impostate. Poiché le regole sono configurate nel servizio, è possibile gestirle senza effettuare implementazioni aggiuntive. Per ulteriori informazioni sull'SDK, consulta Usare un AWS SDK.

Nota

X-Ray utilizza un approccio ottimale nell'applicazione delle regole di campionamento e, in alcuni casi, la frequenza di campionamento effettiva potrebbe non corrispondere esattamente alle regole di campionamento configurate. Tuttavia, nel tempo il numero di richieste campionate dovrebbe avvicinarsi alla percentuale configurata.

Ora puoi configurare le regole di campionamento a raggi X direttamente dalla console Amazon. CloudWatch È inoltre possibile continuare a utilizzare la console X-Ray.

CloudWatch console

Per configurare le regole di campionamento nella console CloudWatch

1. Accedere AWS Management Console e aprire la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

2. Scegli Impostazioni nel riquadro di navigazione a sinistra.

3. Scegliete Visualizza impostazioni in Regole di campionamento all'interno della sezione Tracce X-Ray.

4. Per creare una regola, scegliere Create sampling rule (Crea regola di campionamento).

   Per modificare una regola, scegliete una regola e scegliete Modifica per modificarla.

   Per eliminare una regola, scegli una regola e scegli Elimina per eliminarla.

X-Ray console

Per configurare le regole di campionamento nella console X-Ray

1. Apri la console X-Ray.

2. Scegli Sampling nel riquadro di navigazione a sinistra.

3. Per creare una regola, scegliere Create sampling rule (Crea regola di campionamento).

   Per modificare una regola, scegliere il nome di una regola.

   Per eliminare una regola, sceglierne una e utilizzare il menu Actions (Operazioni) per eliminarla.

Opzioni delle regole di campionamento

Per ogni regola sono disponibili le seguenti opzioni. I valori di stringa possono utilizzare caratteri jolly per corrispondere a un solo carattere (?) o a zero o a più caratteri (*).

Opzioni delle regole di campionamento

• Nome della regola (stringa): un nome univoco per la regola.

• Priorità (numero intero compreso tra 1 e 9999): la priorità della regola di campionamento. I servizi valutano le regole in ordine crescente di priorità e prendono una decisione sul campionamento in base alla prima regola corrispondente.

• Reservoir (numero intero non negativo): un numero fisso di richieste corrispondenti allo strumento al secondo, prima dell'applicazione del tasso fisso. Il reservoir non viene utilizzato direttamente dai servizi, ma si applica a tutti i servizi che utilizzano la regola nel loro complesso.

• Tasso (numero intero compreso tra 0 e 100): la percentuale di richieste corrispondenti allo strumento, dopo l'esaurimento del serbatoio. Quando configuri una regola di campionamento nella console, scegli una percentuale compresa tra 0 e 100. Quando configuri una regola di campionamento in un SDK client utilizzando un documento JSON, fornisci un valore percentuale compreso tra 0 e 1.

• Nome del servizio (stringa): il nome del servizio strumentato, così come appare nella mappa di traccia.

  • X-Ray SDK: il nome del servizio configurato sul registratore.

  • Amazon API Gateway —api-name/stage.

• Tipo di servizio (stringa): il tipo di servizio, così come appare nella mappa di traccia. Per X-Ray SDK, imposta il tipo di servizio applicando il plug-in appropriato:

  • AWS::ElasticBeanstalk::Environment— Un AWS Elastic Beanstalk ambiente (plugin).

  • AWS::EC2::Instance— Un'istanza Amazon EC2 (plug-in).

  • AWS::ECS::Container— Un contenitore Amazon ECS (plug-in).

  • AWS::APIGateway::Stage— Una fase di Amazon API Gateway.

  • AWS::AppSync::GraphQLAPI — Una richiesta AWS AppSync API.

• Host (stringa): il nome host dall'intestazione dell'host HTTP.

• Metodo HTTP (stringa) — Il metodo della richiesta HTTP.

• Percorso URL (stringa) — Il percorso URL della richiesta.

  • X-Ray SDK: la parte del percorso dell'URL della richiesta HTTP.

• ARN della risorsa (stringa) — L'ARN della AWS risorsa che esegue il servizio.

  • X-Ray SDK: non supportato. L'SDK può solo utilizzare le regole con Resource ARN (ARN risorse) impostato su *.

  • Amazon API Gateway: l'ARN di fase.

• (Facoltativo) Attributi (chiave e valore): attributi del segmento noti al momento della decisione di campionamento.

  • X-Ray SDK: non supportato. L'SDK ignora le regole che specificano degli attributi.

  • Amazon API Gateway: intestazioni della richiesta HTTP originale.

Esempi di regole di campionamento

Esempio — Regola predefinita senza serbatoio e tariffa bassa

Puoi modificare la riserva e la percentuale della regola di default. La regola di default si applica alle richieste che non soddisfano nessun'altra regola.

• Serbatoio: 0

• Frequenza: 5 (0.05se configurata utilizzando un documento JSON)

Esempio — Regola di debug per tracciare tutte le richieste relative a un percorso problematico

Un regola ad alta priorità applicata temporaneamente per il debug.

• Nome della regola: DEBUG – history updates

• Priorità: 1

• Serbatoio: 1

• Frequenza: 100 (1se configurata utilizzando un documento JSON)

• Nome del servizio: Scorekeep

• Tipo di servizio: *

• Ospite: *

• Metodo HTTP: PUT

• Percorso URL: /history/*

• ARN della risorsa: *

Esempio — Tariffa minima più elevata per i POST

• Nome della regola: POST minimum

• Priorità: 100

• Serbatoio: 10

• Frequenza: 10 (.1se configurata utilizzando un documento JSON)

• Nome del servizio: *

• Tipo di servizio: *

• Ospite: *

• Metodo HTTP: POST

• Percorso URL: *

• ARN della risorsa: *

Configura il tuo servizio per utilizzare le regole di campionamento

L'SDK X-Ray richiede una configurazione aggiuntiva per utilizzare le regole di campionamento configurate nella console. Consulta la sezione dedicata alla configurazione per il tuo linguaggio per scoprire i dettagli sulla configurazione di una strategia di campionamento:

• Java: Regole di campionamento

• Vai: Regole di campionamento

• Node.js: Regole di campionamento

• Python: Regole di campionamento

• Rubino: Regole di campionamento

• .NET: Regole di campionamento

Per API Gateway, vedereSupporto di tracciamento attivo di Amazon API Gateway per AWS X-Ray.

Visualizzazione dei risultati del campionamento

La pagina di campionamento della console X-Ray mostra informazioni dettagliate su come i servizi utilizzano ciascuna regola di campionamento.

La colonna Trend (Tendenza) mostra come la regola è stata utilizzata negli ultimi minuti. Ogni colonna mostra le statistiche relative a una finestra di 10 secondi.

Statistiche di campionamento

• Regola di corrispondenza totale: il numero di richieste corrispondenti a questa regola. Questo numero non include le richieste che avrebbero potuto soddisfare questa regola, ma che hanno soddisfatto prima una regola ad alta priorità.

• Totale campionato: il numero di richieste registrate.

• Campionato con tasso fisso: il numero di richieste campionate applicando la tariffa fissa della regola.

• Campionato con limite di riserva: il numero di richieste campionate utilizzando una quota assegnata da X-Ray.

• Prese in prestito dal serbatoio: il numero di richieste campionate prendendo in prestito dal serbatoio. La prima volta che un servizio abbina una richiesta a una regola, X-Ray non gli ha ancora assegnato una quota. Tuttavia, se il serbatoio è almeno 1, il servizio prende in prestito una traccia al secondo fino a quando X-Ray non assegna una quota.

Per ulteriori informazioni sulle statistiche di campionamento e su come i servizi utilizzano le regole di campionamento, consulta Using sampling rules with the X-Ray API (Utilizzo delle regole di campionamento con l'API X-Ray).

Passaggi successivi

È possibile utilizzare l'API X-Ray per gestire le regole di campionamento. Con l'API puoi creare e aggiornare le regole in modo programmatico in base a una pianificazione o in risposta ad allarmi o notifiche. Consulta Configurazione delle impostazioni di campionamento, gruppi e crittografia con l'API X-Ray per le istruzioni di utilizzo e ulteriori esempi di regole.

X-Ray SDK utilizza Servizi AWS anche l'API X-Ray per leggere le regole di campionamento, riportare i risultati del campionamento e ottenere obiettivi di campionamento. I servizi devono tenere traccia della frequenza con cui applicano ogni regola, valutare le regole in base alla priorità e prendere in prestito dal serbatoio quando una richiesta corrisponde a una regola per la quale X-Ray non ha ancora assegnato una quota al servizio. Per ulteriori dettagli su come un servizio utilizza l'API per il campionamento, vedere. Using sampling rules with the X-Ray API (Utilizzo delle regole di campionamento con l'API X-Ray)

Quando l'SDK X-Ray chiama le API di campionamento, utilizza il demone X-Ray come proxy. Se la porta TCP 2000 è già utilizzata, puoi configurare il daemon per funzionare da proxy su un'altra porta. Per informazioni dettagliate, vedi Configurazione del demone AWS X-Ray.

Collegamento diretto alla console

Puoi utilizzare percorsi e query per creare collegamenti diretti a tracce specifiche o visualizzazioni filtrate delle tracce e della mappa di traccia.

Pagine della console

• Pagina di benvenuto — xray/home#/welcome

• Guida introduttiva — xray/home#/getting-started

• Mappa delle tracce — xray/home#/service-map

• Tracce — xray/home#/trace

Tracce

Puoi generare link per la sequenza temporale, i dati non elaborati e le visualizzazioni sulla mappa di specifici tracciamenti.

Traccia la cronologia — xray/home#/traces/trace-id

Dati di tracciamento grezzi — xray/home#/traces/trace-id/raw

Esempio — dati di traccia non elaborati

https://console.aws.amazon.com/xray/home#/traces/1-57f5498f-d91047849216d0f2ea3b6442/raw

Espressioni filtro

Collegamento a un elenco filtrato di tracciamenti.

Visualizzazione filtrata delle tracce — xray/home#/traces?filter=filter-expression

Esempio — espressione di filtro

https://console.aws.amazon.com/xray/home#/traces?filter=service("api.amazon.com") { fault = true OR responsetime > 2.5 } AND annotation.foo = "bar"

Esempio — espressione di filtro (URL codificato)

https://console.aws.amazon.com/xray/home#/traces?filter=service(%22api.amazon.com%22)%20%7B%20fault%20%3D%20true%20OR%20responsetime%20%3E%202.5%20%7D%20AND%20annotation.foo%20%3D%20%22bar%22

Per ulteriori informazioni sulle espressioni filtro, consulta Usa le espressioni di filtro.

Intervallo temporale

Specifica la durata di un intervallo di tempo o le ore di inizio e fine in formato ISO8601. Gli intervalli di tempo sono in UTC e possono durare fino a 6 ore.

Periodo di tempo — xray/home#/page?timeRange=range-in-minutes

Esempio — mappa di tracciamento dell'ultima ora

https://console.aws.amazon.com/xray/home#/service-map?timeRange=PT1H

Ora di inizio e fine — xray/home#/page?timeRange=start~end

Esempio — intervallo di tempo preciso in secondi

https://console.aws.amazon.com/xray/home#/traces?timeRange=2023-7-01T16:00:00~2023-7-01T22:00:00

Esempio — intervallo di tempo preciso in minuti

https://console.aws.amazon.com/xray/home#/traces?timeRange=2023-7-01T16:00~2023-7-01T22:00

Regione

Specificate un link Regione AWS alle pagine di quella regione. Se non si specifica una regione, la console reindirizza l'utente all'ultima regione visitata.

Regione: xray/home?region=region#/page

Esempio — mappa di tracciamento negli Stati Uniti occidentali (Oregon) (us-west-2)

https://console.aws.amazon.com/xray/home?region=us-west-2#/service-map

Quando includete una regione con altri parametri di interrogazione, la query Region precede l'hash e le query specifiche per i raggi X vanno dopo il nome della pagina.

Esempio — tracciamento della mappa dell'ultima ora negli Stati Uniti occidentali (Oregon) (us-west-2)

https://console.aws.amazon.com/xray/home?region=us-west-2#/service-map?timeRange=PT1H

Combinazioni

Esempio — tracce recenti con un filtro di durata

https://console.aws.amazon.com/xray/home#/traces?timeRange=PT15M&filter=duration%20%3E%3D%205%20AND%20duration%20%3C%3D%208

Output

• Pagina — Tracce

• Intervallo di tempo: ultimi 15 minuti

• Filtro: durata >= 5 E durata <= 8