tsuga-metric-naming-fix

Convert metric names to OpenTelemetry dot notation with evidence-based rename proposals.

2|Updated May 28, 2026
One-click install
npx skills add https://github.com/tsuga-dev/agent-plugins --skill tsuga-metric-naming-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tsuga-metric-naming-fix
Source: https://github.com/tsuga-dev/agent-plugins/tree/main/plugins/telemetry/skills/tsuga-metric-naming-fix
Command: npx skills add https://github.com/tsuga-dev/agent-plugins --skill tsuga-metric-naming-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill fixes metric names that violate OpenTelemetry conventions, preventing inconsistent dashboards, alerts, and analysis across your instrumentation.

Core Features & Use Cases

  • OTel-compliant renaming: Converts metric names to dot notation, removes service/env/version/unit prefixes, and avoids unit suffixes in names.
  • Evidence-based change planning: Lists violating metrics via Tsuga CLI, locates the exact source code call sites, and records file paths and line numbers.
  • Downstream impact guardrails: Checks monitors and dashboards for references to old metric names before presenting a confirmation prompt.
  • Safe mutation workflow: Skips metrics with no aggregation data, and requires explicit user confirmation before applying any code edits.

Quick Start

Provide the service name or metric-name filter and the source code path, then ask the AI to propose and apply OTel naming fixes for your metrics after it confirms impacted monitors and dashboards.

Frequently Asked Questions about tsuga-metric-naming-fix

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

FAQPage Schema
How do I fix metric names to follow OpenTelemetry conventions?

To fix metric names for OpenTelemetry conventions, you need to convert underscore notation to dots, remove service or environment prefixes, and strip unit suffixes like _ms or _bytes from your instrumentation code. This Skill automates that renaming process across your codebase.

Why do my OTel metrics show up with broken dashboard alerts?

Broken dashboard alerts often occur when metric names violate OTel naming conventions by using underscores or embedding environment prefixes. This Skill identifies these violations, checks downstream monitors and dashboards for references, and proposes a safe rename table before editing.

What's the best way to find code call sites for non-compliant metric instrumentation?

The best way to find non-compliant metric instrumentation call sites is to inspect the codebase using Tsuga CLI commands. This Skill locates exact file paths and line numbers for metric naming violations, providing evidence-based change planning before you apply any code refactors.

Can I automatically rename metrics without breaking existing monitors and dashboards?

You cannot automatically rename metrics without risk, because existing monitors and dashboards may reference the old names. This Skill uses Tsuga CLI to check downstream impact and requires explicit user confirmation before applying any file edits to ensure safety.

Does the OTel metric renaming process skip metrics with missing aggregation data?

Yes, the OTel metric renaming process skips metrics that have no aggregation data. This safe mutation workflow ensures the Skill only proposes renaming changes for active metrics that have clear evidence and downstream impact analysis.