Rastreo de llamadas a servicios web HTTP posteriores con el SDK de X-Ray para .NET - AWS X-Ray

Rastreo de llamadas a servicios web HTTP posteriores con el SDK de X-Ray para .NET

nota

Aviso de fin de soporte: el 25 de febrero de 2027, AWS X-Ray dejará de ofrecer soporte para los AWS X-Ray SDK y daemon. Después del 25 de febrero de 2027, ya no recibirá actualizaciones ni versiones. Para obtener más información sobre la cronología del soporte, consulte Cronología del fin del soporte de X-Ray SDK y daemon. Recomendamos migrar a OpenTelemetry. Para obtener más información sobre la migración a OpenTelemetry, consulte Migración de la instrumentación de X-Ray a la instrumentación de OpenTelemetry.

Cuando su aplicación realiza llamadas a microservicios o a las API de HTTP públicas, puede utilizar el método de extensión GetResponseTraced para System.Net.HttpWebRequest del SDK de X-Ray para .NET con el fin de instrumentar dichas llamadas y agregar la API al gráfico de servicios como servicio posterior.

ejemplo HttpWebRequest
using System.Net;
using Amazon.XRay.Recorder.Core;
using Amazon.XRay.Recorder.Handlers.System.Net;

private void MakeHttpRequest()
{
  HttpWebRequest request = (HttpWebRequest)WebRequest.Create("http://names.example.com/api");
  request.GetResponseTraced();
}

Para las llamadas asíncronas, utilice GetAsyncResponseTraced.

request.GetAsyncResponseTraced();

Si utiliza system.net.http.httpclient, utilice el controlador de delegación HttpClientXRayTracingHandler para registrar las llamadas.

ejemplo HttpClient
using System.Net.Http;
using Amazon.XRay.Recorder.Core;
using Amazon.XRay.Recorder.Handlers.System.Net;

private void MakeHttpRequest()
{
  var httpClient = new HttpClient(new HttpClientXRayTracingHandler(new HttpClientHandler()));
  httpClient.GetAsync(URL);
}

Cuando se instrumenta una llamada a un API web posterior, el del SDK de X-Ray para .NET registra un subsegmento con información sobre la solicitud HTTP y la respuesta. X-Ray utiliza el subsegmento para generar un segmento inferido para la API.

ejemplo Subsegmento para una llamada HTTP posterior
{
  "id": "004f72be19cddc2a",
  "start_time": 1484786387.131,
  "end_time": 1484786387.501,
  "name": "names.example.com",
  "namespace": "remote",
  "http": {
    "request": {
      "method": "GET",
      "url": "https://names.example.com/"
    },
    "response": {
      "content_length": -1,
      "status": 200
    }
  }
}
ejemplo Segmento inferido para una llamada HTTP posterior
{
  "id": "168416dc2ea97781",
  "name": "names.example.com",
  "trace_id": "1-62be1272-1b71c4274f39f122afa64eab",
  "start_time": 1484786387.131,
  "end_time": 1484786387.501,
  "parent_id": "004f72be19cddc2a",
  "http": {
    "request": {
      "method": "GET",
      "url": "https://names.example.com/"
    },
    "response": {
      "content_length": -1,
      "status": 200
    }
  },
  "inferred": true
}