调用CLI命令查询指定Logstore中满足查询语法条件的日志分布情况。

请求语法

aliyunlog log get_histograms --request=<value> [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>]

请求参数

该命令的必选和特有参数描述如下。
参数名称 数值类型 是否必选 示例值 描述
--request JSON Object file://./gethistograms.json 查询日志的配置文件路径。
关于该命令的全局参数,请参见全局参数

示例

  1. 创建gethistograms.json文件。其内容示例如下:
    {
    "topic": "",
    "logstore": "logstore-a",
    "project": "aliyun-test-project",
    "toTime": "2021-05-28 15:33:00",
    "query": "level:Information",
    "fromTime": "2021-05-28 15:18:00"
    }
    各参数说明如下:
    参数名称 描述
    topic 日志主题。
    logstore Logstore名称。
    project Project名称。
    toTime 查询结束时间点。Unix时间戳格式,表示从1970-1-1 00:00:00 UTC计算起的秒数。
    query 查询语句。仅支持查询语句,不支持分析语句。关于查询语句的详细语法,请参见查询语法
    fromTime 查询开始时间点。Unix时间戳格式,表示从1970-1-1 00:00:00 UTC计算起的秒数。
  2. 使用默认账号查询Information级别在相对时间内的分布情况。命令示例如下:
    aliyunlog log get_histograms --request="file://./gethistograms.json"
    返回结果如下:
    [
      {
        "count": 0,
        "from": 1622186280,
        "progress": "Complete",
        "to": 1622186310
      },
      {
        "count": 7,
        "from": 1622186580,
        "progress": "Complete",
        "to": 1622186610
      },
      {
        "count": 3,
        "from": 1622186610,
        "progress": "Complete",
        "to": 1622186640
      },
      {
        "count": 0,
        "from": 1622186640,
        "progress": "Complete",
        "to": 1622186670
      },
      {
        "count": 0,
        "from": 1622186670,
        "progress": "Complete",
        "to": 1622186700
      },
      {
        "count": 1,
        "from": 1622186760,
        "progress": "Complete",
        "to": 1622186790
      },
      {
        "count": 0,
        "from": 1622186790,
        "progress": "Complete",
        "to": 1622186820
      }
    ]

错误码

如果返回报错信息,请参见具体接口的错误码处理。更多信息,请参见GetHistograms错误码处理

API参考

GetHistograms