otel-name-span

Validate OpenTelemetry span names for low cardinality and semantic conventions.

10|2|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/TrogonStack/agentskills --skill otel-name-span
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: otel-name-span
Source: https://github.com/TrogonStack/agentskills/tree/main/plugins/trogonstack-otel/skills/otel-name-span
Command: npx skills add https://github.com/TrogonStack/agentskills --skill otel-name-span

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill addresses the common issue of inconsistent and high-cardinality span naming in distributed tracing, which can lead to fragmented observability data and ineffective monitoring.

Core Features & Use Cases

  • Semantic Validation: Ensures span names adhere to OpenTelemetry semantic conventions, focusing on low-cardinality patterns.
  • Attribute Guidance: Provides clear rules on separating operation types from instance-specific data like IDs or timestamps.
  • Protocol Support: Offers specific naming patterns for HTTP, Database, Messaging, and RPC operations to ensure cross-service correlation.

Quick Start

Use the otel-name-span skill to review my current span naming strategy and suggest improvements based on the provided semantic conventions.

Frequently Asked Questions about otel-name-span

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

FAQPage Schema
How do I standardize OpenTelemetry span names for low cardinality?

Standardize OpenTelemetry span names by validating them against semantic conventions, separating static operation types from dynamic instance data like IDs or timestamps to ensure low cardinality and effective distributed tracing.

What is span naming in OpenTelemetry distributed tracing?

Span naming in OpenTelemetry is the process of assigning low-cardinality, protocol-specific identifiers to telemetry operations, ensuring adherence to semantic conventions for accurate observability and cross-service correlation across distributed systems.

How do I validate span names for HTTP and database operations?

Validate span names for HTTP and database operations by applying protocol-specific naming patterns that adhere to OpenTelemetry semantic conventions, ensuring operation types are properly separated from instance-specific data to maintain low cardinality.

Why does high cardinality break observability in telemetry instrumentation?

High cardinality breaks observability by fragmenting telemetry data with unique identifiers like timestamps or IDs embedded in span names, and standardizing span naming patterns prevents this fragmentation to ensure effective distributed tracing.

Does OpenTelemetry semantic convention support RPC and messaging span patterns?

OpenTelemetry semantic conventions support specific naming patterns for RPC and messaging operations, and validating span names against these protocol-specific patterns ensures proper attribute placement and cross-service correlation in distributed systems.

What are the limitations of non-standard span naming in observability auditing?

Non-standard span naming limits observability auditing by causing fragmented monitoring data and ineffective cross-service correlation, where inconsistent span names without semantic conventions prevent accurate protocol-specific tracing and span status mapping.