すべてのプロダクト
Search
ドキュメントセンター

Simple Log Service:get_log

最終更新日:Jun 04, 2026

Logstore から指定された数のログをクエリします。

リクエスト構文

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>]

リクエストパラメーター

次の表に、コマンド固有のパラメーターを示します。

パラメーター名

データ型

必須

値の例

説明

--project

文字列

はい

aliyun-test-project

プロジェクト名。

--logstore

文字列

はい

logstore-a

Logstore 名。

--from_time

文字列

はい

2021-05-28 15:33:00+8:00

クエリ期間の開始時刻。UNIX タイムスタンプまたは "%Y-%m-%d %H:%M:%S<time_zone>" フォーマットで指定します。 例: "2018-01-02 12:12:10+8:00"

--to_time

文字列

はい

2021-05-28 15:40:00+8:00

クエリ期間の終了時刻。UNIX タイムスタンプまたは "%Y-%m-%d %H:%M:%S<time_zone>" フォーマットで指定します。 例: "2018-01-02 12:12:10+8:00"

--topic

文字列

いいえ

""

ログのトピック。 デフォルトは空の文字列 ("") です。 トピック

--query

文字列

いいえ

level:Information|select event_id as Key1,COUNT(*) as Key2 group by Key1

クエリ文または分析文。 クエリと分析の概要

分析文に set session parallel_sql=true; を追加すると、専用 SQL が有効になります。 例: * | set session parallel_sql=true; select count(*) as pv

説明

query パラメーターに分析文が含まれている場合は、sizeoffset を 0 に設定し、LIMIT 句を使用してページネーションを行ってください。 クエリと分析結果のページネーション

--reverse

ブール値

いいえ

true

タイムスタンプの降順 (分単位で正確) でログを返すかどうか。

  • true: 降順。

  • false (デフォルト): 昇順。

重要
  • このパラメーターはクエリ文にのみ適用され、分析文には適用されません。

  • 分析文の場合は、ORDER BY 句を使用してソート順を制御します。 デフォルト: 昇順 (asc)。

--offset

整数

いいえ

0

クエリを開始する行。 クエリ文にのみ有効です。 デフォルト: 0。

--size

整数

いいえ

10

返すログの最大数。 クエリ文にのみ有効です。 値の範囲: 0~100。 デフォルト: 100。

--power_sql

ブール値

いいえ

false

専用 SQL を使用するかどうか。 高性能かつ完全精度のクエリと分析 (専用 SQL)

  • true: 専用 SQL を使用します。

  • false (デフォルト): 標準 SQL を使用します。

このパラメーターを true に設定するか、クエリパラメーターにディレクティブを追加することで、専用 SQL を有効にできます。

このコマンドは、グローバルパラメーターもサポートしています。

  • リクエスト例

    デフォルトアカウントを使用して、上位 20 件の POST リクエスト状態をクエリします。

    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
  • レスポンス例

    {
      "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": "*"
      }
    }

関連コマンド

コマンド

シナリオ

get_logs

JSON 設定ファイルを使用して、ログの完全一致検索を実行します。

get_log_all

大容量のログデータをクエリします。