查询监控指标：GetMonitorData接口调用使用指南

1. 接口描述

2. 输入参数

3. 请求域名 接口请求域名：monitor.api3.${domain_main}，如monitor.api3.3100light2az.fsphere.cn。 说明： ${domain_main}可以通过登录任意一个pod，打开/tce/conf/cm/local.json搜索domain_main关键字来获取。
4. 请求地域 由于监控数据是按地域上报并且是按地域存储的，因此调用接口时需明确指定被拉取实例所在的地域，地域信息获取方式为： 登录任意一个pod，打开/tce/conf/cm/local.json搜索region_list关键字，里面的region_name即为可用的地域。
5. 调用限频 默认接口请求频率限制：20次/秒。
6. 输出参数

7. 示例 拉取某台CVM实例某段时间内统计周期为5分钟的CPU利用率监控数据。 输入示例： `POST HTTP/1.1 Host: monitor.api3.3100light2az.fsphere.cn Content-Type: application/json Action: GetMonitorData { "Namespace": "qce/cvm", "MetricName": "CPUUsage", "Period": 300, "Dimensions": [

    {
        "unInstanceId": "ins-miltleuc"
    }

   ], "StartTime": "2024-03-24T10:51:23+08:00", "EndTime": "2024-03-24T20:51:23+08:00" }输出示例{ "Response": {

    "StartTime": "2019-03-24 10:50:00",
    "EndTime": "2019-03-24 20:50:00",
    "Period": 300,
    "MetricName": "cpu_usage",
    "DataPoints": [
        {
            "Dimensions": {
                    "unInstanceId": "ins-miltleuc"                    },
            "Points": [
                2.566,
                2.283,
                6.316,
                2.816,
                2.7,
                2.35
            ]
        }
    ],
   "RequestId": "d96ec542-6547-4af2-91ac-fee85c1b8b85"

   } }`
8. SDK代码调用 拉取某台CVM实例某段时间内统计周期为5分钟的CPU利用率监控数据。
   1. golang示例 `package main

import ( "fmt"

"github.com/tcecloud/tcecloud-sdk-go/tcecloud/common"
"github.com/tcecloud/tcecloud-sdk-go/tcecloud/common/errors"
"github.com/tcecloud/tcecloud-sdk-go/tcecloud/common/profile"
monitor "github.com/tcecloud/tcecloud-sdk-go/tcecloud/monitor/v20170312"

)

func main() { secretId := "AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" secretKey := "eyzi69sGK3SWFeiblb8NKwD9l2yZplNf"

credential := common.NewCredential(secretId, secretKey)
cpf := profile.NewClientProfile()
cpf.HttpProfile.Scheme = "HTTP"
cpf.HttpProfile.ReqTimeout = 10
cpf.HttpProfile.Endpoint = "monitor.api3.3100light2az.fsphere.cn"
client, _ := monitor.NewClient(credential, "chongqing", cpf)

request := monitor.NewGetMonitorDataRequest()

request.Namespace = common.StringPtr("qce/cvm")
request.MetricName = common.StringPtr("cpu_usage")
request.Period = common.Uint64Ptr(60)
request.StartTime = common.StringPtr("2024-10-17T15:10:42+08:00")
request.EndTime = common.StringPtr("2024-10-17T16:10:42+08:00")

// 构建 Dimensions 字段
dimensions := []string{
    "{\"unInstanceId\": \"ins-miltleuc\"}",
}
request.Dimensions = common.StringPtrs(dimensions)
response, err := client.GetMonitorData(request)

if _, ok := err.(*errors.CloudSDKError); ok {
    fmt.Printf("An API error has returned: %s", err)
    return
}
// Non-SDK exception, direct failure. Other processing can be added to the actual code.
if err != nil {
    panic(err)
}
// Print the returned json string
fmt.Printf("%s", response.ToJsonString())

}

`

说明：

13~14行：secretId、secretKey为调用凭证，用于调用鉴权，相当于通过secretId和secretKey可以识别调用的appid及uin。secretId与secretKey通过如下方式进行创建：

20行：Endpoint为调用域名，获取方式参考第三节"3. 请求域名" 21行：chongqing为云产品实例监控数据所在的地域，获取方式参考第四节"4. 请求地域"

2. python示例 `# -- coding: utf8 -- # import json from tcecloud.common import credential from tcecloud.common.exception.cloud_sdk_exception import CloudSDKException from tcecloud.monitor.v20170312 import monitor_client, models from tcecloud.common.profile.client_profile import ClientProfile from tcecloud.common.profile.http_profile import HttpProfile import ssl

ssl._create_default_https_context = ssl._create_unverified_context

try: secret_id = "AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" secret_key = "1qVuzkBH3WgWhX3F7LJyJJyIJ0NP77rM" cred = credential.Credential(secret_id, secret_key)

httpProfile = HttpProfile()
httpProfile.endpoint = "monitor.api3.3100light2az.fsphere.cn"

clientProfile = ClientProfile()
clientProfile.httpProfile = httpProfile
client = monitor_client.MonitorClient(cred, "chongqing", clientProfile)

req = models.GetMonitorDataRequest()
params = {
    "Namespace": "qce/cvm",
    "MetricName": "cpu_usage",
    "Period": 60,
    "StartTime": "2024-10-17T15:10:42+08:00",
    "EndTime": "2024-10-17T16:10:42+08:00",
    "Dimensions": ['''{"unInstanceId": "ins-miltleuc"}''']
}
req.from_json_string(json.dumps(params))
resp = client.GetMonitorData(req)

# Output json format string back package
print(resp.to_json_string(indent=2))

except CloudSDKException as err: print(err)`

说明：

14~15行：secretId、secretKey为调用凭证，用于调用鉴权，相当于通过secretId和secretKey可以识别调用的appid及uin。secretId与secretKey通过如下方式进行创建：

19行：Endpoint为调用域名，获取方式参考第三节"3. 请求域名" 23行：chongqing为云产品实例监控数据所在的地域，获取方式参考第四节"4. 请求地域" 9. 附录