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

Simple Log Service:get_log

最終更新日:Mar 08, 2025

ログをクエリします。このコマンドは、指定された数のログをクエリする必要があるシナリオに適しています。

リクエスト構文

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

String

はい

aliyun-test-project

プロジェクトの名前。

--logstore

String

はい

logstore-a

ログストアの名前。

--from_time

String

はい

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

String

はい

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

String

いいえ

""

クエリするログのトピック。デフォルト値は二重引用符 ("") です。詳細については、「Topic」をご参照ください。

--query

String

いいえ

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

検索ステートメントまたはクエリステートメント。詳細については、「ログクエリと分析の概要」をご参照ください。

query パラメーターの値の分析文に set session parallel_sql=true; を追加すると、専用 SQL 機能が使用されます。たとえば、値を * | set session parallel_sql=true; select count(*) as pv に設定できます。

説明

query パラメーターの値に分析文を指定する場合は、line パラメーターと offset パラメーターを 0 に設定し、LIMIT 句を使用してページングクエリを実行する必要があります。分析文は SQL ステートメントです。詳細については、「ページングクエリ」をご参照ください。

--reverse

Boolean

いいえ

true

ログをログタイムスタンプの降順で返すかどうかを指定します。ログタイムスタンプの精度は分単位です。

  • true:ログはログタイムスタンプの降順で返されます。

  • false:ログはログタイムスタンプの昇順で返されます。これはデフォルト値です。

重要
  • reverse パラメーターは、query パラメーターが検索ステートメントに設定されている場合にのみ有効になります。 reverse パラメーターは、返されるログのソート順を指定します。

  • query パラメーターがクエリステートメントに設定されている場合、reverse パラメーターは無効です。返されるログのソート順は、分析文の ORDER BY 句で指定されます。ORDER BY 句でデフォルトキーワード asc を使用すると、ログは昇順でソートされます。ORDER BY 句で desc キーワードを使用すると、ログは降順でソートされます。

--offset

Integer

いいえ

0

クエリが開始される行。このパラメーターは、query パラメーターが検索ステートメントに設定されている場合にのみ有効になります。デフォルト値:0。

--size

Integer

いいえ

10

返すログの最大数。このパラメーターは、query パラメーターが検索ステートメントに設定されている場合にのみ有効になります。最小値:0。最大値:100。デフォルト値:100。

--power_sql

Boolean

いいえ

false

専用 SQL 機能を使用するかどうかを指定します。詳細については、「専用 SQL を有効にする」をご参照ください。

  • true:専用 SQL 機能が使用されます。

  • false:標準 SQL 機能が使用されます。これはデフォルト値です。

powerSql パラメーターまたは query パラメーターを使用して、専用 SQL 機能を使用するかどうかを指定できます。

このコマンドのグローバルパラメーターの詳細については、「グローバルパラメーター」をご参照ください。

  • サンプルリクエスト

    デフォルトアカウントを使用して、リクエストメソッドが POST である 20 件のイベントログをクエリします。コマンド例:

    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

多数のログをクエリします。