Telemetry Foundations

Overview

A shared vocabulary for observability across HVE Core agents. This skill describes what telemetry data exists and how it is named, not which SDK or vendor to use. Agents producing planning artifacts (ADRs, PRDs, security/RAI plans, code-review reports) and agents producing user-facing application code reference this skill so that downstream pipelines (traces, metrics, logs) speak a consistent OpenTelemetry-aligned language.

When to Apply

Apply this skill in the following situations:

• Any agent producing user-facing application code that emits spans, metrics, or structured logs.
• Architecture Decision Records that touch observability, monitoring, or audit logging.
• Code-review reports that flag telemetry gaps, inconsistent span naming, or unbounded metric cardinality.
• Security or Responsible AI plans that cite audit logs, traceability, or evidence chains.
• Product or business requirement documents that specify success metrics expressed as service telemetry.

Core Principles

The vocabulary in this skill follows five principles: