Gunakan GetContextLogs untuk kueri log kontekstual-Simple Log Service-Alibaba Cloud

Deskripsi operasi

Catatan penggunaan

Anda dapat menentukan suatu log sebagai log awal. Rentang waktu untuk kueri kontekstual mencakup satu hari sebelum dan satu hari setelah waktu pembuatan log awal tersebut.
Host terdiri atas nama proyek dan titik akhir Simple Log Service. Anda harus menentukan proyek dalam Host.
Pasangan Kunci Akses telah dibuat dan diperoleh. Untuk informasi selengkapnya, lihat AccessKey pair.

Pasangan Kunci Akses milik Akun Alibaba Cloud memiliki izin atas semua operasi API. Menggunakan kredensial ini untuk menjalankan operasi di Simple Log Service merupakan operasi berisiko tinggi. Kami menyarankan agar Anda menggunakan Pengguna Resource Access Management (RAM) untuk memanggil operasi API atau melakukan O&M rutin. Untuk membuat Pengguna RAM, login ke Konsol RAM. Pastikan Pengguna RAM tersebut memiliki izin manajemen atas resource Simple Log Service. Untuk informasi selengkapnya, lihat Create a RAM user and authorize the RAM user to access Simple Log Service.

Informasi yang diperlukan untuk mengkueri log telah diperoleh. Informasi tersebut mencakup nama proyek tempat log tersebut berada, wilayah proyek, dan nama Logstore tempat log tersebut berada. Untuk informasi selengkapnya, lihat Manage a project dan Manage a Logstore.
Indeks telah dikonfigurasi sebelum Anda mengkueri log. Untuk informasi selengkapnya, lihat Create indexes.
Nilai bidang pack_id dan pack_meta telah diperoleh sebelum Anda mengkueri log. Bidang-bidang ini merupakan bidang internal, dan Anda dapat memperoleh nilainya dengan menggunakan fitur debugging browser di Konsol Simple Log Service.

Resource otorisasi

Tabel berikut menjelaskan informasi otorisasi yang diperlukan untuk operasi ini. Anda dapat menambahkan informasi tersebut ke elemen Action dalam pernyataan kebijakan RAM untuk memberikan izin kepada Pengguna RAM atau Peran RAM guna memanggil operasi ini.

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

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}?type=context_log 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
pack_id	string	Yes	Identifier unik dari kelompok log tempat log awal berada.	85C897C740352DC6-808
pack_meta	string	Yes	Identifier konteks unik dari log awal dalam kelompok log tersebut.	2\|MTY1NTcwNTUzODY5MTY0MDk1Mg==\|3\|0
back_lines	integer	Yes	Jumlah log yang ingin Anda peroleh dan dibuat sebelum waktu pembuatan log awal. Nilai yang valid: `(0,100]`.	10
forward_lines	integer	Yes	Jumlah log yang ingin Anda peroleh dan dibuat setelah waktu pembuatan log awal. Nilai yang valid: `(0,100]`.	10

Elemen respons

Element	Type	Description	Example
	object	Skema Respons
total_lines	integer	Total jumlah log yang dikembalikan. Log tersebut mencakup log awal yang ditentukan dalam permintaan.	201
back_lines	integer	Jumlah log yang dibuat sebelum waktu pembuatan log awal.	100
forward_lines	integer	Jumlah log yang dibuat setelah waktu pembuatan log awal.	100
progress	string	Menunjukkan apakah hasil kueri dan analisis telah lengkap. Nilai yang valid: Complete: Kueri berhasil, dan hasil kueri serta analisis lengkap dikembalikan. Incomplete: Kueri berhasil, tetapi hasil kueri dan analisis tidak lengkap. Untuk memperoleh hasil lengkap, Anda harus mengulangi permintaan.	Complete
logs	array<object>	Log yang dikembalikan.
	object	Log yang dikembalikan. Log tersebut diurutkan berdasarkan urutan kontekstual. Jika tidak ditemukan log kontekstual berdasarkan log awal yang ditentukan, parameter ini akan kosong.	{ "__index_number__": "-100", "__tag__:__pack_id__": "895CEA449A52FE-8c8", "__pack_meta__": "0\|MTU1OTI4NTExMjg3NTQ2NDU1OA==\|4\|1"}

Parameter logs berisi konten log dan bidang-bidang berikut yang diformat dalam pasangan kunci-nilai.

Field	Type	Example	Description
`__index_number__`	String	-100	Posisi log dalam konteks. Nilai negatif menunjukkan bahwa log tersebut dibuat sebelum waktu pembuatan log awal. Nilai 0 menunjukkan bahwa log tersebut adalah log awal. Nilai positif menunjukkan bahwa log tersebut dibuat setelah waktu pembuatan log awal. Sebagai contoh, nilai -100 menunjukkan bahwa log tersebut adalah log ke-100 sebelum waktu pembuatan log awal.
`__tag__:__pack_id__`	String	895CEA449A52FE-8c8	Identifier unik dari kelompok log tempat log tersebut berada. Identifier ini dapat digunakan sebagai nilai parameter pack_id dalam permintaan.
`__pack_meta__`	String	`0	MTU1OTI4NTExMjg3NTQ2NDU1OA==

Contoh

Respons sukses

JSONformat

{
  "total_lines": 201,
  "back_lines": 100,
  "forward_lines": 100,
  "progress": "Complete",
  "logs": [
    {
      "__index_number__": "-100",
      "__tag__:__pack_id__": "895CEA449A52FE-8c8",
      "__pack_meta__": "0|MTU1OTI4NTExMjg3NTQ2NDU1OA==|4|1"
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.