GitHunt
CB

cbartz/opentelemetry-collector-operator

This charmed operator automates the operational procedures of running OpenTelemetry Collector, an open-source telemetry collector.

OpenTelemetry Collector Operator for Machines

CharmHub Badge
Release
Discourse Status

This repository contains the source code for a Charmed Operator that drives OpenTelemetry Collector, a vendor-agnostic way to receive, process and export telemetry data, on machines (LXD, MAAS, etc).

Usage

Assuming you have access to a bootstrapped Juju controller, you can:

$ juju deploy opentelemetry-collector

The opentelemetry-collector operator for machines is a subordinate charm.

It needs to be related to a principal charm. The principal charm needs to support relations through the cost-agent or juju-info interfaces.
For example, if you have the ubuntu principal, you can relate it to this charm:

$ juju integrate ubuntu opentelemetry-collector

Given that this charm is a subordinate, it scales up and down with its principal. As a result, if the Ubuntu principal is scaled up to 2, a new machine is spun up and the opentelemetry-collector charm will be deployed in it and related to Ubuntu.

Snap

This charm uses the Opentelemetry Collector snap.
When deployed, the charm will write a configuration file for the workload based on available integrations, configurations, etc and
write it to the machine hosting the snap at /etc/otelcol/config.d.

Contributing

Please see the Juju SDK docs for guidelines on enhancements to this charm following best practice guidelines, and the contributing doc for developer guidance.

Contributors

Apache License 2.0
Created December 8, 2025
Updated March 2, 2026