調用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 } ]
相關文檔
Log Service提供Java SDK的GetHistograms查詢使用樣本。更多資訊,請參見使用GetHistograms查詢日誌分布數量。
在調用API介面過程中,若服務端返回結果中包含錯誤資訊,則表示調用API介面失敗。您可以參考API錯誤碼對照表尋找對應的解決方案。更多資訊,請參見API錯誤處理對照表。
阿里雲OpenAPI開發人員門戶提供調試、SDK、樣本和配套文檔。通過OpenAPI,您無需手動封裝請求和簽名操作,就可以快速對Log ServiceAPI進行調試。更多資訊,請參見OpenAPI開發人員門戶。
關於該API介面的詳細資料,請參見GetHistograms。