alicloud-observability-sls-log-query

🔍 阿里云SLS智能日志排障助手

基于阿里云官方SDK的SLS日志查询技能,支持query|analysis语法进行日志检索与根因分析,适合运维排障场景。

收藏
4.1k
安装
1.8k
版本
v1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

该Skill提供阿里云日志服务(SLS)的查询与排障能力,基于Python SDK实现。用户需配置环境变量(AccessKey、Endpoint、Project、Logstore)后,可通过两种方式使用:一是直接调用Python SDK编写自定义查询逻辑,二是使用内置脚本快速执行常见查询任务。支持时间范围限定、日志过滤、统计聚合(如status:500 | SELECT status, count(*) AS pv GROUP BY status),并提供专门的排障脚本用于错误日志分组分析。

显著优点

1. 官方SDK保障:基于aliyun-log-python-sdk阿里云官方SDK,接口稳定可靠
2. 安全设计:敏感凭证通过环境变量管理,无硬编码风险

3. 双模式灵活:既支持SDK深度定制,也提供开箱即用的命令行脚本

4. 排障专用:内置troubleshoot.py脚本,支持按字段分组聚合,快速定位异常模式

5. 查询语法完整:完整支持SLS的query|analysis语法,满足从简单检索到复杂统计分析的需求

潜在缺点与局限性

1. 云平台锁定:仅支持阿里云SLS,无法跨云或对接其他日志平台
2. 只读限制:脚本设计为只读操作,无法执行写入、删除等管理操作

3. 依赖版本未锁定:安装命令使用-U标志,生产环境可能因SDK更新引入不兼容变更

4. 无权限声明:Skill本身未声明所需最小权限,需用户自行配置RAM策略

5. T3来源:由个人开发者维护,长期维护稳定性存疑

适合的目标群体

  • 阿里云SLS用户,尤其是运维工程师、SRE、后端开发人员
  • 需要快速排查线上故障、分析错误日志分布的技术团队
  • 希望将日志查询集成到自动化工作流中的DevOps工程师
  • 有一定Python基础、需要自定义查询逻辑的高级用户

使用风险

1. 凭证泄露风险:AccessKey通过环境变量传递,需确保.env文件不被误提交至代码仓库
2. 权限过大风险:若使用主账号AccessKey而非RAM子账号,可能暴露过多云资源权限

3. 查询性能风险:大范围时间查询或复杂聚合可能消耗大量SLS计算资源,产生意外费用

4. 依赖漂移风险:未锁定SDK版本可能导致行为变更,建议生产环境指定固定版本

alicloud-observability-sls-log-query 内容

agents文件夹
references文件夹
scripts文件夹
手动下载zip · 5.2 kB
openai.yamltext/plain
请选择文件