用途:为 Evernote 集成搭建完整的可观测性体系,包括 API 调用监控、结构化日志、分布式追踪、健康检查与告警。适用于需要监控、日志、追踪或告警 Evernote 应用的场景。
主要能力:
- 指标采集:用 Prometheus counter 与 histogram 跟踪 evernote_api_calls_total(按 method/status)、evernote_api_duration_seconds(延迟直方图,桶为 0.1/0.5/1/2/5/10)、evernote_rate_limits_total(限流次数)、evernote_quota_usage_bytes(上传配额消耗)。
- 埋点客户端:用 Proxy 包装 NoteStore,自动为每次 API 调用记录指标,成功/失败递增计数、观测延迟、统计限流事件。
- 结构化日志:JSON 格式,统一字段 timestamp、level、method、duration、userId(哈希后)、noteGuid,并从所有日志输出中去除访问令牌。
- 健康检查:实现 /health(存活:进程是否运行)与 /ready(就绪:能否访问 Evernote API),含缓存连通性检查。
- 告警规则:Prometheus 告警,如 10 分钟内限流 > 5 次、API 错误率 > 10%、p95 延迟 > 5 秒、配额使用 > 90%。
前置条件:监控基础设施(Prometheus、Datadog 或 CloudWatch)、日志聚合(ELK、Loki 或 CloudWatch Logs)、告警系统(PagerDuty、Opsgenie 或 Slack webhook)。
常见问题:指标端点未被抓取(在 Prometheus 抓取配置中添加服务);缺少追踪上下文(在创建 Evernote 客户端前初始化 tracer);日志量过大(对 debug 日志采样,错误与限流始终记录);告警疲劳(依据基线指标调整阈值)。
限制:官方页面仅提供部分代码片段,完整指标配置、Grafana 仪表盘 JSON、追踪配置与告警规则需参考 Implementation Guide;本技能的具体安装命令暂未提供。