From 464f21acefb39af4bfc3a90585f9371b90e42285 Mon Sep 17 00:00:00 2001 From: Johannes Ott Date: Fri, 7 Aug 2026 16:25:18 +0200 Subject: [PATCH 1/7] docs(metrics-operator): add service-provider-metrics-operator to examples, CRD browser, and configure guide Signed-off-by: Johannes Ott --- .../serviceprovider/06-examples.mdx | 14 +++++++ docs/reference/services/metrics-operator.md | 42 +++++++++++++++++++ docs/users/getting-started/03-configure.md | 28 +++++++++++++ 3 files changed, 84 insertions(+) create mode 100644 docs/reference/services/metrics-operator.md diff --git a/docs/developers/serviceprovider/06-examples.mdx b/docs/developers/serviceprovider/06-examples.mdx index a4364183..72b1cc48 100644 --- a/docs/developers/serviceprovider/06-examples.mdx +++ b/docs/developers/serviceprovider/06-examples.mdx @@ -115,6 +115,20 @@ Community Service Providers that extend OpenControlPlane. Use these as inspirati +
+
+ +

service-provider-metrics-operator

+
+
+ Integrates the Prometheus metrics-operator into OpenControlPlane for metrics collection and alerting on managed workloads. +
+
+ GitHub + CRD Browser +
+
+ ## Community Service Providers diff --git a/docs/reference/services/metrics-operator.md b/docs/reference/services/metrics-operator.md new file mode 100644 index 00000000..8c1d88e6 --- /dev/null +++ b/docs/reference/services/metrics-operator.md @@ -0,0 +1,42 @@ +--- +sidebar_position: 7 +id: metrics-operator +--- + +import CRDViewerCompact from '@site/src/components/CRDViewerCompact'; + +# Metrics Operator + +
+ Metrics Operator +
+

Delivers the Prometheus metrics-operator as a service within ControlPlanes, enabling metrics collection and alerting for managed workloads.

+
+
+ +**API Group:** `metrics.services.open-control-plane.io` +**API Version:** `v1alpha1` +**Kind:** `MetricsOperator` + + + +## Usage + +Deploy the metrics-operator within a control plane: + +```yaml +apiVersion: metrics.services.open-control-plane.io/v1alpha1 +kind: MetricsOperator +metadata: + name: my-controlplane + namespace: project-platform-team--ws-dev +spec: + version: "v0.13.0" +``` + +The MetricsOperator service provider manages the installation and lifecycle of [metrics-operator](https://github.com/openmcp-project/service-provider-metrics-operator) within your ControlPlane, enabling Prometheus-based metrics collection and alerting for managed workloads. diff --git a/docs/users/getting-started/03-configure.md b/docs/users/getting-started/03-configure.md index 7cdce602..4b061025 100644 --- a/docs/users/getting-started/03-configure.md +++ b/docs/users/getting-started/03-configure.md @@ -222,6 +222,33 @@ kubectl apply -f external-secrets.yaml Once installed, you can create `SecretStore` and `ExternalSecret` resources on the ControlPlane to pull secrets from your chosen backend. + + + +[Metrics Operator](https://github.com/openmcp-project/service-provider-metrics-operator) installs the Prometheus-based metrics-operator into your ControlPlane, enabling metrics collection and alerting for managed workloads. + +To install the Metrics Operator, create a `MetricsOperator` resource in the same namespace as your ControlPlane: + +:::apply-to-onboarding-api + +```yaml +apiVersion: metrics.services.open-control-plane.io/v1alpha1 +kind: MetricsOperator +metadata: + name: my-controlplane + namespace: project-platform-team--ws-dev +spec: + version: "v0.13.0" +``` + +```bash +kubectl apply -f metrics-operator.yaml +``` + +::: + +The chart version and Helm values are configured by your platform owner via the `ProviderConfig`. See the [MetricsOperator CRD reference](/reference/services/metrics-operator) for the full API. + @@ -282,3 +309,4 @@ Congratulations! You have a working ControlPlane with managed services. Here's w - **[Flux Service Provider](https://github.com/openmcp-project/service-provider-flux)** — GitOps-driven continuous delivery - **[Velero Service Provider](https://github.com/openmcp-project/service-provider-velero)** — Backup and disaster recovery - **[External Secrets Service Provider](https://github.com/openmcp-project/service-provider-external-secrets)** — Sync secrets from external vaults +- **[Metrics Operator Service Provider](https://github.com/openmcp-project/service-provider-metrics-operator)** — Prometheus metrics collection and alerting From 290c7684b81908536bf36c2884db96e09a79c593 Mon Sep 17 00:00:00 2001 From: Maximilian Techritz Date: Fri, 7 Aug 2026 16:29:03 +0200 Subject: [PATCH 2/7] chore: update examples to latest version Co-authored-by: Maximilian Techritz Signed-off-by: Maximilian Techritz --- docs/reference/services/metrics-operator.md | 2 +- docs/users/getting-started/03-configure.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/services/metrics-operator.md b/docs/reference/services/metrics-operator.md index 8c1d88e6..af4862a9 100644 --- a/docs/reference/services/metrics-operator.md +++ b/docs/reference/services/metrics-operator.md @@ -36,7 +36,7 @@ metadata: name: my-controlplane namespace: project-platform-team--ws-dev spec: - version: "v0.13.0" + version: "v1.0.0" ``` The MetricsOperator service provider manages the installation and lifecycle of [metrics-operator](https://github.com/openmcp-project/service-provider-metrics-operator) within your ControlPlane, enabling Prometheus-based metrics collection and alerting for managed workloads. diff --git a/docs/users/getting-started/03-configure.md b/docs/users/getting-started/03-configure.md index 4b061025..2256e4e5 100644 --- a/docs/users/getting-started/03-configure.md +++ b/docs/users/getting-started/03-configure.md @@ -238,7 +238,7 @@ metadata: name: my-controlplane namespace: project-platform-team--ws-dev spec: - version: "v0.13.0" + version: "v1.0.0" ``` ```bash From f08afdadaef76ff97f0ec919b0af7efd28bab7b2 Mon Sep 17 00:00:00 2001 From: Johannes Ott Date: Fri, 7 Aug 2026 16:28:20 +0200 Subject: [PATCH 3/7] docs(metrics-operator): use metrics.svg logo Signed-off-by: Johannes Ott --- .../serviceprovider/06-examples.mdx | 2 +- docs/reference/services/metrics-operator.md | 2 +- static/img/logos/metrics.svg | 20 +++++++++++++++++++ 3 files changed, 22 insertions(+), 2 deletions(-) create mode 100644 static/img/logos/metrics.svg diff --git a/docs/developers/serviceprovider/06-examples.mdx b/docs/developers/serviceprovider/06-examples.mdx index 72b1cc48..d75d0045 100644 --- a/docs/developers/serviceprovider/06-examples.mdx +++ b/docs/developers/serviceprovider/06-examples.mdx @@ -117,7 +117,7 @@ Community Service Providers that extend OpenControlPlane. Use these as inspirati
- + Metrics Operator Service Provider

service-provider-metrics-operator

diff --git a/docs/reference/services/metrics-operator.md b/docs/reference/services/metrics-operator.md index af4862a9..f07be811 100644 --- a/docs/reference/services/metrics-operator.md +++ b/docs/reference/services/metrics-operator.md @@ -8,7 +8,7 @@ import CRDViewerCompact from '@site/src/components/CRDViewerCompact'; # Metrics Operator
- Metrics Operator + Metrics Operator

Delivers the Prometheus metrics-operator as a service within ControlPlanes, enabling metrics collection and alerting for managed workloads.

diff --git a/static/img/logos/metrics.svg b/static/img/logos/metrics.svg new file mode 100644 index 00000000..88c0df95 --- /dev/null +++ b/static/img/logos/metrics.svg @@ -0,0 +1,20 @@ + + + + + + + + + + + + \ No newline at end of file From 6240a821181f42fcc6d2e1c50698b9c99211cbff Mon Sep 17 00:00:00 2001 From: Johannes Ott Date: Mon, 10 Aug 2026 14:12:11 +0200 Subject: [PATCH 4/7] Update docs/users/getting-started/03-configure.md Co-authored-by: Michael Signed-off-by: Johannes Ott --- docs/users/getting-started/03-configure.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/users/getting-started/03-configure.md b/docs/users/getting-started/03-configure.md index 2256e4e5..cd90c684 100644 --- a/docs/users/getting-started/03-configure.md +++ b/docs/users/getting-started/03-configure.md @@ -227,7 +227,7 @@ Once installed, you can create `SecretStore` and `ExternalSecret` resources on t [Metrics Operator](https://github.com/openmcp-project/service-provider-metrics-operator) installs the Prometheus-based metrics-operator into your ControlPlane, enabling metrics collection and alerting for managed workloads. -To install the Metrics Operator, create a `MetricsOperator` resource in the same namespace as your ControlPlane: +To install the Metrics Operator, create a `MetricsOperator` resource in the same namespace and with the same name as your `ControlPlane`: :::apply-to-onboarding-api From e0471fefb48db0d47e6b74745614d8b9e9114f8b Mon Sep 17 00:00:00 2001 From: Johannes Ott Date: Mon, 10 Aug 2026 14:12:20 +0200 Subject: [PATCH 5/7] Update docs/users/getting-started/03-configure.md Co-authored-by: Michael Signed-off-by: Johannes Ott --- docs/users/getting-started/03-configure.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/users/getting-started/03-configure.md b/docs/users/getting-started/03-configure.md index cd90c684..b1efb513 100644 --- a/docs/users/getting-started/03-configure.md +++ b/docs/users/getting-started/03-configure.md @@ -225,7 +225,7 @@ Once installed, you can create `SecretStore` and `ExternalSecret` resources on t -[Metrics Operator](https://github.com/openmcp-project/service-provider-metrics-operator) installs the Prometheus-based metrics-operator into your ControlPlane, enabling metrics collection and alerting for managed workloads. +[Metrics Operator](https://github.com/openmcp-project/service-provider-metrics-operator) installs the OTel-based metrics-operator into your ControlPlane, enabling metrics collection and alerting for managed workloads. To install the Metrics Operator, create a `MetricsOperator` resource in the same namespace and with the same name as your `ControlPlane`: From 6b3ad65f7189b7fab7335fb9a2f5d5d98ebe80be Mon Sep 17 00:00:00 2001 From: Johannes Ott Date: Mon, 10 Aug 2026 14:12:27 +0200 Subject: [PATCH 6/7] Update docs/reference/services/metrics-operator.md Co-authored-by: Michael Signed-off-by: Johannes Ott --- docs/reference/services/metrics-operator.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/services/metrics-operator.md b/docs/reference/services/metrics-operator.md index f07be811..b5814484 100644 --- a/docs/reference/services/metrics-operator.md +++ b/docs/reference/services/metrics-operator.md @@ -39,4 +39,4 @@ spec: version: "v1.0.0" ``` -The MetricsOperator service provider manages the installation and lifecycle of [metrics-operator](https://github.com/openmcp-project/service-provider-metrics-operator) within your ControlPlane, enabling Prometheus-based metrics collection and alerting for managed workloads. +The MetricsOperator service provider manages the installation and lifecycle of [metrics-operator](https://github.com/openmcp-project/metrics-operator) within your ControlPlane, enabling OTel-based metrics collection and alerting for managed workloads. From dc6d359a729c6a771cc159d100a13fc389df750c Mon Sep 17 00:00:00 2001 From: Johannes Ott Date: Mon, 10 Aug 2026 14:12:33 +0200 Subject: [PATCH 7/7] Update docs/reference/services/metrics-operator.md Co-authored-by: Michael Signed-off-by: Johannes Ott --- docs/reference/services/metrics-operator.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/services/metrics-operator.md b/docs/reference/services/metrics-operator.md index b5814484..184607ad 100644 --- a/docs/reference/services/metrics-operator.md +++ b/docs/reference/services/metrics-operator.md @@ -10,7 +10,7 @@ import CRDViewerCompact from '@site/src/components/CRDViewerCompact';
Metrics Operator
-

Delivers the Prometheus metrics-operator as a service within ControlPlanes, enabling metrics collection and alerting for managed workloads.

+

Delivers the OTel [metrics-operator](https://github.com/openmcp-project/metrics-operator) as a service within `ControlPlanes`, enabling metrics collection and alerting for managed workloads.