获取数据接口

获取监控数据（历史数据）

1.接口描述

2.输入参数

3.输出参数

4.示例

1.接口描述

域名：monitor.api.ksyun.com

VPC内调用域名：monitor.internal.api.ksyun.com

接口名: GetMetricStatistics

本接口支持查询最近15min以前的历史数据（30天以内），支持并发量小。

若需查询最近15min内的实时数据，且为高并发量数据，请用批量获取数据接口。

容器引擎产品见容器引擎获取数据接口。

用户单位时间内调用单API次数，每分钟最多3600次请求。

2.输入参数

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

参数名称	必选	类型	描述
Namespace	是	String	表示一类云产品，指定命名空间。
InstanceID	是	String	监控实例的ID 备注：MongoDB产品，请在相应监控实例ID前添加user前缀
MetricName	是	String	监控项名称
StartTime	是	String	本地时间，开始时间戳，如2017-02-28T17:00:00Z
EndTime	是	String	本地时间，结束时间戳，如2017-02-28T18:00:00Z, 数据采集有2分钟左右延迟，EndTime需比当前时间延迟两分钟
Period	否	Interger	采样周期，60的整数倍，单位为秒，如果和控制台不一致，会导致数据不一致。默认值为空，将不对数据进行降采样，按产品线的推送频率进行展示。
Aggregate	是	String	数据聚合的方法，Average,Max,Min,Sum ，如果和控制台不一致，会导致数据不一致

3.输出参数

参数名称	类型	描述
Datapoints	Array	按照指定的统计方法获取的监控数据
Label	String	监控指标
RequestId	String	请求ID

4.示例

输入

https://monitor.${region}.api.ksyun.com?
Action=GetMetricStatistics
&Version=2010-05-25
&InstanceID=instanceId
&Namespace=KEC
&MetricName=cpu.utilizition.total
&StartTime=2017-02-28T017:00:00Z
&EndTime=2017-02-28T017:14:00Z
&Aggregate=Average,Sum,Count,Max,Min
&Period=600
&公共参数

${region}可替换相应区域，详见region说明

输出

<GetMetricStatisticsResponse xmlns="https://ksyun.kingeyes.com/">
    <GetMetricStatisticsResult>
        <Datapoints>
            <member>
                <Average>0.158</Average>
                <Max>0.217</Max>
                <Min>0.117</Min>
                <SampleCount>1</SampleCount>
                <Sum>2</Sum>
                <Timestamp>2017-02-28T17:00:00Z</Timestamp>
            </member>
            <member>
                <Average>0.158</Average>
                <Max>0.183</Max>
                <Min>0.117</Min>
                <SampleCount>1</SampleCount>
                <Sum>2</Sum>
                <Timestamp>2017-02-28T17:10:00Z</Timestamp>
            </member>       
        </Datapoints>
        <Label>cpu.utilizition.total</Label>
    </GetMetricStatisticsResult>
    <ResponseMetadata>
        <RequestId>11eb1447-e7ee-402e-bc31-5c21f90a2955</RequestId>
    </ResponseMetadata>
</GetMetricStatisticsResponse>