調用CLI命令查詢指定Project下某個Logstore中的日誌。該命令適用於精確查詢情境。在使用該命令時,您需要構造JSON格式的request請求設定檔,在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 | 是 | file://./getlogs.json | 查詢日誌的設定檔路徑。 您需要在執行該命令前,建立該檔案,指定待查詢的Project、Logstore、時間區段和查詢分析語句等。 |
關於該命令的全域參數,請參見全域參數。
命令樣本
查詢logstore-a中TOP3的狀態代碼分布情況,操作過程如下。
建立getlogs.json檔案,用於指定待查詢的Project、Logstore、時間區段和查詢分析語句等,其內容樣本如下:
{ "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" }
使用預設帳號查日誌。命令樣本如下:
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": "*" } }
以上查詢返回TOP3的status及對應的數量分布情況。
相關文檔
為便於查詢日誌,CLI提供以下命令。您可以根據情境選擇合適命令。
命令
使用情境
查詢指定數量日誌資料。
查詢大批量日誌資料。
在調用API介面過程中,若服務端返回結果中包含錯誤資訊,則表示調用API介面失敗。您可以參考API錯誤碼對照表尋找對應的解決方案。更多資訊,請參見API錯誤處理對照表。
阿里雲OpenAPI開發人員門戶提供調試、SDK、樣本和配套文檔。通過OpenAPI,您無需手動封裝請求和簽名操作,就可以快速對Log ServiceAPI進行調試。更多資訊,請參見OpenAPI開發人員門戶。
關於該API介面的詳細資料,請參見GetLogs。
Log Service提供Java和Python SDK的GetLogs查詢使用樣本。更多資訊,請參見使用GetLogs介面查詢日誌和使用GetLogs介面查詢日誌。