Skills Development Speak Observability Setup

Speak Observability Setup

v20260311
speak-observability
Set up comprehensive observability for Speak language learning integrations, including metrics, tracing, logging, alerts, and Grafana dashboards to ensure operational health.
Get Skill
319 downloads
Overview

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.

Info
Category Development
Name speak-observability
Version v20260311
Size 4.14KB
Updated At 2026-03-12
Language