Gunakan GetHistograms untuk kueri distribusi log - Simple Log Service

Deskripsi operasi

Deskripsi antarmuka

Host dalam sintaks permintaan terdiri dari nama proyek dan endpoint Simple Log Service. Anda harus menentukan proyek dalam Host.
Subinterval dalam respons dibagi secara konsisten. Jika rentang waktu yang diminta sama, pembagian subinterval dalam respons juga akan sama.
Jika jumlah log dalam suatu kueri sangat bervariasi, antarmuka pemrograman aplikasi (API) Simple Log Service tidak dapat memprediksi berapa kali panggilan yang diperlukan untuk mengambil hasil lengkap. Anda harus memeriksa status anggota progress di setiap respons. Status ini menunjukkan apakah perlu memanggil operasi lagi untuk mengambil hasil akhir. Setiap panggilan ulang mengonsumsi jumlah CU kueri yang sama.
Simple Log Service mengklasifikasikan log menjadi dua tipe berdasarkan stempel waktunya, yang menentukan keterlambatan antara saat log ditulis ke Logstore dan saat log tersebut dapat dikueri menggunakan operasi GetHistograms dan GetLogs:
- Data real-time: Stempel waktu log berada dalam rentang (-180 detik, +900 detik] relatif terhadap waktu saat ini di server. Misalnya, jika stempel waktu log adalah UTC 2014-09-25 12:03:00 dan server menerimanya pada UTC 2014-09-25 12:05:00, log tersebut diproses sebagai data real-time. Latensi maksimum agar data real-time dapat dicari adalah 3 detik. Dalam 99,9% kasus, data tersebut dapat dicari dalam waktu 1 detik.
- Data historis: Stempel waktu log berada dalam rentang [-7 × 86400 detik, -180 detik) relatif terhadap waktu saat ini di server. Misalnya, jika stempel waktu log adalah UTC 2014-09-25 12:00:00 dan server menerimanya pada UTC 2014-09-25 12:05:00, log tersebut diproses sebagai data historis. Hal ini biasanya terjadi selama pengisian ulang data.

Catatan

Simple Log Service menghitung selisih antara waktu log (bidang __time__) dan waktu penerimaan log oleh server (bidang __tag__:__receive_time__). Jika selisih tersebut berada dalam rentang (-180 detik, 900 detik], datanya merupakan data real-time. Jika selisih tersebut berada dalam rentang [-7 × 86400 detik, -180 detik), datanya merupakan data historis.

Simple Log Service menyediakan contoh kit pengembangan perangkat lunak (SDK) Java untuk menggunakan kueri GetHistograms. Untuk informasi selengkapnya, lihat Gunakan GetHistograms untuk mengkueri distribusi log.

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}/index?type=histogram 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
from	integer	Yes	Awal rentang waktu untuk subinterval. Nilainya berupa Stempel waktu UNIX yang merepresentasikan jumlah detik yang telah berlalu sejak 1970-01-01 00:00:00 UTC.	1409529600
to	integer	Yes	Akhir rentang waktu untuk subinterval. Nilainya berupa Stempel waktu UNIX yang merepresentasikan jumlah detik yang telah berlalu sejak 1970-01-01 00:00:00 UTC.	1409569200
topic	string	No	Topik log.	topic
query	string	No	Pernyataan pencarian. Hanya pernyataan pencarian yang didukung. Pernyataan analitik tidak didukung. Untuk informasi selengkapnya mengenai sintaks pernyataan pencarian, lihat Sintaks pencarian.	with_pack_meta

Elemen respons

Element	Type	Description	Example
	array
	object
from	integer	Awal rentang waktu untuk subinterval. Nilainya berupa Stempel waktu UNIX yang merepresentasikan jumlah detik yang telah berlalu sejak 1970-01-01 00:00:00 UTC. Rentang waktu merupakan interval kiri-tertutup, kanan-terbuka. Artinya, subinterval mencakup waktu mulai tetapi tidak mencakup waktu akhir. Jika nilai from dan to sama, interval tersebut tidak valid dan akan dikembalikan error.	1409529600
to	integer	Akhir rentang waktu untuk subinterval. Nilainya berupa Stempel waktu UNIX yang merepresentasikan jumlah detik yang telah berlalu sejak 1970-01-01 00:00:00 UTC. Rentang waktu merupakan interval kiri-tertutup, kanan-terbuka. Artinya, subinterval mencakup waktu mulai tetapi tidak mencakup waktu akhir. Jika nilai from dan to sama, interval tersebut tidak valid dan akan dikembalikan error.	1409569200
count	integer	Jumlah log yang ditemukan dalam subinterval.	2
progress	string	Menunjukkan apakah hasil kueri dalam subinterval telah lengkap. Complete: Kueri selesai dan hasilnya lengkap. Incomplete: Kueri selesai tetapi hasilnya belum lengkap. Kirim permintaan lagi untuk mendapatkan hasil lengkap.	Complete

Contoh

Respons sukses

JSONformat

[
  {
    "from": 1409529600,
    "to": 1409569200,
    "count": 2,
    "progress": "Complete"
  }
]

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.