Come posso risolvere l'errore relativo alla quota di tracce in X-Ray?

Breve descrizione

I seguenti scenari potrebbero far sì che i documenti di traccia superino il limite consentito in AWS X-Ray:

• Hai inviato un numero maggiore di segmenti in batch per una traccia in cui la dimensione del documento di traccia supera i 500 KB.
• Hai inviato segmenti non in batch per una traccia in cui la dimensione del documento di traccia supera la dimensione di 100 KB.
• Sono stati aggiunti segmenti, metadati e annotazioni personalizzati che hanno aumentato le dimensioni del documento di traccia.

Il limite superiore della dimensione di un documento di traccia a raggi X cambia dinamicamente in base al numero di segmenti inviati insieme. Ciò è dovuto alla funzione di tracciamento del limite superato. Per un numero elevato di segmenti inviati insieme in un batch collegato a una traccia, il limite massimo è 500 KB. Per i singoli segmenti inviati con un intervallo di tempo associato a una traccia, il limite massimo è 100 KB.

Più velocemente invii una traccia (più segmenti vengono raggruppati e inviati), più aumenta l'efficienza di compressione. Più lentamente invii una traccia (invia i segmenti singolarmente con un intervallo di tempo), più la traccia si suddivide in più revisioni. Inoltre, più lentamente invii una traccia, più consuma la capacità di archiviazione per la cache nel backend. Le tracce che durano più a lungo producono più duplicati e fanno sì che X-Ray raccolga meno dati.

Risoluzione

Nota: Se ricevi errori durante l'esecuzione dei comandi dell’Interfaccia della linea di comando AWS (AWS CLI), allora assicurati di utilizzare la versione dell’interfaccia della linea di comando AWS più recente.

Visualizza la traccia nella console X-Ray oppure esegui il seguente comando per confermare che il documento di traccia superi il limite di dimensione:

aws xray batch-get-traces --trace-ids <EXAMPLE_TRACE_ID>

Nota: Sostituisci EXAMPLE\ _TRACE\ _ID con l'ID della tua traccia.

X-Ray raccoglie le seguenti informazioni per una traccia più ampia:

{
    "Id": "<EXAMPLE_TRACE_ID>",
    "Duration": 187.859,
    "LimitExceeded": true,
    "Segments": [
         ...
     ]
     ....
 }

**Nota:**Se il parametro LimitExceeded è vero, hai superato la quota di tracce o segmenti.

Aumento del numero di segmenti in batch per una traccia in cui la dimensione del documento di traccia supera la dimensione di 500 KB

Questo scenario si verifica quando si integra Step Functions con X-Ray. Quando si integra Step Functions con X-Ray, non è possibile personalizzare ciò che X-Ray traccia o non traccia. Quando si passa l'ID di traccia attraverso tutte le funzioni AWS Lambda, i dati dei segmenti vengono aggiunti all'ID di traccia.

Se utilizzi Step Functions, completa i seguenti passaggi:

1. Vai a Step Functions, quindi disattiva il tracciamento attivo.
2. Trasmetti l'ID di traccia tra le funzioni Lambda solo per i flussi di lavoro critici e non superare il limite massimo di traccia.
3. Se Lambda riceve l'intestazione di traccia dai servizi upstream, rimuovi l'autorizzazione PutTraceSegments dal ruolo di esecuzione Lambda. Il limite superiore viene regolato dinamicamente.

Se non utilizzi Step Functions, completa i seguenti passaggi:

1. Esegui il debug del codice per verificare se stai trasmettendo lo stesso ID di traccia per richieste diverse.
2. Interrompi la traccia. A tale scopo, non passare l'ID di traccia nella chiamata ai servizi downstream.
3. Crea un nuovo ID di traccia dal punto di interruzione.

**Nota:**Se si crea un ID di traccia per ogni applicazione, il numero di tracce aumenta. Per un tracciamento più semplice, mantieni i flussi di lavoro delle applicazioni critiche come parte di un'unica traccia.

Per ulteriori informazioni, consulta AWS X-Ray e Step Functions.

Segmenti non in batch per una traccia in cui la dimensione del documento di traccia supera la dimensione di 100 KB

Per questo scenario, utilizza la soluzione della sezione precedente.

Interrompi le tracce per il nuovo limite superiore di 100 KB. Oppure, raggruppa più segmenti nell'applicazione per aumentare il limite massimo a 500 KB. Il batching dei segmenti è supportato solo con SDK di telemetria aperta. Se utilizzi X-Ray SDK, modifica il modo in cui l'applicazione invia i segmenti.

Sono stati aggiunti segmenti, metadati e annotazioni personalizzati che hanno aumentato le dimensioni del documento

Per ridurre le dimensioni del documento di traccia, non aggiungere segmenti personalizzati aggiuntivi allo stesso ID di traccia. Aggiungi segmenti personalizzati solo per i flussi di lavoro necessari. Inoltre, per ridurre le dimensioni del documento di traccia, riduci i metadati e le annotazioni nelle tracce.