调用GetHistograms接口查询指定Logstore中满足查询语法条件的日志分布情况。
前提条件
您已完成以下操作：
开通日志服务。
初始化日志服务Python SDK。
参数说明
def get_histograms(self, request):请求参数
名称 | 类型 | 是否必填 | 说明 |
request | GetHistogramsRequest | 是 | GetHistograms请求参数类，用于查询指定Logstore中满足查询语法条件的日志分布情况。 |
GetHistogramsRequest 参数说明：
名称 | 类型 | 是否必填 | 说明 |
project | String | 是 | Project名称：项目（Project）是日志服务的资源管理单元，是进行多用户隔离与访问控制的主要边界。更多信息，请参见管理Project。 |
logstore | String | 是 | Logstore名称：Logstore是日志服务中日志数据的采集、存储和查询单元。更多信息，请参见管理Logstore。 |
fromTime | int | 是 | 子时间区间的开始时间点，使用Unix时间戳格式。 |
toTime | int | 是 | 子时间区间的结束时间点，使用Unix时间戳格式。 |
topic | String | 否 | 日志主题。默认值为空字符串。更多信息，请参见日志主题（Topic）。 |
query | String | 否 | 查询语句。更多信息，请参见查询语法与功能。 说明 此处仅支持查询语句，不支持分析语句。 |
返回参数
返回参数请参见：GetHistograms - 查询日志分布情况。
示例代码
from aliyun.log import LogClient, GetHistogramsRequest
import os
# 本示例从环境变量中获取AccessKey ID和AccessKey Secret
access_key_id = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID', '')
access_key_secret = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET', '')
# 日志服务的服务接入点
endpoint = "cn-hangzhou.log.aliyuncs.com"
client = LogClient(endpoint, access_key_id, access_key_secret)
def main():
project = "proj-test-1"
logstore = "logstore-1"
fromTime = 1728973609
toTime = 1728973612
# 实例化GetHistogramsRequest类
request = GetHistogramsRequest(project, logstore, fromTime, toTime)
# 查询日志的分布数量
response = client.get_histograms(request)
response.log_print()
if __name__ == '__main__':
main()
示例返回结果
相关文档
查询日志数据的API请参见：
GetCursor - 通过时间查询Cursor
GetCursorTime - 通过Cursor查询服务器端时间
GetLogsV2 - 查询Logstore中的日志数据
GetContextLogs - 查询上下文日志
GetHistograms - 查询日志分布情况
更多示例代码，请参见Aliyun Log Python SDK on GitHub。