PullLogs - Simple Log Service

Panggil operasi PullLogs untuk mengambil data log dari posisi kursor yang ditentukan. Operasi ini mengambil log mentah. Untuk melakukan kueri atau menganalisis log, gunakan operasi GetLogsV2.

Deskripsi operasi

Peringatan Operasi ini tidak didukung oleh SDK OpenAPI. Gunakan SDK Simple Log Service.

Tentukan shard untuk mengambil log.
Operasi ini hanya mendukung pembacaan data dalam format Protocol Buffer.
Host dalam sintaksis permintaan terdiri dari nama proyek dan titik akhir Simple Log Service. Proyek harus ditentukan dalam Host.

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

GET /logstores/{logStore}/shards/{shardId}?type=log HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
project	string	Yes	Nama proyek.	ali-test-project
logStore	string	Yes	Nama Logstore.	ali-test-logstore
shardId	integer	Yes	ID shard dalam Logstore.	1

Parameter permintaan

Parameter	Type	Required	Description	Example
cursor	string	Yes	Kursor yang menentukan posisi awal untuk membaca data.	MTQ0NzMyOTQwMTEwMjEzMDkwNA
count	integer	Yes	Jumlah LogGroup yang akan dikembalikan. Nilainya harus berupa bilangan bulat antara 1 hingga 1000.	1000
end_cursor	string	No	Kursor yang menentukan posisi akhir untuk menghentikan pembacaan data.	MTU1NzA1NzQwMTEwMjEzMDkwCg
query	string	No	Pernyataan filter dalam sintaksis Structured Process Language (SPL). Untuk informasi selengkapnya, lihat petunjuk SPL.	* \| where userId='123'
Accept-Encoding	string	No	Format kompresi data yang dikembalikan oleh server. Hanya format lz4 yang didukung.	lz4

Header permintaan berikut khusus untuk operasi PullLogs:

Accept: application/x-protobuf
Accept-Encoding: lz4

Nilai Accept-Encoding dapat berupa lz4, deflate, atau tanda kutip ganda ("").

Contoh permintaan:

GET /logstores/sls-test-logstore/shards/0?type=logs&cursor=MTQ0NzMyOTQwMTEwMjEzMDkwNA&count=1000 HTTP/1.1
Host:ali-test-project.cn-hangzhou.log.aliyuncs.com
Content-Type:application/json

Elemen respons

Element	Type	Description	Example
	LogGroupList	Data terkompresi dalam format protobuf.

Header respons berikut khusus untuk operasi PullLogs:

x-log-cursor: Kursor untuk log berikutnya yang akan dibaca.
x-log-end-of-cursor: Kursor dari log terakhir yang dibaca dalam permintaan saat ini.
x-log-count: Jumlah log yang dikembalikan.

Untuk informasi mengenai header respons umum operasi API Simple Log Service, lihat Header respons umum.

Badan respons berisi data yang diserialisasi dalam format protobuf dan mungkin dikompresi.

Contoh

Respons sukses

JSONformat

{
  "logGroupList": [
    {
      "Topic": "topic-test",
      "Source": "192.1.1.1",
      "LogTags": [
        {
          "Key": "key-test",
          "Value": "value-test"
        }
      ],
      "LogItems": [
        {
          "Time": 1690254376,
          "Contents": [
            {
              "Key": "key-test",
              "Value": "value-test"
            }
          ]
        }
      ]
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.