调用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 |
分区类型。可能值:
|
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
}
]
}
]
}
错误码
访问错误中心查看更多错误码。