otel-migration

Guide phased OpenTelemetry retrofitting into existing uninstrumented applications.

20|7|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/honeycombio/agent-skill --skill otel-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: otel-migration
Source: https://github.com/honeycombio/agent-skill/tree/main/honeycomb/skills/otel-migration
Command: npx skills add https://github.com/honeycombio/agent-skill --skill otel-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a phased approach to retrofitting OpenTelemetry into existing, uninstrumented applications, ensuring seamless integration with existing logging and metrics.

Core Features & Use Cases

  • Phased Migration: Guides users through six distinct, independently deployable phases, from SDK initialization to metrics bridging.
  • Context Propagation: Offers detailed language-specific strategies for threading trace context through complex call chains.
  • Bridging Existing Systems: Provides instructions for integrating existing logging and Prometheus metrics with OpenTelemetry.
  • Use Case: A team needs to add observability to a legacy Java application. This Skill guides them through adding OTel SDK, instrumenting HTTP middleware, refactoring context propagation, and bridging their existing Logback logs and Prometheus metrics.

Quick Start

Use the otel-migration skill to start retrofitting OpenTelemetry into an existing application.

Frequently Asked Questions about otel-migration

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

FAQPage Schema
How do I add OpenTelemetry to an existing application with logging and metrics?

Retrofitting OpenTelemetry into existing applications follows a phased migration approach spanning six independently deployable phases. It starts with SDK initialization and progresses to instrumenting HTTP middleware and bridging existing logging and Prometheus metrics.

Can I bridge existing Prometheus metrics and logging systems with OpenTelemetry?

Yes, you can bridge existing Prometheus metrics and logging systems with OpenTelemetry. The migration provides specific instructions for integrating existing logging and metrics systems to coexist with OTel.

What is the best way to refactor function signatures for OpenTelemetry trace context threading?

The best way to refactor function signatures for trace context threading is using language-specific strategies. These strategies help thread trace context through complex call chains while integrating framework middleware for proper context propagation.

Does retrofitting observability require understanding language-specific context propagation mechanisms?

Yes, retrofitting observability requires understanding language-specific context propagation mechanisms. This knowledge is necessary to refactor function signatures for trace context threading and integrate framework middleware effectively.

How do I instrument HTTP middleware during an OpenTelemetry migration?

To instrument HTTP middleware during an OpenTelemetry migration, follow the phased deployment guide. This process integrates OTel into your application's request handling flow without disrupting current logging or metrics systems.