查询边缘函数分析时序数据

1. 接口描述

接口请求域名: teo.intl.tencentcloudapi.com 。

本接口查询边缘函数分析的时序数据。请注意本接口查询数据有 10 分钟左右延迟,建议拉取当前时间 10 分钟以前的数据。

默认接口请求频率限制:20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

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

参数名称必选类型描述
Action是String公共参数,本接口取值:DescribeTimingFunctionAnalysisData。
Version是String公共参数,本接口取值:2022-09-01。
Region否String公共参数,此参数为可选参数。
ZoneIds.N是Array of String

站点 ID 集合,至少填入1个站点 ID。

StartTime是Timestamp ISO8601

开始时间。

EndTime是Timestamp ISO8601

结束时间。查询时间范围(EndTime - StartTime)需小于等于 7 天。

MetricNames.N是Array of String

指标列表,取值有:

  • function_requestCount: 边缘函数请求数,为累计值;
  • function_cpuCostTime: 边缘函数执行的平均 CPU 耗时,单位为微秒;
  • function_wallClockTime: 边缘函数执行的平均墙上时钟耗时,单位为微秒。
  • Interval否String

    查询时间粒度,取值有:

  • min: 1分钟;
  • 5min: 5分钟;
  • hour: 1小时;
  • day: 1天。
  • 不填将根据开始时间跟结束时间的间距自动推算粒度,具体为:2 小时范围内以 min 粒度查询,2 天范围内以 5min 粒度查询,7 天范围内以 hour 粒度查询,超过 7 天以 day 粒度查询。
    Filters.N否Array of QueryCondition

    过滤条件,Filters.Value 的集合数量上限为20,详细的过滤条件 Key 值如下:

  • domain:按照子域名进行过滤,示例值: www.example.com。
  • function-name:按照边缘函数名称进行过滤,示例值: test051301-zone-2r2fdoxxxx-130000000。
  • function-result:按照边缘函数执行结果进行过滤。对应 Value 的可选项如下:
       success:成功;
       fail:失败。
  • Area否String

    数据归属地区,取值有:

  • overseas:全球(除中国大陆地区)数据;
  • mainland:中国大陆地区数据;
  • global:全球数据。
  • 不填默认取值为 global。

    3. 输出参数

    参数名称类型描述
    TotalCountInteger

    查询结果的总条数。

    DataArray of TimingDataRecord

    时序数据列表。

    RequestIdString唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

    4. 示例

    示例1 根据函数名称查询边缘函数请求数时序数据

    输入示例

    POST / HTTP/1.1
    Host: teo.intl.tencentcloudapi.com
    Content-Type: application/json
    X-TC-Action: DescribeTimingFunctionAnalysisData
    <公共请求参数>
    
    {
        "ZoneIds": [
            "zone-2o7b38ba1hvr"
        ],
        "StartTime": "2022-07-31T00:00:00+08:00",
        "EndTime": "2022-08-29T19:17:59+08:00",
        "MetricNames": [
            "function_requestCount"
        ],
        "Interval": "day",
        "Area": "mainland",
        "Filters": [
            {
                "Key": "function-name",
                "Operator": "equals",
                "Value": [
                    "test051301-zone-2o7b38ba1hvr-13000000"
                ]
            }
        ]
    }

    输出示例

    {
        "Response": {
            "RequestId": "141a7ccd-9713-43a2-91d5-1b47692d0609",
            "Data": [
                {
                    "TypeKey": "13000000",
                    "TypeValue": [
                        {
                            "Avg": 803,
                            "Detail": [
                                {
                                    "Timestamp": 1659139200,
                                    "Value": 0
                                },
                                {
                                    "Timestamp": 1661731200,
                                    "Value": 0
                                }
                            ],
                            "Max": 7921,
                            "MetricName": "function_requestCount",
                            "Sum": 24918
                        }
                    ]
                }
            ],
            "TotalCount": 1
        }
    }

    5. 开发者资源

    SDK

    云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

    命令行工具

    6. 错误码

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

    错误码描述
    FailedOperation操作失败。
    InternalError.ProxyServer后端服务器发生未知错误。
    InvalidParameter参数错误。
    InvalidParameterValue参数取值错误。
    LimitExceeded超过配额限制。
    LimitExceeded.QueryTimeLimitExceeded查询时间范围超出限制。
    OperationDenied操作被拒绝。
    ResourceNotFound资源不存在。
    ResourceUnavailable资源不可用。
    UnauthorizedOperation.CamUnauthorizedCam 未授权。