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

指定されたLogstoreで指定された検索条件を満たすログの分布を照会します。応答には、指定された時間範囲内に生成されたログの数が含まれます。

コマンド構文

aliyunlog log get_histograms --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	課金されます	ファイル: //./gethistograms.json	設定ファイルへのパス。設定ファイルには、ログのクエリに使用されるパラメーターが含まれています。

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

サンプルコマンド

この例では、サンプルの生ログが提供され、gethistograms.jsonファイルが書き込まれて、request_methodフィールドの値がPUTで、statusフィールドの値が指定された間隔内に200されているログの分布を照会します。

次のコードは、サンプルの生ログを示しています。

body_bytes_sent:1750
host:www.example.com
http_referer:www.example.com
http_user_agent:Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_6_6; it-it) AppleWebKit/533.20.25 (KHTML, like Gecko) Version/5.0.4 Safari/533.20.27
http_x_forwarded_for:203.0.103.10
remote_addr:203.0.103.10
remote_user:p288
request_length:13741
request_method:GET
request_time:71
request_uri:/request/path-1/file-1
status:200
time_local:11/Aug/2021:06:52:27
upstream_response_time:0.66

gethistograms.jsonという名前のファイルを作成して、request_methodフィールドの値がPUTで、statusフィールドの値が過去15分以内に200であるログの分布を照会します。次の例は、ファイルの内容を示しています。

{
"topic": "",
"logstore": "logstore-a",
"project": "aliyun-test-project",
"toTime": "2023-03-03 14:30:41",
"query": "request_method:PUT and status:200",
"fromTime": "2023-03-03 14:15:41"
}

下表に、各パラメーターを説明します。

パラメーター	説明
topic	ログのトピックです。
logstore	ログストアの名前
project	プロジェクトの名前。
toTime	照会する期間の終了時刻を設定します。例: 2023-03-03 14:30:41。
query	検索文。 `検索文`のみサポートされています。 `分析ステートメント`はサポートされていません。詳細については、「検索構文」をご参照ください。
fromTime	照会する期間の開始時刻です。例: 2023-03-03 14:15:41。

以下のコマンドを実行します。

aliyunlog log get_histograms --request="file://./gethistograms.json" --format-output=json

次のレスポンスは、過去15分以内に指定された条件を満たすログの分布を示しています。

[
  {
    "count": 18,
    "from": 1677824141,
    "progress": "Complete",
    "to": 1677824160
  },
  {
    "count": 37,
    "from": 1677824160,
    "progress": "Complete",
    "to": 1677824190
  },
 ......
  {
    "count": 30,
    "from": 1677825000,
    "progress": "Complete",
    "to": 1677825030
  },
  {
    "count": 0,
    "from": 1677825030,
    "progress": "Complete",
    "to": 1677825041
  }
]

Simple Log Service:get_histogs

コマンド構文

コマンドパラメーター

サンプルコマンド

関連ドキュメント