Honey Explore

Creates a local web app for you to explore your schema compatible OpenTelemetry Semantic Conventions alongside your Honeycomb datasets.

All attributes are built into a namespace tree from any supplied Semantic Convention models. Each attribute has its documentation alongside Honeycomb datasets that have used it in the last 60 days. Clicking on a dataset name will take you to a query in the Honeycomb UI grouping by that attribute.

Installing

Follow the instructions on the release page. There are installers of pre-built binaries for popular OSes.

Building

If you really want to build from source and not use a pre-built binary release then firstly you'll need a Rust installation to compile it:

$ git clone https://github.com/jerbly/honey-explore.git
$ cd honey-explore
$ cargo build --release
$ ./target/release/honey-explore --version
0.1.8

Usage

Honey Explore

Usage: honey-explore [OPTIONS] --model <MODEL>...

Options:
  -m, --model <MODEL>...  Model paths
  -a, --addr <ADDR>       Address [default: 127.0.0.1:3000]
  -h, --help              Print help (see more with '--help')
  -V, --version           Print version

You must provide HONEYCOMB_API_KEY as an environment variable or in a .env file. This api key must have access to read datasets and columns, create and run queries.

You must provide at least one path to the model root directory of OpenTelemetry Semantic Convention compatible yaml files. Provide multiple root directories separated by spaces after --model. It is recommended to clone the OpenTelemetry Semantic Conventions project and add this alongside your own Semantic Conventions. The path should be prefixed with a nickname followed by a double colon. For example: honey-explore --model otel::/code/semantic-conventions/model