调用create_savedsearch创建快速查询_日志服务(SLS)-阿里云帮助中心

调用CLI命令创建一个快速查询。当您需要频繁查看某一查询和分析语句的结果时，可以将该查询和分析语句保存为快速查询。

注意事项

在使用CLI命令之前，您需要注意以下事项：

已安装日志服务CLI，并完成配置。具体操作，请参见安装CLI和配置CLI。
已创建日志服务Project、Logstore并完成日志采集。具体操作，请参见创建项目Project、创建Logstore和数据采集概述。
已创建并获取AccessKey。更多信息，请参见访问密钥。
阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维。RAM用户需具备操作日志服务资源的权限。具体操作，请参见创建RAM用户及授权。
已明确您查询日志所属的Project名称、所属地域、Logstore名称等。如何查询，请参见管理Project和管理Logstore。
日志服务查询日志时存在使用限制。请设计合理查询与分析语句、设置合理查询区间等。更多信息，请参见查询日志使用限制和分析日志使用限制。

命令格式

aliyunlog log create_savedsearch --project=<value> --detail=<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>] [--profile=<value>]

命令参数

该命令的必选和特有参数描述如下。

参数名称	数值类型	是否必选	示例值	描述
--project	String	是	ali-test-project	Project名称。
--detail	String	是	file://./savedsearch_config.json	快速查询的配置文件路径。您需要在执行该命令前，创建该文件，指定快速查询名称、查询和分析语句等信息。

关于该命令的全局参数，请参见全局参数。

命令示例

创建savedsearch_config.json文件，用于指定快速查询名称、查询和分析语句等信息。该快速查询用于查询每分钟PV的数量，其内容示例如下：

{
  "project": "ali-test-project",
  "savedsearchName": "pv_in_minutes",
  "logstore": "nginx-moni",
  "searchQuery": "*|select date_format(__time__-__time__%60, '%H:%i:%s') as time, COUNT(*) as pv group by time order by time",
  "tokenQuery": "",
  "tokens": [],
  "topic": ""
}

创建一个名为pv_in_minutes的快速查询。
- 命令示例
```
aliyunlog log create_savedsearch --project="ali-test-project" --detail="file://./savedsearch_config.json"
```
- 返回示例
  命令执行成功后，无响应消息。您可以执行aliyunlog log get_savedsearch --project="ali-test-project" --entity="pv_in_minutes" --format-output=json,no_escape查询快速查询的详细信息。
```
{
  "displayName": "pv_in_minutes",
  "logstore": "nginx-moni",
  "project": "ali-test-project",
  "savedsearchName": "pv_in_minutes",
  "searchQuery": "*|select date_format(__time__-__time__%60, '%H:%i:%s') as time, COUNT(*) as pv group by time order by time",
  "tokenQuery": "",
  "tokens": [],
  "topic": ""
}
```
  您可以在日志服务控制台通过资源 > 快速查询查看已创建的快速查询，单击快速查询即可快速进行查询和分析操作。

注意事项

命令格式

命令参数

命令示例

相关文档