DescribeInstanceMonitorData - - Alibaba Cloud Documentation Center

Mengambil data pemantauan instans Elastic Compute Service (ECS), mencakup pemanfaatan vCPU, kredit CPU untuk instans burstable, lalu lintas data masuk, lalu lintas data keluar, serta bandwidth rata-rata.

Catatan Penggunaan

Perhatikan hal-hal berikut:

Maksimal 400 entri data pemantauan dapat dikembalikan dalam satu permintaan. Permintaan akan menghasilkan kesalahan jika nilai yang dihitung menggunakan rumus berikut melebihi 400: (EndTime − StartTime)/Period.
Anda dapat mengambil data pemantauan hingga 30 hari ke belakang. Jika parameter StartTime ditetapkan lebih dari 30 hari sebelum waktu saat ini, sistem akan mengembalikan kesalahan.
Dalam beberapa skenario—misalnya ketika instans berada dalam status Stopped—sistem tidak dapat mengumpulkan informasi terkait, sehingga sebagian data pemantauan yang dikembalikan mungkin tidak lengkap.
Pemantauan dasar CPU tidak tersedia untuk instans ECS bare metal. Untuk memperoleh informasi pemantauan CPU, Anda dapat menginstal agen CloudMonitor. Untuk informasi selengkapnya, lihat InstallCloudMonitor.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter Permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	DescribeInstanceMonitorData	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeInstanceMonitorData.
InstanceId	String	Ya	i-bp1a36962lrhj4ab****	ID instans.
StartTime	String	Ya	2014-10-29T23:00:00Z	Awal rentang waktu untuk ditanyakan. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. Jika nilai detik (`ss`) bukan `00`, waktu akan dibulatkan ke menit berikutnya.
EndTime	String	Ya	2014-10-30T08:00:00Z	Akhir rentang waktu untuk ditanyakan. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. Jika nilai detik (`ss`) bukan `00`, waktu akan dibulatkan ke menit berikutnya.
Period	Integer	Tidak	60	Interval pengambilan data pemantauan. Satuan: detik. Nilai yang valid: 60 600 3600 Nilai default: 60.

Parameter Respons

Parameter	Tipe	Contoh	Deskripsi
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
MonitorData	Array of InstanceMonitorData		Data pemantauan instans.
InstanceMonitorData
CPUCreditBalance	Float	120	Jumlah total kredit CPU instans burstable.
BPSRead	Integer	1000	Bandwidth baca disk (disk sistem dan disk data). Satuan: Byte/s.
InternetTX	Integer	343	Volume traffic data yang dikirim oleh instans ke Internet selama periode yang ditentukan oleh parameter `Period`, dimulai dari waktu yang ditentukan oleh parameter `TimeStamp`. Satuan: Kbit.
CPU	Integer	2	Pemanfaatan vCPU instans. Satuan: persen (%).
CPUCreditUsage	Float	30	Jumlah kredit CPU yang dikonsumsi oleh instans burstable.
IOPSWrite	Integer	200	Jumlah operasi I/O tulis per detik pada disk (disk sistem dan disk data).
IntranetTX	Integer	343	Volume traffic data yang dikirim oleh instans ke jaringan internal selama periode yang ditentukan oleh parameter `Period`, dimulai dari waktu yang ditentukan oleh parameter `TimeStamp`. Satuan: Kbit.
InstanceId	String	i-bp1a36962lrhj4****	ID instans.
BPSWrite	Integer	13585	Bandwidth tulis disk (disk sistem dan disk data). Satuan: Byte/s.
CPUNotpaidSurplusCreditUsage	Float	0.5	Kredit CPU overdrawn yang belum dibayar.
CPUAdvanceCreditBalance	Float	0.4	Kredit CPU overdrawn instans burstable.
IOPSRead	Integer	1000	Jumlah operasi I/O baca per detik pada disk (disk sistem dan disk data).
InternetBandwidth	Integer	10	Bandwidth publik instans. Satuan: Kbit/s.
InternetRX	Integer	122	Volume traffic data yang diterima oleh instans dari Internet selama periode yang ditentukan oleh parameter `Period`, dimulai dari waktu yang ditentukan oleh parameter `TimeStamp`. Satuan: Kbit.
TimeStamp	String	2014-10-30T05:00:00Z	Timestamp saat data pemantauan ditanyakan.
IntranetRX	Integer	122	Volume traffic data yang diterima oleh instans dari jaringan internal selama periode yang ditentukan oleh parameter `Period`, dimulai dari waktu yang ditentukan oleh parameter `TimeStamp`. Satuan: Kbit.
IntranetBandwidth	Integer	10	Bandwidth internal instans. Satuan: Kbit/s.

Contoh

Contoh permintaan

https://ecs.aliyuncs.com/?Action=DescribeInstanceMonitorData
&EndTime=2014-10-30T08:00:00Z
&InstanceId=i-bp1a36962lrhj4ab****
&StartTime=2014-10-29T23:00:00Z
&Period=3600
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeInstanceMonitorDataResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <MonitorData>
        <InstanceMonitorData>
            <InstanceId>i-bp1a36962lrhj4ab****</InstanceId>
            <CPU>2</CPU>
            <IntranetRX>122</IntranetRX>
            <IntranetTX>343</IntranetTX>
            <IntranetFlow>675</IntranetFlow>
            <IntranetBandwidth>10</IntranetBandwidth>
            <InternetRX>122</InternetRX>
            <InternetTX>343</InternetTX>
            <InternetFlow>675</InternetFlow>
            <InternetBandwidth>10</InternetBandwidth>
            <IOPSRead>1000</IOPSRead>
            <IOPSWrite>200</IOPSWrite>
            <BPSRead>1000</BPSRead>
            <BPSWrite>13585</BPSWrite>
            <TimeStamp>2014-10-30T05:00:00Z</TimeStamp>
        </InstanceMonitorData>
    </MonitorData>
</DescribeInstanceMonitorDataResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C8B26B44-0189-443E-9816-D951F59623A9",
  "MonitorData" : {
    "InstanceMonitorData" : [ {
      "InstanceId" : "i-bp1a36962lrhj4ab****",
      "CPU" : 0,
      "IntranetRX" : 122,
      "IntranetTX" : 343,
      "IntranetFlow" : 675,
      "IntranetBandwidth" : 10,
      "InternetRX" : 122,
      "InternetTX" : 343,
      "InternetFlow" : 675,
      "InternetBandwidth" : 10,
      "IOPSRead" : 1000,
      "IOPSWrite" : 13585,
      "BPSRead" : 1000,
      "BPSWrite" : 200,
      "TimeStamp" : "2014-10-30T05:00:00Z"
    } ]
  }
}

Kode Kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidEndTime.Malformed	The specified parameter "EndTime" is not valid.	Nilai EndTime tidak valid.
400	InvalidParameter.TooManyDataQueried	Too many data queried.	Jumlah maksimum data pemantauan yang dapat ditanyakan telah terlampaui.
400	Throttling	Request was denied due to request throttling.	Permintaan ditolak karena pembatasan kecepatan.
400	InvalidStartTime.ValueNotSupported	The specified parameter StartTime is later than EndTime.	Waktu akhir tidak boleh lebih awal daripada waktu mulai.
500	InternalError	The request processing has failed due to some unknown error.	Terjadi kesalahan internal. Coba lagi nanti.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	ID instans tidak ditemukan.

Untuk daftar kode kesalahan, lihat Service error codes.