全部产品
Search
文档中心

Simple Log Service:get_histograms

更新时间:Jul 06, 2025

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.

  1. 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.66
  2. Buat 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 pencarian yang didukung. Pernyataan analitik tidak didukung. Untuk informasi lebih lanjut, lihat Sintaks pencarian dan fungsi.

    fromTime

    Awal dari rentang waktu untuk permintaan. Contoh: 2023-03-03 14:15:41.

  3. Jalankan perintah berikut:

    aliyunlog log get_histograms --request="file://./gethistograms.json" --format-output=json

    Respon 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.