ユーザー定義のコンテンツをトレースに追加できます。Cloud Trace API v1 ではラベルを追加できますが、Cloud Trace API v2 ではタイムイベントまたは属性を追加できます。時間イベントは、一連の属性に加えて、文字列の形式でメッセージを指定できるため、より柔軟です。各属性は Key-Value ペアとして表されます。たとえば、属性がインスタンス ID を記録する場合があります。属性の例については、Attributes
の API リファレンス ページをご覧ください。
ラベルで注釈を付ける
Cloud Trace API v1 の patchTraces
を使用するときは、labels
オブジェクトを作成して TraceSpan
オブジェクトにアタッチすることにより、イベント アノテーションをスパンに追加できます。
こうしたイベント アノテーションは、トレースの詳細を表示すると、ラベルとして表示されます。ラベルの詳細については、トレースラベルをご覧ください。
属性で注釈を付ける
Cloud Trace API v2 の batchWrite
を使用するときは、attributes
オブジェクトを作成して Span
オブジェクトにアタッチすることにより、スパンに注釈を付けることができます。
こうしたイベント アノテーションは、トレースの詳細を表示すると、ラベルとして表示されます。詳細については、トレースを調査するをご覧ください。
タイムイベントで注釈を付ける
Cloud Trace API v2 の batchWrite
を使用するときは、TimeEvents
オブジェクトを作成して Span オブジェクトにアタッチすることにより、イベント アノテーションとメッセージ イベントをスパンに追加できます。
TimeEvents
オブジェクトは TimeEvent
オブジェクトの配列で、各オブジェクトには MessageEvent
オブジェクトと Annotation
オブジェクトが含まれます。
トレースの TimeEvents
を表示するには、トレースのウォーターフォール グラフに移動して、[ログとイベントを表示] をクリックします。TimeEvent
を選択すると、その詳細が[詳細] ペインに表示されます。