production-investigation

Diagnose production issues in Honeycomb using structured query, BubbleUp, and trace analysis workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Debugging production incidents without a structured approach leads to confirmation bias, missed root causes, and wasted hours. This Skill provides a repeatable investigation workflow for Honeycomb that chains context priming, broad queries, BubbleUp outlier analysis, trace inspection, and hypothesis verification into a reliable sequence. ## Core Features & Use Cases - Structured Investigation Workflow: A six-step loop covering orientation (SLOs, triggers, prior queries), problem characterization, BubbleUp differentiation, trace drill-down, hypothesis verification, and findings documentation via boards. - Incident Playbooks: Step-by-step guides for latency spikes, error surges, deployment regressions, dependency failures, SLO budget burn, and general health checks. - Deep Reference Guides: Detailed BubbleUp usage (selection types, pagination, result interpretation) and trace exploration (view modes, waterfall analysis, span events and links). - Use Case: Your API's P99 latency suddenly spikes after a deploy. Follow the workflow to run a heatmap query, BubbleUp the slow region to find the culprit deployment version, inspect a slow trace, and verify the hypothesis with filtered queries. ## Quick Start Ask the AI to investigate why your API latency spiked in the last hour using the Honeycomb production investigation workflow.

Frequently Asked Questions about production-investigation

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

FAQPage Schema
How do I investigate a latency spike in Honeycomb?▼

Start with a HEATMAP(duration_ms) and P99 query grouped by name, then run BubbleUp on the slow region to find differentiating fields like deployment version or endpoint. Drill into a slow trace with get_trace and verify the hypothesis with filtered queries.

What is BubbleUp in Honeycomb and how do I use it?▼

BubbleUp compares a selected subset of events against the baseline to show which fields differentiate outliers. Run it via run_bubbleup with a query_pk and a 2D heatmap or group selection, then read dimension and measure charts ranked by differentiation.

How do I find the root cause of an error surge in production?▼

Group COUNT by exception.message to categorize errors, then by service.name and http.route to find scope. Run BubbleUp comparing errored versus successful traffic, and inspect an errored trace with show_events enabled to see stack traces.

Why does BubbleUp show no signal for my query?▼

No signal usually means the selection is too broad or the anomaly is poorly isolated. Try a smaller time range, add filters to sharpen the outlier region, or select a different calculation before rerunning BubbleUp.

What should I look for in a Honeycomb trace waterfall?▼

Look for spans with disproportionate duration versus their parent, sequential spans indicating N+1 patterns, error spans with span events, and gaps between child spans suggesting missing instrumentation or idle time.

When should I skip the full investigation workflow?▼

You should not skip it, even when the cause seems obvious. BubbleUp routinely surfaces secondary causes, and verification queries protect against confirmation bias, which is strongest during incidents.