추가 하위 세그먼트 생성

참고

End-of-support 알림 - 2027년 2월 25일에 AWS X-Ray는 AWS X-Ray SDKs. 2027년 2월 25일 이후에는 더 이상 업데이트 또는 릴리스를 받을 수 없습니다. 지원 타임라인에 대한 자세한 내용은 섹션을 참조하세요X-Ray SDK 및 데몬 지원 종료 타임라인. OpenTelemetry로 마이그레이션하는 것이 좋습니다. OpenTelemetry로 마이그레이션하는 방법에 대한 자세한 내용은 X-Ray 계측에서 OpenTelemetry 계측으로 마이그레이션을 참조하세요.

하위 세그먼트는 추적의 세그먼트를 확장하여 요청을 처리하기 위해 완료된 작업에 대한 세부 정보를 표시합니다. 계측되는 클라이언트에서 직접 호출할 때마다, X-Ray SDK는 하위 세그먼트 안에 생성된 정보를 기록합니다. 추가 하위 세그먼트를 생성하여 다른 하위 세그먼트를 그룹화하거나, 코드 섹션의 성능을 평가하거나, 주석 및 메타데이터를 기록할 수 있습니다.

하위 세그먼트를 관리하려면 BeginSubsegment 및 EndSubsegment 메서드를 사용합니다. try 블록에서 하위 세그먼트의 작업을 수행하고 AddException을 사용하여 예외를 트레이스합니다. finally 블록에서 EndSubsegment를 호출하여 하위 세그먼트가 닫히도록 합니다.

예 Controller.cs – 사용자 지정 하위 세그먼트

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

하위 세그먼트를 세그먼트 또는 다른 하위 세그먼트 내에서 생성할 경우 .NET용 X-Ray SDK가 해당 하위 세그먼트에 대해 ID를 생성하고 시작 시간 및 종료 시간을 기록합니다.

예 메타데이터가 포함된 하위 세그먼트

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