metrics-queries

Query OpenTelemetry metrics datasets in Honeycomb with correct syntax.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps users write correct and efficient queries for OpenTelemetry metrics datasets in Honeycomb, avoiding common pitfalls and understanding the nuances of metrics data.

Core Features & Use Cases

  • Querying Metrics Datasets: Guides users on how to correctly query metrics like gauges, counters, and histograms.
  • Understanding Temporal Aggregation: Explains default aggregations and how to override them for rates and other calculations.
  • Discovering Metrics and Attributes: Shows how to find available metrics and their associated attributes within a dataset.
  • Use Case: A user needs to find the 99th percentile of HTTP request duration for their services over the last hour. This Skill provides the exact query structure and explains why certain operations are used.

Quick Start

Use the metrics-queries skill to find the 99th percentile of http.server.duration for the service.name breakdown over the last hour.

Frequently Asked Questions about metrics-queries

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

FAQPage Schema
How do I query OpenTelemetry metrics datasets in Honeycomb?

Querying OpenTelemetry metrics in Honeycomb requires understanding correct syntax for gauges, counters, and histograms, plus overriding default temporal aggregations to calculate rates and utilization percentages accurately.

How do I calculate the 99th percentile of HTTP request duration over the last hour?

You calculate the 99th percentile of http.server.duration by querying the histogram metric and grouping by service.name to get the exact percentile breakdown for your services over the last hour.

Why do my Honeycomb metrics queries return different results than event datasets?

Honeycomb metrics queries return different results than event datasets because metrics use temporal aggregation by default, which automatically summarizes data points over time windows before applying your query operations.

How do I find available metrics and their attributes within a dataset?

You can discover available metrics and their associated attributes within a dataset by exploring the schema, which allows you to identify what OpenTelemetry instruments are available to query.

How do I override default temporal aggregation for rate calculations in Honeycomb?

You override default temporal aggregation for rate calculations by applying specific query operations that adjust how metrics data is summarized, allowing you to compute custom rates and utilization percentages instead of relying on default rollups.

What is the best way to query histogram metrics in Honeycomb?

The best way to query histogram metrics in Honeycomb is to use the correct query structure for percentile calculations, ensuring you understand how temporal aggregation affects the distribution data before applying your final aggregations.