AWS SRE 报告

当用户针对使用以下组件的栈（stack）提出 SRE 健康检查、基础设施状态、流水线报告 或 AWS 成本概览 请求时，启用此技能：

• Amazon SQS（主队列 + 死信队列 DLQ）
• AWS Lambda 函数
• Amazon CloudWatch 指标
• AWS Cost Explorer
• Amazon Bedrock（用于 AI 诊断）
• Telegram（用于通知）

所需凭证

必需的 AWS IAM 权限

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["cloudwatch:GetMetricStatistics", "cloudwatch:ListMetrics"],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": ["sqs:GetQueueAttributes", "sqs:ReceiveMessage"],
      "Resource": ""
    },
    {
      "Effect": "Allow",
      "Action": ["ce:GetCostAndUsage"],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": ["bedrock:InvokeModel"],
      "Resource": [
        "arn:aws:bedrock:*::foundation-model/anthropic.*",
        "arn:aws:bedrock:*:*:inference-profile/*"
      ]
    }
  ]
}

执行步骤

1 — 导入并配置 reporter

import { SreReporter } from "openclaw-aws-sre-report";

const reporter = new SreReporter({
  region:           process.env.AWS_REGION!,
  telegramBotToken: process.env.TELEGRAM_BOT_TOKEN!,
  telegramChatId:   process.env.TELEGRAM_CHAT_ID!,
  dlqUrl:           process.env.DLQ_URL!,
  audioQueueUrl:    process.env.AUDIO_QUEUE_URL!,
  lambdaFunctions:  process.env.LAMBDA_FUNCTIONS!.split(","),
  monthlyBudgetUsd: parseFloat(process.env.MONTHLY_BUDGET_USD ?? "50"),
  sloTarget:        parseFloat(process.env.SLO_TARGET ?? "99.5"),
});

2 — 运行报告

const report = await reporter.run();

console.log(`SLO: ${report.sloValue.toFixed(1)}%`);
console.log(`DLQ: ${report.dlqCount} 条消息`);
console.log(`Lambda 错误（24 小时内）: ${report.lambdaErrors}`);
console.log(`AWS 昨日花费: $${report.costs?.yesterday.toFixed(2) ?? "N/A"}`);

if (report.incident) {
  console.log("\n🔴 检测到事件:");
  console.log("Contexto:", report.incident.contexto);
  console.log("CTAs:", report.incident.ctas);
}

3 — Telegram 报告示例

健康流水线：

📊 AWS SRE 报告

🔋 流水线（24 小时）
  已处理: 47   DLQ: 0 ✅
  Lambda 错误: 0 ✅

📈 SLO
  可用性: 100.0% ✅（目标 99.5%）
  预算消耗: 0.0%

💰 FinOps（2026-04-12）
  AWS 总计: $2.14
  ├ Fargate/ECS: $1.68（79%）
  └ Bedrock: $0.28（13%）
  单条成本: $0.0455
  本月累计（MTD）: $21.40 / $50（43%）✅

检测到事件时：

🔴 检测到事件

Context
3 条 DLQ 消息表明流水线中存在验证错误，
该问题自昨日 14:00 UTC 起开始出现。DLQ 样本显示为 ZodError —— 很可能源于边缘场景下的非法载荷。

Findings
  ✓ 已读取 DLQ 样本：字段 "target" 上发生 ZodError（不允许为 null）

Next Actions
  1. 尾随 ECS 日志：aws logs tail /ecs/my-worker --follow --region us-east-1
  2. 检查 DLQ：aws sqs receive-message --queue-url  --region us-east-1
  3. 修复后重驱动：aws sqs start-message-move-task --source-queue-url  --destination-queue-url 

必须执行的操作（MUST DO）

• 即使 Cost Explorer 或 Bedrock 调用失败，也必须将报告发送至 Telegram；对不可用数据统一使用 "N/A"
• 切勿删除 DLQ 中的消息 —— ReceiveMessage 仅用于只读预览
• 在构建 Telegram 消息前，需对所有动态值中的 MarkdownV2 特殊字符进行转义
• 无论您的工作负载位于哪个区域，Cost Explorer 的端点一律使用 us-east-1（AWS 强制要求）

禁止执行的操作（MUST NOT DO）

• 若 Cost Explorer 返回空数据，不得中止流程 —— 24 小时延迟属正常现象，请优雅跳过 FinOps 区块
• 不得自动清空或重驱动 DLQ 消息 —— 所有相关操作必须作为运维人员可执行的 CTAs 显式呈现
• 不得硬编码任何 AWS 账户 ID、ARN 或资源名称

致谢

由 @vieiradiego 开发 —— 以开源形式回馈社区。
MIT License。