如何使用GetHistograms介面查詢某時間區間中日誌的分布數量 - Simple Log Service

本文通過程式碼範例介紹如何使用GetHistograms介面查詢某時間區間中日誌的分布數量。

前提條件

已建立RAM使用者並完成授權。具體操作，請參見建立RAM使用者並完成授權。
已配置環境變數ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET。具體操作，請參見在Linux、macOS和Windows系統配置環境變數。
重要
- 阿里雲帳號的AccessKey擁有所有API的存取權限，建議您使用RAM使用者的AccessKey進行API訪問或日常營運。
- 強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡，否則可能導致AccessKey泄露，威脅您帳號下所有資源的安全。
已安裝Python SDK。更多資訊，請參見安裝Python SDK。
已寫入日誌到Logstore。具體操作，請參見資料擷取概述。

注意事項

本樣本以華東1（杭州）的公網Endpoint為例，其公網Endpoint為https://cn-hangzhou.log.aliyuncs.com。如果您通過與Project同地區的其他阿里雲產品訪問Log Service，請使用內網Endpointhttps://cn-hangzhou-intranet.log.aliyuncs.com。關於Log Service支援的地區與Endpoint的對應關係，請參見服務入口。

原始日誌範例

body_bytes_sent:1750
host:www.example.com
http_referer:www.example.com
http_user_agent:Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_6_6; it-it) AppleWebKit/533.20.25 (KHTML, like Gecko) Version/5.0.4 Safari/533.20.27
http_x_forwarded_for:203.0.XX.XX
remote_addr:203.0.XX.XX
remote_user:p288
request_length:13741
request_method:GET
request_time:71
request_uri:/request/path-1/file-1
http_code:200
time_local:11/Aug/2021:06:52:27
upstream_response_time:0.66

範例程式碼

以下代碼用於查詢1分鐘內的PUT請求數量分布。

import time
import os

from aliyun.log import LogClient
from aliyun.log import GetHistogramsRequest

# 本樣本從環境變數中擷取AccessKey ID和AccessKey Secret。
accessKeyId = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID', '')
accessKey = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET', '')
# Log Service的服務存取點。此處以杭州為例，其它地區請根據實際情況填寫。
endpoint = "cn-hangzhou.log.aliyuncs.com"
# 建立Log ServiceClient。
client = LogClient(endpoint, accessKeyId, accessKey)

# Project名稱。
project_name = "ali-test-project"
# Logstore名稱。
logstore_name = "ali-test-logstore"

if __name__ == '__main__':
    # 查詢1分鐘內的PUT請求數量分布。
    query = "request_method:PUT"

    # from_time和to_time表示查詢日誌的時間範圍，Unix時間戳記格式。
    from_time = int(time.time()) - 60
    to_time = time.time()

    # 查詢請求。
    request = GetHistogramsRequest(project_name, logstore_name, from_time, to_time, "", query)
    response = client.get_histograms(request)

    # 由於區間較多，只輸出有日誌分布的區間。
    for Histogram in response.get_histograms():
        if Histogram.get_count() > 0:
            Histogram.log_print()

預期結果如下。該查詢結果說明在1分鐘內的3個時間區間的請求分別為83、32、43次，查詢結果完整。

Histogram:
from: 1671002771
to: 1671002780
count: 83
progress: Complete
Histogram:
from: 1671002790
to: 1671002800
count: 32
progress: Complete
Histogram:
from: 1671002800
to: 1671002810
count: 43
progress: Complete

Simple Log Service：使用GetHistograms查詢日誌分布數量

前提條件

注意事項

原始日誌範例

範例程式碼

相關文檔