用途:管理阿里云日志服务(SLS)的告警与通知,包括配置告警规则、管理通知资源、排查告警事件。
主要能力:
- 告警规则管理:查找、查看、创建、更新、禁用、启用、删除规则,以及临时静音/取消静音。
- 告警通知管理:管理通知对象、告警策略、行动策略和内容模板。
- 告警事件诊断:解释触发原因、频率和持续时间,或查询告警历史。
使用方式:
- 前置检查:运行 aliyun version 确认版本 >= 3.3.22;检查 aliyun sls version 及命令帮助,必要时执行 aliyun plugin update --name sls 更新插件。
- 默认使用 CLI 已配置的 profile,仅在用户指定时添加 --profile。
- 每次云 API 调用(含 dry run)必须携带 --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-sls-alerting/{session-id} skill-version/{skill-version}",其中 {skill-version} 取自技能 manifest 顶层非空字符串 version,{session-id} 为本次对话新生成的 32 位小写十六进制随机串,并在分页与重试中复用。本地 configure、plugin、version、help 命令豁免。
- 将解析后的值设置到 SLS_ALERT_USER_AGENT 并以双引号传入。
限制与边界:
- 禁止运行 aliyun configure get;禁止提取或打印 AccessKey ID、AccessKey Secret、STS token,禁止要求用户粘贴凭证,由 CLI 使用已配置的认证。
- 替换更新前先读取并保留无关字段;写入后回读比对目标字段,配置成功不代表评估或投递成功。
- 仅执行用户请求与现有授权范围内的变更。
- 参考文档涵盖 CLI 安装、区域与端点配置、相关 API、RAM 策略等。
适用场景:需要以命令行方式集中管理 SLS 告警规则、通知策略或诊断告警事件时使用。