获取 Trace 详情。

请求说明

应用性能监控已在全球多个地域部署服务，旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅服务地址文档，根据业务所在地选择最合适的接入点。

请求地址：https://apmplus-server.cn-beijing.volcengineapi.com?Action=GetTraceDetail&Version=2026-01-01

请求参数

下方仅列出该接口特有的请求参数和部分公共参数，更多详细信息参见公共参数。

参数	类型	是否必选	示例值	描述
Action	String	是	GetTraceDetail	接口名称。当前 API 的名称为 GetTraceDetail。
Version	String	是	2026-01-01	接口版本。当前 API 的版本为 2026-01-01。
TraceId	String	是	b7d963cxxxx30e7c5ddexxxx	待查询的 Trace ID。
SuggestTime	Long	是	1767196800	加快查询速度。通过时间戳形式配置，若配置此参数，会将搜索的时间范围限制在 SuggestTime 的前后一个小时。若无法预估时间范围或不使用加速查询时，配置为 0。

请求示例

返回参数

Trace

参数	类型	示例值	描述
Status	Integer	0	Trace 状态码。非 HTTP 组件中，0 表示正常，1 表示异常。 HTTP 组件中，等同于 http_status_code，例如：404、500 等。
ApiName	String	DemoMethod	Trace 的起始接口。
TraceId	String	b7d963c267c30e7c5ddexxxx	待查询的 Trace ID。
SpanList	Array of SpanBrief	-	Span 列表的摘要信息。
ServiceName	String	test-grpc-server	Trace 的起始服务。
ServiceType	String	rpc	Trace 的起始服务类型。
DurationMicroseconds	Long	1873	整体耗时，单位：微秒。
StartTimeMillisecond	Long	1767196800000	开始时间。

SpanBrief

参数	类型	示例值	描述
Env	String	prod	当前 Span 所属的环境。
SpanId	String	4374f05fb9axxxxx	Span ID 信息。
Status	Integer	0	Span 状态码。非 HTTP 组件中，0 表示正常，1 表示异常。 HTTP 组件中，等同于 http_status_code，例如：404、500 等。
ApiName	String	DemoMethod	接口名。
ApiTime	Long	1767196800	服务端接收时间。
Hostname	String	demo-grpc-server-7f89c4677c-xxxxx	主机名。
SpanType	String	server	Span 类型。
EventList	Array of Event	-	事件列表。
InputTokens	Long	16	生成 AI Span 的 input token 数。
ServiceName	String	test-grpc-server	服务名称。
ServiceType	String	rpc	服务类型。
TotalTokens	Long	166	生成 AI Span 的总 token 数。
OutputTokens	Long	150	生成 AI Span 的 output token 数。
ParentSpanId	String	4ce724e472axxxx	父 Span ID。
ErrorInfoList	Array of TraceErrorInfo	-	错误信息列表，支持在一个 Span 中查看多个错误。
GenAISpanKind	String	llm	生成 AI Span 的类型。
OperationName	String	redis.command	操作名。
CacheReadTokens	Long	100	生成 AI Span 的 cache read token 数。
CallServiceType	String	rpc	下游服务类型。
DurationMicroseconds	Long	1096	耗时，单位：微秒。
StartTimeMicrosecond	Long	1767196800000000	开始时间，单位：微秒。
StartTimeMillisecond	Long	1767196800000	开始时间，单位：毫秒。
RelativeStartTimeMillisecond	Long	100	从请求调用开始到当前 Span 开始的相对时间，单位：毫秒。

Event

参数	类型	示例值	描述
Tags	JSON Map	{'message.id':'1.0','message.type':'RECEIVED'}	事件标签。
TraceId	String	58f56847851be99ea0ff3cxxxxxxxxxx	事件所属 TraceID。
EventName	String	message	事件名。
ServiceName	String	demo-service	事件所属服务。
OperationName	String	Get	事件操作名。
EventTimeMillisecond	Long	1767196800000	事件发生时间，单位：毫秒。

Tags

TraceErrorInfo

参数	类型	示例值	描述
IssueId	String	b7d963c267c30e7c5ddexxxx	错误 ID。
ErrorKind	String	UncaughtException	错误类型。
ErrorTags	JSON Map	{'error_tag_key':'error_tag_value'}	错误标签。
ErrorStack	String	java.lang.RuntimeException: Node not found\n\tat com.example.grpcserver.xxx.demoMethod(xxx.java:34)....	错误堆栈。
ErrorMessage	String	Node not found	错误消息。
ErrorOccurTime	Long	1767196800	错误发生时间。

ErrorTags

TraceSummaryInfo

参数	类型	示例值	描述
SpanNums	Integer	10	Span 总数。
ServiceNums	Integer	5	涉及的服务总数。
ErrorSpanIds	Array of String	['4374f05fb9axxxxx','4ce724e472axxxx']	错误 Span ID 列表。
ComponentSpanIds	JSON Map	{'kitex':['4374f05fb9axxxxx','4ce724e472axxxx'],'redis':['4374f05fb9axxxxx']}	组件和组件 Span ID 列表。其中，key 为组件包含中间件、服务调用，value 为 Span ID 列表。说明不同组件可能包含重复 Span。
LLMComponentSpanIds	JSON Map	{'OpenAI':['4374f05fb9axxxxx','4ce724e472axxxx']}	大模型组件的统计。其中，key 为大模型组件的 span.kind、gen_ai.system，value 为 Span ID 列表。说明不同组件可能包含重复 Span。

ComponentSpanIds

LLMComponentSpanIds

返回示例

错误码

若接口调用返回异常，可参考以下接口错误码和公共错误码进行故障排查。

HTTP 状态码	错误码	错误信息	说明
500	ErrInternalServerError	We encountered an unexpected server error, please try again later.	服务器内部错误。