全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

获取数据接口

最近更新时间:2024-04-22 11:56:52

获取监控数据(历史数据)

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>

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈