全部产品
Search
文档中心

Simple Log Service:GetLogsV2

更新时间:Feb 09, 2026

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.

ActionResource in an authorization policy
log:GetLogStoreLogsacs: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 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: 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 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.