阿里云SLS日志查询

阿里云日志查询技能 (aliyun-sls-获取-记录) 技能描述

调用阿里云日志服务（SLS）命令行工具命令查询指定Project和记录store下的日志数据，支持基础日志查询和SQL分析查询，适用于获取指定时间范围内、指定数量的日志数据场景。

前置依赖与环境准备 系统与软件要求 依赖项 要求 操作系统 Windows、Linux、macOS Python版本 Python 2.7+ 或 Python 3.7+（推荐Python 3.7及以上） 依赖组件 docopt、aliyun-记录-python-sdk、jmespath、aliyun-python-sdk-core、aliyun-python-sdk-sts、请求s Python环境配置 Linux/macOS

创建并编辑环境变量配置文件

touch ~/.bash_性能分析 vim ~/.bash_性能分析

添加Python安装路径（替换为实际路径）

导出 PATH=$PATH:/usr/local/python3/bin

使配置生效

source ~/.bash_性能分析

Windows

右键单击「此电脑」→「属性」→「高级系统设置」→「环境变量」

在「用户变量」的「Path」中添加Python安装路径下的bin目录，例如：D:\dev\python\python37\bin

重启命令行或IDE使配置生效

命令行工具安装 通用安装命令（推荐） pip3 安装 aliyun-记录-python-sdk aliyun-记录-命令行工具 -U --no-缓存

各系统验证安装 aliyun记录 --version # 输出示例：aliyun-记录-命令行工具 0.2.9

命令行工具升级与卸载

升级到最新版本

pip3 安装 aliyun-记录-python-sdk aliyun-记录-命令行工具 -U --no-缓存

卸载命令行工具

pip3 un安装 aliyun-记录-命令行工具

命令行工具配置指南 凭证优先级（从高到低）

命令行直接传入的全局参数（--访问-id、--访问-key等）

--性能分析参数指定的阿里云命令行工具配置文件凭证

ALIYUN_记录_命令行工具系统环境变量

日志服务命令行工具配置文件（~/.aliyun记录命令行工具）

阿里云命令行工具系统环境变量（ALIBABACLOUD、ALICLOUD）

阿里云命令行工具配置文件（~/.aliyun/config.json）

配置默认账号

执行配置命令

aliyun记录 配置 "你的访问Key ID" "你的访问Key Secret" "cn-hangzhou.记录.aliyuncs.com"

验证配置 配置文件会自动生成在以下路径：

Linux/macOS：~/.aliyun记录命令行工具

Windows：C:\Users\你的用户名\.aliyun记录命令行工具 文件内容示例：

[mAIn] 访问-id = LTAI***pLMZ 访问-key = XjAsP**eRqax region-端点 = cn-hangzhou.记录.aliyuncs.com sts-令牌 =

配置多账号

执行配置命令（指定配置名称）

aliyun记录 配置 "你的访问Key ID" "你的访问Key Secret" "cn-shanghAI.记录.aliyuncs.com" "test"

使用指定账号执行命令

aliyun记录 记录 获取_记录 ... --命令行工具ent-name=test

全局输出格式配置

全局配置JSON格式化输出

aliyun记录 配置 --格式化-输出=json

全局配置不转义非英文字符（解决中文乱码）

aliyun记录 配置 --格式化-输出=no_escape

组合配置（推荐）

aliyun记录 配置 --格式化-输出=json,no_escape

特殊字符转义

当查询语句包含$、`、\、!等特殊字符时，需使用以下两种方式之一转义：

反斜线转义

--查询="event_name:\$_enter"

单引号强制引用（推荐）

--查询='event_name:$_enter'

触发词

阿里云日志查询

SLS日志查询

aliyun 记录 获取

查询阿里云日志

SLS日志分析

参数定义 业务参数 参数名 类型 是否必选 默认值 描述 project string 是 - 阿里云SLS Project名称 记录store string 是 - 阿里云SLS 记录store名称 from_time string 是 - 查询开始时间，支持两种格式：
1. Unix时间戳（秒级）
2. %Y-%m-%d %H:%M:%S 格式，如 2026-05-14 18:00:00+8:00 to_time string 是 - 查询结束时间，格式同from_time topic string 否 "" 日志主题，默认空字符串 查询 string 否 "" 查询语句或SQL分析语句，默认查询所有日志 reverse boolean 否 false 仅基础查询有效，是否按时间戳降序返回日志
true：降序
false：升序（默认） off设置 integer 否 0 仅基础查询有效，查询开始行偏移量 size integer 否 100 仅基础查询有效，返回最大日志条数，范围0-100 power_sql boolean 否 false 是否使用SQL独享版
true：使用独享版
false：使用普通版（默认） 全局参数（可选） 参数名 类型 是否必选 示例值 描述 访问-id string 否 LTAI*************** 阿里云访问Key ID，优先级高于配置文件 访问-key string 否 your访问KeySecret 阿里云访问Key Secret sts-令牌 string 否 - STS临时访问令牌 region-端点 string 否 cn-hangzhou.记录.aliyuncs.com SLS服务入口域名 命令行工具ent-name string 否 test 使用指定的多账号配置名称 性能分析 string 否 ak性能分析 使用阿里云命令行工具配置文件中的凭证 格式化-输出 string 否 json,no_escape 输出格式，支持组合：json、no_escape jmes-过滤器 string 否 "data[].状态" JMES语法表达式，过滤返回结果 decode-输出 string 否 utf8 二进制日志解码方式，支持utf8、latin1、gbk 命令模板 aliyun记录 记录 获取_记录 \ --project="{{project}}" \ --记录store="{{记录store}}" \ --from_time="{{from_time}}" \ --to_time="{{to_time}}" \ {{#if topic}}--topic="{{topic}}"{{/if}} \ {{#if 查询}}--查询="{{查询}}"{{/if}} \ {{#if reverse}}--reverse={{reverse}}{{/if}} \ {{#if off设置}}--off设置={{off设置}}{{/if}} \ {{#if size}}--size={{size}}{{/if}} \ {{#if power_sql}}--power_sql={{power_sql}}{{/if}} \ {{#if 访问-id}}--访问-id="{{访问-id}}"{{/if}} \ {{#if 访问-key}}--访问-key="{{访问-key}}"{{/if}} \ {{#if sts-令牌}}--sts-令牌="{{sts-令牌}}"{{/if}} \ {{#if region-端点}}--region-端点="{{region-端点}}"{{/if}} \ {{#if 命令行工具ent-name}}--命令行工具ent-name="{{命令行工具ent-name}}"{{/if}} \ {{#if 性能分析}}--性能分析="{{性能分析}}"{{/if}} \ {{#if jmes-过滤器}}--jmes-过滤器="{{jmes-过滤器}}"{{/if}} \ {{#if decode-输出}}--decode-输出="{{decode-输出}}"{{/if}} \ --格式化-输出={{格式化_输出|default("json,no_escape")}}

使用示例 示例1：基础日志查询（获取最近100条信息级别日志） 用户输入：查询阿里云日志 project=aliyun-test-project 记录store=记录store-a from_time="2026-05-14 18:00:00+8:00" to_time="2026-05-14 18:30:00+8:00" 查询="level:信息" reverse=true

生成命令：

aliyun记录 记录 获取_记录 \ --project="aliyun-test-project" \ --记录store="记录store-a" \ --from_time="2026-05-14 18:00:00+8:00" \ --to_time="2026-05-14 18:30:00+8:00" \ --查询="level:信息" \ --reverse=true \ --格式化-输出=json,no_escape

示例2：SQL分析查询（统计不同状态码的请求数） 用户输入：阿里云日志分析 project=aliyun-test-project 记录store=记录store-a from_time="2026-05-14 00:00:00+8:00" to_time="2026-05-14 18:30:00+8:00" 查询=" | select 状态,COUNT() as pv group by 状态 order by pv desc limit 20"

生成命令：

aliyun记录 记录 获取_记录 \ --project="aliyun-test-project" \ --记录store="记录store-a" \ --from_time="2026-05-14 00:00:00+8:00" \ --to_time="2026-05-14 18:30:00+8:00" \ --查询=" | select 状态,COUNT() as pv group by 状态 order by pv desc limit 20" \ --格式化-输出=json,no_escape

示例3：使用全局参数指定临时凭证 用户输入：SLS临时查询 proj