
Service Provider: OTEL Operator
An OpenMCP Service Provider that automates the deployment and lifecycle management of the OpenTelemetry Operator into Control Planes (CPs) via Helm.
Quality Criteria

| Criterion |
Status |
Notes |
| Deletion behaviour |
β |
|
| Status reporting & error messages |
β |
|
| Operation annotations |
β |
|
| API stability policy |
β |
|
| Custom CA support |
β |
|
| Release artifacts (image + OCM) |
β |
|
| Testing |
β |
|
| Ownership and maintenance docs |
β |
|
See the OpenControlPlane Quality Criteria for definitions.
Overview
This service provider installs the OpenTelemetry Operator for each CP that requests one. It uses the official opentelemetry-kube-stack Helm chart for both releases: one CRD-only release targets the CP, and one operator-only release targets the workload cluster. Once the operator is running, users can create OpenTelemetryCollector custom resources in the CP to configure and manage collector instances.
Architecture
Platform Cluster CP (per tenant)
βββββββββββββββββββββββ ββββββββββββββββββββββββββββββββββββββββββββ
β ProviderConfig β β namespace: opentelemetry-operator-systemβ
β (cluster-scoped) β β β
β - chartURL β β HelmRelease: <name>-crds β β kube-stack CRDs
β - pollInterval β β β CRDs (OpenTelemetryCollector, etc.) β
β - helmValues β β β
β - imagePullSecrets β β Workload HelmRelease: <name>-workload β β kube-stack operator
βββββββββββββββββββββββ β β
β OpenTelemetryCollector CRs β β user creates
Onboarding Cluster ββββββββββββββββββββββββββββββββββββββββββββ
ββββββββββββββββββββββββ
β OtelOperator β β one per CP
β (per-CP overrides) β
ββββββββββββββββββββββββ
Reconciliation Flow
- Set status to
Progressing
- Prepare CP ServiceAccount auth for the workload operator
- Sync image pull secrets from the platform cluster to the workload cluster (if configured)
- Create one
opentelemetry-kube-stack OCIRepository
- Install or upgrade the CP CRD-only HelmRelease (
<name>-crds)
- Install or upgrade the workload operator-only HelmRelease (
<name>-workload)
- Set status to
Ready
On deletion, the service provider uninstalls the managed Helm releases. The CRD release uses orphan deletion propagation so existing CP custom resources are not garbage-collected with the HelmRelease.
cert-manager
The OpenTelemetry Operator Helm chart supports cert-manager for webhook certificate management. By default, this service provider disables cert-manager and uses auto-generated self-signed certificates instead (admissionWebhooks.autoGenerateCert.enabled: true). This makes the operator self-contained without requiring cert-manager in the CP.
If cert-manager is available in your CPs, you can enable it via the ProviderConfig's helmValues:
spec:
helmValues:
opentelemetry-operator:
admissionWebhooks:
certManager:
enabled: true
autoGenerateCert:
enabled: false
API
OtelOperator (onboarding cluster)
Created per CP to request an OpenTelemetry Operator installation. All fields are optional overrides β defaults come from the ProviderConfig.
apiVersion: oteloperator.services.openmcp.cloud/v1alpha1
kind: OtelOperator
metadata:
name: my-cp
spec:
# opentelemetry-kube-stack chart version
version: "0.20.1"
Cluster-scoped resource that provides default values for all CPs.
apiVersion: oteloperator.services.openmcp.cloud/v1alpha1
kind: ProviderConfig
metadata:
name: otel-operator
spec:
pollInterval: 1m
chartURL: "oci://ghcr.io/open-telemetry/opentelemetry-helm-charts/opentelemetry-kube-stack"
chartPullSecret: my-registry-secret
helmValues:
opentelemetry-operator:
admissionWebhooks:
certManager:
enabled: false
autoGenerateCert:
enabled: true
Project Structure
βββ api/
β βββ v1alpha1/ # API types (OtelOperator, ProviderConfig)
β βββ crds/ # Embedded CRD manifests
βββ cmd/
β βββ service-provider-otel-operator/ # Entrypoint (init + run commands)
βββ internal/
β βββ controller/ # Reconciler (CreateOrUpdate / Delete)
β βββ helm/ # Helm SDK integration (install/upgrade/uninstall)
β βββ resources/ # Kubernetes resource helpers
β βββ constants.go # Labels
β βββ namespace.go # Namespace reconciliation
β βββ imagepullsecret.go # Image pull secret sync (platform β CP)
βββ pkg/
β βββ spruntime/ # Generic SP/PC reconciler framework
βββ test/
β βββ e2e/ # End-to-end tests
βββ hack/ # Build tooling
Development
Prerequisites
- Go 1.25+
- Task (build system)
- Docker (for building images and running e2e tests)
- Access to an OpenMCP environment (for e2e tests)
- On macOS: GNU
realpath is required for e2e tests (brew install coreutils)
Build
go build ./...
Docker
# Build image for current platform (used by e2e tests)
task build:img:build-test
Run Tests
# Unit tests
task test
# End-to-end tests (requires Docker for kind clusters)
task test-e2e
Generate CRDs and DeepCopy
task generate
task validate
CLI Flags
The service provider binary accepts a command (init or run) as its first argument, followed by flags:
| Flag |
Default |
Description |
--environment |
"" |
Name of the environment |
--provider-name |
"" |
Name of the provider resource |
--metrics-bind-address |
0 |
Address for the metrics endpoint (:8443 for HTTPS, :8080 for HTTP, 0 to disable) |
--health-probe-bind-address |
:8081 |
Address for health probe endpoint |
--leader-elect |
false |
Enable leader election |
--metrics-secure |
true |
Serve metrics via HTTPS |
--enable-http2 |
false |
Enable HTTP/2 for metrics and webhook servers |
--verbosity |
|
Logging verbosity level |
π€ Support, Feedback, Contributing
This project is open to feature requests/suggestions, bug reports etc. via GitHub issues. Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines.
π Security / Disclosure
If you find any bug that may be a security problem, please follow our instructions at in our security policy on how to report it. Please do not create GitHub issues for security-related doubts or problems.
π Code of Conduct
We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone. By participating in this project, you agree to abide by its Code of Conduct at all times.
π Licensing
"Flux" is a registered trademark of the Linux Foundation.
Copyright OpenControlPlane contributors. Please see our LICENSE for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available via the REUSE tool.
OpenControlPlane is part of ApeiroRA, an EU Important Project of Common European Interest (IPCEI-CIS).
Copyright Linux Foundation Europe. For web site terms of use, trademark policy and other project policies please see https://linuxfoundation.eu/en/policies.