Skip to main content
This feature is available in Odigos Enterprise tier only. Please contact the Odigos team to inquire about access to the Enterprise version.

​
What does Odigos Central include?

Odigos Central consists of three main components:
  • Central UI – A user interface for managing all connected clusters, sources, destinations, and sampling configurations.
  • Central Backend – The brain of the centralized system; stores configuration and communicates with remote clusters via a proxy.
  • Central Proxy – A lightweight service deployed in each connected (remote) cluster. It securely forwards requests from the central backend to the local Odigos services (which run without public internet access).

​
Why use Odigos Central?

If you’re running multiple Kubernetes clusters, Odigos Central helps you:
  • Manage instrumentation, sampling, and observability pipelines from one place
  • Avoid logging into each cluster separately
  • Centralize authentication and access management control

​
Getting Started

To get started with Odigos Central, you need to install the central components and configure remote clusters to connect to them.
1

Install Odigos Central

You can install Odigos Central using the CLI or Helm chart.
  • CLI
  • Helm
Use the odigos pro central install command:
odigos pro central install \
  --onprem-token <token> \
  --central-admin-password <password>
This installs:
  • central-backend
  • central-ui
  • redis (for state)
  • keycloak (as identity provider)
2

Access the Central UI

After installation, you can access the Central UI using port-forward:
odigos pro central ui
This will forward the Central UI to http://localhost:3000 and the Central Backend to http://localhost:8081.
3

Connect Remote Clusters

To connect remote clusters to your Central deployment, you can use the odigos config set command to configure the central backend URL and cluster name:
# Set the central backend URL
odigos config set central-backend-url <your-central-backend-url>

# Set the cluster name for identification in Central
odigos config set cluster-name <your-cluster-name>
Example:
# Configure cluster to connect to Central Backend running on port 8081
odigos config set central-backend-url http://central-backend.example.com:8081
odigos config set cluster-name production-cluster-1
The central-backend-url should point to your Central Backend service and must include the port number. If you’re using port-forward, this would be http://localhost:8081.
Odigos Central is an Enterprise feature and requires a valid license token. Make sure your --onprem-token is valid and has the necessary permissions.