Skip to main content

Getting Started

prometheus
These instructions are for the self hosted Prometheus instance. If you need a managed service, please follow the instructions on the Grafana Cloud Prometheus page.
Enabling Remote Write in Prometheus
Currently, Odigos supports Prometheus via the Remote Write API. In order to enable remote write in Prometheus, set the following feature flag.

Configuring Destination Fields

āŒ Traces āœ… Metrics āŒ Logs
  • PROMETHEUS_REMOTEWRITE_URL string : Remote Write URL.
    • This field is required
  • PROMETHEUS_RESOURCE_ATTRIBUTES_LABELS string[] : Resource Attributes Labels (Deprecated). deprecated. will be removed soon.
    • This field is optional
  • PROMETHEUS_BEARER_TOKEN string : Bearer Token. use this bearer token if your prometheus remote write endpoint requires authentication
    • This field is optional
    • Example: your-bearer-token

Adding Destination to Odigos

There are two primary methods for configuring destinations in Odigos:
Using the UI
1

Use the Odigos CLI to access the UI
odigos ui
2

Click on Add Destination, select Prometheus and follow the on-screen instructions
Using Kubernetes manifests
1

Save the YAML below to a file (e.g. prometheus.yaml)
apiVersion: odigos.io/v1alpha1
kind: Destination
metadata:
  name: prometheus-example
  namespace: odigos-system
spec:
  data:
    PROMETHEUS_REMOTEWRITE_URL: <Remote Write URL>
    # Note: The commented fields below are optional.
    # PROMETHEUS_RESOURCE_ATTRIBUTES_LABELS: <Resource Attributes Labels (Deprecated)>
  destinationName: prometheus
  # Uncomment the 'secretRef' below if you are using the optional Secret.
  # secretRef:
  #   name: prometheus-secret
  signals:
  - METRICS
  type: prometheus

---

# The following Secret is optional. Uncomment the entire block if you need to use it.
# apiVersion: v1
# data:
#   PROMETHEUS_BEARER_TOKEN: <Base64 Bearer Token>
# kind: Secret
# metadata:
#   name: prometheus-secret
#   namespace: odigos-system
# type: Opaque
2

Apply the YAML using kubectl
kubectl apply -f prometheus.yaml
⌘I