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

Simple Log Service:get_logs

最終更新日:Sep 06, 2024

指定されたプロジェクトの指定された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 Object

課金されます

ファイル: //./getlogs.json

設定ファイルへのパス。 設定ファイルには、ログのクエリに使用されるパラメーターが含まれています。

コマンドを実行する前に、構成ファイルを作成する必要があります。 設定ファイルでは、プロジェクト、Logstore、時間範囲、およびクエリステートメントを指定する必要があります。

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

Logstore-aという名前のlogstoreの上位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"
    }

    クエリパラメーターには、Simple Log Serviceコンソールでデータのクエリに使用できる有効な検索ステートメントまたはクエリステートメントを指定することをお勧めします。 詳細については、「ログ検索の概要」および「ログ分析の概要」をご参照ください。

  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"
        }
      ],
      "meta": {
        "aggQuery": "select status,COUNT(*) as pv group by status order by pv desc limit 20",
        "columnTypes": [
          "long",
          "long"
        ],
        "count": 2,
        "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",
        "telementryType": "logging",
        "telemetryType": "logging",
        "terms": [
          {
            "key": "",
            "term": "*"
          }
        ],
        "whereQuery": "*"
      }
    }

    クエリと分析の結果には、上位3つのステータスと、各ステータスのページビュー数が表示されます。

関連ドキュメント

  • Simple Log Service CLIには、ログのクエリに使用できる次のコマンドが用意されています。 シナリオに基づいてコマンドを選択できます。

    コマンド

    シナリオ

    get_log

    指定した数のログを照会します。

    get_log_all

    多数のログを照会します。

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

  • Alibaba Cloud OpenAPI Explorerは、デバッグ機能、SDK、サンプル、および関連ドキュメントを提供します。 OpenAPI Explorerを使用して、リクエストを手動でカプセル化したり署名したりすることなく、Log Service API操作をデバッグできます。 詳細については、をご覧ください。 OpenAPIポータル

  • このコマンドに対応するAPI操作の詳細については、「GetLogs」をご参照ください。

  • Simple Log Serviceは、Simple Log Service SDK for JavaおよびSimple Log Service SDK for Pythonを使用してGetLogs APIを呼び出す方法の例を提供します。 詳細については、「GetLogsを使用してログを照会する」および「GetLogsを使用してログを照会する」をご参照ください。