Meminta distribusi log yang memenuhi kondisi pencarian tertentu dalam Logstore yang ditentukan. Respon mencakup jumlah log yang dihasilkan dalam rentang waktu tertentu.
Sintaks perintah
aliyunlog log get_histograms --request=<value> [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>]Parameter perintah
Tabel berikut menjelaskan parameter yang diperlukan dan unik dari perintah ini.
Parameter | Tipe | Diperlukan | Contoh | Deskripsi |
--request | JSON Object | Ya | file://./gethistograms.json | Path ke file konfigurasi. File konfigurasi berisi parameter yang digunakan untuk meminta log. |
Untuk informasi lebih lanjut tentang parameter global dari perintah ini, lihat Parameter Global.
Contoh perintah
Dalam contoh ini, sebuah log mentah sampel disediakan dan file gethistograms.json dibuat untuk menanyakan distribusi log di mana nilai bidang request_method adalah PUT dan nilai bidang status adalah 200 dalam interval tertentu.
Kode berikut menunjukkan log mentah sampel:
body_bytes_sent:1750 host:www.example.com http_referer:www.example.com http_user_agent:Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_6_6; it-it) AppleWebKit/533.20.25 (KHTML, like Gecko) Version/5.0.4 Safari/533.20.27 http_x_forwarded_for:203.0.103.10 remote_addr:203.0.103.10 remote_user:p288 request_length:13741 request_method:GET request_time:71 request_uri:/request/path-1/file-1 status:200 time_local:11/Aug/2021:06:52:27 upstream_response_time:0.66Buat file bernama gethistograms.json untuk menanyakan distribusi log di mana nilai bidang request_method adalah PUT dan nilai bidang status adalah 200 dalam 15 menit terakhir. Contoh berikut menunjukkan isi file tersebut:
{ "topic": "", "logstore": "logstore-a", "project": "aliyun-test-project", "toTime": "2023-03-03 14:30:41", "query": "request_method:PUT and status:200", "fromTime": "2023-03-03 14:15:41" }Tabel berikut menjelaskan parameter.
Parameter
Deskripsi
topic
Topik dari log.
logstore
Nama dari Logstore.
project
Nama dari proyek.
toTime
Akhir dari rentang waktu untuk permintaan. Contoh: 2023-03-03 14:30:41.
query
Pernyataan pencarian. Hanya
pernyataan pencarianyang didukung.Pernyataan analitiktidak didukung. Untuk informasi lebih lanjut, lihat Sintaks pencarian dan fungsi.fromTime
Awal dari rentang waktu untuk permintaan. Contoh: 2023-03-03 14:15:41.
Jalankan perintah berikut:
aliyunlog log get_histograms --request="file://./gethistograms.json" --format-output=jsonRespon berikut menunjukkan distribusi log yang memenuhi kondisi tertentu dalam 15 menit terakhir:
[ { "count": 18, "from": 1677824141, "progress": "Complete", "to": 1677824160 }, { "count": 37, "from": 1677824160, "progress": "Complete", "to": 1677824190 }, ...... { "count": 30, "from": 1677825000, "progress": "Complete", "to": 1677825030 }, { "count": 0, "from": 1677825030, "progress": "Complete", "to": 1677825041 } ]
Referensi
Dokumentasi Layanan Log Sederhana menyediakan contoh tentang cara memanggil operasi GetHistograms menggunakan SDK Layanan Log Sederhana untuk Java. Untuk informasi lebih lanjut, lihat Gunakan GetHistograms untuk menanyakan distribusi log.
Jika respon yang dikembalikan oleh Layanan Log Sederhana berisi informasi kesalahan setelah Anda memanggil operasi API, pemanggilan gagal. Anda dapat menangani kesalahan berdasarkan kode kesalahan yang dikembalikan saat pemanggilan API gagal. Untuk informasi lebih lanjut, lihat Kode Kesalahan.
Layanan Log Sederhana juga kompatibel dengan SDK Alibaba Cloud. Untuk informasi lebih lanjut, lihat Simple Log Service_SDK Center_Alibaba Cloud OpenAPI Explorer.
Untuk informasi lebih lanjut tentang operasi API, lihat GetHistograms.