Creazione di sottosegmenti aggiuntivi

Nota

End-of-support avviso — Il 25 febbraio 2027, AWS X-Ray interromperà il supporto per e daemon. AWS X-Ray SDKs Dopo il 25 febbraio 2027, non riceverai più aggiornamenti o versioni. Per ulteriori informazioni sulla tempistica del supporto, consulta. Cronologia della fine del supporto per X-Ray SDK e daemon Ti consigliamo di migrare a. OpenTelemetry Per ulteriori informazioni sulla migrazione a OpenTelemetry, vedere Migrazione dalla strumentazione a raggi X alla strumentazione. OpenTelemetry

I sottosegmenti estendono il segmento di una traccia con dettagli sul lavoro svolto per soddisfare una richiesta. Ogni volta che si effettua una chiamata con un client dotato di strumentazione, l'X-Ray SDK registra le informazioni generate in un sottosegmento. È possibile creare sottosegmenti aggiuntivi per raggruppare altri sottosegmenti, misurare le prestazioni di una sezione di codice o registrare annotazioni e metadati.

Per gestire i sottosegmenti, utilizza i metodi BeginSubsegment e EndSubsegment. Esegui qualsiasi attività nel sottosegmento in un blocco try e utilizza AddException per tracciare le eccezioni. Chiama EndSubsegment in un blocco finally per assicurarti che il sottosegmento venga chiuso.

Esempio Controller.cs — Sottosegmento personalizzato

AWSXRayRecorder.Instance.BeginSubsegment("custom method");
try
{
  DoWork();
}
catch (Exception e)
{
  AWSXRayRecorder.Instance.AddException(e);
}
finally
{
  AWSXRayRecorder.Instance.EndSubsegment();
}

Quando si crea un sottosegmento all'interno di un segmento o di un altro sottosegmento, X-Ray SDK for .NET genera un ID per tale sottosegmento e registra l'ora di inizio e l'ora di fine.

Esempio Sottosegmento con metadati

"subsegments": [{
  "id": "6f1605cd8a07cb70",
  "start_time": 1.480305974194E9,
  "end_time": 1.4803059742E9,
  "name": "Custom subsegment for UserModel.saveUser function",
  "metadata": {
    "debug": {
      "test": "Metadata string from UserModel.saveUser"
    }
  },