云监控服务 CES-批量查询监控数据:响应消息

时间:2024-10-10 14:45:53

响应消息

  • 响应参数
    表5 响应参数

    名称

    参数类型

    说明

    metrics

    Arrays of objects

    指标数据。

    详细参数请参见表6

    表6 metrics字段数据结构说明

    名称

    参数类型

    说明

    unit

    String

    指标单位。

    datapoints

    Arrays of objects

    指标数据列表。由于查询数据时, 云监控 会根据所选择的聚合粒度向前取整from参数,所以datapoints中包含的数据点有可能会多于预期,最多返回3000个数据点(响应参数metrics属性对应对象datapoints属性累加最多返回3000个数据点)。

    详细参数请参见表8

    namespace

    String

    指标命名空间,格式为service.item;service和item必须是字符串,必须以字母开头,只能包含0-9/a-z/A-Z/_,service.item总长度最短为3,最大为32。

    dimensions

    Arrays of objects

    指标维度列表。

    单个维度为json对象,结构说明如下:

    {

    "name": "instance_id",

    "value": "33328f02-3814-422e-b688-bfdba93d4050"

    }

    详细参数请参见表7

    metric_name

    String

    指标名称,必须以字母开头,只能包含0-9/a-z/A-Z/_,长度最短为1,最大为64。

    表7 dimensions字段数据结构说明

    名称

    参数类型

    说明

    name

    String

    监控维度名称,例如弹性云服务器的维度为instance_id。各服务维度请参考支持监控的服务列表,可参考维度中key字段。

    必须以字母开头,只能包含0-9/a-z/A-Z/_/-,长度最短为1,最大为32。

    value

    String

    维度取值,例如弹性云服务器的ID。

    必须以字母或数字开头,只能包含0-9/a-z/A-Z/_/-,长度最短为1,最大为256。

    表8 datapoints字段数据结构说明

    名称

    参数类型

    说明

    average

    Double

    聚合周期内指标数据的平均值。

    max

    Double

    聚合周期内指标数据的最大值。

    min

    Double

    聚合周期内指标数据的最小值。

    sum

    Double

    聚合周期内指标数据的求和值。

    variance

    Double

    聚合周期内指标数据的方差。

    timestamp

    Long

    指标采集时间,UNIX时间戳,单位毫秒。

  • 响应样例
    响应样例一:维度是instance_id为faea5b75-e390-4e2b-8733-9226a9026070的弹性云服务器的监控数据cpu_util的平均值和维度是instance_id为06b4020f-461a-4a52-84da-53fa71c2f42b的弹性云服务器的监控数据network_vm_connections的平均值。
    {
        "metrics": [
            {
                "namespace": "SYS.E CS ",
                "metric_name": "cpu_util",
                "dimensions": [
                    {
                        "name": "instance_id",
                        "value": "faea5b75-e390-4e2b-8733-9226a9026070"
                    }
                ],
                "datapoints": [
                    {
                        "average": 0.69,
                        "timestamp": 1556625610000
                    },
                    {
                        "average": 0.7,
                        "timestamp": 1556625715000
                    }
                ],
                "unit": "%"
            },
            {
                "namespace": "SYS.ECS",
                "metric_name": "network_vm_connections",
                "dimensions": [
                    {
                        "name": "instance_id",
                        "value": "06b4020f-461a-4a52-84da-53fa71c2f42b"
                    }
                ],
                "datapoints": [
                    {
                        "average": 1,
                        "timestamp": 1556625612000
                    },
                    {
                        "average": 3,
                        "timestamp": 1556625717000
                    }
                ],
                "unit": "count"
            }
        ]
    }
    响应样例二:维度是rds_cluster_id为3c8cc15614ab46f5b8743317555e0de2in01的关系性数据库和维度是rds_cluster_id为3b2fa8b55a9b4adca3713962a9d31884in01的关系性数据库的监控数据rds021_myisam_buf_usage的求和值。
    {
        "metrics": [
            {
                "unit": "Ratio",
                "datapoints": [
                    {
                        "sum": 0.07,
                        "timestamp": 1556625628000
                    },
                    {
                        "sum": 0.07,
                        "timestamp": 1556625688000
                    }
                ],
                "namespace": "SYS.RDS",
                "dimensions": [
                    {
                        "name": "rds_cluster_id",
                        "value": "3c8cc15614ab46f5b8743317555e0de2in01"
                    }
                ],
                "metric_name": "rds021_myisam_buf_usage"
            },
            {
                "unit": "Ratio",
                "datapoints": [
                    {
                        "sum": 0.06,
                        "timestamp": 1556625614000
                    },
                    {
                        "sum": 0.07,
                        "timestamp": 1556625674000
                    }
                ],
                "namespace": "SYS.RDS",
                "dimensions": [
                    {
                        "name": "rds_cluster_id",
                        "value": "3b2fa8b55a9b4adca3713962a9d31884in01"
                    }
                ],
                "metric_name": "rds021_myisam_buf_usage"
            }
        ]
    }
    响应样例三:维度是instance_id为cd841102-f6b1-407d-a31f-235db796dcbb和proc为b28354b543375bfa94dabaeda722927f的主机监控的监控数据rds021_myisam_buf_usage的最小值。
    {
        "metrics": [
            {
                "unit": "Ratio",
                "datapoints": [
                    {
                        "min": 0,
                        "timestamp": 1556625612000
                    },
                    {
                        "min": 0,
                        "timestamp": 1556625672000
                    }
                ],
                "namespace": "AGT.ECS",
                "dimensions": [
                    {
                        "name": "instance_id",
                        "value": "cd841102-f6b1-407d-a31f-235db796dcbb"
                    },
                    {
                        "name": "proc",
                        "value": "b28354b543375bfa94dabaeda722927f"
                    }
                ],
                "metric_name": "rds021_myisam_buf_usage"
            }
        ]
    }
support.huaweicloud.com/api-ces/ces_03_0034.html