AnalyticDB:DescribeDBClusterPerformance - AnalyticDB for PostgreSQL - Alibaba Cloud - AnalyticDB

Mengkueri data pemantauan performa instans AnalyticDB for PostgreSQL selama periode waktu tertentu.

Deskripsi operasi

Hanya data dalam 30 hari terakhir yang dapat dikueri.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

gpdb:DescribeDBClusterPerformance

get

*DBInstance

acs:gpdb:*:{#accountId}:dbinstance/{#DBInstanceId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
DBInstanceId	string	Yes	ID instans. Catatan Anda dapat memanggil operasi DescribeDBInstances untuk mengkueri detail semua instans AnalyticDB for PostgreSQL di wilayah tertentu, termasuk ID instans.	gp-bp12ga6v69h86****
Key	string	Yes	Nama metrik performa. Pisahkan beberapa metrik dengan koma (,). Untuk informasi lebih lanjut, lihat Parameter performa.	adbpg_conn_count
StartTime	string	Yes	Awal rentang waktu untuk dikueri. Tentukan waktu dalam format `YYYY-MM-DDTHH:mmZ`. Catatan Hanya data dalam 30 hari terakhir yang dapat dikueri.	2021-11-03T15:00Z
EndTime	string	Yes	Akhir rentang waktu untuk dikueri. Tentukan waktu dalam format `YYYY-MM-DDTHH:mmZ`. Catatan Waktu akhir harus setelah waktu mulai, dan interval antara waktu mulai dan waktu akhir tidak boleh melebihi tujuh hari.	2021-11-03T15:10Z
Nodes	string	No	Digunakan untuk mengkueri metrik pemantauan satu atau beberapa node. Pisahkan beberapa nama node dengan koma (,), misalnya `master-10****1,master-10**2`. Anda dapat memanggil operasi DescribeDBClusterNode untuk mendapatkan nama node. Anda juga dapat memfilter node berdasarkan nilai metrik pemantauan. Nilai valid: top10: 10 node teratas dengan nilai metrik pemantauan tertinggi. top20: 20 node teratas dengan nilai metrik pemantauan tertinggi. bottom10: 10 node dengan nilai metrik pemantauan terendah. bottom20**: 20 node dengan nilai metrik pemantauan terendah.	top10
NodeType	string	No	Tipe node. Nilai valid: master: Node master. segment: Node segmen. Catatan Jika Anda tidak menentukan parameter ini, metrik pemantauan semua node akan dikembalikan.	master
ResourceGroupName	string	No	Nama kelompok sumber daya.	testgroup

Elemen respons

Element	Type	Description	Example
	object
PerformanceKeys	array<object>	Daftar nilai metrik performa instans.
	array<object>
Unit	string	Unit metrik pemantauan.	%
Series	array<object>	Kumpulan metrik performa.
	array<object>
Values	array<object>	The value of the performance metric collected at a point in time.
	object
Point	array	The value of the performance metric and the time when the metric value was collected.
	string		["2021-11-03T15:00:00+08:00","5.84"]
Role	string	The role of the node. Valid values: master: primary coordinator node standby: standby coordinator node segment: compute node	standby
Name	string	The name of the compute node or compute group.	standby-********-cpu
Name	string	Nama metrik performa. Untuk informasi lebih lanjut, lihat Parameter performa.	adbpg_group_cpu_used_percent
EndTime	string	Waktu akhir kueri (waktu UTC). Waktu dalam format `YYYY-MM-DDTHH:mmZ`.	2021-11-03T15:10Z
RequestId	string	ID permintaan.	8E8990F0-C81E-4C94-8F51-5F**********
StartTime	string	Waktu mulai kueri (waktu UTC). Waktu dalam format `YYYY-MM-DDTHH:mmZ`.	2021-11-03T15:00Z
DBClusterId	string	ID instans.	gp-bp12ga6v69h86****

Contoh

Respons sukses

JSONformat

{
  "PerformanceKeys": [
    {
      "Unit": "%",
      "Series": [
        {
          "Values": [
            {
              "Point": [
                "[\"2021-11-03T15:00:00+08:00\",\"5.84\"]"
              ]
            }
          ],
          "Role": "standby",
          "Name": "standby-********-cpu"
        }
      ],
      "Name": "adbpg_group_cpu_used_percent"
    }
  ],
  "EndTime": "2021-11-03T15:10Z",
  "RequestId": "8E8990F0-C81E-4C94-8F51-5F**********",
  "StartTime": "2021-11-03T15:00Z",
  "DBClusterId": "gp-bp12ga6v69h86****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.