GetHistograms - 查詢日誌分布情況 - Simple Log Service

介面說明

請求文法中 Host 由 Project 名稱和Log Service Endpoint 構成，您需要在 Host 中指定 Project。
該介面的響應中子區間劃分方式是一直穩定的。如果您在請求查詢的時間區間不變，則響應中子區間劃分結果也不會改變。
當查詢涉及的日誌數量變化非常大時，Log Service API 無法預測需要調用多少次該介面來擷取完整結果。所以需要您查看每次請求返回結果中的 progress 成員狀態值，根據成員狀態值來確定是否需要重複調用該介面來擷取最終完整結果。每次重複調用該介面都會重新消耗相同數量的查詢 CU。
從日誌寫入日誌庫到查詢介面（GetHistograms 和 GetLogs）查到該日誌，延時時間長度因寫入日誌類型不同而異。Log Service按日誌時間戳記把日誌分為如下兩類：
- 即時資料：日誌中時間點為伺服器目前時間點（-180 秒，900 秒]。例如，日誌時間為 UTC 2014-09-25 12:03:00，伺服器收到時為 UTC 2014-09-25 12:05:00，則該日誌被視作即時資料處理。即時資料從寫入到在日誌查詢介面查詢到該資料的延遲為 3 秒。
- 歷史資料：日誌中時間點為伺服器目前時間點[-7x86400 秒，-180 秒）。例如，日誌時間為 UTC 2014-09-25 12:00:00，伺服器收到時為 UTC 2014-09-25 12:05:00，則該日誌被作為歷史資料處理，一般出現在補資料情境下。其中，即時資料寫入至可查詢的最大延時為 3 秒，99.9%情況下 1 秒內即可查詢完畢。

說明

Log Service將日誌時間（欄位名稱為__time__）和伺服器收到時間（欄位名稱為__tag__:__receive_time__）做差，若其差值位於(-180 秒，900 秒]範圍，則為即時資料，若其差位於[-7x86400 秒，-180 秒），則為歷史資料。

Log Service提供 Java SDK 的 GetHistograms 查詢使用樣本。更多資訊，請參見使用 GetHistograms 查詢日誌分布數量。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

GET /logstores/{logstore}/index?type=histogram HTTP/1.1

路徑參數

名稱	類型	必填	描述	樣本值
logstore	string	是	Logstore 名稱。	test-logstore

請求參數

名稱	類型	必填	描述	樣本值
project	string	是	project 名稱。	ali-test-project
from	integer	是	子時間區間的開始時間點。UNIX 時間戳記格式，表示從 1970-1-1 00:00:00 UTC 計算起的秒數。	1409529600
to	integer	是	子時間區間的結束時間點。UNIX 時間戳記格式，表示從 1970-1-1 00:00:00 UTC 計算起的秒數。	1409569200
topic	string	否	日誌主題。	topic
query	string	否	查詢語句。僅支援查詢語句，不支援分析語句。關於查詢語句的詳細文法，請參見查詢文法。	with_pack_meta

返回參數

名稱	類型	描述	樣本值
	array
	object
from	integer	子時間區間的開始時間點。UNIX 時間戳記格式，表示從 1970-1-1 00:00:00 UTC 計算起的秒數。時間區間遵循“左閉右開”原則，即該時間區間包括區間開始時間點，但不包括區間結束時間點。如果 from 和 to 的值相同，則為無效區間，函數直接返回錯誤。	1409529600
to	integer	子時間區間的結束時間點。UNIX 時間戳記格式，表示從 1970-1-1 00:00:00 UTC 計算起的秒數。時間區間遵循“左閉右開”原則，即該時間區間包括區間開始時間點，但不包括區間結束時間點。如果 from 和 to 的值相同，則為無效區間，函數直接返回錯誤。	1409569200
count	integer	該子時間區間內查詢到的日誌條數。	2
progress	string	當前查詢結果在該子時間區間內的結果是否完整。 Complete：查詢已經完成，返回結果為完整結果。 Incomplete：查詢已經完成，返回結果為不完整結果，需要重複請求以獲得完整結果。	Complete

樣本

正常返回樣本

JSON格式

[
  {
    "from": 1409529600,
    "to": 1409569200,
    "count": 2,
    "progress": "Complete"
  }
]

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。