查询调用指标数据散点图

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

1. 接口描述

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

查询调用指标数据散点图

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

接口更新时间：2026-02-04 20:39:57。

接口只验签名不鉴权。

2. 输入参数

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

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeInvocationMetricScatterPlot
Version	是	否	String	公共参数，本接口取值：2018-03-26
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
MetricDimensions	否	否	Array of MetricDimension	查询指标维度, 不能为空。可选 NamespaceId, GroupId, InstanceId, OperationName, ServiceName, PeerServiceName, PeerOperationName 示例值：查看
Metrics	否	否	Array of Metric	查询指标名，不能为空。仅支持 range_count_duratioin 为 key 下的 sum 方法示例值：查看
Kind	否	否	String	视图视角。可选值：SERVER, CLIENT。默认为SERVER 示例值：
StartTime	否	否	Datetime	查询开始时间示例值：
EndTime	否	否	Datetime	查询结束时间示例值：
Period	否	否	Int64	查询时间粒度，单位秒。可选值：60、3600、86400。示例值：

3. 输出参数

参数名称	类型	描述
Result	InvocationMetricScatterPlot	多值时间统计指标示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

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

错误码	描述
InvalidParameter.ParamError	参数错误。
FailedOperation.TsfApmCtsdbClientRequestError	TSF应用性能管理CTSDB客户端调用失败。
InvalidParameter.TsfApmStatsSearchRequestParamError	TSF应用性能管理运行状态统计查询请求参数错误。
FailedOperation.TsfPrivilegeError	TSF权限模块异常，请联系系统管理员。。
ResourceNotFound.MicroserviceOffline	目标微服务已离线[%s]。。

5. 示例

示例1 DescribeInvocationMetricDataCurve

输入示例

https://tsf.api3.fincloud.tencent.com/?Action=DescribeInvocationMetricScatterPlot
&StartTime=2020-06-03 17:11:49
&EndTime=2020-06-03 17:21:49
&MetricDimensions.0.Name=NamespaceId
&MetricDimensions.0.Value=namespace-6a79x94v
&Metrics.0.Name=request_count
&Metrics.0.Function=sum
&<Common Parameters>

输出示例

{
  "Response": {
    "Result": {
      "EndTime": 0,
      "StartTime": 0,
      "Period": 0,
      "DataPoints": [
        {
          "Points": [
            {
              "Values": [
                0
              ]
            }
          ],
          "MetricName": "namespaceId",
          "PointKeys": [
            "time"
          ]
        }
      ]
    },
    "RequestId": "96561cf1-738a-47d6-943b-dec7ebbccabe"
  }
}