Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.odigos.io/llms.txt

Use this file to discover all available pages before exploring further.

This guide shows you how to deploy Odigos in your Kubernetes cluster using Argo CD with the official Odigos Helm chart. This allows for GitOps-based management and observability instrumentation across your applications.

​
Prerequisites

Before you begin, make sure you have:
  • A running Kubernetes cluster
  • Argo CD installed and configured in the cluster
  • Helm CLI installed (optional but useful for inspection and verification)

​
Step 1: Add the Odigos Helm Repository

Add the Odigos Helm repository to your Helm configuration: 
helm repo add odigos https://odigos-io.github.io/odigos --force-update
helm repo update

​
Step 2: Identify the Helm Chart Version

Check available versions of the Odigos chart to determine the desired targetRevision: 
helm search repo odigos --versions

​
Step 3: Define the Argo CD Application Manifest

Create an Argo CD Application custom resource to deploy Odigos using Helm. Save the following YAML as odigos-application.yaml: 
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: odigos
  namespace: <ARGOCD_NAMESPACE>  # <- Replace with your Argo CD namespace
spec:
  project: default
  source:
    repoURL: https://odigos-io.github.io/odigos
    chart: odigos
    targetRevision:  # REQUIRED: set the version from 'helm search repo odigos --versions'
    helm:
      releaseName: odigos
      values: |
        # OPTIONAL: add your custom Helm values here if needed.
        # Argo CD expects this field to be a YAML-formatted string.
        # To use chart defaults, delete this field entirely or set it to an empty string ("").
  destination:
    server: https://kubernetes.default.svc
    namespace: <ODIGOS_NAMESPACE>  # <- Replace with the desired namespace where you want Odigos to be installed
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    syncOptions:
      - CreateNamespace=true

​
Step 4: Apply the Application

Use kubectl to create the application in Argo CD: 
kubectl apply -f odigos-application.yaml
This will instruct Argo CD to deploy Odigos using the Helm chart.

​
Step 5: Monitor the Deployment

You can monitor the status of the deployment through the Argo CD UI:
  • Navigate to your Argo CD web interface.
  • Find the application named odigos.
  • Verify that it reaches a Healthy and Synced state.
Once complete, Odigos will be installed in your cluster and ready to instrument workloads.