Menjalankan kueri terhadap log mentah dari Logstore tertentu dalam suatu Proyek. Respons berisi log mentah dalam rentang waktu yang ditentukan dan dikompresi untuk transmisi.
Deskripsi operasi
-
SDK Simple Log Service tersedia untuk Go, Java, dan Python. Anda juga dapat memanggil semua operasi OpenAPI secara langsung.
-
Tentukan metode kompresi saat memanggil operasi ini. Algoritma kompresi yang tersedia bergantung pada bahasa pemrograman yang digunakan. Untuk informasi selengkapnya, lihat parameter permintaan Accept-Encoding.
-
Untuk informasi selengkapnya, lihat GetLogs.
Izin
Tabel berikut mencantumkan izin yang diperlukan untuk memanggil operasi API ini. Tambahkan aksi ke pernyataan kebijakan RAM guna memberikan izin kepada Pengguna RAM atau Peran RAM agar dapat memanggil operasi ini.
| Action | Resource in an authorization policy |
log:GetLogStoreLogs | acs:log:{#regionId}:{#accountId}:project/{#ProjectName} |
Coba sekarang
Test
RAM authorization
Sintaks permintaan
POST /logstores/{logstore}/logs HTTP/1.1
Path Parameters
|
Parameter |
Type |
Required |
Description |
Example |
| logstore |
string |
Yes |
Nama Logstore. |
test-logstore |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| project |
string |
Yes |
Nama proyek. |
ali-test-project |
| Accept-Encoding |
string |
Yes |
Metode kompresi.
Valid values:
|
lz4 |
| body |
object |
No |
Struktur permintaan. |
|
| from |
integer |
Yes |
Awal rentang waktu untuk kueri. Nilainya adalah waktu log yang ditentukan saat log ditulis. Rentang waktu merupakan interval kiri-tertutup kanan-terbuka. Artinya, rentang tersebut mencakup waktu mulai tetapi tidak mencakup waktu akhir. Jika nilai from dan to sama, interval tersebut tidak valid dan akan mengembalikan error. Nilainya berupa Stempel waktu UNIX yang merepresentasikan jumlah detik sejak 00:00:00 UTC pada 1 Januari 1970. |
1627268185 |
| to |
integer |
Yes |
Akhir rentang waktu untuk kueri. Nilainya adalah waktu log yang ditentukan saat log ditulis. Rentang waktu merupakan interval kiri-tertutup kanan-terbuka. Artinya, rentang tersebut mencakup waktu mulai tetapi tidak mencakup waktu akhir. Jika nilai from dan to sama, interval tersebut tidak valid dan akan mengembalikan error. Nilainya berupa Stempel waktu UNIX yang merepresentasikan jumlah detik sejak 00:00:00 UTC pada 1 Januari 1970. |
1627268185 |
| line |
integer |
No |
Jumlah maksimum log yang dikembalikan. Parameter ini hanya berlaku jika parameter kueri berisi pernyataan kueri. Nilainya harus berupa bilangan bulat antara 0 hingga 100. Nilai default-nya adalah 100. |
100 |
| offset |
integer |
No |
Nomor baris tempat memulai kueri. Parameter ini hanya berlaku jika parameter kueri berisi pernyataan kueri. Nilai default-nya adalah 0. |
0 |
| reverse |
boolean |
No |
Menentukan apakah log dikembalikan dalam urutan menurun berdasarkan stempel waktunya. Presisi berada pada tingkat menit. true: Mengembalikan log dalam urutan menurun berdasarkan stempel waktunya. false (default): Mengembalikan log dalam urutan menaik berdasarkan stempel waktunya. Catatan: Jika parameter kueri berisi pernyataan kueri, parameter reverse berlaku dan menentukan urutan pengurutan. Jika parameter kueri berisi pernyataan kueri dan analisis, parameter reverse tidak berlaku. Urutan pengurutan ditentukan oleh klausa ORDER BY dalam pernyataan analitik. Jika ORDER BY bernilai asc (default), log diurutkan secara menaik. Jika ORDER BY bernilai desc, log diurutkan secara menurun. |
false |
| powerSql |
boolean |
No |
Menentukan apakah SQL tingkat lanjut diaktifkan. Nilai default-nya adalah false. |
false |
| session |
string |
No |
Parameter kueri. |
mode=scan |
| topic |
string |
No |
Topik log. Nilai default-nya adalah tanda kutip ganda (""). |
"" |
| query |
string |
No |
Pernyataan kueri atau pernyataan analitik. Untuk informasi selengkapnya, lihat Ikhtisar kueri dan Ikhtisar analisis. Untuk menggunakan fitur Exclusive SQL, tambahkan set session parallel_sql=true; ke pernyataan analitik dalam parameter query. Contoh: * | set session parallel_sql=true; select count(*) as pv. Catatan: Jika parameter query berisi pernyataan analitik (pernyataan SQL), parameter line dan offset tidak berlaku. Atur nilainya menjadi 0. Gunakan klausa LIMIT dalam pernyataan SQL untuk penomoran halaman. Untuk informasi selengkapnya, lihat Penomoran halaman hasil kueri dan analisis. |
status: 401 | SELECT remote_addr,COUNT(*) as pv GROUP by remote_addr ORDER by pv desc limit 5 |
| forward |
boolean |
No |
Untuk kueri scan atau frasa, menentukan apakah penomoran halaman dilakukan maju atau mundur. |
false |
| highlight |
boolean |
No |
Menentukan apakah hasilnya disorot. |
false |
| isAccurate |
boolean |
No |
Menentukan apakah pengurutan tingkat nanodetik diaktifkan. |
true |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Data yang dikembalikan. |
||
| meta |
object |
Metadata dari data yang dikembalikan. |
|
| progress |
string |
Kemajuan kueri. Nilai yang valid:
|
Complete |
| aggQuery |
string |
Bagian SQL dari pernyataan kueri yang mengikuti karakter pipa (|). |
select * |
| whereQuery |
string |
Bagian dari pernyataan kueri yang mendahului karakter pipa (|). |
* |
| hasSQL |
boolean |
Menunjukkan apakah kueri merupakan kueri SQL. |
false |
| processedRows |
integer |
Jumlah baris yang diproses dalam kueri. |
10000 |
| elapsedMillisecond |
integer |
Waktu yang dikonsumsi oleh kueri, dalam milidetik. |
5 |
| cpuSec |
number |
Core-hour untuk Exclusive SQL. |
0.002 |
| cpuCores |
integer |
Jumlah core CPU yang digunakan. |
3 |
| keys |
array |
Semua kunci dalam hasil kueri. |
|
|
string |
Kunci. |
key |
|
| terms |
array<object> |
Semua kata kunci dalam pernyataan kueri. |
|
|
object |
Kata kunci. |
{term=*, key=} |
|
| limited |
integer |
Jumlah entri yang dikembalikan. Parameter ini dikembalikan jika pernyataan SQL tidak berisi klausa LIMIT. |
100 |
| mode |
integer |
Mode kueri. Nilai yang valid: 0: Kueri normal, termasuk kueri SQL. 1: Kueri frasa. 2: Kueri SCAN. 3: Kueri SCAN SQL. |
0 |
| phraseQueryInfo |
object |
Informasi mengenai kueri frasa. |
|
| scanAll |
boolean |
Menunjukkan apakah semua log dipindai. |
true |
| beginOffset |
integer |
Offset awal hasil pemindaian setelah penyaringan indeks. |
0 |
| endOffset |
integer |
Offset akhir hasil pemindaian setelah penyaringan indeks. |
0 |
| endTime |
integer |
Waktu akhir hasil pemindaian setelah penyaringan indeks. |
1 |
| scanBytes |
integer |
Volume data yang dipindai dalam kueri scan, dalam byte. |
1024 |
| highlights |
array |
Konten yang disorot. |
|
|
array |
Konten yang disorot. |
||
| LogContent |
Konten log yang disorot. |
||
| count |
integer |
Jumlah entri log yang dikembalikan dalam kueri ini. |
1 |
| processedBytes |
integer |
Volume log yang diproses dalam kueri, dalam byte. |
10000 |
| isAccurate |
boolean |
Menunjukkan apakah pengurutan tingkat nanodetik diaktifkan. |
true |
| columnTypes |
array |
Tipe kolom. |
|
|
string |
Tipe. |
long |
|
| telementryType |
string |
Tipe data observabel. |
None |
| data |
array<object> |
Hasil kueri. |
|
|
object |
Data yang dikembalikan. |
||
|
string |
Data yang dikembalikan. |
{'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'} |
Contoh
Respons sukses
JSONformat
{
"meta": {
"progress": "Complete",
"aggQuery": "select *",
"whereQuery": "*",
"hasSQL": false,
"processedRows": 10000,
"elapsedMillisecond": 5,
"cpuSec": 0.002,
"cpuCores": 3,
"keys": [
"key"
],
"terms": [
{
"test": "test",
"test2": 1
}
],
"limited": 100,
"mode": 0,
"phraseQueryInfo": {
"scanAll": true,
"beginOffset": 0,
"endOffset": 0,
"endTime": 1
},
"scanBytes": 1024,
"highlights": [
[
{
"Key": "key-test",
"Value": "value-test"
}
]
],
"count": 1,
"processedBytes": 10000,
"isAccurate": true,
"columnTypes": [
"long"
],
"telementryType": "None"
},
"data": [
{
"key": "{'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}"
}
]
}
Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.