呼叫 GetHistograms 介面查詢指定 Logstore 中滿足查詢語法條件的日誌分佈情況。
介面說明
介面說明
請求語法中 Host 由 Project 名稱和日誌服務 Endpoint 構成，您需要在 Host 中指定 Project。
該介面的回應中子區間劃分方式是一直穩定的。如果您在請求查詢的時間區間不變，則回應中子區間劃分結果也不會改變。
當查詢涉及的日誌數量變化非常大時，日誌服務 API 無法預測需要呼叫多少次該介面來獲取完整結果。所以需要您查看每次請求返回結果中的 progress 成員狀態值，根據成員狀態值來確定是否需要重複呼叫該介面來獲取最終完整結果。每次重複呼叫該介面都會重新消耗相同數量的查詢 CU。
- 從日誌寫入日誌庫到查詢介面（GetHistograms 和 GetLogs）查到該日誌，延遲時間因寫入日誌類型不同而異。日誌服務按日誌時間戳把日誌分為如下兩類：
即時資料：日誌中時間點為伺服器當前時間點（-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 秒內即可查詢完畢。
日誌服務將日誌時間（欄位名稱為__time__）和伺服器收到時間（欄位名稱為__tag__:__receive_time__）做差，若其差值位於(-180 秒，900 秒]範圍，則為即時資料，若其差位於[-7x86400 秒，-180 秒），則為歷史資料。
日誌服務提供 Java SDK 的 GetHistograms 查詢使用範例。更多資訊，請參見使用 GetHistograms 查詢日誌分佈數量。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求文法
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"
}
]錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。