日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

AI 助理
備案控制臺
文檔
輸入文檔關鍵字查找
首頁 日志服務 開發參考 API參考 API目錄 日志庫 GetLogs - 查詢日志庫日志

GetLogs - 查詢日志庫日志

更新時間：
產品詳情
我的收藏

查詢指定Project下某個Logstore中的日志數據。

接口說明

說明 日志服務支持創建定時 SQL 任務。具體操作，請參見創建定時 SQL 任務。
  • 請求語法中 Host 由 Project 名稱和日志服務 Endpoint 構成，您需要在 Host 中指定 Project。
  • 已創建并獲取 AccessKey。更多信息，請參見訪問密鑰。

阿里云賬號 AccessKey 擁有所有 API 的訪問權限，風險很高。強烈建議您創建并使用 RAM 用戶進行 API 訪問或日常運維。RAM 用戶需具備操作日志服務資源的權限。具體操作，請參見創建 RAM 用戶及授權。

  • 已明確您查詢日志所屬的 Project 名稱、所屬地域、Logstore 名稱等。如何查詢，請參見管理 Project和管理 Logstore。

  • 日志服務查詢日志時存在使用限制。請設計合理查詢與分析語句、設置合理查詢區間等。更多信息，請參見查詢日志使用限制和分析日志使用限制。

  • 查詢日志前，已配置索引。具體操作，請參見創建索引。

  • 當查詢涉及的日志數量變化非常大時，日志服務 API 無法預測需要調用多少次該接口來獲取完整結果。所以需要您查看每次請求返回結果中的 x-log-progress 狀態值，根據狀態值來確定是否需要重復調用該接口來獲取最終完整結果。每次重復調用該接口都會重新消耗相同數量的查詢 CU。

  • 當日志寫入到 Logstore 中，日志服務的查詢接口（GetHistograms 和 GetLogs）能夠查到該日志的延時因寫入日志類型不同而異。日志服務按日志時間戳把日志分為如下兩類：

    • 實時數據：日志中時間點為服務器當前時間點(-180 秒，900 秒]。例如，日志時間為 UTC 2014-09-25 12:03:00，服務器收到時為 UTC 2014-09-25 12:05:00，則該日志被作為實時數據處理，一般出現在正常場景下。
    • 歷史數據：日志中時間點為服務器當前時間點[-7*86400 秒，-180 秒）。例如，日志時間為 UTC 2014-09-25 12:00:00，服務器收到時為 UTC 2014-09-25 12:05:00，則該日志被作為歷史數據處理，一般出現在補數據場景下。 其中，實時數據寫入至可查詢的延時為 3 秒左右。
說明 日志服務將日志時間（字段名稱為__time__）和服務器收到時間（字段名稱為__tag__:receive_time）做差，若其差值位于(-180 秒，900 秒]范圍，則為實時數據，若其差位于[-7x86400 秒，-180 秒），則為歷史數據。

鑒權資源

下表列出了 API 對應的授權信息。您可以在 RAM 權限策略語句的 Action 元素中添加該信息，用于為 RAM 用戶或 RAM 角色授予調用此 API 的權限。

動作（Action）授權策略中的資源描述方式（Resource）
log:GetLogStoreLogsacs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

當前API暫無授權信息透出。

請求語法

GET /logstores/{logstore}?type=log HTTP/1.1

請求參數

名稱類型必填描述示例值
projectstring是

Project 名稱。

ali-test-project
logstorestring是

查詢 Logstore 中的數據。

example-logstore
frominteger是

查詢開始時間點。該時間是指寫入日志數據時指定的日志時間。

  • 請求參數 from 和 to 定義的時間區間遵循左閉右開原則，即該時間區間包括區間開始時間點，但不包括區間結束時間點。如果 from 和 to 的值相同，則為無效區間，函數直接返回錯誤。
  • Unix 時間戳格式，表示從 1970-1-1 00:00:00 UTC 計算起的秒數。
說明 如果您要確保不漏查數據，請將查詢時間對齊到分鐘級別。如果您在分析語句中設置了時間范圍，則查詢分析時以該時間范圍為準。

如果您需要精確到秒，需要在分析語句中指定時間時，使用from_unixtime 函數或to_unixtime 函數轉換下時間格式。例如：

  • * | SELECT * FROM log WHERE from_unixtime(__time__) > from_unixtime(1664186624) AND from_unixtime(__time__) < now()
  • * | SELECT * FROM log WHERE __time__ > to_unixtime(date_parse('2022-10-19 15:46:05', '%Y-%m-%d %H:%i:%s')) AND __time__ < to_unixtime(now())
1627268185
tointeger是

查詢結束時間點。該時間是指寫入日志數據時指定的日志時間。

  • 請求參數 from 和 to 定義的時間區間遵循左閉右開原則，即該時間區間包括區間開始時間點，但不包括區間結束時間點。如果 from 和 to 的值相同，則為無效區間，函數直接返回錯誤。
  • Unix 時間戳格式，表示從 1970-1-1 00:00:00 UTC 計算起的秒數。
說明 如果您要確保不漏查數據，請將查詢時間對齊到分鐘級別。如果您在分析語句中設置了時間范圍，則查詢分析時以該時間范圍為準。

如果您需要精確到秒，需要在分析語句中指定時間時，使用from_unixtime 函數或to_unixtime 函數轉換下時間格式。例如：

  • * | SELECT * FROM log WHERE from_unixtime(__time__) > from_unixtime(1664186624) AND from_unixtime(__time__) < now()
  • * | SELECT * FROM log WHERE __time__ > to_unixtime(date_parse('2022-10-19 15:46:05', '%Y-%m-%d %H:%i:%s')) AND __time__ < to_unixtime(now())
1627269085
querystring否

查詢語句或者分析語句。更多信息，請參見查詢概述和分析概述。 在 query 參數的分析語句中加上set session parallel_sql=true;，表示使用 SQL 獨享版。例如* | set session parallel_sql=true; select count(*) as pv 。常見查詢與分析問題，請參見查詢與分析日志的常見報錯。

說明 當 query 參數中有分析語句（SQL 語句）時，該接口的 line 參數和 offset 參數無效，建議設置該接口的參數為 0，需通過 SQL 語句的 LIMIT 語法實現翻頁。更多信息，請參見分頁顯示查詢分析結果。
status: 401 | SELECT remote_addr,COUNT(*) as pv GROUP by remote_addr ORDER by pv desc limit 5
topicstring否

日志主題。默認值為空字符串。更多信息，請參見日志主題（Topic）。

topic
linelong否

僅當 query 參數為查詢語句時，該參數有效，表示請求返回的最大日志條數。最小值為 0，最大值為 100，默認值為 100。分頁查詢請參見分頁顯示查詢分析結果。

100
offsetlong否

僅當 query 參數為查詢語句時，該參數有效，表示查詢開始行。默認值為 0。分頁查詢請參見分頁顯示查詢分析結果。

0
reverseboolean否

用于指定返回結果是否按日志時間戳降序返回日志，精確到分鐘級別。

  • true：按照日志時間戳降序返回日志。
  • false（默認值）：按照日志時間戳升序返回日志。
注意
  • 當 query 參數為查詢語句時，參數 reverse 有效，用于指定返回日志排序方式。
  • 當 query 參數為查詢和分析語句時，參數 reverse 無效，由 SQL 分析語句中 order by 語法指定排序方式。如果 order by 為 asc（默認），則為升序；如果 order by 為 desc，則為降序。
    •
    		false
    powerSqlboolean否

    是否使用 SQL 獨享版。更多信息，請參見開啟 SQL 獨享版。

    • true：使用 SQL 獨享版。
    • false（默認值）：使用 SQL 普通版。

    除通過 powerSql 參數配置 SQL 獨享版外，您還可以使用 query 參數。

    		false

    返回參數

    名稱類型描述示例值
    headersobject
    x-log-progressstring

    整體查詢結果的狀態，包括：

    • Complete：本次查詢已經完成，整體返回結果為完整結果。
    • Incomplete：本次查詢已經完成，整體返回結果為不完整結果，需要重復請求以獲得完整結果。
    說明 獲取日志總條數，您可以使用*|select count(*) as count獲取，也可以使用 GetHistogram 接口獲取每個區間內日志條數后自行累加。如果不需要獲取日志總條數，可修改接口中 offset 后多次執行查詢，當狀態為 Complete 且返回的行數小于請求的行數時，表示已讀完全部數據。
    		Complete
    x-log-countlong

    本次查詢請求返回的日志行數。

    說明 返回參數中不支持查詢滿足條件的日志總條數。您可以通過查詢語句查詢滿足條件的日志總條數。例如request_method:GET|select count(*) as count用于查詢 request_method 為 GET 的日志總條數。更多信息，請參見查詢與分析最佳實踐和使用 Java SDK 查詢和分析日志示例。
    		100
    x-log-processed-rowslong

    本次查詢處理的行數。

    		10000
    x-log-elapsed-millisecondlong

    本次查詢消耗的毫秒時間。

    		5
    Serverstring

    服務器名稱。

    		nginx
    Content-Typestring

    返回的響應體的內容格式。

    		application/json
    Content-Lengthstring

    響應內容長度。

    		0
    Connectionstring

    是否長鏈接。取值包括：

    • close：不是長鏈接，則每個 HTTP 請求都會重新建立 TCP 連接。
    • keep-alive：長鏈接，TCP 連接建立后保持連接狀態，節省連接所需時間和帶寬。
    		close
    Datestring

    返回響應的時間。

    		Sun, 27 May 2018 08:25:04 GMT
    x-log-requestidstring

    服務端產生的標識，該請求的唯一 ID。

    		5B0A6B60BB6EE39764D458B5
    array<object>

    日志數組 Logs，其每個元素就是一條 Log。

    object

    日志數組 Logs，其每個元素就是一條 Log。

    		[{'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}, {'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}, {'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}, {'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}, {'remote_addr': '198.51.100.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}]

    示例

    正常返回示例

    JSON格式

    [
  {
    "test": "test",
    "test2": 1
  }
]

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    HttpStatusCodeErrorCodeErrorMessage錯誤碼描述
    404ProjectNotExistProject does not exist.Project 不存在。
    404LogStoreNotExistLogstore does not exist.Logstore 不存在。
    400InvalidTimeRangeRequest time range is invalid.請求的時間區間無效。
    400InvalidQueryStringQuery string is invalid.請求的查詢分析語句無效。
    400InvalidOffsetOffset is invalid.請求的 offset 參數無效。
    400InvalidLineLine is invalid.請求的 line 參數無效。
    400InvalidReverseReverse value is invalid.Reverse 參數的值無效。
    400IndexConfigNotExistLogstore without index config.Logstore 未開啟索引。
    400ParameterInvalidErrorType:OLSQueryParseError.ErrorMessage:offset is not available for pagination in sql query, please use limit x,y syntax for pagination.當 query 參數中有分析語句（SQL 語句）時，建議設置該接口的 line 參數和 offset 參數為 0，通過 SQL 語句的 LIMIT 語法實現翻頁。
    query 參數中的 SQL 語句存在問題時，您可以參見查詢與分析日志的常見報錯進行排查。
    500InternalServerErrorSpecified Server Error Message.內部服務調用錯誤。

    更多信息，請參見通用錯誤碼。