调用CLI命令更新快速查询。
注意事项
在使用CLI命令之前,您需要注意以下事项:
已创建并获取AccessKey。更多信息,请参见访问密钥。
阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维。RAM用户需具备操作日志服务资源的权限。具体操作,请参见创建RAM用户及授权。
已明确您查询日志所属的Project名称、所属地域、Logstore名称等。如何查询,请参见管理Project和管理Logstore。
日志服务查询日志时存在使用限制。请设计合理查询与分析语句、设置合理查询区间等。更多信息,请参见查询日志使用限制和分析日志使用限制。
命令格式
aliyunlog log update_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_update.json | 修改后的快速查询的配置文件路径。您需要在执行该命令前,创建该文件,指定快速查询名称、查询和分析语句等信息。 |
关于该命令的全局参数,请参见全局参数。
命令示例
创建savedsearch_config_update.json文件,用于指定修改后的Logstore名称(logstore)、快速查询名称(savedsearchName)、查询和分析语句(searchQuery)等信息。该快速查询用于查询每小时PV的数量,其内容示例如下:
{ "project": "ali-test-project", "savedsearchName": "pv_in_minutes", "logstore": "nginx-moni", "searchQuery": "*|select date_format(__time__-__time__%3600, '%H:%i:%s') as time, COUNT(*) as pv group by time order by time", "tokenQuery": "", "tokens": [], "topic": "" }
修改名称为pv_in_minutes的快速查询。
命令示例
aliyunlog log update_savedsearch --project="ali-test-project" --detail="file://./savedsearch_config_update.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__%3600, '%H:%i:%s') as time, COUNT(*) as pv group by time order by time", "tokenQuery": "", "tokens": [], "topic": "" }
修改快速查询后,您可以在日志服务控制台通过
查看已修改的快速查询,单击快速查询即可快速进行查询和分析操作。
相关文档
在调用API接口过程中,若服务端返回结果中包含错误信息,则表示调用API接口失败。您可以参考API错误码对照表查找对应的解决方法。更多信息,请参见API错误处理对照表。
阿里云OpenAPI开发者门户提供调试、SDK、示例和配套文档。通过OpenAPI,您无需手动封装请求和签名操作,就可以快速对日志服务API进行调试。更多信息,请参见OpenAPI开发者门户。
关于该API接口的详细信息,请参见UpdateSavedSearch - 更新快速查询。