GetProjectLogs - - Alibaba Cloud Documentation Center

Menjalankan pernyataan SQL untuk mengkueri log dalam sebuah proyek.

Catatan penggunaan

Host terdiri dari nama proyek dan titik akhir Simple Log Service. Anda harus menentukan proyek dalam Host.
Pasangan Kunci Akses telah dibuat dan diperoleh. Untuk informasi selengkapnya, lihat AccessKey pair.
Pasangan Kunci Akses milik Akun Alibaba Cloud memiliki izin atas semua operasi API. Menggunakan kredensial ini untuk menjalankan operasi di Simple Log Service merupakan operasi berisiko tinggi. Kami menyarankan agar Anda menggunakan pengguna Resource Access Management (RAM) untuk memanggil operasi API atau melakukan operasi O&M rutin. Untuk membuat pengguna RAM, login ke Konsol RAM dan pastikan pengguna tersebut memiliki izin manajemen atas resource Simple Log Service. Untuk informasi selengkapnya, lihat Create a RAM user and authorize the RAM user to access Log Service.
Informasi yang diperlukan untuk mengkueri log telah diperoleh, mencakup nama proyek tempat log berada dan wilayah proyek tersebut. Untuk informasi selengkapnya, lihat Manage a project.
Indeks telah dikonfigurasi sebelum Anda mengkueri log. Untuk informasi selengkapnya, lihat Create indexes.
Terdapat batasan saat Anda menggunakan Simple Log Service untuk mengkueri log. Kami menyarankan agar Anda menentukan pernyataan kueri dan rentang waktu kueri sesuai dengan batasan tersebut. Untuk informasi selengkapnya, lihat Log search overview dan Log analysis overview.
Anda dapat menggunakan parameter query untuk menentukan pernyataan SQL Standar.
Anda harus menentukan Logstore dalam klausa FROM pernyataan SQL. Logstore dapat digunakan sebagai tabel SQL.
Anda harus menentukan rentang waktu dalam pernyataan SQL dengan menggunakan parameter __date__ atau __time__. Nilai parameter __date__ berupa timestamp, sedangkan nilai parameter __time__ berupa bilangan bulat dalam satuan detik.

Informasi otorisasi

Tabel berikut menjelaskan informasi otorisasi yang diperlukan untuk operasi ini. Anda dapat menambahkan informasi tersebut ke elemen Action dalam pernyataan kebijakan RAM untuk memberikan izin kepada pengguna RAM atau role RAM agar dapat memanggil operasi ini.

Action	Autentikasi Sumber Daya
`log:GetProjectLogs`	`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}`

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 ini untuk berbagai SDK.

Header permintaan

Operasi ini hanya menggunakan header permintaan umum. Untuk informasi selengkapnya, lihat Common request headers.

Sintaksis permintaan

GET /logs HTTP/1.1

Parameter permintaan

Parameter	Tipe	Posisi	Wajib	Contoh	Deskripsi
project	String	Host	Ya	ali-test-project	Nama proyek.
query	String	Query	Ya	SELECT COUNT(*) as pv FROM nginx-moni where __time__ > 1646102500 and __time__ < 1646103400	Pernyataan SQL Standar. Dalam contoh ini, pernyataan SQL mengkueri jumlah tampilan halaman (PVs) dari 2022-03-01 10:41:40 hingga 2022-03-01 10:56:40 dalam Logstore bernama nginx-moni.
powerSql	Boolean	Query	Tidak	false	Menentukan apakah fitur Dedicated SQL diaktifkan. Untuk informasi selengkapnya, lihat Enable Dedicated SQL. Nilai yang valid: true false (default): mengaktifkan fitur SQL Standar. Anda dapat menggunakan parameter powerSql atau query untuk mengonfigurasi Dedicated SQL.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
x-log-progress	String	Complete	Status hasil kueri dan analisis. Nilai yang valid: Complete: Kueri berhasil, dan hasil kueri serta analisis lengkap dikembalikan. Incomplete: Kueri berhasil, tetapi hasil kueri dan analisis tidak lengkap. Untuk mendapatkan hasil lengkap, Anda harus mengulangi permintaan.
x-log-count	Long	10000	Jumlah total log dalam hasil kueri dan analisis.
x-log-processed-rows	Long	10000	Jumlah baris yang diproses berdasarkan permintaan.
x-log-elapsed-millisecond	Long	5	Waktu yang dikonsumsi oleh permintaan. Satuan: milidetik.
Server	String	nginx	Nama server.
Content-Type	String	application/json	Tipe konten badan respons.
Content-Length	String	0	Panjang konten badan respons.
Connection	String	close	Menunjukkan apakah koneksi bersifat persisten. Nilai yang valid: close dan keep-alive. close: Koneksi tidak persisten. Koneksi TCP baru dibuat untuk setiap permintaan HTTP. keep-alive: Koneksi persisten. Setelah koneksi TCP dibuat, koneksi tetap terbuka sehingga tidak memerlukan waktu atau bandwidth tambahan untuk membuat koneksi baru.
Date	String	Sun, 27 May 2018 08:25:04 GMT	Waktu respons dikembalikan.
x-log-requestid	String	5B0A6B60BB6EE39764D458B5	ID permintaan.
	Array of Object	[ { "__time__" : 1409529660, "__source__" : "192.168.1.100", "Key1" : "error", "Key2" : "Value2" }, { "__time__" : 1409529680, "__source__" : "192.168.1.100", "Key3" : "error", "Key4" : "Value4" } ]	Log yang dikembalikan.

Contoh

Contoh permintaan

GET /logs?query=SELECT COUNT(*) as pv FROM nginx-moni where __time__ > 1646102500 and __time__ < 1646103400&powerSql=false HTTP/1.1
Host:ali-test-project.ch-hangzhou.log.aliyuncs.com
Content-Type:application/json

Contoh respons sukses

JSON format

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

[ {
  "__time__" : 1409529660,
  "__source__" : "192.168.1.100",
  "Key1" : "error",
  "Key2" : "Value2"
}, {
  "__time__" : 1409529680,
  "__source__" : "192.168.1.100",
  "Key3" : "error",
  "Key4" : "Value4"
} ]

Kode kesalahan

Untuk daftar kode kesalahan, lihat Service error codes.

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	ParameterInvalid	Parameter is invalid.	Parameter yang ditentukan tidak valid.

Untuk informasi selengkapnya, lihat Common error codes.