技能 编程开发 Speak 可观测性集成

Speak 可观测性集成

v20260311
speak-observability
为 Speak 语言学习集成部署全面的可观测性,涵盖指标、追踪、结构化日志、告警和 Grafana 仪表盘,保障服务健康。
获取技能
319 次下载
概览

Speak Observability

Overview

Set up comprehensive observability for Speak language learning integrations.

Prerequisites

  • Prometheus or compatible metrics backend
  • OpenTelemetry SDK installed
  • Grafana or similar dashboarding tool
  • AlertManager configured

Instructions

  1. Key Metrics for Language Learning
  2. Prometheus Metrics Implementation
  3. Instrumented Speak Client
  4. Distributed Tracing
  5. Structured Logging
  6. Alert Configuration
  7. Grafana Dashboard

For full implementation details, load: Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)

Output

  • Business and technical metrics
  • Distributed tracing configured
  • Structured logging implemented
  • Alert rules deployed
  • Grafana dashboard ready

Error Handling

Issue Cause Solution
Missing metrics No instrumentation Wrap client calls
Trace gaps Missing propagation Check context headers
Alert storms Wrong thresholds Tune alert rules
High cardinality Too many labels Reduce label values

Examples

Quick Metrics Endpoint

app.get('/metrics', async (req, res) => {
  res.set('Content-Type', registry.contentType);
  res.send(await registry.metrics());
});

Resources

Next Steps

For incident response, see speak-incident-runbook.

信息
Category 编程开发
Name speak-observability
版本 v20260311
大小 4.14KB
更新时间 2026-03-12
语言