[GEN-1962]: add KloudMate destination support and documentation

README.md

@@ -101,6 +101,7 @@ For more details, see our [quickstart guide](https://docs.odigos.io/intro).
 | Google Cloud Storage    |   ✅   |         |  ✅  |
 | Grafana Cloud           |   ✅   |   ✅    |  ✅  |
 | Honeycomb               |   ✅   |   ✅    |  ✅  |
+| KloudMate               |   ✅   |   ✅    |  ✅  |
 | Last9                   |   ✅   |   ✅    |      |
 | Lightstep               |   ✅   |         |      |
 | Logz.io                 |   ✅   |   ✅    |  ✅  |

common/config/kloudmate.go

@@ -0,0 +1,69 @@
+package config
+
+import (
+	"errors"
+
+	"github.com/odigos-io/odigos/common"
+)
+
+const (
+	KloudMateEndpoint = "KLOUDMATE_ENDPOINT"
+)
+
+var (
+	ErrorKloudMateEndpointMissing = errors.New("KloudMate is missing a required field (\"KLOUDMATE_ENDPOINT\"), KloudMate will not be configured")
+)
+
+type KloudMate struct{}
+
+func (j *KloudMate) DestType() common.DestinationType {
+	return common.KloudMateDestinationType
+}
+
+func (j *KloudMate) ModifyConfig(dest ExporterConfigurer, currentConfig *Config) error {
+	config := dest.GetConfig()
+	uniqueUri := "kloudmate-" + dest.GetID()
+
+	url, exists := config[KloudMateEndpoint]
+	if !exists {
+		return ErrorKloudMateEndpointMissing
+	}
+
+	endpoint, err := parseOtlpHttpEndpoint(url)
+	if err != nil {
+		return err
+	}
+
+	exporterName := "otlphttp/" + uniqueUri
+	exporterConfig := GenericMap{
+		"endpoint": endpoint,
+		"headers": GenericMap{
+			"Authorization": "${KLOUDMATE_API_KEY}",
+		},
+	}
+
+	currentConfig.Exporters[exporterName] = exporterConfig
+
+	if isTracingEnabled(dest) {
+		pipeName := "traces/" + uniqueUri
+		currentConfig.Service.Pipelines[pipeName] = Pipeline{
+			Exporters: []string{exporterName},
+		}
+	}
+
+	if isMetricsEnabled(dest) {
+		pipeName := "metrics/" + uniqueUri
+		currentConfig.Service.Pipelines[pipeName] = Pipeline{
+			Exporters: []string{exporterName},
+		}
+	}
+
+	if isLoggingEnabled(dest) {
+		pipeName := "logs/" + uniqueUri
+		currentConfig.Service.Pipelines[pipeName] = Pipeline{
+			Exporters: []string{exporterName},
+		}
+	}
+
+	return nil
+}

common/config/root.go

@@ -18,7 +18,7 @@ var availableConfigers = []Configer{
 	&AppDynamics{}, &Axiom{}, &AWSS3{}, &AzureBlobStorage{}, &Causely{}, &Chronosphere{}, &Clickhouse{}, &Coralogix{},
 	&Datadog{}, &Debug{}, &Dynatrace{}, &ElasticAPM{}, &Elasticsearch{}, &GenericOTLP{}, &GoogleCloud{},
 	&GoogleCloudStorage{}, &GrafanaCloudLoki{}, &GrafanaCloudPrometheus{}, &GrafanaCloudTempo{},
-	&Honeycomb{}, &Jaeger{}, &Last9{}, &Lightstep{}, &Logzio{}, &Loki{}, &Lumigo{}, &Middleware{}, &Mock{}, &NewRelic{},
+	&Honeycomb{}, &Jaeger{}, &KloudMate{}, &Last9{}, &Lightstep{}, &Logzio{}, &Loki{}, &Lumigo{}, &Middleware{}, &Mock{}, &NewRelic{},
 	&Nop{}, &OpsVerse{}, &OTLPHttp{}, &Prometheus{}, &Qryn{}, &QrynOSS{}, &Quickwit{}, &Sentry{},
 	&Signoz{}, &Splunk{}, &SumoLogic{}, &Tempo{}, &Uptrace{},
 }

common/dests.go

@@ -24,6 +24,7 @@ const (
 	GrafanaCloudTempoDestinationType      DestinationType = "grafanacloudtempo"
 	HoneycombDestinationType              DestinationType = "honeycomb"
 	JaegerDestinationType                 DestinationType = "jaeger"
+	KloudMateDestinationType              DestinationType = "kloudmate"
 	Last9DestinationType                  DestinationType = "last9"
 	LightstepDestinationType              DestinationType = "lightstep"
 	LogzioDestinationType                 DestinationType = "logzio"

destinations/data/kloudmate.yaml

@@ -0,0 +1,30 @@
+apiVersion: internal.odigos.io/v1beta1
+kind: Destination
+metadata:
+  type: kloudmate
+  displayName: KloudMate
+  category: managed
+spec:
+  image: kloudmate.svg
+  signals:
+    traces:
+      supported: true
+    metrics:
+      supported: true
+    logs:
+      supported: true
+  fields:
+    - name: KLOUDMATE_ENDPOINT
+      displayName: KloudMate OTLP HTTP Endpoint
+      componentType: input
+      initialValue: 'https://otel.kloudmate.com:4318'
+      componentProps:
+        type: text
+        required: true
+    - name: KLOUDMATE_API_KEY
+      displayName: KloudMate API Key
+      componentType: input
+      secret: true
+      componentProps:
+        type: password
+        required: true

docs/backends-overview.mdx

@@ -23,6 +23,7 @@ Odigos has destinations for many observability backends.
 | Grafana Cloud           | Managed          |   ✅   |   ✅    |  ✅  |
 | Honeycomb               | Managed          |   ✅   |   ✅    |  ✅  |
 | Jaeger                  | Self-Hosted      |   ✅   |         |      |
+| KloudMate               | Managed          |   ✅   |   ✅    |  ✅  |
 | Last9                   | Managed          |   ✅   |   ✅    |      |
 | Lightstep               | Managed          |   ✅   |         |      |
 | Logz.io                 | Managed          |   ✅   |   ✅    |  ✅  |

docs/backends/kloudmate.mdx

@@ -0,0 +1,60 @@
+---
+title: 'KloudMate'
+---
+
+## Configuring Backend
+
+- **KLOUDMATE_ENDPOINT** - OpenTelemetry HTTP Endpoint, the format is `host:port`.
+  - host is required.
+  - port is required.
+- **KLOUDMATE_API_KEY** - API Key, required.
+
+## Adding a Destination to Odigos
+
+Odigos makes it simple to add and configure destinations, allowing you to select the specific signals [traces/logs/metrics] that you want to send to each destination. There are two primary methods for configuring destinations in Odigos:
+
+1. **Using the UI**
+
+Use the [Odigos CLI](https://docs.odigos.io/cli/odigos_ui) to access the UI:
+
+```bash
+odigos ui
+```
+
+2. **Using kubernetes manifests**
+
+Save the YAML below to a file (e.g., `destination.yaml`) and apply it using `kubectl`:
+
+```bash
+kubectl apply -f destination.yaml
+```
+
+
+```yaml
+apiVersion: odigos.io/v1alpha1
+kind: Destination
+metadata:
+  name: kloudmate-example
+  namespace: odigos-system
+spec:
+  data:
+    KLOUDMATE_ENDPOINT: <KloudMate OTLP HTTP Endpoint>
+  destinationName: kloudmate
+  secretRef:
+    name: kloudmate-secret
+  signals:
+  - TRACES
+  - METRICS
+  - LOGS
+  type: kloudmate
+
+---
+apiVersion: v1
+data:
+  KLOUDMATE_API_KEY: <base64 KloudMate API Key>
+kind: Secret
+metadata:
+  name: kloudmate-secret
+  namespace: odigos-system
+type: Opaque
+```

docs/mint.json

@@ -197,6 +197,7 @@
             "backends/grafanacloudtempo",
             "backends/honeycomb",
             "backends/jaeger",
+            "backends/kloudmate",
             "backends/last9",
             "backends/lightstep",
             "backends/logzio",

docs/quickstart/next-steps.mdx

@@ -35,6 +35,7 @@ Select the relevant backend for your use case below to connect it to Odigos.
   <Card title="Grafana Cloud Tempo" href="/backends/grafanacloudtempo" />
   <Card title="Honeycomb" href="/backends/honeycomb" />
   <Card title="Jaeger" href="/backends/jaeger" />
+  <Card title="KloudMate" href="/backends/kloudmate" />
   <Card title="Last9" href="/backends/last9" />
   <Card title="Lightstep" href="/backends/lightstep" />
   <Card title="Logz.io" href="/backends/logzio" />