調用get_histograms命令查詢指定Logstore中滿足查詢文法條件的日誌分布情況 - Simple Log Service

調用CLI命令查詢指定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	是	file://./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.*.10
remote_addr:203.0.*.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檔案，用於查詢15分鐘內request_method為PUT且status狀態為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	Logstore名稱。
project	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_histograms

命令格式

命令參數

命令樣本

相關文檔