调用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代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| log:GetLogStoreHistogram | Read |
|
| 无 |
请求语法
GET /logstores/{logstore}/index?type=histogram
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| project | string | 是 | project 名称。 | ali-test-project |
| logstore | string | 是 | Logstore 名称。 | test-logstore |
| from | long | 是 | 子时间区间的开始时间点。UNIX 时间戳格式，表示从 1970-1-1 00:00:00 UTC 计算起的秒数。 | 1409529600 |
| to | long | 是 | 子时间区间的结束时间点。UNIX 时间戳格式，表示从 1970-1-1 00:00:00 UTC 计算起的秒数。 | 1409569200 |
| topic | string | 否 | 日志主题。 | topic |
| query | string | 否 | 查询语句。仅支持查询语句，不支持分析语句。关于查询语句的详细语法，请参见查询语法。 | with_pack_meta |
返回参数
示例
正常返回示例
JSON格式
[
{
"from": 1409529600,
"to": 1409569200,
"count": 2,
"progress": "Complete"
}
]错误码
访问错误中心查看更多错误码。
| HttpStatusCode | ErrorCode | ErrorMessage | 错误码描述 |
|---|---|---|---|
| 404 | ProjectNotExist | Project does not exist. | Project 不存在。 |
| 404 | LogStoreNotExist | Logstore does not exist. | Logstore 不存在。 |
| 400 | InvalidTimeRange | request time range is invalid. | 请求的时间区间无效。 |
| 400 | InvalidQueryString | query string is invalid. | 请求的查询语句无效。 |
| 500 | InternalServerError | Specified Server Error Message. | 内部服务调用错误。 |
更多信息，请参见通用错误码。