What problem does it solve?
Teams producing observability instrumentation often end up with inconsistent span names, unbounded metric cardinality, and accidental PII leakage across services. This Skill provides a shared, declarative telemetry vocabulary so agents and developers emit traces, metrics, and logs that follow one OpenTelemetry-aligned standard.
Core Features & Use Cases
- Trace, Metric, and Log Vocabulary: Standardized span kinds, span naming patterns (
<verb>.<resource>), metric instrument types with UCUM units, and OTel log severity levels with trace correlation fields.
- PII Denylist with Redaction Strategies: A default-deny list of sensitive fields (emails, tokens, payment data) with hash, drop, and tokenize redaction patterns.
- Sampling and Cardinality Guidance: Parent-based and tail-based sampling defaults plus cardinality discipline to control telemetry cost.
- Use Case: When writing an ADR or code-review report that touches observability, apply this vocabulary so every service names spans like
get.order and metrics like http.server.request.duration consistently, and never emits raw user emails as attributes.
Quick Start
Ask the agent to apply the telemetry-foundations conventions when instrumenting a new service endpoint with spans, metrics, and structured logs.