SuperAPI AI 工具集

alibabacloud-sls-query

通用与其它

查看项目

更新于 10-15 16:48

技能介绍

用途:该技能用于阿里云 SLS(Simple Log Service)日志查询与分析,帮助用户解释、重写、优化或执行已有查询,并把自然语言需求转换为 SLS 索引查询、SQL 或 SPL 语句。

前置条件:需安装 Aliyun CLI,运行 aliyun version 确认版本不低于 3.3.8,否则按 references/cli-installation-guide.md 安装或更新;运行 aliyun plugin update 更新插件;运行 aliyun configure list 检查凭证,若无有效 profile 应停止并请用户在会话外执行 aliyun configure。安全规则要求绝不读取、回显或打印 AK/SK,绝不要求用户粘贴 AK/SK。

权限:查询与读取结果需 log:GetLogStoreLogs(get-logs-v2),读取索引配置需 log:GetIndex(get-index);权限失败时应停止并展示 references/ram-policies.md。

核心流程:先调用 get-index 读取索引配置(判断全文索引 line 与字段索引 keys,无索引则停止并提示先创建索引);再选择查询模式,优先索引搜索,需要聚合或字段投影时用索引搜索加 SQL,SQL scan 与 SPL 仅在用户明确要求时使用;然后编写语句、解析时间范围(--from 含、--to 不含,Unix 秒)、通过 get-logs-v2 执行、从响应提取数据并展示完整可复制的 CLI 命令与结果。

可观测性:每个调用云 API 的 aliyun 命令必须带 --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-sls-query/{session-id}",会话内生成一次 32 位小写十六进制 session-id;本地工具命令(configure、plugin、version)不支持该参数。

限制与注意:不要硬编码 time 过滤;不要调用已废弃的 get-logs,始终使用 get-logs-v2;SQL 默认返回上限 100 行,分页用 LIMIT offset, count,不支持 LIMIT count OFFSET offset;响应 meta.progress 为 Incomplete 时需重试。排查顺序为时间范围、索引配置、字段类型与统计、语法、模式选择、完整性;ProjectNotExist 需确认地域或使用跨地域发现(get-project --cross-region true 仅 cn-zhangjiakou 端点可用)。