Gunakan GetLogs untuk kueri data log-Simple Log Service-Alibaba Cloud - Simple Log Service

Deskripsi operasi

Catatan

Simple Log Service memungkinkan Anda membuat node SQL terjadwal. Untuk informasi lebih lanjut, lihat Membuat node SQL terjadwal.

Host dalam sintaks permintaan terdiri dari nama Proyek dan titik akhir Simple Log Service. Anda harus menentukan Proyek di Host.
Buat dan dapatkan Pasangan Kunci Akses. Untuk informasi lebih lanjut, lihat Pasangan Kunci Akses.

Pasangan Kunci Akses akun Alibaba Cloud memiliki izin akses untuk semua operasi API, yang menimbulkan risiko keamanan tinggi. Kami sangat menyarankan Anda membuat dan menggunakan Pengguna Resource Access Management (RAM) untuk akses API atau operasional dan pemeliharaan rutin. Pengguna RAM harus memiliki izin akses untuk mengelola Sumber daya EPS Simple Log Service. Untuk informasi lebih lanjut, lihat Membuat pengguna RAM dan memberikan otorisasi kepada pengguna RAM.

Tentukan nama Proyek, Wilayah, dan nama penyimpanan log untuk log yang ingin Anda kueri. Untuk informasi lebih lanjut, lihat Mengelola Proyek dan Mengelola penyimpanan log.
Simple Log Service memiliki batas penggunaan untuk mengkueri log. Rancang pernyataan kueri dan pernyataan analitik yang tepat serta tetapkan rentang waktu kueri yang sesuai. Untuk informasi lebih lanjut, lihat Batas pada kueri log dan Batas pada analisis log.
Sebelum Anda mengkueri log, konfigurasikan indeks. Untuk informasi lebih lanjut, lihat Membuat indeks.
Ketika jumlah log yang terlibat dalam kueri berubah secara signifikan, API Simple Log Service tidak dapat memprediksi berapa kali operasi ini harus dipanggil untuk mendapatkan hasil lengkap. Periksa nilai status x-log-progress dalam tanggapan setiap permintaan untuk menentukan apakah Anda perlu memanggil operasi ini lagi untuk mendapatkan hasil lengkap. Setiap pemanggilan berulang mengonsumsi jumlah unit komputasi kueri (CU) yang sama.
Setelah log ditulis ke penyimpanan log, latensi sebelum operasi kueri (GetHistograms dan GetLogs) dapat mengkueri log bervariasi berdasarkan tipe log. Simple Log Service mengklasifikasikan log menjadi dua tipe berikut berdasarkan stempel waktu UNIX log:
- Data real-time: Titik waktu dalam log berada dalam rentang (-180 detik, 900 detik] relatif terhadap pengatur waktu saat ini di server. Misalnya, jika waktu log adalah UTC 2014-09-25 12:03:00 dan server menerima log pada UTC 2014-09-25 12:05:00, log diproses sebagai data real-time. Ini umumnya terjadi dalam skenario normal.
- Data historis: Titik waktu dalam log berada dalam rentang [-7×86400 detik, -180 detik) relatif terhadap pengatur waktu saat ini di server. Misalnya, jika waktu log adalah UTC 2014-09-25 12:00:00 dan server menerima log pada UTC 2014-09-25 12:05:00, log diproses sebagai data historis. Ini umumnya terjadi dalam skenario pengisian ulang data. Latensi dari penulisan data real-time hingga pengkuerian data adalah sekitar 3 detik.

Catatan

Simple Log Service menghitung selisih antara waktu log (nama bidang: time) dan waktu penerimaan server (nama bidang: tag:receive_time). Jika selisihnya berada dalam rentang (-180 detik, 900 detik], log adalah data real-time. Jika selisihnya berada dalam rentang [-7×86400 detik, -180 detik), log adalah data historis.

Simple Log Service menyediakan contoh penggunaan operasi GetLogs dengan Java SDK dan Python SDK. Untuk informasi lebih lanjut, lihat Contoh Java SDK untuk GetLogs dan Contoh Python SDK untuk GetLogs.

Sumber daya otentikasi

Tabel berikut mencantumkan informasi otorisasi yang sesuai dengan operasi API ini. Anda dapat menambahkan informasi ini ke elemen Action dalam pernyataan kebijakan akses RAM untuk memberikan otorisasi kepada Pengguna RAM atau Peran RAM untuk memanggil operasi API ini.

Action	Resource
`log:GetLogStoreLogs`	`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

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

Path Parameters

Parameter	Type	Required	Description	Example
logstore	string	Yes	Nama penyimpanan log tempat Anda ingin mengkueri data.	example-logstore

Parameter permintaan

Parameter	Type	Required	Description	Example
project	string	Yes	Nama Proyek.	ali-test-project
		No		lz4
		No

Elemen respons

Element	Type	Description	Example
	array	Array log. Setiap elemen adalah entri log.
	object	Array Logs. Setiap elemen dalam array adalah entri log.	[{'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}, {'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}, {'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}, {'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}, {'remote_addr': '198.51.100.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}]

Contoh

Respons sukses

JSONformat

[
  {
    "test": "test",
    "test2": 1
  }
]

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.