查询调用链

最近更新时间: 2026-10-11 00:12:03

1. 接口描述

接口请求域名： tsf.api3.fincloud.tencent.com。

查询调用链

默认接口请求频率限制：10000次/秒。

接口更新时间：2026-04-01 21:51:32。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：SearchTrace
Version	是	否	String	公共参数，本接口取值：2018-03-26
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
IncludeNonRoot	否	否	Bool	查询非根节点调用链示例值：
MinDuration	否	否	Uint64	最小耗时示例值：
MaxDuration	否	否	Uint64	最长耗时示例值：
EndTime	是	否	Datetime	搜索结束时间示例值：
CallerServiceName	否	否	String	调用方服务名示例值：
ResultStatus	否	否	String	错误码示例值：
ErrMsg	否	否	String	错误信息示例值：
ErrorTrace	否	否	Bool	是否仅展示错误调用链示例值：
OrderType	否	否	String	排序方向，支持"asc"和"desc" 示例值：
CalleeInterfaceName	否	否	String	被调方接口名示例值：
CallerIp	否	否	String	调用方IP 示例值：
CalleeIp	否	否	String	被调方IP 示例值：
OrderBy	否	否	String	排序方式，支持"timestamp"和"duration" 示例值：
Limit	否	否	Uint64	返回trace数目，取值范围[0, 100]，默认值20 示例值：
ClusterId	否	否	String	TSF集群ID 示例值：
NamespaceId	否	否	String	TSF命名空间ID 示例值：
Offset	否	否	Uint64	查询trace偏移量示例值：
StartTime	是	否	Datetime	搜索开始时间示例值：
CalleeServiceName	否	否	String	被调方服务名示例值：
CallerInterfaceName	否	否	String	调用方接口名示例值：
Tags	否	否	String	用户自定义标签示例值：
RootInterface	否	否	String	入口span的接口示例值：
RootIp	否	否	String	入口ip 示例值：
RootService	否	否	String	入口span的服务名示例值：
TraceId	否	否	String	调用链traceId 示例值：

3. 输出参数

参数名称	类型	描述
Result	TsfPageZipkinTraceInfoV2	调用链列表示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InvalidParameter.ParamError	参数错误。
FailedOperation.TsfApmCtsdbClientRequestError	TSF应用性能管理CTSDB客户端调用失败。
UnauthorizedOperation.NoPrivilege	用户无权限访问该接口。。
InternalError.UnhandledException	[%s]模块未处理异常。。
InvalidParameter.TsfApmTraceSearchRequestParamError	TSF应用性能管理调用链搜索请求参数错误。
ResourceNotFound.LicenseServerNotFound	无法找到License服务器。
ResourceNotFound.TsfApmNamespaceUnavailable	TSF应用性能管理子账户没有可用的命名空间。

5. 示例

示例1 查询调用链

输入示例

POST / HTTP/1.1
Host: tsf.api3.fincloud.tencent.com
Content-Type: application/json
X-TC-Action: SearchTrace
<Common Parameters>

{
    "EndTime": "2019-05-29 14:58:29",
    "ErrorTrace": "false",
    "Limit": "20",
    "StartTime": "2019-05-29 14:48:29",
    "Offset": "0"
}

输出示例

{
  "Response": {
    "RequestId": "b4bf7f58-eeab-4d01-bc4e-2d7fef43935b",
    "Result": {
      "TotalCount": 531,
      "Content": [
        {
          "TraceId": "e1f552e5af09fc8b",
          "Timestamp": 1559113048105000,
          "Duration": 10000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "9793a0828b813f4f",
          "Timestamp": 1559113047088000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "ac6221f5601f225e",
          "Timestamp": 1559113046072000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "f9dba4e127472907",
          "Timestamp": 1559113045054000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "84eaf6f5ab5576c2",
          "Timestamp": 1559113044035000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "f046ae036f4c2b1d",
          "Timestamp": 1559113043017000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "b49ce6572b4a16e5",
          "Timestamp": 1559113042006000,
          "Duration": 10000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "76381357eef3b698",
          "Timestamp": 1559113040989000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "13ac3e65c2809e0a",
          "Timestamp": 1559113039971000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "971e4ff11b94c155",
          "Timestamp": 1559113038956000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "e2153ed866ae4706",
          "Timestamp": 1559113037944000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "acbf4203e5fdcf86",
          "Timestamp": 1559113036924000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "936b60450c385dc5",
          "Timestamp": 1559113035903000,
          "Duration": 10000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "59e9fa6a82974d2d",
          "Timestamp": 1559113034888000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "0ad52ba81e0c00c5",
          "Timestamp": 1559113033868000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "0aac1c23fdea37a3",
          "Timestamp": 1559113032853000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "da72a1e0e7353298",
          "Timestamp": 1559113031836000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "f568cbd118911716",
          "Timestamp": 1559113030821000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "a7ac333464db3b64",
          "Timestamp": 1559113029801000,
          "Duration": 12000,
          "ResultStatus": "200",
          "ResultError": false
        },
        {
          "TraceId": "c26f2f3762d94804",
          "Timestamp": 1559113028780000,
          "Duration": 11000,
          "ResultStatus": "200",
          "ResultError": false
        }
      ]
    }
  }
}