validate_telemetry

Validate local OpenTelemetry telemetry against narrative specs or health checks.

20|6|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/adrielp/ai-engineering-harness --skill validate-telemetry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate_telemetry
Source: https://github.com/adrielp/ai-engineering-harness/tree/main/claude/skills/validate_telemetry
Command: npx skills add https://github.com/adrielp/ai-engineering-harness --skill validate-telemetry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate locally emitted telemetry against a written narrative spec, or a generic health check on the local OpenTelemetry stack. Delegates to the observability-driven-development skill's Validation section.

Core Features & Use Cases

  • Activate the observability-driven-development skill and run its Validation section.
  • Validate that telemetry data and traces align with the narrative spec or pass a generic health check across the OpenTelemetry stack.
  • Use case: Verify instrumented services publish correct traces and metrics before deployment.

Quick Start

Activate the validation workflow by triggering the Validation section of the ODD skill.

Frequently Asked Questions about validate_telemetry

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why is my local OpenTelemetry stack validation not working?

Local OpenTelemetry stack validation fails if the Aspire dashboard is unreachable or the OTEL_EXPORTER_OTLP_ENDPOINT is not set. Ensure both the dashboard and endpoint environment variable are properly configured before running validation.

How do I validate OpenTelemetry traces locally before deployment?

Validate OpenTelemetry traces locally by automating the verification of emitted telemetry against a written narrative spec or passing a generic health check. This confirms instrumented services publish correct traces and metrics before deployment.

What is telemetry validation against a narrative spec?

Telemetry validation against a narrative spec is the process of checking that locally emitted traces and metrics align with expected operational behaviors. It delegates to the observability-driven-development skill's Validation section to verify correctness.

Do I need the Aspire dashboard to validate local telemetry?

You need the Aspire dashboard to be reachable and the OTEL_EXPORTER_OTLP_ENDPOINT environment variable set. An optional spec-file path can be provided to drive spec-based validation during the local health check.

Can I use this to run telemetry health checks in CI pipelines?

Yes, you can run telemetry health checks in CI pipelines to verify instrumented services. The validation process applies to CI checks and operational health assessments where confirming telemetry correctness before deployment is required.

Why is my local OpenTelemetry stack validation not working?

Local OpenTelemetry stack validation fails if the Aspire dashboard is unreachable or the OTEL_EXPORTER_OTLP_ENDPOINT is not set. Ensure both the dashboard and endpoint environment variable are properly configured before running validation.