有奖捉虫:云通信与企业服务文档专题,速来> HOT

1. 接口描述

域名:monitor.api.qcloud.com
接口:GetMonitorData

查询Ckafka产品消费分组监控数据,入参取值如下:

namespace:qce/ckafka

维度名称取值:instanceId,topicId

dimensions.0.name=instanceId

dimensions.0.value=实例 ID

dimensions.1.name=topicId

dimensions.1.value=主题 ID

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 页面。其中,此接口的 Action 字段为 GetMonitorData。

2.1输入参数

参数名称 必选 类型 输入内容 描述
namespace String qce/ckafka 命名空间,每个云产品会有一个命名空间,具体名称见输入内容一栏
metricName String 具体的指标名称 指标名称,具体名称见2.2
dimensions.0.name String instanceId Ckafka 实例 ID
dimensions.0.value String 实例 ID 用户需要查看监控的实例 ID
dimensions.1.name String topicId Ckafka topic ID
dimensions.1.value String 主题 ID 用户订阅主题 ID
period Int 60/300 监控统计周期,绝大部分指标支持60s统计粒度,部分指标仅支持300s统计粒度,统计粒度根据指标的不同而变,输入参数时可参考2.2的指标详情列表
startTime Datetime 起始时间 起始时间,如"2016-01-01 10:25:00"。 默认时间为当天的”00:00:00”
endTime Datetime 结束时间 结束时间,默认为当前时间。 endTime 不能小于 startTime

2.2 指标名称

指标名称 含义 单位 维度
ctopic_pro_flow 主题生产流量 MB instanceId,topicId
ctopic_con_flow 主题消费流量 MB instanceId,topicId
ctopic_msg_heap 主题落磁盘消息数量 MB instanceId,topicId
ctopic_pro_count 主题生产消息数量 instanceId,topicId
ctopic_pro_req_count 主题生产请求次数 instanceId,topicId
ctopic_con_req_count 主题消费请求次数 instanceId,topicId
ctopic_msg_count 主题落磁盘消息数 instanceId,topicId
ctopic_con_count 主题消费消息数量 instanceId,topicId

3. 输出参数

参数名称 类型 描述
code Int 错误码,0:成功,其他值表示失败
message String 返回信息
startTime Datetime 起始时间
endTime Datetime 结束时间
metricName String 指标名称
period Int 监控统计周期
dataPoints Array 监控数据列表

4. 错误码表

错误代码 错误描述 英文描述
-502 资源不存在 OperationDenied.SourceNotExists
-503 请求参数有误 InvalidParameter
-505 参数缺失 InvalidParameter.MissingParameter
-507 超出限制 OperationDenied.ExceedLimit
-509 错误的维度组合 InvalidParameter.DimensionGroupError
-513 DB操作失败 InternalError.DBoperationFail

5. 示例

输入

https://monitor.api.qcloud.com/v2/index.php?
&公共请求参数
&namespace=qce/ckafka
&metricName=ctopic_msg_count 
&dimensions.0.name=instanceId
&dimensions.0.value=instance-3ewkfa
&dimensions.1.name=topicId
&dimensions.1.value=topic-resd2d
&startTime=2016-06-28 14:10:00
&endTime=2016-06-28 14:20:00

输出

{
    "code": 0,
    "message": "",
    "metricName": "cgroup_max_offset",
    "startTime": "2016-06-28 14:10:00",
    "endTime": "2016-06-28 14:20:00",
    "period": 300,
    "dataPoints": [
        50,
        80,
        100
    ]
}