調用CLI命令查詢目標Project下的日志,該命令是Project級別的SQL查詢命令。
注意事項
在使用CLI命令之前,您需要注意以下事項:
已創建日志服務Project、Logstore并完成日志采集。具體操作,請參見創建項目Project、創建Logstore和數據采集概述。
已創建并獲取AccessKey。更多信息,請參見訪問密鑰。
阿里云賬號AccessKey擁有所有API的訪問權限,風險很高。強烈建議您創建并使用RAM用戶進行API訪問或日常運維。RAM用戶需具備操作日志服務資源的權限。具體操作,請參見創建RAM用戶及授權。
已明確您查詢日志所屬的Project名稱、所屬地域、Logstore名稱等。如何查詢,請參見管理Project和管理Logstore。
日志服務查詢日志時存在使用限制。請設計合理查詢與分析語句、設置合理查詢區間等。更多信息,請參見查詢日志使用限制和分析日志使用限制。
查詢日志前,已配置索引。具體操作,請參見創建索引。
命令格式
aliyunlog log get_project_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>] [--profile=<value>]
命令參數
該命令的必選和特有參數描述如下。
參數名稱 | 數值類型 | 是否必選 | 示例值 | 描述 |
--request | String | 是 | file://./get_project_logs_config.json | 查詢日志的配置文件路徑。您需要在執行該命令前,創建該文件,指定Project名稱、查詢分析語句等信息。 您可以參考命令示例中說明創建該文件。
|
關于該命令的全局參數,請參見全局參數。
命令示例
創建get_project_logs_config.json文件,用于指定查詢的Project、查詢分析語句等。該query用于查詢一小時內每10分鐘的PV數量,其中ali-test-project為Project名稱,nginx-moni為Logstore名稱,query為標準的SQL查詢語句。其內容示例如下:
{ "project": "ali-test-project", "query": "select date_format(__time__-__time__%600, '%H:%i:%s') as time, COUNT(*) as pv from nginx-moni where __time__ > 1683252000 and __time__ < 1683255600 group by time order by time", "power_sql": false }
查詢目標Project下小時內每10分鐘的日志數量分布。
命令示例
aliyunlog log get_project_logs --request="file://./get_project_logs_config.json" --format-output=json,no_escape
返回示例
{ "data": [ { "__source__": "", "__time__": "1", "pv": "110", "time": "09:30:00" } ], "meta": { "aggQuery": "select date_format(__time__-__time__%600, '%H:%i:%s') as time, COUNT(*) as pv from gs-api where __time__ > 1718933444 and __time__ < 1718933864 group by time order by time", "count": 1, "cpuCores": 26, "cpuSec": 0.076, "elapsedMillisecond": 29, "hasSQL": true, "mode": 0, "processedRows": 110, "progress": "Complete", "whereQuery": "" } }
相關文檔
在調用API接口過程中,若服務端返回結果中包含錯誤信息,則表示調用API接口失敗。您可以參考API錯誤碼對照表查找對應的解決方法。更多信息,請參見API錯誤處理對照表。
阿里云OpenAPI開發者門戶提供調試、SDK、示例和配套文檔。通過OpenAPI,您無需手動封裝請求和簽名操作,就可以快速對日志服務API進行調試。更多信息,請參見OpenAPI開發者門戶。
關于該API接口的詳細信息,請參見GetProjectLogs - 獲取目標Project下的日志。