办公协同&微信生态产品文档捉虫活动邀您参加！> HOT
文档中心>腾讯云可观测平台

拉取指标监控数据

最近更新时间：2025-04-25 01:45:51

我的收藏

本页目录：

1. 接口描述

接口请求域名： monitor.tencentcloudapi.com 。

获取云产品的监控数据。此接口不适用于拉取容器服务监控数据，如需拉取容器服务监控数据，请使用根据维度条件查询监控数据接口。
传入产品的命名空间、对象维度描述和监控指标即可获得相应的监控数据。
接口调用限制：单请求最多可支持批量拉取10个实例的监控数据，单请求的数据点数限制为1440个。
若您需要调用的指标、对象较多，可能存在因限频出现拉取失败的情况，建议尽量将请求按时间维度均摊。
参数SpecifyStatistics目前可支持返回三种统计方式（avg，max，min），分别为二进制1，2，4。
例子：3:avg+max，5:avg+min，6:max+min，7:avg+max+min
拉取数据的粒度和统计方式的对应关系尽量在接入平台进行配置，如果没有配置对应统计方式，请提工单反馈。

说明：

  • 2022年9月1日起，腾讯云可观测平台开始对GetMonitorData接口计费。每个主账号每月可获得100万次免费请求额度，超过免费额度后如需继续调用接口需要开通 API请求按量付费。计费规则可查看API计费文档。

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

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

2. 输入参数

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

参数名称 必选 类型 描述
Action 是 String 公共参数，本接口取值：GetMonitorData。
Version 是 String 公共参数，本接口取值：2018-07-24。
Region 是 String 公共参数，详见产品支持的 地域列表。
Namespace 是 String 命名空间，如QCE/CVM。各个云产品的详细命名空间说明请参阅各个产品监控指标文档
示例值：QCE/CVM
MetricName 是 String 指标名称，如CPUUsage，仅支持单指标拉取。各个云产品的详细指标说明请参阅各个产品监控指标文档，对应的指标英文名即为MetricName
示例值：CPUUsage
Instances.N 是 Array of Instance 实例对象的维度组合，格式为key-value键值对形式的集合。不同类型的实例字段完全不同，如CVM为[{"Name":"InstanceId","Value":"ins-j0hk02zo"}]，Ckafka为[{"Name":"instanceId","Value":"ckafka-l49k54dd"}]，COS为[{"Name":"appid","Value":"1258344699"},{"Name":"bucket","Value":"rig-1258344699"}]。各个云产品的维度请参阅各个产品监控指标文档，对应的维度列即为维度组合的key，value为key对应的值。单请求最多支持批量拉取10个实例的监控数据。
示例值：[{"Dimensions":[{"Name":"uuid","Value":"9f25c238-4e82-46e4-a0fe-76443480c8db"}]}]
Period 否 Integer 监控统计周期，如60。默认为取值为300，单位为s。每个指标支持的统计周期不一定相同，各个云产品支持的统计周期请参阅各个产品监控指标文档，对应的统计周期列即为支持的统计周期。单请求的数据点数限制为1440个。
示例值：300
StartTime 否 Timestamp ISO8601 起始时间，如2018-09-22T19:51:23+08:00
示例值：2019-03-24T10:51:23+08:00
EndTime 否 Timestamp ISO8601 结束时间，如2018-09-22T20:51:23+08:00，默认为当前时间。 EndTime不能小于StartTime
示例值：2019-03-24T20:51:23+08:00
SpecifyStatistics 否 Integer 返回多种统计方式数据。avg, max, min (1,2,4)可以自由组合。注意: 仅支持对API配置文档中展示的统计方式返回对应的统计数据。如所需的统计方式不满足您的查询需求，请提工单反馈。
示例值：1

3. 输出参数

参数名称 类型 描述
Period Integer 统计周期
示例值：300
MetricName String 指标名
示例值：CPUUsage
DataPoints Array of DataPoint 数据点数组
示例值：[{"Dimensions":[{"Name":"uuid","Value":"9f25c238-4e82-46e4-a0fe-76443480c8db"}],"Timestamps":[1535079000],"Values":[2.5]}]
StartTime Timestamp ISO8601 开始时间
示例值：2019-03-24T10:50:00+08:00
EndTime Timestamp ISO8601 结束时间
示例值：2019-03-24T20:50:00+08:00
Msg String 返回信息
示例值：请求缺少必传参数 Instances 。
RequestId String 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 拉取单台CDB监控数据

拉取某台CDB实例某段时间内统计周期为5分钟的CPU利用率监控数据

输入示例

复制
复制成功
POST / HTTP/1.1
Host: monitor.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: GetMonitorData
<公共请求参数>

{
    "Namespace": "QCE/CDB",
    "MetricName": "CpuUseRate",
    "Period": 300,
    "Instances": [
        {
            "Dimensions": [
                {
                    "Name": "InstanceId",
                    "Value": "cdb-k5d6z7p0"
                },
                {
                    "Name": "InstanceType",
                    "Value": "2"
                }
            ]
        }
    ],
    "StartTime": "2018-09-22T19:23:07+08:00",
    "EndTime": "2018-09-22T20:23:07+08:00"
}

输出示例

复制
复制成功
{
    "Response": {
        "StartTime": "2018-09-22T19:20:00+08:00",
        "EndTime": "2018-09-22T20:20:00+08:00",
        "Period": 300,
        "MetricName": "CpuUseRate",
        "DataPoints": [
            {
                "Dimensions": [
                    {
                        "Name": "InstanceType",
                        "Value": "2"
                    },
                    {
                        "Name": "InstanceId",
                        "Value": "cdb-k5d6z7p0"
                    }
                ],
                "Timestamps": [],
                "Values": []
            }
        ],
        "Msg": "",
        "RequestId": "2bcfe8b7-8ea8-4488-9d17-f1aeb106eecd"
    }
}

示例2 拉取单台云服务器监控数据

拉取某台云服务器某段时间内统计周期为5分钟的CPU利用率监控数据

输入示例

复制
复制成功
POST / HTTP/1.1
Host: monitor.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: GetMonitorData
<公共请求参数>

{
    "Namespace": "QCE/CVM",
    "MetricName": "CPUUsage",
    "Period": 300,
    "Instances": [
        {
            "Dimensions": [
                {
                    "Name": "InstanceId",
                    "Value": "ins-j0hk02zo"
                }
            ]
        }
    ],
    "StartTime": "2019-03-24T10:51:23+08:00",
    "EndTime": "2019-03-24T20:51:23+08:00"
}

输出示例

复制
复制成功
{
    "Response": {
        "StartTime": "2019-03-24T10:50:00+08:00",
        "EndTime": "2019-03-24T20:50:00+08:00",
        "Period": 300,
        "MetricName": "CPUUsage",
        "DataPoints": [
            {
                "Dimensions": [
                    {
                        "Name": "InstanceId",
                        "Value": "ins-j0hk02zo"
                    }
                ],
                "Timestamps": [
                    1535079000,
                    1535079300,
                    1535079600,
                    1535079900,
                    1535080200,
                    1535080500
                ],
                "Values": [
                    2.566,
                    2.283,
                    6.316,
                    2.816,
                    2.7,
                    2.35
                ]
            }
        ],
        "Msg": "",
        "RequestId": "d96ec542-6547-4af2-91ac-fee85c1b8b85"
    }
}

示例3 拉取多台云服务器监控数据

拉取多台云服务器某段时间内统计周期为5分钟的CPU利用率监控数据

输入示例

复制
复制成功
POST / HTTP/1.1
Host: monitor.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: GetMonitorData
<公共请求参数>

{
    "Namespace": "QCE/CVM",
    "MetricName": "CPUUsage",
    "Period": 300,
    "Instances": [
        {
            "Dimensions": [
                {
                    "Name": "InstanceId",
                    "Value": "ins-j0hk02zo"
                }
            ]
        },
        {
            "Dimensions": [
                {
                    "Name": "InstanceId",
                    "Value": "ins-o8vv2w10"
                }
            ]
        }
    ],
    "StartTime": "2018-09-22T19:51:23+08:00",
    "EndTime": "2018-09-22T20:51:23+08:00"
}

输出示例

复制
复制成功
{
    "Response": {
        "StartTime": "2018-09-22T19:50:00+08:00",
        "EndTime": "2018-09-22T20:50:00+08:00",
        "Period": 300,
        "MetricName": "CPUUsage",
        "DataPoints": [
            {
                "Dimensions": [
                    {
                        "Name": "InstanceId",
                        "Value": "ins-j0hk02zo"
                    }
                ],
                "Timestamps": [],
                "Values": []
            },
            {
                "Dimensions": [
                    {
                        "Name": "InstanceId",
                        "Value": "ins-o8vv2w10"
                    }
                ],
                "Timestamps": [],
                "Values": []
            }
        ],
        "Msg": "",
        "RequestId": "9ac53ccc-fbab-483d-980b-b763bcc2f83f"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

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

命令行工具

6. 错误码

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

错误码 描述
FailedOperation.ErrNotOpen 未开通。
FailedOperation.ErrOwed 欠费。
InternalError 内部错误。
InvalidParameterValue 参数取值错误。
UnsupportedOperation 操作不支持。

如果遇到产品相关问题，您可咨询 在线客服寻求帮助。

腾讯云可观测平台 相关文档

中国站
目录