odigos config
Manage Odigos configurationSynopsis
Manage Odigos configuration settings to customize system behavior. Configurable properties:- “telemetry-enabled”: Enables or disables telemetry (true/false).
- “openshift-enabled”: Enables or disables OpenShift support (true/false).
- “psp”: Enables or disables Pod Security Policies (true/false).
- “skip-webhook-issuer-creation”: Skips webhook issuer creation (true/false).
- “allow-concurrent-agents”: Allows concurrent agents (true/false).
- “image-prefix”: Sets the image prefix.
- “ui-mode”: Sets the UI mode (default/readonly).
- “ui-pagination-limit”: Controls the number of items to fetch per paginated-batch in the UI.
- “ui-remote-url”: Sets the public URL of a remotely, self-hosted UI.
- “central-backend-url”: Sets the URL of the Odigos Tower Backend.
- “cluster-name”: Sets the name of this cluster, for Odigos Tower.
- “ignored-namespaces”: List of namespaces to be ignored.
- “ignored-containers”: List of containers to be ignored.
- “mount-method”: Determines how Odigos agent files are mounted into the pod’s container filesystem. Options include k8s-host-path (direct hostPath mount) and k8s-virtual-device (virtual device-based injection).
- “custom-container-runtime-socket-path”: Path to the custom container runtime socket (e.g /var/lib/rancher/rke2/agent/containerd/containerd.sock).
- “k8s-node-logs-directory”: Directory where Kubernetes logs are symlinked in a node (e.g /mnt/var/log).
- “user-instrumentation-envs”: JSON string defining per-language env vars to customize instrumentation, e.g.,
{"languages":{"java":{"enabled":true,"env":{"OTEL_INSTRUMENTATION_COMMON_EXPERIMENTAL_VIEW_TELEMETRY_ENABLED":"true"}}}}
- “agent-env-vars-injection-method”: Method for injecting agent environment variables into the instrumented processes. Options include loader, pod-manifest and loader-fallback-to-pod-manifest.
- “node-selector”: Apply a space-separated list of Kubernetes NodeSelectors to all Odigos components (ex: “kubernetes.io/os=linux mylabel=foo”).
- “karpenter-enabled”: Enables or disables Karpenter support (true/false).
- “instrumentation-auto-rollback-disabled”: Disable auto rollback feature for failing instrumentations.
- “instrumentation-auto-rollback-grace-time”: Grace time before uninstrumenting an application [default: 5m].
- “instrumentation-auto-rollback-stability-window”: Time windows where the auto rollback can happen [default: 1h].
- “automatic-rollout-disabled”: Disable auto rollout feature for workloads when instrumenting or uninstrumenting.
- “oidc-tenant-url”: Sets the URL of the OIDC tenant.
- “oidc-client-id”: Sets the client ID of the OIDC application.
- “oidc-client-secret”: Sets the client secret of the OIDC application.
- “odiglet-health-probe-bind-port”: Sets the port for the Odiglet health probes (readiness/liveness).
- “service-graph-disabled”: Enable or disable the service graph feature [default: false].
- “go-auto-offsets-cron”: Cron schedule for automatic Go offsets updates (e.g. “0 0 * * *” for daily at midnight). Set to empty string to disable.
- “go-auto-offsets-mode”: Mode for automatic Go offsets updates. Options include direct (default) and image.
- “clickhouse-json-type-enabled”: Enable or disable ClickHouse JSON column support. When enabled, telemetry data is written using a new schema with JSON-typed columns (requires ClickHouse v25.3+). [default: false]
- “allowed-test-connection-hosts”: List of allowed domains for test connection endpoints (e.g., “https://api.honeycomb.io”, “https://otel.example.com”). Use ”*” to allow all domains. Empty list allows all domains for backward compatibility.
- “enable-data-compression”: Enable or disable data compression before sending data to the Gateway collector. [default: false],
- “resource-size-preset”: Set the sizing configuration for the Odigos components (size_s, size_m [default], size_l).
- “wasp-enabled”: Enable wasp.
Options
Options inherited from parent commands
SEE ALSO
- odigos - Automate OpenTelemetry Observability in Kubernetes
- odigos config set - Set a configuration property in Odigos