Kueri kinerja proksi database - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi DescribeDBProxyPerformance untuk mengkueri metrik kinerja proksi database pada instans ApsaraDB RDS.

Sebelum memanggil operasi DescribeDBProxyPerformance, pastikan Anda telah memanggil operasi ModifyDBProxy untuk mengaktifkan fitur proksi database pada instans tersebut.

Fitur proksi khusus ApsaraDB RDS for MySQL menyediakan kemampuan seperti Pemisahan baca/tulis dan optimasi koneksi singkat. Untuk informasi selengkapnya, lihat Apa itu proksi database?
Fitur proksi database ApsaraDB RDS for PostgreSQL mendukung Pemisahan baca/tulis. Untuk informasi selengkapnya, lihat Apa itu proksi database?

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan 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	Type	Required	Example	Description
Action	String	Yes	DescribeDBProxyPerformance	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeDBProxyPerformance.
DBInstanceId	String	Yes	rm-t4n3axxxxx	ID instans. Anda dapat memanggil operasi DescribeDBInstances untuk mengkueri ID instans tersebut.
DBProxyInstanceType	String	No	DedicatedProxy	Jenis proksi yang diaktifkan pada instans. Tetapkan nilainya ke DedicatedProxy.
StartTime	String	Yes	2019-09-19T01:00:00Z	Awal rentang waktu yang akan dikueri. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.
EndTime	String	Yes	2019-09-21T18:00:00Z	Akhir rentang waktu yang akan dikueri. Waktu akhir harus lebih baru daripada waktu awal. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.
RegionId	String	Yes	cn-hangzhou	ID Wilayah tempat instans berada. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.
MetricsName	String	Yes	Maxscale_CpuUsage	Metrik kinerja yang ingin Anda kueri. Jika instans menjalankan MySQL, Anda hanya dapat mengkueri metrik kinerja Maxscale_CpuUsage, yang menunjukkan penggunaan CPU instans tersebut. Jika instans menjalankan PostgreSQL, Anda dapat mengkueri metrik kinerja berikut: Maxscale_TotalConns: jumlah koneksi per detik Maxscale_CurrentConns: jumlah koneksi yang telah terbentuk Maxscale_DownFlows: outbound traffic Maxscale_UpFlows: inbound traffic Maxscale_QPS: QPS Maxscale_MemUsage: Penggunaan memori Maxscale_CpuUsage: penggunaan CPU Jika Anda ingin mengkueri lebih dari satu metrik kinerja, pisahkan metrik tersebut dengan koma (,). Anda dapat menentukan hingga enam metrik kinerja dalam satu permintaan.
DBProxyEngineType	String	No	normal	Parameter internal. Anda tidak perlu menentukan parameter ini.

Parameter respons

Parameter	Type	Example	Description
EndTime	String	2019-09-21T18:00:00Z	Akhir rentang waktu yang dikueri.
StartTime	String	2019-09-19T01:00:00Z	Awal rentang waktu yang dikueri.
DBInstanceId	String	lsmexxxxxxx	ID instans.
RequestId	String	DD31056F-A0CE-41D7-AD39-689B6ABAE982	ID permintaan.
DBProxyEngineType	String	normal	Parameter internal. Anda tidak perlu menentukan parameter ini.
PerformanceKeys	Array of PerformanceKey		Array yang berisi metrik kinerja yang dikembalikan.
PerformanceKey
ValueFormat	String	docker_container_cpu	Format pengembalian nilai metrik kinerja.
Key	String	cpu_ratio	Nama metrik kinerja.
Values	Array of PerformanceValue		Array yang berisi nilai-nilai metrik kinerja dalam format berikut: {value1, value2, ...}.
PerformanceValue
Date	String	2019-10-10T09:00:00Z	Waktu pencatatan nilai metrik kinerja. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
Value	String	2.83	Nilai metrik kinerja.

Contoh

Contoh permintaan

http(s)://rds.aliyuncs.com/?Action=DescribeDBProxyPerformance
&RegionId=cn-hangzhou
&DBInstanceId=rm-t4n3axxxxx
&MetricsName=Maxscale_CpuUsage
&StartTime=2019-09-19T01:00:00Z
&EndTime=2019-09-21T18:00:00Z
&<Common request parameters>

Contoh respons sukses

XML format

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

<DescribeDBProxyPerformanceResponse>
<DBInstanceId>lsmexxxxxxx</DBInstanceId>
<RequestId>DD31056F-A0CE-41D7-AD39-689B6ABAE982</RequestId>
<PerformanceKeys>
    <PerformanceKey>
        <Values>
            <PerformanceValue>
                <Value>2.83</Value>
                <Date>2019-10-10T09:00:00Z</Date>
            </PerformanceValue>
        </Values>
        <Key>cpu_ratio</Key>
        <ValueFormat>docker_container_cpu</ValueFormat>
    </PerformanceKey>
</PerformanceKeys>
<EndTime>2019-10-10T09:39:28Z</EndTime>
<StartTime>2019-10-01T09:39:28Z</StartTime>
</DescribeDBProxyPerformanceResponse>

JSON format

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

{
  "DBInstanceId" : "lsmexxxxxxx",
  "RequestId" : "DD31056F-A0CE-41D7-AD39-689B6ABAE982",
  "PerformanceKeys" : {
    "PerformanceKey" : [ {
      "Values" : {
        "PerformanceValue" : [ {
          "Value" : "2.83",
          "Date" : "2019-10-10T09:00:00Z"
        } ]
      },
      "Key" : "cpu_ratio",
      "ValueFormat" : "docker_container_cpu"
    } ]
  },
  "EndTime" : "2019-10-10T09:39:28Z",
  "StartTime" : "2019-10-01T09:39:28Z"
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidDBInstanceName.NotFound	The specified DB instance name does not exist.	Pesan kesalahan yang dikembalikan karena nama instans tidak ditemukan.
400	InvalidDBInstanceName	Specified parameter DBInstanceName is not valid.	Pesan kesalahan yang dikembalikan karena nilai parameter DBInstanceName tidak valid. Periksa apakah nilainya null atau string kosong.
404	Endpoint.NotFound	Specified endpoint is not found.	Pesan kesalahan yang dikembalikan karena nomor port yang Anda tentukan tidak ditemukan.

Untuk daftar kode kesalahan, kunjungi API Error Center.