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.

The different components of the Odigos observability control plane work together to achieve observability for the cluster. The interaction between the components is performed via the Kubernetes API server. The autoscaler, instrumentor and scheduler are Kubernetes Operators. They coordinate by writing and watching the odigos custom resources in the Kubernetes API server. Odigos adds the following custom resources to the Kubernetes API server:

​
Source

This resource defines namespaces and workloads to instrument. It has the following spec fields:
FieldDescriptionTypeDefaultRequired
disableInstrumentationExcludes the specified workload from instrumentation.boolfalseOptional
workload.nameName of the workload for this Source.stringn/aRequired
workload.namespaceNamespace of the workload for this Source.stringn/aRequired
workload.kindKind of the workload for this Source.WorkloadKindn/aRequired
Valid values for WorkloadKind are:
  • Deployment
  • DaemonSet
  • StatefulSet
  • Namespace
These values are case-sensitive.

​
Destination

This custom resource is used to define the backend destinations for the observability data. Destinations can be either vendors (Datadog, Honeycomb, etc) or on premise. The destination object holds any data that is needed to connect to the backend system. Notice that sensitive fields such as API keys are stored in a Kubernetes secret and referenced by the destination object.

​
CollectorsGroup

The CollectorsGroup object is used to define a group of collectors that have a shared role. For example, a collectors group might include collectors that are deployed as DaemonSet that are responsible for collecting telemetry data, or collectors that are deployed as Deployment and are responsible for shipping the data to the selected destinations.