Gunakan GetLogsV2 untuk kueri log mentah dari Logstore - Simple Log Service - Alibaba Cloud - Simple Log Service

Mengkueri data log mentah dari penyimpanan log tertentu dalam sebuah Proyek dan mengembalikan log mentah dalam rentang waktu tertentu. Hasil dikompresi sebelum transmisi.

Deskripsi operasi

Tentukan metode kompresi saat penggunaan. Bahasa pemrograman yang berbeda mengimplementasikan algoritma kompresi yang berbeda. Untuk detail, lihat parameter permintaan Accept-Encoding.
Untuk informasi lebih lanjut, lihat GetLogs.

Otentikasi

Tabel berikut menjelaskan informasi otorisasi yang diperlukan oleh API ini. Anda dapat menambahkan informasi ini ke elemen Action dalam pernyataan kebijakan akses RAM untuk memberikan izin kepada pengguna RAM atau peran RAM untuk memanggil API ini.

Action	Resource
`log:GetLogStoreLogs`	`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}`

Prosedur berikut menjelaskan cara menggunakan API ini:

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST /logstores/{logstore}/logs HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
logstore	string	Yes	Nama penyimpanan log.	test-logstore

Parameter permintaan

Parameter	Type	Required	Description	Example
project	string	Yes	Nama proyek.	ali-test-project
Accept-Encoding	string	No	Metode kompresi untuk konten respons. Pengguna SDK tidak perlu menentukan parameter ini karena SDK secara otomatis menangani kompresi dan dekompresi. Java, Python, dan Go saat ini mendukung dekompresi lz4 dan gzip. php, JavaScript, dan C# saat ini hanya mendukung dekompresi gzip. Valid values: lz4 : lz4 gzip : gzip.	lz4
body	object	No	Struktur permintaan.
from	integer	Yes	Waktu mulai kueri. Waktu ini merujuk pada waktu log yang ditentukan saat data log ditulis. Pengatur waktu yang ditentukan oleh parameter permintaan from dan to mengikuti prinsip tertutup-kiri, terbuka-kanan. Pengatur waktu mencakup waktu mulai tetapi tidak mencakup waktu akhir. Jika nilai from dan to sama, pengatur waktu tidak valid dan fungsi mengembalikan error. Nilainya adalah stempel waktu UNIX yang mewakili jumlah detik yang telah berlalu sejak 1 Januari 1970, 00:00:00 UTC.	1627268185
to	integer	Yes	Waktu akhir kueri. Waktu ini merujuk pada waktu log yang ditentukan saat data log ditulis. Pengatur waktu yang ditentukan oleh parameter permintaan from dan to mengikuti prinsip tertutup-kiri, terbuka-kanan. Pengatur waktu mencakup waktu mulai tetapi tidak mencakup waktu akhir. Jika nilai from dan to sama, pengatur waktu tidak valid dan fungsi mengembalikan error. Nilainya adalah stempel waktu UNIX yang mewakili jumlah detik yang telah berlalu sejak 1 Januari 1970, 00:00:00 UTC.	1627268185
line	integer	No	Jumlah maksimum log yang dikembalikan. Parameter ini hanya valid jika parameter query adalah pernyataan kueri (bukan pernyataan analitik). Nilai minimum: 0. Nilai maksimum: 100. Nilai default: 100.	100
offset	integer	No	Baris tempat kueri dimulai. Parameter ini hanya valid jika parameter query adalah pernyataan kueri (bukan pernyataan analitik). Nilai dimulai dari 0. Nilai default: 0.	0
reverse	boolean	No	Apakah akan mengembalikan log dalam urutan kronologis terbalik berdasarkan stempel waktu log, akurat hingga tingkat menit. Parameter ini hanya valid jika parameter query adalah pernyataan kueri (bukan pernyataan analitik). true: Mengembalikan log dalam urutan menurun berdasarkan stempel waktu log. false (default): Mengembalikan log dalam urutan menaik berdasarkan stempel waktu log. Untuk mengurutkan hasil dalam pernyataan analitik, gunakan sintaks ORDER BY. Jika ORDER BY diatur ke asc (default), log dikembalikan dalam urutan menaik. Jika ORDER BY diatur ke desc, log dikembalikan dalam urutan menurun.	false
powerSql	boolean	No	Apakah akan mengaktifkan SQL Khusus. Dinonaktifkan secara default.	false
session	string	No	Parameter kueri.	mode=scan
topic	string	No	Topik. Nilai default: string kosong.	""
query	string	No	Pernyataan kueri atau pernyataan analitik. Untuk informasi lebih lanjut, lihat ikhtisar kueri dan ikhtisar analisis. Tambahkan set session parallel_sql=true; ke pernyataan analitik dalam parameter query untuk menggunakan SQL Khusus. Contoh: * \| set session parallel_sql=true; select count(*) as pv. Catatan: Ketika parameter query berisi pernyataan analitik (pernyataan SQL), parameter line dan offset dari API ini tidak valid. Atur menjadi 0. Gunakan sintaks LIMIT dalam pernyataan SQL untuk paginasi. Untuk informasi lebih lanjut, lihat Menampilkan hasil kueri dan analisis per halaman.	status: 401 \| SELECT remote_addr,COUNT(*) as pv GROUP by remote_addr ORDER by pv desc limit 5
forward	boolean	No	Apakah akan melakukan paginasi maju atau mundur untuk kueri Pemindaian atau phrase.	false
highlight	boolean	No	Apakah akan mengaktifkan penyorotan.	false
isAccurate	boolean	No	Apakah akan mengaktifkan urutan presisi nanodetik.	true

Elemen respons

Element	Type	Description	Example
	object	Badan respons.
meta	object	Metadata respons.
progress	string	Menunjukkan apakah hasil kueri lengkap. Nilai valid: Complete: Kueri selesai dan hasil lengkap. Incomplete: Kueri selesai tetapi hasil tidak lengkap. Ulangi permintaan untuk mendapatkan hasil lengkap.	Complete
aggQuery	string	Bagian SQL setelah pipa (\|) dalam pernyataan kueri.	select *
whereQuery	string	Bagian sebelum pipa (\|) dalam pernyataan kueri.	*
hasSQL	boolean	Menunjukkan apakah kueri adalah kueri SQL.	false
processedRows	integer	Jumlah baris yang diproses dalam kueri ini.	10000
elapsedMillisecond	integer	Waktu yang dikonsumsi oleh kueri ini, dalam milidetik.	5
cpuSec	number	Core-hour yang dikonsumsi oleh SQL Khusus.	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	Batas jumlah baris. Dikembalikan ketika pernyataan SQL tidak berisi klausa LIMIT.	100
mode	integer	Mode kueri. Nilai valid: 0: kueri standar (termasuk SQL) 1: kueri phrase 2: SCAN 3: SCAN SQL	0
phraseQueryInfo	object	Informasi kueri phrase.
scanAll	boolean	Menunjukkan apakah semua log telah Pemindaian.	true
beginOffset	integer	Offset awal hasil pemindaian setelah penyaringan indeks.	0
endOffset	integer	Offset akhir hasil pemindaian setelah penyaringan indeks.	0
endTime	integer	pengatur waktu akhir hasil Pemindaian setelah penyaringan Indeks.	1
scanBytes	integer	Jumlah data yang dipindai selama pemindaian, dalam byte.	1024
highlights	array<object>	Konten yang disorot.
	object	Konten yang disorot.
count	integer	Jumlah entri log yang dikembalikan dalam permintaan kueri ini.	1
processedBytes	integer	Volume log yang diproses oleh kueri, dalam byte.	10000
isAccurate	boolean	Apakah akan mengaktifkan urutan presisi nanodetik.	true
columnTypes	array	Tipe kolom.
	string	Tipe.	long
telementryType	string	Tipe data yang dapat diamati.	None
data	array<object>	Hasil yang dikembalikan.
	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": [
      {
        "test": "test",
        "test2": 1
      }
    ],
    "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.