调用DescribeContainerGroupMetric查询一个ECI实例的监控数据。

接口说明

  • 最多支持返回50条监控数据,超出50条将会报错。
  • 仅支持分别查询5分钟以内的实时数据,或者5分钟之前的历史数据。如果查询时间段超出了当前时间点,默认只查询5分钟之前的历史数据。
  • 仅支持查询创建时间晚于北京时间2019年04月03日15点的ECI实例的监控数据。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeContainerGroupMetric

系统规定参数,取值:DescribeContainerGroupMetric。

ContainerGroupId String eci-bp17da5olmkuagfr****

ECI实例ID,即容器组ID。

RegionId String cn-hangzhou

地域ID。

StartTime String 2019-03-12T01:00:00.000Z

查询某个时间段内的监控数据时,设置的开始时间。取值必须为30天之内,默认为EndTime减去5分钟。

格式为RFC3339时间格式。例如:北京时间2019年03月12号上午9点整可以表示为2019-03-12T09:00:00.000+08:00或者2019-03-12T01:00:00.000Z

EndTime String 2019-09-12T01:05:00.000Z

查询某个时间段内的监控数据时,设置的结束时间。默认为当前时间。

格式为RFC3339时间格式。

Period String 15

数据聚合周期,单位为秒。目前只支持15、30、60和600秒。默认为60秒。

说明 如果StartTime和EndTime均没有设置,则默认获取最新5分钟的监控数据,默认聚合周期为15S,传入的Period将被忽略。

返回数据

名称 类型 示例值 描述
ContainerGroupId String eci-bp1dqpye03ke5s6p****

ECI实例ID,即容器组ID。

Records Array of Record

ECI实例的监控数据详情。

CPU Struct

CPU数据。

Limit Long 2000

CPU使用上限(CPU核数*1000)。

Load Long 0

最近10秒的平均负载情况。

UsageCoreNanoSeconds Long 70769883

CPU历史使用总量。

UsageNanoCores Long 0

CPU在采样窗口内的使用量(纳秒)。

Containers Array of Container

容器的监控数据详情。

CPU Struct

容器的CPU数据。

Limit Long 1024

CPU使用上限(CPU核数*1000)。

Load Long 0

最近10秒的平均负载情况。

UsageCoreNanoSeconds Long 40876694

CPU历史使用总量。

UsageNanoCores Long 0

CPU在采样窗口内的使用量(纳秒)。

Memory Struct

容器的内存数据。

AvailableBytes Long 4285091840

可用内存。

Cache Long 9289728

缓存。

Rss Long 9289728

常驻内存集,即实际使用的物理内存。

UsageBytes Long 9289728

已使用内存。

WorkingSet Long 9289728

当前内存工作集使用量。

Name String u1

容器名称。

Disk Array of DiskStats

磁盘数据。

Device String /dev/vda

磁盘名称。

ReadBytes Long 210714112

磁盘读取的数据量,单位为Byte。

ReadIO Long 123

该参数暂未开放使用。

WriteBytes Long 1375109120

磁盘写入的数据量,单位为Byte。

WriteIO Long 123

该参数暂未开放使用。

Filesystem Array of FsStats

文件系统分区数据。

Available Long 35319836672

可用空间。

Capacity Long 41610981376

空间总量。

Category String System

分区类型。可能值:

  • System
  • Volume
  • Other
FsName String /dev/root

分区名称。

Usage Long 4368744448

已使用空间。

Memory Struct

内存数据。

AvailableBytes Long 4285091840

可用内存。

Cache Long 9289728

缓存。

Rss Long 9289728

常驻内存集,即实际使用的物理内存。

UsageBytes Long 9289728

已使用内存。

WorkingSet Long 9289728

当前内存工作集使用量。

Network Struct

网络数据。

Interfaces Array of Interface

网卡数据。

Name String eth0

网卡名称。

RxBytes Long 505001954

累计接收字节数。

RxDrops Long 0

累计接收丢包数。

RxErrors Long 0

累计接收错误数。

RxPackets Long 4800583

累计接收包数量。

TxBytes Long 1381805699

累计发送字节数。

TxDrops Long 0

累计发送丢包数。

TxErrors Long 0

累计发送错误数。

TxPackets Long 5158427

累计发送包数量。

Timestamp String 2021-08-25T16:22:00.000+08:00

每条监控数据对应的统计时间。格式为RFC3339时间格式。

RequestId String D81A4A13-6DCC-4579-AC62-90A6C3EC7BBC

请求ID,唯一标识。

示例

请求示例

https://eci.aliyuncs.com/?Action=DescribeContainerGroupMetric
&ContainerGroupId=eci-bp17da5olmkuagfr****
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

<DescribeContainerGroupMetricResponse>
      <RequestId>96F7805E-16E6-55B1-817F-EA6CF365E7AE</RequestId>
      <ContainerGroupId>eci-2zea33h8fdgiw23jfp3f</ContainerGroupId>
      <Records>
            <Memory>
                  <UsageBytes>11153408</UsageBytes>
                  <Rss>1593344</Rss>
                  <AvailableBytes>4289445888</AvailableBytes>
                  <WorkingSet>5521408</WorkingSet>
                  <Cache>7028736</Cache>
            </Memory>
            <Network>
                  <Interfaces>
                        <RxPackets>0</RxPackets>
                        <TxDrops>0</TxDrops>
                        <RxDrops>0</RxDrops>
                        <RxErrors>0</RxErrors>
                        <TxErrors>0</TxErrors>
                        <TxPackets>0</TxPackets>
                        <RxBytes>505001954</RxBytes>
                        <TxBytes>1381805699</TxBytes>
                        <Name>eth0</Name>
                  </Interfaces>
            </Network>
            <Containers>
                  <Memory>
                        <UsageBytes>9850880</UsageBytes>
                        <Rss>1593344</Rss>
                        <AvailableBytes>0</AvailableBytes>
                        <WorkingSet>4841472</WorkingSet>
                        <Cache>7028736</Cache>
                  </Memory>
                  <CPU>
                        <UsageCoreNanoSeconds>38373298</UsageCoreNanoSeconds>
                        <Load>0</Load>
                        <UsageNanoCores>0</UsageNanoCores>
                        <Limit>0</Limit>
                  </CPU>
                  <Name>nginx</Name>
            </Containers>
            <Containers>
                  <Memory>
                        <UsageBytes>9850880</UsageBytes>
                        <Rss>1593344</Rss>
                        <AvailableBytes>0</AvailableBytes>
                        <WorkingSet>4841472</WorkingSet>
                        <Cache>7028736</Cache>
                  </Memory>
                  <CPU>
                        <UsageCoreNanoSeconds>38373298</UsageCoreNanoSeconds>
                        <Load>0</Load>
                        <UsageNanoCores>0</UsageNanoCores>
                        <Limit>0</Limit>
                  </CPU>
                  <Name>nginx</Name>
            </Containers>
            <CPU>
                  <UsageCoreNanoSeconds>70769883</UsageCoreNanoSeconds>
                  <Load>0</Load>
                  <UsageNanoCores>0</UsageNanoCores>
                  <Limit>2000</Limit>
            </CPU>
            <Filesystem>
                  <Usage>612556800</Usage>
                  <Category>System</Category>
                  <FsName>/dev/disk/by-uuid/39d6ac87-caa5-4bdd-b31e-660301e51bab</FsName>
                  <Capacity>52576092160</Capacity>
                  <Available>49262403584</Available>
            </Filesystem>
            <Filesystem>
                  <Usage>5022646272</Usage>
                  <Category>Other</Category>
                  <FsName>/dev/root</FsName>
                  <Capacity>41610981376</Capacity>
                  <Available>34665934848</Available>
            </Filesystem>
            <Filesystem>
                  <Usage>0</Usage>
                  <Category>Other</Category>
                  <FsName>/dev/shm</FsName>
                  <Capacity>1991725056</Capacity>
                  <Available>1991725056</Available>
            </Filesystem>
            <Filesystem>
                  <Usage>37249024</Usage>
                  <Category>Other</Category>
                  <FsName>/dev/vda2</FsName>
                  <Capacity>511647744</Capacity>
                  <Available>436822016</Available>
            </Filesystem>
            <Timestamp>2021-08-25T16:22:00.000+08:00</Timestamp>
            <Disk>
                  <Device>/dev/vda</Device>
                  <ReadBytes>177200640</ReadBytes>
                  <WriteBytes>8542216192</WriteBytes>
            </Disk>
      </Records>
</DescribeContainerGroupMetricResponse>

JSON格式

{
    "RequestId": "96F7805E-16E6-55B1-817F-EA6CF365E7AE",
    "ContainerGroupId": "eci-2zea33h8fdgiw23jfp3f",
    "Records": [
        {
            "Memory": {
                "UsageBytes": 11153408,
                "Rss": 1593344,
                "AvailableBytes": 4289445888,
                "WorkingSet": 5521408,
                "Cache": 7028736
            },
            "Network": {
                "Interfaces": [
                    {
                        "RxPackets": 0,
                        "TxDrops": 0,
                        "RxDrops": 0,
                        "RxErrors": 0,
                        "TxErrors": 0,
                        "TxPackets": 0,
                        "RxBytes": 505001954,
                        "TxBytes": 1381805699,
                        "Name": "eth0"
                    }
                ]
            },
            "Containers": [
                {
                    "Memory": {
                        "UsageBytes": 9850880,
                        "Rss": 1593344,
                        "AvailableBytes": 0,
                        "WorkingSet": 4841472,
                        "Cache": 7028736
                    },
                    "CPU": {
                        "UsageCoreNanoSeconds": 38373298,
                        "Load": 0,
                        "UsageNanoCores": 0,
                        "Limit": 0
                    },
                    "Name": "nginx"
                },
                {
                    "Memory": {
                        "UsageBytes": 9850880,
                        "Rss": 1593344,
                        "AvailableBytes": 0,
                        "WorkingSet": 4841472,
                        "Cache": 7028736
                    },
                    "CPU": {
                        "UsageCoreNanoSeconds": 38373298,
                        "Load": 0,
                        "UsageNanoCores": 0,
                        "Limit": 0
                    },
                    "Name": "nginx"
                }
            ],
            "CPU": {
                "UsageCoreNanoSeconds": 70769883,
                "Load": 0,
                "UsageNanoCores": 0,
                "Limit": 2000
            },
            "Filesystem": [
                {
                    "Usage": 612556800,
                    "Category": "System",
                    "FsName": "/dev/disk/by-uuid/39d6ac87-caa5-4bdd-b31e-660301e51bab",
                    "Capacity": 52576092160,
                    "Available": 49262403584
                },
                {
                    "Usage": 5022646272,
                    "Category": "Other",
                    "FsName": "/dev/root",
                    "Capacity": 41610981376,
                    "Available": 34665934848
                },
                {
                    "Usage": 0,
                    "Category": "Other",
                    "FsName": "/dev/shm",
                    "Capacity": 1991725056,
                    "Available": 1991725056
                },
                {
                    "Usage": 37249024,
                    "Category": "Other",
                    "FsName": "/dev/vda2",
                    "Capacity": 511647744,
                    "Available": 436822016
                }
            ],
            "Timestamp": "2021-08-25T16:22:00.000+08:00",
            "Disk": [
                {
                    "Device": "/dev/vda",
                    "ReadBytes": 177200640,
                    "WriteBytes": 8542216192
                }
            ]
        }
    ]
}

错误码

访问错误中心查看更多错误码。