过去一年，SLS 日志服务持续完善 CLI 与 Agent Skills，将日志采集、分析和监控等能力逐步接入 Agent 工作流。用户可以用自然语言描述业务目标，由 Agent 协同完成日志接入、监控搭建与故障排查，减少手动配置、命令编写和反复查询的工作。
目前，SLS 已提供 8 个技能，覆盖日志从产生到使用的完整生命周期：从 SDK 接入、日志采集，到日志库创建、索引配置，再到查询分析、告警、可视化和根因分析。各技能支持按需安装，并采用渐进式上下文披露，按任务需要加载相关说明，减少不必要的上下文开销。
本文将结合实际场景，介绍这些技能的功能、使用方法与最佳实践。
技能与能力总览
| 技能 | 能力 | 场景 |
| alibabacloud-sls-query | 查询与分析 | 在线日志查询与分析，支持 SLS 查询语法、SQL、SPL 多种语法；生成和优化查询语句。 |
| alibabacloud-loongcollector-ops | 日志采集 | - 在 ECS、Linux 主机、ACK 或自建 Kubernetes 上安装、升级 Logtail/LoongCollector - 管理采集配置、机器组和绑定关系 - 排查采集无数据和机器组心跳异常 |
| alibabacloud-sls-agent-workflow | 资源管理与组合任务 | SLS 技能选择与安装；创建和管理 Project、Logstore，根据任务组合日志接入、索引配置、查询分析和告警等技能。 |
| alibabacloud-sls-alerting | 告警管理与诊断 | 创建和调整告警规则，配置通知渠道、接收人和策略，支持启停、静默，结合告警历史与源日志定位触发原因。 |
| alibabacloud-sls-dashboard | 仪表盘与可视化 | 创建和修改仪表盘、图表及筛选控件，排查显示问题，管理仪表盘订阅。 |
| alibabacloud-sls-data-agent | 根因分析 | 调用 SLS Data Agent 完成取数、分析和可视化，辅助异常排查与根因分析，支持保留会话和多轮追问。 |
| alibabacloud-sls-index-config-management | 索引管理 | 管理 Logstore 索引，根据日志样本生成配置，按查询需求优化字段类型和统计配置，兼顾写入吞吐和存储成本。 |
| alibabacloud-sls-sdk-guidance | SDK 快速接入 | 根据编程语言和业务场景自动选择 SLS SDK，提供依赖安装、初始化和代码示例，支持日志写入、消费、查询、日志框架接入等能力。 |
场景示例：一句话完成 Codex 用量监控
以 Codex 用量监控为例，我们希望了解 Token 消耗在哪里、周额度还剩多少，并在额度重置时收到通知。我们可以把需求概括成如下的提示词交给 Agent：
帮我写脚本采集本机 Codex 的 Token 消耗（包括 input、output、cached 等详细信息）和当前消耗额度（定时上报），使用 aliyun cli 上报到 SLS 的 xxxx Project，创建好相应的 logstore、索引配置，然后创建一个仪表盘，包含每日、每周的 token 消耗统计、额度消耗曲线、各个维度的 token 消耗统计，最后配置一个告警， codex 周额度重置时通过邮件通知到 xxxx@example.com 邮箱内。Agent 会自动完成几个相互衔接的步骤：
- 采集与上报：将 Token 用量和额度快照写入 token-usage 日志库，持续记录消耗、剩余额度和重置时间。
- 创建 logstore 与配置索引：创建对应的 logstore， 为 Token 数量、额度百分比和时间等字段配置索引与统计能力，让这些数据可以直接查询和分析。
- 搭建仪表盘：按模型、项目和会话查看 Token 消耗，观察用量趋势，了解额度花在了哪些任务上。
- 配置告警邮件提醒：定期查询周额度记录，识别额度重置，在满足条件时发送邮件。
推荐配合 browser use、browser act、chrome use、playwright、agent browser 等能够控制浏览器的技能或者工具使用， 让 agent 能够使用浏览器验证、调整仪表盘显示细节，实现更佳的显示效果。
下面是 Agent 创建的仪表盘示意图：
下面是 Codex 重置时邮箱收到的告警截图：
通过这个例子，我们可以看到，采集、索引、查询、可视化和告警能够围绕一个业务目标协同工作。我们描述“了解用量，并在额度恢复时收到提醒”的需求，Agent 就可以将它转化为可以持续运行的监控流程。
安装与使用
使用 npx 安装技能需要 Node.js。
1. alibabacloud-sls-query
在线查询和分析 SLS 日志，支持 SLS 查询语法、SQL 和 SPL，生成和优化查询语句。可按字段检索日志，统计错误数量、接口排名和延迟变化。
安装命令：
npx -y skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-sls-query -y --full-depth场景一：统计错误接口 Top 10
查询 cn-hangzhou 的 prod-web/nginx-access，统计过去一小时各 request_uri 的
500 请求数，列出错误最多的 10 个接口，并给出查询语句和统计结果。场景二：对比延迟趋势
分析 prod-web/nginx-access 最近一小时与昨天同期的平均延迟变化，按分钟统计。参见 Query 使用文档。
2. alibabacloud-loongcollector-ops
- 在 ECS、Linux 主机、ACK 或自建 Kubernetes 上安装、升级 Logtail/LoongCollector
- 管理采集配置、机器组和绑定关系
- 排查采集无数据和机器组心跳异常
支持主机日志采集接入、采集配置调整和基础故障排查。
安装命令：
npx -y skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-loongcollector-ops -y --full-depth场景一：接入主机日志
在 cn-hangzhou 的 ECS i-example 上安装 LoongCollector，将 /var/log/nginx/access.log
采集到 prod-web/nginx-access，配置机器组和绑定，并验证 SLS 中能查到日志。场景二：排查采集无数据
cn-hangzhou 的 prod-web/nginx-access 最近没有新日志。
请检查关联采集配置、机器组绑定和成员心跳，说明异常位置及处理建议。3. alibabacloud-sls-agent-workflow
根据任务选择并组合技能，完成资源创建、日志采集、查询分析和告警配置。支持从日志库与索引创建到日志写入、查询验证的组合任务。
安装命令：
npx -y skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-sls-agent-workflow -y --full-depth场景示例：完成日志写入与查询
在 cn-hangzhou 创建 Project=demo-sls 和 Logstore=app-logs，
为 level、service、message 配置索引，写入几条测试日志，
再查询 ERROR 日志并按 service 统计数量，验证写入和查询结果。4. alibabacloud-sls-alerting
创建和调整告警规则，管理通知渠道、接收人和策略，支持启停、静默和告警降噪。结合告警历史与源日志定位触发原因，分析告警频率和持续时间。
安装命令：
npx -y skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-sls-alerting -y --full-depth场景一：创建日志告警
在 cn-hangzhou 的 prod-web 创建 web-500-alert，数据源是 nginx-access。
每 1 分钟检查过去 5 分钟的日志，status=500 的请求数不少于 100 时告警，
邮件发送给已有通知人 web-ops@example.com。场景二：分析历史告警
分析 cn-hangzhou 的 prod-web/web-500-alert 在北京时间
2026-10-08 09:00 到 10:00 的告警，核对触发原因、频率和持续时间，
并结合源日志找出错误集中的接口，给出查询证据。“每 1 分钟”是检查频率，“过去 5 分钟”是查询窗口。规则配置、执行和通知送达需分别验证。参见 Alerting 使用文档。
5. alibabacloud-sls-dashboard
创建和修改仪表盘、图表及筛选控件，排查显示问题，管理仪表盘订阅。支持将查询结果配置为监控看板，展示请求量、错误率、延迟等指标。
安装命令：
npx -y skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-sls-dashboard -y --full-depth场景一：创建请求监控看板
为 cn-hangzhou 的 prod-web/nginx-access 创建请求监控仪表盘。
展示每分钟请求量、5xx 数量和平均 request_time（单位为秒），
增加 service 筛选控件，先验证查询，再发布到 prod-web。场景二：调整已有仪表盘
读取 cn-hangzhou 的 prod-web 中仪表盘 web-overview，
新增按 request_uri 统计的错误数 Top 10 图表，保留其他图表和筛选控件，
更新后核验配置。6. alibabacloud-sls-data-agent
调用 SLS Data Agent，通过数字员工完成取数、处理、分析和可视化，辅助异常排查与根因分析，支持保留分析会话、多轮追问和日志下钻。
该技能依赖 StarOps 数字员工能力，使用前需准备可用的 StarOps 数字员工和目标 Project。
安装命令：
npx -y skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-sls-data-agent -y --full-depth场景示例：分析异常并继续下钻
使用 SLS Data Agent 和数字员工 apsara-ops，分析 cn-hangzhou 的
prod-web/nginx-access 最近一小时的请求量、错误率和延迟，
找出异常时间段，给出图表和分析结论。可以在同一会话中继续追问：
继续分析刚才的异常时间段，按接口比较错误率，找出变化最大的接口。7. alibabacloud-sls-index-config-management
管理 Logstore 索引，根据日志样本生成配置，按查询需求调整字段类型和统计配置。支持索引的查看、创建、修改和删除，以及写入吞吐和存储成本优化。
安装命令：
npx -y skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-sls-index-config-management -y --full-depth场景一：根据日志样本生成索引
为下面的日志样本生成索引配置，需要按 status 过滤、按 service 分组，
并统计 latency_ms 的平均值。先给出配置 JSON 和字段说明，不执行更新。
{"status":500,"service":"order","latency_ms":238.5,"message":"timeout"}场景二：补充分析字段
读取 cn-hangzhou 的 prod-web/app-logs 索引，为 latency_ms 配置 double 类型
并开启统计，支持平均值分析；保留其他字段配置，给出变更内容。8. alibabacloud-sls-sdk-guidance
根据编程语言和业务场景自动选择 SLS SDK，提供依赖安装、初始化和代码示例。支持日志写入、消费、查询，以及 Log4j2、Logback 等日志框架接入。
安装命令：
npx -y skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-sls-sdk-guidance -y --full-depth场景一：选择写入和消费 SDK
为 Java 17 项目选择 SLS SDK。日志需要异步批量写入，消费端需要
Consumer Group、checkpoint 和多实例负载均衡。
请给出选型理由、Maven 依赖和最小接入示例。场景二：通过 Log4j2 接入
Java 项目已有 Log4j2，希望通过 Appender 将日志发送到 cn-hangzhou 的
prod-web/app-logs。请给出 Maven 依赖和 log4j2.xml 配置。参见 SDK 集成文档。
配置凭证
SLS 技能主要依赖于 Aliyun CLI 和 SLS 插件。除静态 AccessKey 外，也支持 OAuth、EcsRamRole 等无需配置长期 AccessKey 的方式。支持所有凭证类型和配置方法参见 阿里云 CLI：配置与管理身份凭证。认证后仍需具备对应资源的 RAM 权限。
| 凭证类型 | 适用场景 | 支持非交互式配置 | 详细配置 |
| AK | 使用阿里云账号或 RAM 用户的长期访问密钥（AccessKey）直接认证。凭证永久有效，安全性相对较低。如确实要使用，建议先参考AccessKey最佳实践。 | 是 | 配置 AK 凭证 |
| OAuth | 在浏览器中以阿里云账号、RAM 用户或 SSO 登录，支持 MFA 和通行密钥（Passkey）。无需存储长期访问密钥（AccessKey），安全性高。 | 否 | 配置 OAuth 凭证 |
| EcsRamRole | 在 ECS 实例内运行 CLI 时，通过实例绑定的 RAM 角色自动获取临时安全凭证，无需配置或存储长期访问密钥（AccessKey）。 | 是 | 配置 EcsRamRole 凭证 |
| RamRoleArn | 扮演 RAM 角色并以角色身份操作资源。适合临时提权或跨账号访问场景。例如：以基础权限 RAM 用户扮演具备资源管理权限的 RAM 角色，或跨阿里云账号访问资源。使用临时安全凭证STS Token。 | 是 | 配置 RAM 角色凭证 |
| ChainableRamRoleArn | 链式角色扮演（角色链），适用于需要跨多个账号进行资源访问的场景。 | 是 | 配置 RAM 角色链凭证 |
| OIDC | 通过兼容 OIDC（OpenID Connect）协议的外部身份提供商颁发的 ID Token 进行身份认证和角色扮演。建议在开启了 RRSA（RAM Roles for Service Accounts）的 ACK/ACS Pod 中使用。 | 是 | 配置 OIDC 凭证 |
| CloudSSO | 适合开启了云 SSO 和资源目录的多账号企业环境。与 OAuth 类似，通过浏览器登录认证，属于交互式认证方式，支持 MFA。 | 否 | 配置 CloudSSO 凭证 |
| External | 调用外部可执行程序动态获取凭证（AccessKey 或临时安全令牌），适用于自定义凭证提供程序的场景。 | 是 | 配置 External 凭证 |
| CredentialsURI | 通过您提供的HTTP URI 地址获取临时安全凭证 STS Token，适用于自建凭证分发服务的场景。 | 否 | 配置 CredentialsURI 凭证 |
| StsToken | 手动提供临时安全凭证 STS Token，令牌过期后需手动更新。 | 是 | 配置 StsToken 凭证 |
| BearerToken | 使用 Bearer Token 认证阿里云 API 服务，适用于CI/CD等自动化场景。 | 是 | 配置 BearerToken 凭证 |
aliyun cli 支持将凭证信息与地域信息保存在 profile 内，来实现不同身份、地域、凭证类型的快速切换，默认的 profile 名字是 default。使用下列命令可以列出现有的 profile:
aliyun configure list这里介绍几种常用的凭证类型的配置方式，其他凭证类型和配置方法参见 阿里云 CLI：配置与管理身份凭证。
静态 AccessKey
使用静态 AccessKey 配置 profile：
aliyun configure # 配置默认 profile
aliyun configure --profile <profileName> # 配置指定名称的 profile，不存在时会自动化创建OAuth 登录授权
对于可以使用浏览器登录阿里云账号的环境（例如处于办公网的本地 mac 电脑），使用 OAuth 接入比较简单。OAuth 首次登录需要给账号授权。
之后可使用 OAuth 配置指定 profile，会自动打开浏览器进行登录授权:
aliyun configure --mode OAuth --profile <profileName>管理跨地域 Project 资源
alibabacloud-sls-query 内置了 Project 跨地域发现能力。当默认地域找不到 Project，或用户不确定 Project 所属地域时，Agent 会在全局查找该 Project，获取其 Region 和 Endpoint，并使用发现的 Endpoint 继续执行查询，免去人工查找和设置 Region 或 Endpoint。
也可以通过以下方式手动查询（需要指定 endpoint 固定为 cn-zhangjiakou.log.aliyuncs.com）
aliyun sls get-project --project <projectName> --cross-region true --endpoint cn-zhangjiakou.log.aliyuncs.com常见问题
需要提前安装 CLI 和 SLS 插件吗？
执行云端操作时需要安装。Agent 会检查 CLI 和 SLS 插件，并在缺失或版本不满足要求时提供安装、升级指引。仅解释配置或生成代码示例时无需访问云资源。参见 Query 文档和 Alerting 文档。
能使用内网、传输加速或自定义 Endpoint 吗？
支持。在需求中指定 Endpoint，例如 cn-hangzhou-intranet.log.aliyuncs.com，并确保运行环境能够访问。参见 Query FAQ。
推荐安装哪些技能？
alibabacloud-sls-query 是最推荐安装的技能，建议直接安装，对日志查询分析、生成 SQL/SPL 都有很大帮助。其他技能可根据实际需求安装。
对于诺曼底托管的日志资源如何接入？
目前 aliyun cli 暂不支持诺曼底的鉴权方式，推荐安装并使用 normandy-cli 技能，配合 alibabacloud-sls-query 技能一起使用。
总结
通过官方 CLI 和 8 个 Agent Skills，SLS 已将日志采集、SDK 接入、资源与索引管理、查询分析、告警、可视化和根因分析等能力连接起来，覆盖日志的完整生命周期。配合多种鉴权方式和跨地域资源发现，用户可以围绕业务目标组织任务，减少环境配置、命令编写和工具切换的工作。
目前，CLI 日均请求量已超过 110 万次，Skills 日均请求量已超过 50 万次。其中，CLI 日均请求量约为 2026 年 2 月的 700 倍，CLI 和 Skills 正在成为开发和运维人员使用 SLS 的日常入口。
后续，我们会进一步完善技能场景的覆盖，提升多技能协同和复杂问题分析能力，将更多经过验证的操作流程与排查经验沉淀到技能中。在提高执行准确性和可靠性的同时，持续将 SLS 打造为 AI First、Agent Native 的可观测平台，让数据、工具与产品能力能够被 Agent 自然调用和组合，充分释放 Agent 在数据分析、系统诊断和自动化运维中的潜力。
