otel_semantic_conventions

Enforce OpenTelemetry semantic conventions for telemetry attribute naming and placement.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenTelemetry semantic conventions provide standardized attribute names and placement across resource, span, and metric data, reducing ambiguity and improving observability quality.

Core Features & Use Cases

  • Standardized naming: Follow the official registry to avoid ad-hoc attribute names and reduce cardinality.
  • Placement guidance: Ensure attributes appear at the correct telemetry level (resource, scope, span, or metric) for accurate analysis.
  • Migration support: Guidance to migrate legacy attributes to current conventions with minimal disruption, plus registry namespace references.

Quick Start

Consult the official semantic conventions registry to align your telemetry attributes with the standard set and begin migrating legacy attributes.

Frequently Asked Questions about otel_semantic_conventions

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

FAQPage Schema
How do I enforce OpenTelemetry semantic conventions for telemetry attribute naming?

To enforce OpenTelemetry semantic conventions, you apply standardized attribute names from the official registry across resource, scope, span, event, log, and metric levels. This ensures correct attribute placement and reduces ambiguity in your observability data.

How do I migrate legacy OpenTelemetry attributes to the current semantic conventions registry?

Migrating legacy OpenTelemetry attributes involves referencing the current registry-backed standards to update outdated names and placements. This process provides migration guidance to transition legacy attributes with minimal disruption to existing services and deployments.

What is the correct placement for OpenTelemetry attributes across resource, span, and metric levels?

Correct OpenTelemetry attribute placement ensures attributes appear at the appropriate telemetry level, whether resource, scope, span, event, log, or metric. Proper placement guarantees accurate analysis and standardized telemetry data across libraries and deployments.

Why do my OpenTelemetry semantic conventions have high cardinality and ad-hoc attribute names?

High cardinality and ad-hoc attribute names occur when telemetry data lacks standardized naming. Following the official OpenTelemetry semantic conventions registry avoids custom attributes and reduces cardinality by enforcing consistent naming across your telemetry pipeline.

Can I apply OpenTelemetry semantic conventions across multiple services and libraries?

Yes, OpenTelemetry semantic conventions can be applied across services, libraries, and deployments. Standardized naming and correct attribute placement are enforced universally to ensure consistent telemetry data across your entire distributed system.

When do I need to standardize OpenTelemetry telemetry attributes using semantic conventions?

You need to standardize OpenTelemetry telemetry attributes when you want to reduce ambiguity and improve observability quality. Applying semantic conventions ensures standardized naming and correct attribute placement for accurate telemetry analysis.