[GEN-1947]: add Better Stack destination support and documentation

README.md

@@ -91,6 +91,7 @@ For more details, see our [quickstart guide](https://docs.odigos.io/intro).
 | Axiom                   |   ✅   |         |  ✅  |
 | AWS S3                  |   ✅   |         |  ✅  |
 | Azure Blob Storage      |   ✅   |         |  ✅  |
+| Better Stack            |        |   ✅    |  ✅  |
 | Causely                 |   ✅   |         |      |
 | Chronosphere            |   ✅   |   ✅    |      |
 | Coralogix               |   ✅   |   ✅    |  ✅  |

common/config/betterstack.go

@@ -0,0 +1,54 @@
+package config
+
+import (
+	"github.com/odigos-io/odigos/common"
+)
+
+type BetterStack struct{}
+
+func (j *BetterStack) DestType() common.DestinationType {
+	return common.BetterStackDestinationType
+}
+
+func (j *BetterStack) ModifyConfig(dest ExporterConfigurer, cfg *Config) error {
+	uniqueUri := "betterstack-" + dest.GetID()
+
+	processorName := "attributes/" + uniqueUri
+	cfg.Processors[processorName] = GenericMap{
+		"actions": []GenericMap{
+			{
+				"key":    "better_stack_source_token",
+				"value":  "${BETTERSTACK_TOKEN}",
+				"action": "insert",
+			},
+		},
+	}
+
+	if isMetricsEnabled(dest) {
+		exporterName := "prometheusremotewrite/" + uniqueUri
+		cfg.Exporters[exporterName] = GenericMap{
+			"endpoint": "https://in-otel.logs.betterstack.com/metrics",
+		}
+
+		pipeName := "metrics/" + uniqueUri
+		cfg.Service.Pipelines[pipeName] = Pipeline{
+			Processors: []string{processorName},
+			Exporters:  []string{exporterName},
+		}
+	}
+
+	if isLoggingEnabled(dest) {
+		exporterName := "otlp/" + uniqueUri
+		cfg.Exporters[exporterName] = GenericMap{
+			"endpoint": "https://in-otel.logs.betterstack.com:443",
+		}
+
+		pipeName := "logs/" + uniqueUri
+		cfg.Service.Pipelines[pipeName] = Pipeline{
+			Processors: []string{processorName},
+			Exporters:  []string{exporterName},
+		}
+	}
+
+	return nil
+}

common/config/root.go

@@ -15,7 +15,7 @@ const (
 )
 
 var availableConfigers = []Configer{
-	&AppDynamics{}, &Axiom{}, &AWSS3{}, &AzureBlobStorage{}, &Causely{}, &Chronosphere{}, &Clickhouse{}, &Coralogix{},
+	&AppDynamics{}, &Axiom{}, &AWSS3{}, &AzureBlobStorage{}, &BetterStack{}, &Causely{}, &Chronosphere{}, &Clickhouse{}, &Coralogix{},
 	&Datadog{}, &Debug{}, &Dynatrace{}, &ElasticAPM{}, &Elasticsearch{}, &GenericOTLP{}, &GoogleCloud{},
 	&GoogleCloudStorage{}, &GrafanaCloudLoki{}, &GrafanaCloudPrometheus{}, &GrafanaCloudTempo{}, &Groundcover{},
 	&Honeycomb{}, &Jaeger{}, &Last9{}, &Lightstep{}, &Logzio{}, &Loki{}, &Lumigo{}, &Middleware{}, &Mock{}, &NewRelic{},

common/dests.go

@@ -7,6 +7,7 @@ const (
 	AWSS3DestinationType                  DestinationType = "s3"
 	AxiomDestinationType                  DestinationType = "axiom"
 	AzureBlobDestinationType              DestinationType = "azureblob"
+	BetterStackDestinationType            DestinationType = "betterstack"
 	CauselyDestinationType                DestinationType = "causely"
 	ChronosphereDestinationType           DestinationType = "chronosphere"
 	ClickhouseDestinationType             DestinationType = "clickhouse"

destinations/data/betterstack.yaml

@@ -0,0 +1,23 @@
+apiVersion: internal.odigos.io/v1beta1
+kind: Destination
+metadata:
+  type: betterstack
+  displayName: Better Stack
+  category: managed
+spec:
+  image: betterstack.svg
+  signals:
+    traces:
+      supported: false
+    metrics:
+      supported: true
+    logs:
+      supported: true
+  fields:
+    - name: BETTERSTACK_TOKEN
+      displayName: Better Stack Source Token
+      componentType: input
+      secret: true
+      componentProps:
+        type: password
+        required: true

docs/backends-overview.mdx

@@ -10,6 +10,7 @@ Odigos has destinations for many observability backends.
 | Axiom                   | Managed          |   ✅   |         |  ✅  |
 | AWS S3                  | Managed          |   ✅   |         |  ✅  |
 | Azure Blob Storage      | Managed          |   ✅   |         |  ✅  |
+| Better Stack            | Managed          |        |   ✅    |  ✅  |
 | Causely                 | Managed          |   ✅   |         |      |
 | Chronosphere            | Managed          |   ✅   |   ✅    |      |
 | ClickHouse              | Self-Hosted      |   ✅   |   ✅    |  ✅  |

docs/backends/betterstack.mdx

@@ -0,0 +1,60 @@
+---
+title: 'Better Stack'
+---
+
+## Configuring Backend
+
+- **BETTERSTACK_TOKEN** - Source Token, generated from Better Stack UI.
+
+**Note:**
+We handle the endpoint internally, so you don't need to provide it.
+- The endpoint for metrics is `https://in-otel.logs.betterstack.com/metrics`.
+- The endpoint for logs is `https://in-otel.logs.betterstack.com:443`.
+
+## 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: betterstack-example
+  namespace: odigos-system
+spec:
+  data: {}
+  destinationName: betterstack
+  secretRef:
+    name: betterstack-secret
+  signals:
+  - METRICS
+  - LOGS
+  type: betterstack
+
+---
+apiVersion: v1
+data:
+  BETTERSTACK_TOKEN: <base64 Better Stack Source Token>
+kind: Secret
+metadata:
+  name: betterstack-secret
+  namespace: odigos-system
+type: Opaque
+```

docs/mint.json

@@ -182,6 +182,7 @@
             "backends/s3",
             "backends/axiom",
             "backends/azureblob",
+            "backends/betterstack",
             "backends/causely",
             "backends/chronosphere",
             "backends/clickhouse",

docs/quickstart/next-steps.mdx

@@ -21,6 +21,7 @@ Select the relevant backend for your use case below to connect it to Odigos.
   <Card title="AWS S3" href="/backends/s3" />
   <Card title="Axiom" href="/backends/axiom" />
   <Card title="Azure Blob Storage" href="/backends/azureblob" />
+  <Card title="Better Stack" href="/backends/betterstack" />
   <Card title="Causely" href="/backends/causely" />
   <Card title="Chronosphere" href="/backends/chronosphere" />
   <Card title="Coralogix" href="/backends/coralogix" />