关于 alibabacloud-sls-alerting
此 Agent Skill 通过 Aliyun CLI 管理 Alibaba Cloud SLS 告警规则、通知配置和告警事件诊断,面向负责 SLS 可观测性配置的人员。它强调写入前读取现有配置,并在修改后回读核对。
主要功能
- 01管理告警规则
- 02管理通知对象与策略
- 03查询告警历史
- 04诊断告警触发原因
- 05写入后回读核对配置
适用场景
- 01查找或调整告警规则
- 02启用、停用或临时静默规则
- 03管理告警策略与内容模板
- 04分析告警频率和持续时间
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ aliyun/ alibabacloud-aiops-skills --skill alibabacloud-sls-alerting安装后在 Claude Code 中输入/alibabacloud-sls-alerting确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/cli-installation-guide.mdmanifest.jsonreferences/diagnosis/cause.mddiagnose.mdreferences/diagnosis/history/center.mdexecution-fields.mdproject.mdreferences/examples/latency-alert.mdreferences/notifications/manage-notifications.mdreferences/notifications/action-policies/action-conditions.mdactions.mdchannels.mdcreate-update-action-policy.mdescalation.mdmanage-action-policies.mdreferences/notifications/alert-policies/create-update-alert-policy.mdmanage-alert-policies.mdnotification-grouping.mdreferences/notifications/api/resource-records.mdreferences/notifications/objects/manage-notification-objects.mdon-call.mduser-groups.mdusers.mdreferences/notifications/objects/webhooks/bots.mdcustom-http.mdmanage-webhook-integrations.mdreferences/notifications/templates/channel-content.mdcreate-update-content-template.mdmanage-content-templates.mdsyntax.md详细介绍
Alibaba Cloud SLS 告警
前置条件
执行命令前请完成这些检查;仅需解释的请求无需配置 CLI。
安装 Aliyun CLI
运行 aliyun version,确认版本不低于 3.3.22。如果尚未安装或版本过旧,请参阅
CLI 安装指南。
更新插件
检查 aliyun sls version 和所请求命令的帮助信息。需要更新时,请更新 SLS 插件:
aliyun plugin update --name sls
选择配置文件
默认使用 CLI 已配置的配置文件;仅当用户指定配置文件时才添加 --profile。
可观测性(每条 aliyun api 命令都必须遵守)
首次调用云端之前,请阅读此技能的清单,并将其中顶层的非空字符串 version 用作 {skill-version}。如果文件或版本无效或缺失,请停止并报告;绝不可猜测。
为此技能在对话中生成一个全新的随机 32 位小写十六进制 {session-id};在操作、分页和重试时重复使用。切换技能时,请阅读所选技能的清单,并使用该技能自己的会话 ID 和版本;返回此技能时也同样如此。
每条云端 API 命令和仅发送请求的试运行都必须包含此标记。
本地的 configure、plugin、version 和帮助命令除外:
--user-agent "AlibabaCloud-Agent-Skills/alibabacloud-sls-alerting/{session-id} skill-version/{skill-version}"
将解析出的值设置为 SLS_ALERT_USER_AGENT,并用双引号括起来传入。
不要发送字面占位符、凭据或个人身份信息。
选择操作
规则定义何时触发告警。通知资源决定如何处理和发送这些告警。事件诊断用于说明已发生的告警。 阅读相应的管理或诊断条目,然后仅遵循完成所请求操作所需的参考内容。
- 管理告警规则:查找、检查、创建、 更新、禁用、启用、删除规则,或临时静默/取消静默规则。
- 管理告警通知:管理 通知对象、告警策略、行动策略和内容模板。
- 诊断告警事件:说明触发原因、频率和 持续时间,或查询告警历史记录。
技能使用问题排查
如果运行命令或捆绑脚本时遇到问题,请使用 技能使用问题排查指南。 规则行为和告警结果请参阅以上功能分支。
通用操作边界
- 替换更新前先读取现有内容,并保留无关字段。
- 执行用户请求且现有授权涵盖的更改。
- 写入后读取并核对预期字段。配置成功并不代表评估或发送成功。
- 绝不可运行
aliyun configure get。 - 绝不可从配置文件、环境变量或命令输出中提取或打印 AccessKey ID、AccessKey 密钥或 STS 令牌。绝不要要求用户粘贴凭据。让 CLI 使用其已配置的身份验证方式。
参考文档
这些参考资料适用于所有操作分支;请按需查阅。