文档中心

应用性能监控全链路版

会话分析

GetSessionDetail

获取会话详情。

请求说明

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

请求方式：POST

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

请求参数

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

参数	类型	是否必选	示例值	描述
Action	String	是	GetSessionDetail	接口名称。当前 API 的名称为 GetSessionDetail。
Version	String	是	2026-01-01	接口版本。当前 API 的版本为 2026-01-01。
StartTime	Long	是	1767196800000	查询开始时间的时间戳，单位：毫秒。
EndTime	Long	是	1767200400000	查询开始时间的时间戳，单位：毫秒。
SessionId	String	是	sess_001	会话 ID。
Workspace	String	否	default	工作区。应用性能监控提供的数据管理和数据隔离方式，每个工作区拥有独立的数据上报凭证，可针对不同应用归属特性，将对应的链路、日志、指标数据做统一管理。
Service	String	否	runtime-id.runtime-name	会话所属服务。

请求示例

POST https://apmplus-server.cn-beijing.volcengineapi.com?Action=GetSessionDetail&Version=2026-01-01​
{​
    "StartTime": 1767196800000,​
    "EndTime": 1767200400000,​
    "SessionId": "sess_001",​
    "Workspace": "default",​
    "Service": "runtime-id.runtime-name"​
}

返回参数

参数	类型	示例值	描述
UserId	String	u123	用户 ID。
TraceIds	Array of String	["trace_001","trace_002"]	会话包含的 Trace ID 列表，顺序与 SessionTraces 一致。
SessionId	String	sess_001	会话 ID。
TotalTokens	Integer	420	会话总 Token 数。
SessionTraces	Array of SessionTrace	[{"trace_id":"trace_001","user_id":"u123","total_tokens":180,"model_input_tokens":{"doubao-seed-1-6":80},"model_output_tokens":{"doubao-seed-1-6":100},"model_total_tokens":{"doubao-seed-1-6":180},"duration":7000,"start_time":1767196802000,"input":"Please summarize this text","output":"This text mainly describes the execution process of the system call link"}]	会话关联的 Trace 明细列表，按 Trace 的开始时间升序排列。
SessionEndTime	Long	1767196815000	会话最后调用时间的时间戳，单位：毫秒。
ModelInputTokens	JSON Map	{"doubao-seed-1-6":180}	会话维度按模型聚合的输入 Token 数。
ModelTotalTokens	JSON Map	{"doubao-seed-1-6":420}	会话维度按模型聚合的总 Token 数。
SessionStartTime	Long	1767196801000	会话开始时间的时间戳，单位：毫秒。
ModelOutputTokens	JSON Map	{"doubao-seed-1-6":240}	会话维度按模型聚合的输出 Token 数。

SessionTrace

参数	类型	示例值	描述
Input	String	Please summarize this text	Trace 输入内容。说明优先取 AI root span 的输入，缺失时则取 Trace 内第一个非空 Span 的输入。
Output	String	This text mainly describes the execution process of the system call link	Trace 输出内容。说明优先取 AI root span 的输出，缺失时则取 Trace 内最后一个非空 Span 输出
UserId	String	u123	用户 ID。
TraceId	String	trace_001	Trace ID。
Duration	Long	7000	Trace 耗时，单位：毫秒。说明优先取 AI root span 的耗时，缺失时则按 Trace 内 Span 时间范围计算。
StartTime	Long	1767196802000	Trace 开始时间，单位：毫秒。说明优先取 AI root span 的开始时间，缺失时则取 Trace 内最早 Span 的开始时间。
TotalTokens	Integer	180	Trace 总 Token 数，按 Trace 内 LLM Span 汇总。
ModelInputTokens	JSON Map	{"doubao-seed-1-6":80}	按模型聚合的输入 Token 数。
ModelTotalTokens	JSON Map	{"doubao-seed-1-6":180}	按模型聚合的总 Token 数。
ModelOutputTokens	JSON Map	{"doubao-seed-1-6":100}	按模型聚合的输出 Token 数。

ModelInputTokens

参数	类型	示例值	描述
key	String	doubao-seed-1-6	模型名称。
value	Integer	80	输入 Token 数。

ModelTotalTokens

参数	类型	示例值	描述
key	String	doubao-seed-1-6	模型名称。
value	Integer	180	总 Token 数。

ModelOutputTokens

参数	类型	示例值	描述
key	String	doubao-seed-1-6	模型名称。
value	Integer	100	输出 Token 数。

返回示例

{​
    "Result": {​
        "SessionId": "sess_001",​
        "TotalTokens": 420,​
        "TraceIds": [​
            "trace_001"​
        ],​
        "UserId": "u123",​
        "SessionStartTime": 1767196801000,​
        "SessionEndTime": 1767196815000,​
        "ModelInputTokens": {​
            "doubao-seed-1-6": 180​
        },​
        "ModelOutputTokens": {​
            "doubao-seed-1-6": 240​
        },​
        "ModelTotalTokens": {​
            "doubao-seed-1-6": 420​
        },​
        "SessionTraces": [​
            {​
                "TraceId": "trace_001",​
                "UserId": "u123",​
                "TotalTokens": 180,​
                "Duration": 7000,​
                "StartTime": 1767196802000​
            }​
        ]​
    },​
    "ResponseMetadata": {​
        "RequestId": "20230604110420****100232280022D31",​
        "Action": "GetSessionDetail",​
        "Version": "2026-01-01",​
        "Service": "apmplus_server",​
        "Region": "cn-north-1"​
    }​
}

错误码

当前接口暂无独立错误码，若接口调用返回异常，可参考公共错误码进行故障排查。

最近更新时间：2026.08.21 10:08:12

这个页面对您有帮助吗？

有用

无用