Create OpenShift dashboard to visualize Collector metrics

.chloggen/2995-openshift-dashboard.yaml

@@ -0,0 +1,16 @@
+# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
+change_type: enhancement
+
+# The name of the component, or a single word describing the area of concern, (e.g. collector, target allocator, auto-instrumentation, opamp, github action)
+component: collector
+
+# A brief description of the change. Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: Create automatically an OpenShift dashboard to visualize OpenTelemetry Collector metrics
+
+# One or more tracking issues related to the change
+issues: [2995]
+
+# (Optional) One or more lines of additional information to render under the primary note.
+# These lines will be padded with 2 spaces and then inserted directly into the document.
+# Use pipe (|) for multiline entries.
+subtext: To enable this feature, you need to specify the `--openshift-create-dashboard` argument to the operator

internal/openshift/dashboards/dashboards.go

@@ -0,0 +1,74 @@
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package openshift
+
+import (
+	"context"
+	_ "embed"
+
+	corev1 "k8s.io/api/core/v1"
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+	v1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+	"k8s.io/client-go/kubernetes"
+)
+
+// The dashboard is created manually following the syntax from Grafana 5. For development purposes, this dashboard can be created just by loading the JSON file
+// in a ConfigMap from the openshift-config-managed and adding the console.openshift.io/dashboard=true label.
+//
+//go:embed metrics-dashboard.json
+var dashboardContent string
+
+const (
+	openshiftDashboardsNamespace = "openshift-config-managed"
+	configMapName                = "opentelemetry-collector"
+)
+
+type DashboardManagement struct {
+	clientset kubernetes.Interface
+}
+
+func NewDashboardManagement(clientset kubernetes.Interface) DashboardManagement {
+	return DashboardManagement{
+		clientset: clientset,
+	}
+}
+
+func (d DashboardManagement) Start(ctx context.Context) error {
+	cm := corev1.ConfigMap{
+		ObjectMeta: v1.ObjectMeta{
+			Name:      configMapName,
+			Namespace: openshiftDashboardsNamespace,
+			Labels: map[string]string{
+				"console.openshift.io/dashboard": "true",
+			},
+		},
+		Data: map[string]string{
+			"otel.json": dashboardContent,
+		},
+	}
+
+	_, err := d.clientset.CoreV1().ConfigMaps(openshiftDashboardsNamespace).Create(ctx, &cm, metav1.CreateOptions{})
+	if err != nil {
+		return nil
+	}
+
+	<-ctx.Done()
+
+	return d.clientset.CoreV1().ConfigMaps(openshiftDashboardsNamespace).Delete(ctx, configMapName, metav1.DeleteOptions{})
+}
+
+func (d DashboardManagement) NeedLeaderElection() bool {
+	return true
+}