Queries logs. This command is suitable for scenarios in which you need to query a large number of logs.

Request syntax

aliyunlog log get_log_all --project=<value> --logstore=<value> --from_time=<value> --to_time=<value> [--topic=<value>] [--query=<value>] [--reverse=<value>] [--offset=<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 parameters

The following table describes the required and unique parameters of this command.
ParameterTypeRequiredExampleDescription
--projectStringYesaliyun-test-projectThe name of the project.
--logstoreStringYeslogstore-aThe name of the Logstore.
--from_timeStringYes2021-05-28 15:33:00+8:00The beginning of the time range to query. Specify the value as a UNIX timestamp or in the "%Y-%m-%d %H:%M:%S<time_zone>" format. Example: “2018-01-02 12:12:10+8:00“.
--to_timeStringYes2021-05-28 15:40:00+8:00The end of the time range to query. Specify the value as a UNIX timestamp or in the "%Y-%m-%d %H:%M:%S<time_zone>" format. Example: “2018-01-02 12:12:10+8:00“.
--topicStringNo""The topic of the logs. For more information, see Topic.
--queryStringNolevel:Information|select event_id as Key1,COUNT(*) as Key2 group by Key1The query statement. For more information, see Log search overview and Log analysis overview.
Note If you specify an analytic statement in the value of the query parameter, you must set the line and offset parameters to 0 and use the LIMIT clause to perform a paged query. An analytic statement is an SQL statement. For more information, see Paging of analysis results.
--reverseBooleanNotrueSpecifies whether to return logs in reverse chronological order by log timestamp. The log timestamps are accurate to minutes.
  • true: Logs are returned in reverse chronological order by log timestamp. The latest log is returned first.
  • false: Logs are returned in chronological order by log timestamp. This is the default value.
--offsetIntegerNo0The row from which the query starts. Default value: 0.
For more information about the global parameters of this command, see Global parameters.

Examples

  • Sample requests
    Use the default account to query the event logs whose level is Information and determine the number of returned logs. Command example:
    aliyunlog log get_log_all --project="aliyun-test-project" --logstore="logstore-a" --from_time="2021-05-28 15:33:00+8:00" --to_time="2021-05-28 15:40:00+8:00" --query="level:Information|select event_id as Key1,COUNT(*) as Key2 group by Key1" --reverse=true
  • Sample responses
    [
  {
    "Key1": "16394",
    "Key2": "1",
    "__source__": "",
    "__time__": "1622186400"
  },
  {
    "Key1": "44",
    "Key2": "1",
    "__source__": "",
    "__time__": "1622186400"
  },
  {
    "Key1": "7036",
    "Key2": "7",
    "__source__": "",
    "__time__": "1622186400"
  },
  {
    "Key1": "16384",
    "Key2": "1",
    "__source__": "",
    "__time__": "1622186400"
  },
  {
    "Key1": "43",
    "Key2": "1",
    "__source__": "",
    "__time__": "1622186400"
  },
  {
    "Key1": "19",
    "Key2": "1",
    "__source__": "",
    "__time__": "1622186400"
  }
]
  • Download example
    Use the get_log_all command to download logs to your computer. Command example:
    aliyunlog log get_log_all --project="aliyun-test-project" --logstore="logstore-a" --from_time="2022-12-29 15:54:31" --to_time="2022-12-29 16:09:31" --query="status:200|select request_method as method,COUNT(*) as pv group by method order by pv" --format-output=json >>download_data.txt
  • Download description
    After the command is run, the download_data.txt file is generated in the root directory where the command is run. You can view the downloaded logs in the file. 
    [
  {
    "__source__": "",
    "__time__": "1672905271",
    "method": "HEAD",
    "pv": "21"
  },
  {
    "__source__": "",
    "__time__": "1672905271",
    "method": "DELETE",
    "pv": "502"
  },
  {
    "__source__": "",
    "__time__": "1672905271",
    "method": "PUT",
    "pv": "1275"
  },
  {
    "__source__": "",
    "__time__": "1672905271",
    "method": "POST",
    "pv": "1279"
  },
  {
    "__source__": "",
    "__time__": "1672905271",
    "method": "GET",
    "pv": "5226"
  }
]

Related commands

CommandDescription
get_logsQueries logs in exact match mode by using a JSON configuration file.
get_logQueries a specified number of logs.