Python용 X-Ray SDK를 사용하여 다운스트림 HTTP 웹 서비스에 대한 호출 추적하기

애플리케이션이 마이크로서비스 또는 퍼블릭 HTTP API를 호출하면 Python용 X-Ray SDK를 사용하여 해당 호출을 구성하고 API를 서비스 그래프에 다운스트림 서비스로 추가할 수 있습니다.

HTTP 클라이언트를 구성하려면 발신 호출을 생성할 때 사용하는 라이브러리를 패치합니다. requests 또는 Python의 내장 HTTP 클라이언트를 사용하는 경우 더 이상 수행할 작업이 없습니다. aiohttp의 경우 비동기 컨텍스트를 사용하여 레코더를 구성합니다.

aiohttp 3의 클라이언트 API를 사용하면, SDK에서 제공하는 추적 구성의 인스턴스로 ClientSession의 클라이언트 API도 함께 구성해야 합니다.

예 aiohttp 3 클라이언트 API

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()

다운스트림 웹 API에 대한 직접 호출을 계측할 때 Python용 X-Ray SDK가 HTTP 요청 및 응답에 대한 정보가 포함된 하위 세그먼트를 기록합니다. X-Ray는 하위 세그먼트를 사용하여 원격 API에 대해 추정된 세그먼트를 생성합니다.

예 다운스트림 HTTP 호출에 대한 하위 세그먼트

{
  "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
    }
  }
}

예 다운스트림 HTTP 호출에 대한 추정된 세그먼트

{
  "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
}