get_log - Simple Log Service - Alibaba Cloud ドキュメントセンター

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

リクエスト構文

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

リクエストパラメーター

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

パラメーター	データ型	必須	例	説明
-- プロジェクト	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	課金されません	""	照会するログのトピック。デフォルト値は二重引用符 ("") です。詳細については、「トピック」をご参照ください。
-- query	String	課金されません	`レベル: 情報 \| 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パラメーターの値に分析ステートメントを指定する場合は、lineパラメーターとoffsetパラメーターを0に設定し、LIMIT句を使用してページ化されたクエリを実行する必要があります。分析ステートメントはSQLステートメントです。詳細については、「ページ分割分析結果」をご参照ください。
-逆	ブール値	課金されません	true	ログタイムスタンプの降順でログを返すかどうかを指定します。ログのタイムスタンプは分単位で正確です。 true: ログはログタイムスタンプの降順で返されます。 false: ログはログタイムスタンプの昇順で返されます。デフォルト値です。重要 reverseパラメーターは、クエリパラメーターが検索文に設定されている場合にのみ有効です。 reverseパラメーターは、返されたログをソートする順序を指定します。クエリパラメーターがクエリ文に設定されている場合、reverseパラメーターは無効です。返されたログをソートする順序は、分析ステートメントのorder by句で指定します。 ORDER BY句でデフォルトのキーワードascを使用すると、ログは昇順でソートされます。 ORDER BY句でdescキーワードを使用すると、ログは降順にソートされます。
-- オフセット	Integer	課金されません	0	クエリの開始元となる行。このパラメーターは、クエリパラメーターが検索文に設定されている場合にのみ有効です。デフォルト値：0
-- サイズ	Integer	課金されません	10	返されるログの最大数。このパラメーターは、クエリパラメーターが検索文に設定されている場合にのみ有効です。最小値: 0。最大値：100。デフォルト値：100
-- power_sql	ブール値	課金されません	false	専用SQL機能を使用するかどうかを指定します。詳細については、「Dedicated 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	多数のログを照会します。