사용자 정의 콘텐츠를 trace에 추가할 수 있습니다. Cloud Trace API v1에서는 라벨을 추가할 수 있고 Cloud Trace API v2에서는 시간 이벤트 또는 속성을 추가할 수 있습니다.
시간 이벤트는 속성 집합 외에도 문자열 형식으로 메시지를 지정할 수 있으므로 더 유연합니다.
각 속성은 키-값 쌍으로 표시됩니다.
예를 들어 속성은 인스턴스 식별자를 기록할 수 있습니다. 속성 예시는 Attributes에 대한 API 참조 페이지를 참조하세요.
라벨로 주석 추가
Cloud Trace API v1 patchTraces를 사용하는 경우 labels 객체를 만들고 TraceSpan 객체에 연결하여 스팬에 주석을 추가할 수 있습니다.
이러한 이벤트 주석은 trace의 세부정보를 볼 때 라벨로 표시됩니다. 라벨에 대한 자세한 내용은 trace 라벨을 참조하세요.
속성으로 주석 추가
Cloud Trace API v2 batchWrite를 사용하는 경우 attributes 객체를 만들고 Span 객체에 연결하여 스팬에 주석을 추가할 수 있습니다.
이러한 이벤트 주석은 trace의 세부정보를 볼 때 라벨로 표시됩니다. 자세한 내용은 trace 탐색을 참조하세요.
시간 이벤트로 주석 추가
Cloud Trace API v2 batchWrite를 사용하는 경우 TimeEvents 객체를 만들고 Span 객체에 연결하여 스팬에 이벤트 주석과 메시지 이벤트를 추가할 수 있습니다.
TimeEvents 객체는 TimeEvent 객체의 배열이고, 각 항목에는 MessageEvent 객체와 Annotation 객체가 포함됩니다.
trace의 TimeEvents를 보려면 trace의 폭포식 그래프로 이동하여 로그 및 이벤트 표시를 클릭합니다. TimeEvent를 선택하면 세부정보가 세부정보 창에 표시됩니다.