技能名称: aliyun-sls-log-query
详细描述:
类别: 服务

SLS 日志查询与故障排查

使用 SLS 查询|分析语法和 Python SDK 进行日志搜索、过滤和分析。

前提条件

• - 安装 SDK（建议使用虚拟环境以避免 PEP 668 限制）：

bash
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -U aliyun-log-python-sdk

• - 配置环境变量：

查询组成

• - 查询子句：过滤日志（例如 status:500）。
• 分析子句：统计聚合，格式为 查询|分析。
• 示例： | SELECT status, count() AS pv GROUP BY status

完整语法请参见 references/query-syntax.md。

快速入门（Python SDK）

python
import os
import time
from aliyun.log import LogClient, GetLogsRequest

client = LogClient(
os.environ[SLS_ENDPOINT],
os.environ[ALIBABACLOUDACCESSKEYID],
os.environ[ALIBABACLOUDACCESSKEYSECRET],
)

project = os.environ[SLS_PROJECT]
logstore = os.environ[SLS_LOGSTORE]

query = status:500
start_time = int(time.time()) - 15 * 60
end_time = int(time.time())

request = GetLogsRequest(project, logstore, starttime, endtime, query=query)
response = client.get_logs(request)
for log in response.get_logs():
print(log.contents)

脚本快速入门

bash
python skills/observability/sls/aliyun-sls-log-query/scripts/query_logs.py \
--query status:500 \
--last-minutes 15

可选参数：--project、--logstore（可重复，或逗号分隔的值）、--endpoint、--start、--end、--last-minutes、--limit、--parallel。

故障排查脚本

bash
python skills/observability/sls/aliyun-sls-log-query/scripts/troubleshoot.py \
--group-field status \
--last-minutes 30 \
--limit 20

可选参数：--error-query、--group-field、--limit、--logstore（可重复，或逗号分隔的值）、--parallel，以及上述时间范围参数。

工作流程

1) 确保已启用 Logstore 索引（无索引时查询/分析会失败）。
2) 编写查询子句，并在需要时附加分析子句。
3) 使用 SDK/脚本执行并检查结果。
4) 使用 limit 控制返回行数；必要时缩小时间范围。

验证

bash
mkdir -p output/aliyun-sls-log-query
for f in skills/observability/sls/aliyun-sls-log-query/scripts/*.py; do
python3 -m py_compile $f
done
echo pycompileok > output/aliyun-sls-log-query/validate.txt

通过标准：命令退出码为 0，且生成了 output/aliyun-sls-log-query/validate.txt。

输出与证据

• - 将产物、命令输出和 API 响应摘要保存到 output/aliyun-sls-log-query/ 目录下。
• 在证据文件中包含关键参数（区域/资源 ID/时间范围），以确保可复现性。

参考资料

• - 语法和示例：references/query-syntax.md
• Python SDK 初始化和查询：references/python-sdk.md
• 故障排查模板：references/templates.md

• - 来源列表：references/sources.md