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

Simple Log Service:get_logs

最終更新日:Jun 03, 2026

プロジェクト内の指定された Logstore のログをクエリします。このコマンドは用語クエリシナリオに適しており、プロジェクト、Logstore、時間範囲、クエリおよび分析ステートメントを指定する JSON 設定ファイルを使用します。

コマンド形式

aliyunlog log get_logs --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>]

パラメーター

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

パラメーター名

データ型

必須

説明

--request

JSON オブジェクト

はい

file://./getlogs.json

JSON 設定ファイルのパス。

コマンドを実行する前に、このファイルを作成してください。このファイルには、プロジェクト、Logstore、時間範囲、クエリおよび分析ステートメントを指定します。

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

logstore-a 内で、カウントに基づいて上位 3 つのステータスコードをクエリします。

  1. 次の内容で getlogs.json という名前のファイルを作成します:

    {
    "topic": "",
    "logstore": "logstore-a",
    "project": "aliyun-test-project",
    "toTime": "2021-05-28 15:33:00",
    "offset": "0",
    "query": "*|select status,COUNT(*) as pv group by status order by pv desc limit 3",
    "line": "2",
    "fromTime": "2021-05-28 15:18:00",
    "reverse": "true"
    }

    query パラメーターには、コンソールで正常に実行される任意のクエリまたは分析ステートメントを指定できます。クエリの概要クエリと分析の概要

  2. デフォルトのアカウントでコマンドを実行します:

    aliyunlog log get_logs --request="file://./getlogs.json" --format-output=json

    応答の例:

    {
      "data": [
        {
          "__source__": "",
          "__time__": "1719382500",
          "pv": "17",
          "status": "200"
        },
        {
          "__source__": "",
          "__time__": "1719382500",
          "pv": "3",
          "status": "500"
        },
        {
          "__source__": "",
          "__time__": "1719382500",
          "pv": "1",
          "status": "404"
        }
      ],
      "meta": {
        "aggQuery": "select status,COUNT(*) as pv group by status order by pv desc limit 20",
        "columnTypes": [
          "long",
          "long"
        ],
        "count": 3,
        "cpuCores": 11,
        "cpuSec": 0.024,
        "elapsedMillisecond": 38,
        "hasSQL": true,
        "insertedSQL": "1,29, from \"logstore-a\" ",
        "isAccurate": true,
        "keys": [
          "status",
          "pv"
        ],
        "powerSql": false,
        "processedBytes": 226,
        "processedRows": 20,
        "progress": "Complete",
        "telemetryType": "logging",
        "terms": [
          {
            "key": "",
            "term": "*"
          }
        ],
        "whereQuery": "*"
      }
    }

    クエリは、上位 3 つのステータスコードとその分布を返します。

関連ドキュメント

  • 関連するログクエリコマンド:

    コマンド

    シナリオ

    get_log

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

    get_log_all

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

  • APIを呼び出した後、Log Serviceによって返された応答にエラー情報が含まれている場合、呼び出しは失敗します。 API呼び出しが失敗したときに返されるエラーコードに基づいてエラーを処理できます。 詳細については、エラーコードをご参照ください。

  • Alibaba Cloud OpenAPI Explorerは、デバッグ機能、SDK、サンプル、および関連ドキュメントを提供します。 OpenAPI Explorerを使用して、リクエストを手動でカプセル化したり署名したりすることなく、Log Service API操作をデバッグできます。 Forより情報、訪問OpenAPI Explorer

  • API リファレンス: GetLogs

  • GetLogs API の SDK の例 (Java および Python):「GetLogs API によるログのクエリ」と「GetLogs API によるログのクエリ」。