工具监控总览
更新时间：2026-03-04
POST
https://qianfan.baidubce.com/v2/components
查询单用户单组件监控总览，返回指定时间范围内的调用汇总指标及趋势数据。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
Action
string
接口操作标识。
必选
Body 参数
code
string
组件 code。
必选
startTime
string
起始时间，天级别指定，如 2026-01-08，实际时间默认为当天的 0 点。
必选
endTime
string
终止时间，天级别指定，如 2026-01-08，实际时间默认为当天的 23 点 59 分 59 秒。
必选
channel
string
调用渠道，不填默认全部渠道。可选值：agent、custom_tool、mcp、api。
可选
timeStep
string
时间步长，决定统计数据的离散化间隔，时间范围最长支持 3 个月，超过将返回错误。可选值：day（按天统计，每个数据点代表一天）、week（按周统计，每个数据点代表一周，统计点在周一）、month（按月统计，每个数据点代表一月，统计点在月初一号）。
可选
请求结构
POST /v2/components?Action={Action} HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"code": "5e12955f-6b45-4f54-b2b6-84369f068a3d",
"startTime": "2026-01-01",
"endTime": "2026-01-10",
"channel": "agent",
"timeStep": "day"
}示例代码
请求示例
curl -X POST "https://qianfan.baidubce.com/v2/components?Action=DescribeComponentOverview" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"code": "5e12955f-6b45-4f54-b2b6-84369f068a3d",
"startTime": "2026-01-01",
"endTime": "2026-01-10",
"channel": "agent",
"timeStep": "day"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
状态码，0 表示成功。
必选
message
string
错误信息，成功时为空字符串。
必选
result
object {3}
返回结果数据。
必选
显示子属性
隐藏子属性
requestId
string
请求记录 ID。
必选
summary
object {7}
组件监控汇总指标。
必选
显示子属性
隐藏子属性
totalCount
integer
统计时间范围内的总调用次数。
必选
successCount
integer
统计时间范围内的成功调用次数。
必选
failureCount
integer
统计时间范围内的失败调用次数。
必选
successRate
number
调用成功率，计算公式：successCount / totalCount。
必选
avgTimecost
number
平均调用耗时（毫秒）。
必选
avgQps
number
平均 QPS（请求数 / 秒）。
必选
maxQps
number
最大 QPS（请求数 / 秒）。
必选
trend
array
按时间粒度统计的监控趋势数据。
必选
显示子属性
隐藏子属性
items
object {10}
显示子属性
隐藏子属性
statTime
integer
统计时间点（秒级时间戳）。
必选
totalCount
integer
该时间点的总调用次数。
必选
successCount
integer
该时间点的成功调用次数。
必选
failureCount
integer
该时间点的失败调用次数。
必选
avgTimecost
number
该时间点的平均调用耗时（毫秒）。
必选
p50Timecost
number
该时间点的 P50 调用耗时（毫秒）。
必选
p90Timecost
number
该时间点的 P90 调用耗时（毫秒）。
必选
p99Timecost
number
该时间点的 P99 调用耗时（毫秒）。
必选
avgQps
number
该时间点的平均 QPS（请求数 / 秒）。
必选
maxQps
number
该时间点的最大 QPS（请求数 / 秒）。
必选
返回示例
{
"code": 0,
"message": "",
"result": {
"requestId": "e4fe8713-f9fb-4681-86c5-73a98fd54320",
"summary": {
"totalCount": 8,
"successCount": 8,
"failureCount": 0,
"successRate": 1,
"avgTimecost": 312.62,
"avgQps": 0.7,
"maxQps": 1
},
"trend": [
{
"statTime": 1751299200,
"totalCount": 0,
"successCount": 0,
"failureCount": 0,
"avgTimecost": 0,
"p50Timecost": 0,
"p90Timecost": 0,
"p99Timecost": 0,
"avgQps": 0,
"maxQps": 0
}
]
}
}