Rastrear chamadas para serviços web HTTP subsequentes usando o X-Ray SDK para Python - AWS X-Ray

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Rastrear chamadas para serviços web HTTP subsequentes usando o X-Ray SDK para Python

nota

Aviso de SDK/Daemon manutenção do X-Ray — Em 25 de fevereiro de 2026, o AWS X-Ray SDKs/Daemon entrará no modo de manutenção, onde AWS limitará as versões do X-Ray SDK e do Daemon para tratar apenas de problemas de segurança. Para obter mais informações sobre a linha do tempo do suporte, consulte Cronograma de suporte do X-Ray SDK e do Daemon Support. Recomendamos migrar para o. OpenTelemetry Para obter mais informações sobre a migração para OpenTelemetry, consulte Migrando da instrumentação X-Ray para a instrumentação. OpenTelemetry

Quando seu aplicativo faz chamadas para microsserviços ou HTTP público APIs, você pode usar o X-Ray SDK para Python para instrumentar essas chamadas e adicionar a API ao gráfico de serviços como um serviço downstream.

Para instrumentar clientes HTTP, aplique um patch à biblioteca que você usa para fazer chamadas de saída. Se você usa requests ou o cliente HTTP integrado Python, isso é tudo o que você precisa fazer. Para o aiohttp, configure também o gravador com um contexto assíncrono.

Se você usar a API do cliente do aiohttp 3, também precisará configurar o ClientSessioncom uma instância da configuração de rastreamento fornecida pelo SDK.

exemplo API do cliente do aiohttp 3
from aws_xray_sdk.ext.aiohttp.client import aws_xray_trace_config

async def foo():
    trace_config = aws_xray_trace_config()
    async with ClientSession(loop=loop, trace_configs=[trace_config]) as session:
        async with session.get(url) as resp
            await resp.read()

Quando você instrumenta uma chamada para uma API subsequente da web, o X-Ray SDK para Python registra um subsegmento que contém informações sobre a solicitação e a resposta HTTP. O X-Ray usa o subsegmento para gerar um segmento inferido para a API remota.

exemplo Subsegmento para uma chamada HTTP downstream
{
  "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
    }
  }
}
exemplo Segmento inferido para uma chamada HTTP de downstream
{
  "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
}