1. Docs
2. API
3. Query Template Links

Query Template Links

Query Template Links allow you to define a query parameter in a Honeycomb URL. When you load this URL in your browser, it runs the specified query and displays the results. The query parameter syntax for a basic COUNT with a filter might look like this:

?query={"calculations":[{"op":"COUNT"}],"filters":[{"column":"response_time_ms","op":">","value":500}]}

For example, clicking the following URL will load a P95(response_time_ms) broken down by endpoint on our public Quick Start dataset:

https://ui.honeycomb.io/quickstart/datasets/slow-app?query={"calculations":[{"op":"P95","column":"response_time_ms"}],"breakdowns":["endpoint"]}

Getting a Query Template Link

The simplest way to get a Query Template Link is to use an existing query as a reference. Use our Query Builder to construct a useful query, then click on the Share button > Get Query Template Link to expose a modal with a copy/pastable URL.

The query parameter

The query parameter is a JSON string, optionally containing any of the keys described below. All fields are optional, but a query with no calculations values will have COUNT applied automatically.

See Query Specification for details on defining a query via JSON.