Skip to main content

odigos config

Manage Odigos configuration

Synopsis

This command will be deprecated as setting values now happens via the odigos install command with the “—set” flag. 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

  -h, --help   help for config

Options inherited from parent commands

      --kube-context string   (optional) name of the kubeconfig context to use
      --kubeconfig string     (optional) absolute path to the kubeconfig file (default "KUBECONFIG")
  -v, --verbose               enable verbose output

SEE ALSO

  • odigos - Automate OpenTelemetry Observability in Kubernetes
  • odigos config set - Set a configuration property in Odigos