ユーザー定義のコンテンツをトレースに追加できます。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 を選択すると、その詳細が[詳細] ペインに表示されます。