get_log - Simple Log Service

Mengekstrak log. Perintah ini cocok untuk skenario di mana Anda perlu menanyakan sejumlah log tertentu.

Sintaks permintaan

aliyunlog log get_log --project=<value> --logstore=<value> --from_time=<value> --to_time=<value> [--topic=<value>] [--query=<value>] [--reverse=<value>] [--offset=<value>] [--size=<value>] [--power_sql=<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>] [--profile=<value>]

Parameter permintaan

Tabel berikut menjelaskan parameter yang diperlukan dan unik dari perintah ini.

Parameter	Tipe	Diperlukan	Contoh	Deskripsi
--project	String	Ya	aliyun-test-project	Nama proyek.
--logstore	String	Ya	logstore-a	Nama logstore.
--from_time	String	Ya	2021-05-28 15:33:00+8:00	Awal rentang waktu untuk kueri. Tentukan nilainya sebagai timestamp UNIX atau dalam format `"%Y-%m-%d %H:%M:%S<time_zone>"`. Contoh: `“2018-01-02 12:12:10+8:00“`.
--to_time	String	Ya	2021-05-28 15:40:00+8:00	Akhir rentang waktu untuk kueri. Tentukan nilainya sebagai timestamp UNIX atau dalam format `"%Y-%m-%d %H:%M:%S<time_zone>"`. Contoh: `“2018-01-02 12:12:10+8:00“`.
--topic	String	Tidak	""	Topik log yang akan dikueri. Nilai default adalah tanda kutip ganda (""). Untuk informasi lebih lanjut, lihat Topik.
--query	String	Tidak	`level:Information\|select event_id as Key1,COUNT(*) as Key2 group by Key1`	Pernyataan pencarian atau pernyataan kueri. Untuk informasi lebih lanjut, lihat Ikhtisar kueri dan analisis log. Jika Anda menambahkan `set session parallel_sql=true;` ke dalam pernyataan analitik pada nilai parameter query, fitur Dedicated SQL digunakan. Sebagai contoh, Anda dapat mengatur nilainya menjadi `* \| set session parallel_sql=true; select count() as pv`. Catatan* Jika Anda menentukan pernyataan analitik pada nilai parameter query, Anda harus mengatur parameter line dan offset ke 0 dan menggunakan klausa LIMIT untuk melakukan kueri halaman. Pernyataan analitik adalah pernyataan SQL. Untuk informasi lebih lanjut, lihat Halaman hasil kueri dan analisis.
--reverse	Boolean	Tidak	true	Menentukan apakah akan mengembalikan log dalam urutan menurun berdasarkan cap waktu log. Cap waktu log akurat hingga menit. true: Log dikembalikan dalam urutan menurun berdasarkan cap waktu log. false: Log dikembalikan dalam urutan menaik berdasarkan cap waktu log. Ini adalah nilai default. Penting Parameter reverse hanya berlaku ketika parameter query diatur ke pernyataan pencarian. Parameter reverse menentukan urutan pengurutan log yang dikembalikan. Jika parameter query diatur ke pernyataan kueri, parameter reverse tidak valid. Urutan pengurutan log yang dikembalikan ditentukan oleh klausa ORDER BY dalam pernyataan analitik. Jika Anda menggunakan kata kunci default asc dalam klausa ORDER BY, log diurutkan secara menaik. Jika Anda menggunakan kata kunci desc dalam klausa ORDER BY, log diurutkan secara menurun.
--offset	Integer	Tidak	0	Baris tempat kueri dimulai. Parameter ini hanya berlaku ketika parameter query diatur ke pernyataan pencarian. Nilai default: 0.
--size	Integer	Tidak	10	Jumlah maksimum log yang akan dikembalikan. Parameter ini hanya berlaku ketika parameter query diatur ke pernyataan pencarian. Nilai minimum: 0. Nilai maksimum: 100. Nilai default: 100.
--power_sql	Boolean	Tidak	false	Menentukan apakah akan menggunakan fitur Dedicated SQL. Untuk informasi lebih lanjut, lihat Dedicated SQL: Solusi optimalisasi kueri log tingkat triliun. true: Fitur Dedicated SQL digunakan. false: Fitur Standard SQL digunakan. Ini adalah nilai default. Anda dapat menggunakan parameter powerSql atau query untuk menentukan apakah akan menggunakan fitur Dedicated SQL.

Untuk informasi lebih lanjut tentang parameter global perintah ini, lihat Parameter Global.

Contoh

Permintaan Sampel

Gunakan akun default untuk menanyakan 20 log acara dengan metode permintaan POST. Contoh perintah:

aliyunlog log get_log --project="aliyun-test-project" --logstore="logstore-a" --from_time="2021-05-28 15:33:00+8:00" --to_time="2021-05-28 15:40:00+8:00" --query="request_method:POST | select status,COUNT(*) as pv group by status order by pv desc limit 20" --format-output=json

Respon Sampel

{
  "data": [
    {
      "__source__": "",
      "__time__": "1719382500",
      "pv": "17",
      "status": "200"
    },
    {
      "__source__": "",
      "__time__": "1719382500",
      "pv": "3",
      "status": "500"
    }
  ],
  "meta": {
    "aggQuery": "select status,COUNT(*) as pv group by status order by pv desc limit 20",
    "columnTypes": [
      "long",
      "long"
    ],
    "count": 2,
    "cpuSec": 0.025,
    "elapsedMillisecond": 0,
    "hasSQL": true,
    "insertedSQL": "1,29, from \"gs-api\" ",
    "isAccurate": true,
    "keys": [
      "status",
      "pv"
    ],
    "processedBytes": 226,
    "processedRows": 20,
    "progress": "Complete",
    "telementryType": "logging",
    "telemetryType": "logging",
    "terms": [
      {
        "key": "",
        "term": "*"
      }
    ],
    "whereQuery": "*"
  }
}

Perintah terkait

Perintah	Deskripsi
get_logs	Mengekstrak log dalam mode pencocokan tepat menggunakan file konfigurasi JSON.
get_log_all	Mengekstrak sejumlah besar log.