Kueri Rekaman Log Lambat dengan DescribeSlowLogRecords - Database Autonomy Service

API ini mengambil catatan log lambat dari sebuah instans database, dengan dukungan penyaringan dan pengurutan berdasarkan berbagai kriteria.

Deskripsi operasi

InstanceId adalah ID instans. Parameter ini wajib diisi.
StartTime dan EndTime menentukan rentang waktu untuk kueri. Parameter ini wajib diisi.
Gunakan parameter PageNumber dan PageSize untuk membagi hasil ke dalam halaman.
Gunakan parameter OrderBy untuk mengurutkan hasil. Untuk detail bidang yang dapat diurutkan, lihat dokumentasi.
Gunakan parameter Filters untuk mempersempit kueri berdasarkan kriteria seperti alamat host atau SQL ID.
Penting Beberapa tipe database, seperti RDS for PostgreSQL dan PolarDB for PostgreSQL, tidak mendukung metode pengurutan tertentu. Pilih parameter yang sesuai dengan tipe database Anda.

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

hdm:DescribeSlowLogRecords

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	ID instans.	rm-8vbk4xz99su8****
NodeId	string	No	ID node.	pi-d9j9fe7wq7t9i****
StartTime	integer	Yes	Waktu mulai rentang kueri. Nilai ini merupakan Stempel waktu UNIX yang merepresentasikan jumlah milidetik sejak 1 Januari 1970 pukul 00:00:00 UTC.	1596177993000
EndTime	integer	Yes	Waktu akhir rentang kueri. Nilai ini merupakan Stempel waktu UNIX yang merepresentasikan jumlah milidetik sejak 1 Januari 1970 pukul 00:00:00 UTC.	1634972640000
PageNumber	integer	No	Nomor halaman yang akan dikembalikan. Halaman dimulai dari halaman 1.	1
PageSize	integer	No	Jumlah entri yang dikembalikan pada setiap halaman.	10
Filters	array<object>	No	Kondisi filter.
	object	No	Satu kondisi filter.
Key	string	No	Nama parameter filter. Catatan Untuk informasi lebih lanjut, lihat bagian "Informasi tambahan mengenai parameter permintaan".	None
Value	string	No	Nilai parameter filter.	None
OrderBy	string	No	MySQL `QueryTimeSeconds`: durasi eksekusi kueri, dalam detik. `LockTimeSeconds`: durasi penguncian, dalam detik. `RowsSent`: jumlah baris yang dikirim. `RowsExamined`: jumlah baris yang dipindai. Redis `QueryTime`: durasi eksekusi kueri. `Timestamp`: waktu saat perintah selesai. MongoDB `QueryTime`: durasi eksekusi kueri. `Timestamp`: waktu saat perintah selesai. `KeysExamined`: jumlah entri indeks yang dipindai. `DocsExamined`: jumlah dokumen yang dipindai. `ResponseLength`: jumlah baris yang dikembalikan. Penting Pengurutan tidak didukung untuk instans ApsaraDB RDS for PostgreSQL, PolarDB for PostgreSQL (Kompatibel dengan Oracle), dan ApsaraDB for SQL Server.	QueryTimeSeconds
Asc	boolean	No	Menentukan apakah hasil diurutkan secara ascending. Nilai default: true. true: mengurutkan hasil secara ascending. false: mengurutkan hasil secara descending.	true

Parameter Key mendukung nilai-nilai berikut:

RDS for MySQL, PolarDB for MySQL, RDS for PostgreSQL, dan PolarDB for PostgreSQL
- hostAddress: Alamat IP sumber. Pisahkan beberapa nilai dengan koma.
- sqlId: ID SQL. Pisahkan beberapa nilai dengan koma.
- user: Pengguna. Pisahkan beberapa nilai dengan koma.
- dbName: Nama database. Pisahkan beberapa nilai dengan koma.
- tags: Tag. Pisahkan beberapa nilai dengan koma.
MongoDB
- hostInsId: ID role. Pisahkan beberapa nilai dengan koma.
- insRole: Role instans. Pisahkan beberapa nilai dengan koma.
- opType: Tipe operasi. Pisahkan beberapa nilai dengan koma.
- namespace: Namespace. Pisahkan beberapa nilai dengan koma.
- nodeType: Tipe komponen. Pisahkan beberapa nilai dengan koma.
- queryId: ID kueri. Pisahkan beberapa nilai dengan koma.
Tair
- hostAddress: Alamat IP sumber.
- user: Pengguna.
- dbName: Nama database.
- nodeType: Tipe node.
RDS for SQL Server
- hostAddress: Alamat IP sumber. Pisahkan beberapa nilai dengan koma.
- sqlId: ID SQL. Pisahkan beberapa nilai dengan koma.
- user: Pengguna. Pisahkan beberapa nilai dengan koma.
- dbName: Nama database. Pisahkan beberapa nilai dengan koma.
- tags: Tag. Pisahkan beberapa nilai dengan koma.
PolarDB-X
- traceId: ID jejak.
- role: Role node. Parameter ini wajib diisi. Nilai yang valid: CN (compute node) dan DN (data node).
- hostAddress: Alamat IP sumber. Pisahkan beberapa nilai dengan koma.
- sqlId: ID SQL. Pisahkan beberapa nilai dengan koma.
- user: Pengguna. Pisahkan beberapa nilai dengan koma.
- dbName: Nama database. Pisahkan beberapa nilai dengan koma.
- tags: Tag. Pisahkan beberapa nilai dengan koma.

Catatan

Untuk mesin SQL, Anda dapat mengkueri data berdasarkan sqlId. Parameter sqlId menerima hingga 20 nilai yang dipisahkan koma.
Untuk MongoDB, Anda dapat mengkueri data berdasarkan queryId. Parameter queryId menerima hingga 20 nilai yang dipisahkan koma.

Elemen respons

Element	Type	Description	Example
	object
Code	string	Kode status respons.	200
Message	string	Pesan respons. Catatan Jika permintaan berhasil, Successful dikembalikan. Jika permintaan gagal, pesan error dikembalikan.	Successful
RequestId	string	ID permintaan.	A1C79EE2-D04D-571B-8C60-961FAF8E****
Success	string	Menunjukkan apakah permintaan berhasil. Nilai yang valid: true: Permintaan berhasil. false: Permintaan gagal.	true
Data	object	Detail log kueri lambat.
DbInstanceName	string	ID instans.	rm-bp157g54vy772****
NodeId	string	ID node.	node123
ItemsNumbers	integer	Jumlah catatan log lambat pada halaman saat ini.	10
StartTime	string	Waktu mulai.	1672531200000
EndTime	string	Waktu akhir.	1672617600000
DbInstanceId	integer	ID numerik instans.	100
TotalRecords	integer	Jumlah total entri.	100
PageNumbers	integer	Nomor halaman. Halaman dimulai dari 1. Nilai default adalah 1.	1
MaxRecordsPerPage	integer	Jumlah maksimum entri yang dikembalikan pada setiap halaman. Nilai yang valid: 5 hingga 100.	20
Logs	array<object>	Array catatan log kueri lambat.
	array<object>	Catatan log kueri lambat.
SqlId	string	ID templat SQL.	sqlId
Scheme	string	Skema data.	HTTPS
SubInstanceId	string	ID sub-instans.	r-8vb219d10038****
DbInstanceName	string	ID instans.	rm-2zebg30mk056g****
InsName	string	Nama instans.	test
AccountName	string	Nama akun.	user1
HostAddress	string	Alamat IP sumber.	192.168.1.1
QueryStartTime	string	Waktu saat kueri dimulai. Waktu dalam format yyyy-MM-dd hh:mm:ss dan ditampilkan dalam UTC.	2024-04-01 11:00:00
SQLText	string	Pernyataan SQL.	SELECT * FROM my_table WHERE ROWNUM <= 10
Psql	string	Templat SQL.	SELECT * FROM my_table WHERE ROWNUM <= 10
DBName	string	Nama database.	test
QueryTime	integer	Durasi eksekusi kueri, dalam milidetik.	121
ReturnItemNumbers	string	Nomor item yang dikembalikan.	test
DocsExamined	string	Jumlah dokumen yang dipindai. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB for MongoDB.	100
KeysExamined	string	Jumlah entri indeks yang dipindai. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB for MongoDB.	valueA
TableName	string	Nama tabel.	tableNameExample
LockTime	number	Durasi tunggu penguncian, dalam milidetik.	100
RowsExamined	integer	Jumlah baris yang dipindai.	100
RowsSent	integer	Jumlah baris yang dikembalikan.	10
ThreadId	string	ID thread.	57472578
Timestamp	integer	Stempel waktu Unix. Satuan: detik.	1747118812
SqlTag	object	Detail mengenai tag SQL.
SqlId	string	ID templat SQL.	8ad7069f236bcdaaa9b3ae4b6299****
Tags	string	Tag. Beberapa tag dipisahkan dengan koma (`,`).	DAS_IMPORTANT,DAS_IN_PLAN
Comments	string	Keterangan.	test
LockTimeSeconds	number	Durasi tunggu penguncian, dalam detik.	100
QueryTimeSeconds	number	Durasi eksekusi kueri, dalam detik.	100
SqlType	string	Tipe pernyataan SQL. Nilai yang valid: SELECT UPDATE DELETE	SELECT
CPUTime	number	Waktu CPU yang dikonsumsi oleh kueri. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB RDS for SQL Server.	50
IOWrites	integer	Jumlah penulisan I/O. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB RDS for SQL Server.	1
LastRowsCountAffected	integer	Jumlah baris yang terpengaruh oleh pernyataan terakhir. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB RDS for SQL Server.	10
LogicalIOReads	integer	Jumlah pembacaan logis. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB RDS for SQL Server.	1
PhysicalIOReads	integer	Jumlah pembacaan fisik. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB RDS for SQL Server.	1
RowsCountAffected	integer	Jumlah baris yang terpengaruh. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB RDS for SQL Server.	10
Command	string	Pernyataan kueri lambat. Catatan Parameter ini hanya dikembalikan untuk instans Tair.	SELECT
Namespace	string	Namespace. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB for MongoDB.	pro-test
QueryId	string	ID kueri. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB for MongoDB.	sq-1pzcdMwRb
ReturnNum	string	Jumlah baris yang dikembalikan, dalam bentuk string. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB for MongoDB.	20
ApplicationName	string	Nama aplikasi. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB RDS for SQL Server.	MyApp
CPUTimeSeconds	number	Waktu CPU yang dikonsumsi oleh kueri, dalam detik. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB RDS for SQL Server.	100
Rows	integer	Jumlah total baris yang diperbarui atau dikembalikan oleh compute node instans PolarDB-X 2.0. Catatan Parameter ini hanya dikembalikan untuk instans PolarDB-X 2.0.	20
Frows	integer	Jumlah baris yang diambil oleh compute node (CN) instans PolarDB-X 2.0. Catatan Parameter ini hanya dikembalikan untuk instans PolarDB-X 2.0.	10
Scnt	integer	Jumlah permintaan yang dikirim dari compute node (CN) ke data node (DN) pada instans PolarDB-X 2.0. Catatan Parameter ini hanya dikembalikan untuk instans PolarDB-X 2.0.	10
TraceId	string	ID jejak untuk instans PolarDB-X 2.0. Ini merepresentasikan ID eksekusi pernyataan SQL pada data node. Catatan Parameter ini hanya dikembalikan untuk instans PolarDB-X 2.0.	074ce334-5247-40b9-b0c1-158aea5d****
TemplateId	string	ID templat instans PolarDB-X 2.0. Catatan Parameter ini hanya dikembalikan untuk instans PolarDB-X 2.0.	6a63b6ac4572abfaef7d1163f684****
NodeId	string	ID node.
Cmd	string	Perintah yang digunakan untuk mengkueri data. Catatan Parameter ini hanya dikembalikan untuk instans Tair.
Rt	integer	Durasi eksekusi. Satuan: mikrodetik. Catatan Parameter ini hanya dikembalikan untuk instans Tair.
RequestSize	integer	Ukuran permintaan. Satuan: byte. Catatan Parameter ini hanya dikembalikan untuk instans Tair.
ResponseSize	integer	Ukuran respons. Satuan: byte. Catatan Parameter ini hanya dikembalikan untuk instans Tair.
ClientIp	string	Alamat IP client. Catatan Parameter ini hanya dikembalikan untuk instans Tair.
DbId	string	ID database. Catatan Parameter ini hanya dikembalikan untuk instans Tair.
OriginTime	string	Waktu saat perintah dieksekusi. Waktu dalam format yyyy-MM-ddTHH:mm:ssZ dan ditampilkan dalam UTC. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB for MongoDB.
OpType	string	Tipe operasi. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB for MongoDB.
Fail	string	Menunjukkan apakah perintah gagal dieksekusi. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB for MongoDB.
Params	string	Parameter perintah. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB for MongoDB.
Reason	string	Alasan mengapa perintah gagal dieksekusi. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB for MongoDB.
ReqId	string	ID permintaan. Catatan Parameter ini hanya dikembalikan untuk instans ApsaraDB for MongoDB.

Contoh

Respons sukses

JSONformat

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "A1C79EE2-D04D-571B-8C60-961FAF8E****",
  "Success": "true",
  "Data": {
    "DbInstanceName": "rm-bp157g54vy772****",
    "NodeId": "node123",
    "ItemsNumbers": 10,
    "StartTime": "1672531200000",
    "EndTime": "1672617600000",
    "DbInstanceId": 100,
    "TotalRecords": 100,
    "PageNumbers": 1,
    "MaxRecordsPerPage": 20,
    "Logs": [
      {
        "SqlId": "sqlId",
        "Scheme": "HTTPS",
        "SubInstanceId": "r-8vb219d10038****",
        "DbInstanceName": "rm-2zebg30mk056g****",
        "InsName": "test",
        "AccountName": "user1",
        "HostAddress": "192.168.1.1",
        "QueryStartTime": "2024-04-01 11:00:00",
        "SQLText": "SELECT * FROM my_table WHERE ROWNUM <= 10",
        "Psql": "SELECT * FROM my_table WHERE ROWNUM <= 10\n",
        "DBName": "test",
        "QueryTime": 121,
        "ReturnItemNumbers": "test",
        "DocsExamined": "100",
        "KeysExamined": "valueA",
        "TableName": "tableNameExample",
        "LockTime": 100,
        "RowsExamined": 100,
        "RowsSent": 10,
        "ThreadId": "57472578",
        "Timestamp": 1747118812,
        "SqlTag": {
          "SqlId": "8ad7069f236bcdaaa9b3ae4b6299****",
          "Tags": "DAS_IMPORTANT,DAS_IN_PLAN",
          "Comments": "test"
        },
        "LockTimeSeconds": 100,
        "QueryTimeSeconds": 100,
        "SqlType": "SELECT",
        "CPUTime": 50,
        "IOWrites": 1,
        "LastRowsCountAffected": 10,
        "LogicalIOReads": 1,
        "PhysicalIOReads": 1,
        "RowsCountAffected": 10,
        "Command": "SELECT",
        "Namespace": "pro-test",
        "QueryId": "sq-1pzcdMwRb",
        "ReturnNum": "20",
        "ApplicationName": "MyApp",
        "CPUTimeSeconds": 100,
        "Rows": 20,
        "Frows": 10,
        "Scnt": 10,
        "TraceId": "074ce334-5247-40b9-b0c1-158aea5d****",
        "TemplateId": "6a63b6ac4572abfaef7d1163f684****",
        "NodeId": "",
        "Cmd": "",
        "Rt": 0,
        "RequestSize": 0,
        "ResponseSize": 0,
        "ClientIp": "",
        "DbId": "",
        "OriginTime": "",
        "OpType": "",
        "Fail": "",
        "Params": "",
        "Reason": "",
        "ReqId": ""
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidParams	The request parameters are invalid.
403	NoPermission	You are not authorized to do this action.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.