追加のサブセグメントを作成する - AWS X-Ray

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

追加のサブセグメントを作成する

サブセグメントはトレースを拡張しますセグメントリクエストを処理するために行われた作業の詳細を含む。計測済みクライアント内で呼び出しを行うたびに、X-Ray SDK によってサブセグメントに生成された情報が記録されます。追加のサブセグメントを作成して、他のサブセグメントをグループ化したり、コードセクションのパフォーマンスを測定したり、注釈とメタデータを記録したりできます。

サブセグメントを管理するには、BeginSubsegment および EndSubsegment メソッドを使用します。try ブロックでサブセグメントの任意の作業を実行し、AddException を使用して例外をトレースします。ブロックで EndSubsegment を呼び出し、サブセグメントが閉じられたことを確認します。finally

例 Controller.cs – カスタムサブセグメント
AWSXRayRecorder.Instance.BeginSubsegment("custom method");
try
{
  DoWork();
}
catch (Exception e)
{
  AWSXRayRecorder.Instance.AddException(e);
}
finally
{
  AWSXRayRecorder.Instance.EndSubsegment();
}

セグメントまたは別のサブセグメント内にサブセグメントを作成する場合、X-Ray SDK for .NET によってその 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"
    }
  },