beeline-migration

Migrates Honeycomb Beeline instrumentation to OpenTelemetry SDKs across five languages.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/krzko/pokemon-api --skill beeline-migration-krzko
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: beeline-migration
Source: https://github.com/krzko/pokemon-api/tree/main/.claude/skills/beeline-migration
Command: npx skills add https://github.com/krzko/pokemon-api --skill beeline-migration-krzko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Honeycomb Beelines have reached End of Life and are archived, so teams must migrate to OpenTelemetry without breaking distributed traces across services that still run mixed instrumentation. ## Core Features & Use Cases - Two-Phase Migration Strategy: Enable W3C trace propagation on all Beeline services first, then migrate services to OpenTelemetry one at a time without breaking trace linking. - Per-Language Migration Guides: Provides before/after code and field mappings for Go, Python, Node.js, Java, and Ruby Beelines. - Safety Checklists: Covers service-name preservation, custom field auditing, and attribute name differences between Beeline and OTel. - Use Case: A platform team running Python and Node.js services on Honeycomb Beelines uses this guide to enable W3C headers everywhere, then incrementally replace each Beeline SDK with OpenTelemetry while keeping traces connected. ## Quick Start Ask the assistant to walk you through migrating your service from Honeycomb Beeline to OpenTelemetry, starting with enabling W3C trace propagation.

Frequently Asked Questions about beeline-migration

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

FAQPage Schema
How do I migrate from Honeycomb Beeline to OpenTelemetry?▼

Migration follows two phases: first enable W3C trace propagation on every Beeline service, then replace each service's Beeline SDK with the OpenTelemetry SDK and OTLP exporter one at a time. Complete Phase 1 across all services before starting Phase 2 on any service.

What is the minimum Beeline version for W3C trace propagation?▼

Minimum versions supporting W3C headers are Go 1.4.0, Java 1.7.0, Node.js 3.2.2, Python 2.18.0, and Ruby 2.8.0. All services must run at least these versions with W3C configured before migrating any service to OpenTelemetry.

Why do traces break when migrating one service to OpenTelemetry?▼

Traces break because Beelines default to Honeycomb's proprietary header format while OpenTelemetry uses W3C TraceContext. Without W3C enabled on remaining Beeline services, trace context cannot propagate across service boundaries.

How do Beeline addField calls map to OpenTelemetry?▼

Beeline addField calls map to span.set_attribute in OpenTelemetry, with language-specific equivalents like span.SetAttributes in Go and span.setAttribute in Node.js. Audit every addField call before removing the Beeline SDK to preserve query dimensions.

Does changing the service name during migration affect Honeycomb data?▼

Yes, Honeycomb uses the service name as the dataset name, so changing OTEL_SERVICE_NAME splits telemetry into a new dataset. Keep it identical to the existing Beeline service name during migration.