SuperAPI AI 工具集

observability

部署与运维

查看项目

更新于 10-16 08:05

技能介绍

用途:为生产项目建立完整可观测性,覆盖错误追踪、告警、日志与健康检查,强调“两个服务而非二十个”,面向独立开发者,尽量少服务、可用命令行管理、便于 AI 智能体接入。

主要能力:Sentry 负责错误与性能,PostHog 负责产品分析、功能开关与会话回放,Vercel 自动捕获 stdout 日志,/api/health 提供健康检查。流程为审计、规划、执行、验证四步循环:检查 Sentry 配置、健康端点、结构化日志与 PostHog 是否就位;按必需与推荐项补齐;安装依赖并配置 PII 脱敏、健康端点、JSON 日志与告警规则;最后验证错误上报、健康端点与告警是否生效。

使用方式:先建分支 git checkout -b infra/observability-$(date +%Y%m%d)。安装 Sentry 用 pnpm add @sentry/nextjs 与 npx @sentry/wizard@latest -i nextjs。技能自带脚本可检测、初始化、创建告警、验证与列出问题,例如 ~/.claude/skills/sentry-observability/scripts/detect_sentry.sh、init_sentry.sh、create_alert.sh、verify_setup.sh、list_issues.sh。AI 集成可选 Sentry MCP 服务器、Sentry webhook 触发 GitHub Action,或直接用 CLI 脚本分诊。

适用场景:Next.js 等生产应用,需要错误告警、自动创建 GitHub issue、健康检查与产品分析,并希望由 AI 智能体查询错误、分析根因、提出修复。

限制与注意:资料未提供具体收费与价格信息;PostHog 免费额度、Sentry 免费层等描述以原文为准。要求错误边界必须调用 Sentry.captureException,Next.js 应用需 app/global-error.tsx;明确不建议使用 Vercel Analytics,因其无 API、CLI 与 MCP。环境变量需配置 NEXT_PUBLIC_SENTRY_DSN、SENTRY_AUTH_TOKEN、SENTRY_ORG、SENTRY_PROJECT。