GetLogsV2 - Simple Log Service

Mengambil log mentah dari logstore tertentu dalam suatu Proyek. Respons berisi log mentah dari rentang waktu yang ditentukan dan dikompresi untuk transmisi.

Deskripsi operasi

SDK Simple Log Service hanya tersedia untuk Go, Java, dan Python. Namun, Anda dapat memanggil semua operasi OpenAPI secara langsung.
Anda harus menentukan metode kompresi saat memanggil operasi ini. Algoritma kompresi yang tersedia bervariasi tergantung pada bahasa pemrograman. Untuk informasi selengkapnya, lihat parameter permintaan Accept-Encoding.
Untuk informasi selengkapnya, lihat GetLogs.

Izin

Tabel berikut menjelaskan otorisasi untuk operasi API ini. Untuk memberikan izin kepada RAM user atau RAM role agar dapat memanggil operasi ini, tambahkan aksi tersebut ke pernyataan kebijakan Resource Access Management (RAM).

Action	Resource dalam kebijakan otorisasi
`log:GetLogStoreLogs`	`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}`

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 logstore.	test-logstore

Parameter permintaan

Parameter	Type	Required	Description	Example
project	string	Yes	Nama Proyek.	ali-test-project
Accept-Encoding	string	Yes	Metode kompresi. Java, Python, dan Go mendukung dekompresi lz4 dan gzip. PHP, JavaScript, dan C# hanya mendukung dekompresi gzip. Valid values: lz4 : lz4 gzip : gzip	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 merupakan 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 merupakan 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 pencarian. Nilainya harus berupa bilangan bulat antara 0 hingga 100. Nilai default: 100.	100
offset	integer	No	Nomor baris tempat memulai kueri. Parameter ini hanya berlaku jika parameter kueri berisi pernyataan pencarian. Nilai default: 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 naik berdasarkan stempel waktunya. Catatan Jika parameter kueri berisi pernyataan pencarian, parameter ini berlaku dan menentukan urutan pengurutan. Jika parameter kueri berisi pernyataan analitik, parameter ini tidak berlaku. Urutan pengurutan ditentukan oleh klausa ORDER BY dalam pernyataan analitik. ORDER BY asc (default) mengurutkan log secara naik. ORDER BY desc mengurutkan log secara menurun.	false
powerSql	boolean	No	Menentukan apakah SQL yang ditingkatkan diaktifkan. Nilai default: false.	false
session	string	No	Parameter kueri.	mode=scan
topic	string	No	Topik log. Nilai default adalah tanda kutip ganda ("").	""
query	string	No	Pernyataan pencarian 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, parameter line dan offset tidak berlaku. Atur nilainya menjadi 0. Gunakan klausa LIMIT dalam pernyataan SQL untuk penomoran halaman. Untuk informasi selengkapnya, lihat Penomoran 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 phrase, menentukan apakah penomoran halaman maju atau mundur.	false
highlight	boolean	No	Menentukan apakah hasilnya disorot.	false

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: Kueri selesai, dan hasil yang dikembalikan lengkap. Incomplete: Kueri selesai, tetapi hasil yang dikembalikan tidak lengkap. Anda harus mengirim permintaan lagi untuk mendapatkan hasil lengkapnya.	Complete
aggQuery	string	Bagian SQL dari pernyataan kueri yang mengikuti tanda vertikal (\|).	select *
whereQuery	string	Bagian dari pernyataan kueri yang mendahului tanda vertikal (\|).	*
hasSQL	boolean	Menunjukkan apakah kueri tersebut 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-hours 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 mengandung klausa LIMIT.	100
mode	integer	Mode kueri. Nilai yang valid: 0: Kueri Normal, termasuk kueri SQL. 1: Kueri Phrase. 2: Kueri SCAN. 3: Kueri SCAN SQL.	0
phraseQueryInfo	object	Informasi mengenai kueri phrase.
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. Satuan: 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. Satuan: byte.	10000
isAccurate	boolean	Menunjukkan apakah kueri akurat hingga tingkat detik.	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.