isabella232 / opentelemetry-collector-configs

Honeycomb Metrics-flavored OpenTelemetry Collector configuration

👋 Hi there! If you have questions about this repository, please head on over to our Honeycomb Pollenators Slack channel and join us in the #discuss-metrics channel there -- we'll be happy to help you out!

OpenTelemetry Collector Configuration Generator

Creates a configuration file for OpenTelemetry Collector that:

• Sends OTLP metrics to Honeycomb
• Enables the hostmetrics receiver
• Transforms metrics from the hostmetrics receiver such that they generate optimally-wide Honeycomb records (see more about the event transformation here)

A current version of the config that this repository generates should be available on the Releases page.

In order to use this configuration you will need a version of opentelemetry-collector that contains the metricstransform processor and the timestamp processor. Binaries for those processors should also be available on the Releases page. However, if you would like to build your own binary, refer to this documentation.

Timestamp processor

This repository contains code for a timestamp processor for OpenTelemetry Collector, which allows rounding timestamps in metrics streams to a configurable value.

Building the config

If you'd like to build a version of the configuration yourself, clone this repo and run make config. You'll need these prerequisites available in your $PATH:

• go
• jq
• yq
• ocb built from the opentelemetry-collector-releases project

Watch updates and rebuild on changes using entr with ls | entr make.

Simulate what's happening in CircleCI with: docker run -it --mount=type=bind,source="$(pwd)",target=/home/circleci/project honeycombio/cci-go-yq /bin/bash

Releasing

Aside from the dependencies above you will also need the following:

• docker
• fpm
• gh

Make sure you have committed all code and are on an appropriate branch, then run:

./release.sh