OS Manuals

/usr/bin/tempo

Grafana Tempo is a high volume, minimal dependency distributed tracing backend.

From tempo-3.0 3.0.5-r4 (enterprise-packages), captured 2026-11-08 by running tempo --help (exit 0). permalink

WARNING: sonic/ast only supports (go1.17~1.26 and amd64 CPU) or (go1.20~1.26 and arm64 CPU), but your environment is not suitable and will fallback to encoding/json
Usage of /usr/bin/tempo:
  -auth.enabled
    	Set to true to enable auth (deprecated: use multitenancy.enabled)
  -backend-scheduler.provider.work.compaction.block-retention duration
    	Duration to keep blocks/traces. (default 336h0m0s)
  -backend-scheduler.provider.work.compaction.compaction-window duration
    	Maximum time window across which to compact blocks. (default 1h0m0s)
  -backend-scheduler.provider.work.compaction.max-block-bytes uint
    	Maximum size of a compacted block. (default 107374182400)
  -backend-scheduler.provider.work.compaction.max-objects-per-block int
    	Maximum number of traces in a compacted block. (default 6000000)
  -backend-scheduler.provider.work.max-compaction-level int
    	Maximum compaction level to include in compaction jobs. 0 means no limit.
  -backend-scheduler.provider.work.max-input-blocks int
    	Maximum number of blocks to compact in a single job. (default 4)
  -backend-scheduler.provider.work.min-cycle-interval duration
    	Minimum time between tenant prioritization cycles to prevent excessive CPU usage when no work is available. (default 30s)
  -backend-scheduler.provider.work.min-input-blocks int
    	Minimum number of blocks to compact in a single job. (default 2)
  -backend-scheduler.provider.workbackend-scheduler.compaction-provider.measure-interval duration
    	Interval at which to metric tenant blocklist (default 1m0s)
  -backend-scheduler.provider.workbackend-scheduler.max-jobs-per-tenant int
    	Maximum number of jobs to run per tenant before moving on to the next tenant (default 1000)
  -backend-scheduler.provider.workbackend-scheduler.redaction-provider.max-rescan-generations int
    	Maximum number of rescan generations before giving up and requiring operator resubmission (default 5)
  -backend-scheduler.provider.workbackend-scheduler.redaction-provider.poll-interval duration
    	Interval at which to check for pending redaction jobs when the queue is empty (default 2s)
  -backend-scheduler.provider.workbackend-scheduler.redaction-provider.rescan-delay duration
    	How long to wait before rescanning for output blocks from compaction jobs active at submission time (default 5m0s)
  -backend-scheduler.provider.workbackend-scheduler.retention-interval duration
    	Interval at which to perform tenant retention (default 1h0m0s)
  -backend-scheduler.workdead-job-timeout duration
    	Time after which a job is considered dead and marked as failed (default 24h0m0s)
  -backend-scheduler.workprune-age duration
    	Age at which to prune completed jobs (default 1h0m0s)
  -backend-schedulerbackend-scheduler.backend-flush-interval duration
    	Interval at which to flush the work cache to the backend storage (default 1m0s)
  -backend-schedulerbackend-scheduler.job-timeout duration
    	Internal duration to wait for a job before telling the worker to try again (default 15s)
  -backend-schedulerbackend-scheduler.local-work-path string
    	Path to store local work cache. (default "/var/tempo")
  -backend-schedulerbackend-scheduler.maintenance-interval duration
    	Interval at which to perform scheduler maintenance tasks (default 1m0s)
  -backend-worker.backoff-max-period duration
    	Maximum delay when backing off. (default 1m0s)
  -backend-worker.backoff-min-period duration
    	Minimum delay when backing off. (default 100ms)
  -backend-worker.backoff-retries int
    	Number of times to backoff and retry before failing.
  -backend-worker.compaction.block-retention duration
    	Duration to keep blocks/traces. (default 336h0m0s)
  -backend-worker.compaction.compaction-window duration
    	Maximum time window across which to compact blocks. (default 1h0m0s)
  -backend-worker.compaction.max-block-bytes uint
    	Maximum size of a compacted block. (default 107374182400)
  -backend-worker.compaction.max-objects-per-block int
    	Maximum number of traces in a compacted block. (default 6000000)
  -backend-worker.finish-on-shutdown-timeout duration
    	Timeout for finishing the current job before shutting down the worker. (default 30s)
  -block-builder.assigned-partitions value
    	List of partitions assigned to this block builder.
  -block-builder.block.max-block-bytes uint
    	Maximum size of a block. (default 20971520)
  -block-builder.consume-cycle-duration duration
    	Interval between consumption cycles. (default 5m0s)
  -block-builder.instance-id string
    	Instance id. (default "localhost")
  -block-builder.max-bytes-per-cycle uint
    	Maximum number of bytes that can be consumed in a single cycle. 0 to disable (default 5000000000)
  -block-builder.partitions-per-instance int
    	Number of partitions assigned to this block builder.
  -block-builder.wal.path string
    	Path at which store WAL blocks. (default "/var/tempo/block-builder/traces")
  -block-profile-threshold int
    	Override default block profiling threshold.
  -config.enable-legacy-overrides
    	Enable the deprecated legacy overrides format. This is disabled by default and will be removed in a future release.
  -config.expand-env value
    	Whether to expand environment variables in config file
  -config.file value
    	Configuration file to load
  -config.per-user-override-config string
    	File name of per-user Overrides.
  -config.per-user-override-period value
    	Period with this to reload the Overrides. (default 10s)
  -config.verify value
    	Verify configuration and exit
  -distributor.ingestion-burst-size-bytes int
    	Per-user ingestion burst size in bytes. Should be set to the expected size (in bytes) of a single push request. (default 30000000)
  -distributor.ingestion-rate-limit-bytes int
    	Per-user ingestion rate limit in bytes per second. (default 30000000)
  -distributor.log-discarded-spans.enabled
    	Enable to log every discarded span to help debug ingestion or calculate span error distributions using the logs.
  -distributor.log-discarded-spans.filter-by-status-error
    	Enable to filter out spans without status error.
  -distributor.log-discarded-spans.include-attributes
    	Enable to include span attributes in the logs.
  -distributor.log-received-spans.enabled
    	Enable to log every received span to help debug ingestion or calculate span error distributions using the logs.
  -distributor.log-received-spans.filter-by-status-error
    	Enable to filter out spans without status error.
  -distributor.log-received-spans.include-attributes
    	Enable to include span attributes in the logs.
  -distributor.rate-limit-strategy string
    	Whether the various ingestion rate limits should be applied individually to each distributor instance (local), or evenly shared across the cluster (global). (default "local")
  -enable-go-runtime-metrics
    	Set to true to enable all Go runtime metrics
  -generator.address string
    	The Kafka backend address. (default "localhost:9092")
  -generator.auto-create-topic-default-partitions int
    	When auto-creation of Kafka topic is enabled and this value is positive, Kafka's num.partitions configuration option is set on Kafka brokers with this value when Tempo component that uses Kafka starts. This configuration option specifies the default number of partitions that the Kafka broker uses for auto-created topics. Note that this is a Kafka-cluster wide setting, and applies to any auto-created topic. If the setting of num.partitions fails, Tempo proceeds anyways, but auto-created topics could have an incorrect number of partitions. (default 1000)
  -generator.auto-create-topic-enabled
    	Enable auto-creation of Kafka topic if it doesn't exist. (default true)
  -generator.client-id string
    	The Kafka client ID.
  -generator.consumer-group string
    	The consumer group used by the consumer to track the last consumed offset. The consumer group must be different for each ingester. If the configured consumer group contains the '<partition>' placeholder, it is replaced with the actual partition ID owned by the ingester. When empty (recommended), Tempo uses the ingester instance ID to guarantee uniqueness.
  -generator.consumer-group-offset-commit-interval duration
    	How frequently a consumer should commit the consumed offset to Kafka. The last committed offset is used at startup to continue the consumption from where it was left. (default 1s)
  -generator.consumer_group_lag_metric_update_interval duration
    	How often the lag metric is updated. Set to 0 to disable metric calculation and export  (default 1m0s)
  -generator.dial-timeout duration
    	The maximum time allowed to open a connection to a Kafka broker. (default 2s)
  -generator.disable-kafka-telemetry
    	Disable KIP-714 Kafka client metrics
  -generator.instance-availability-zone string
    	Define Availability Zone in which this instance is running.
  -generator.instance-id string
    	Instance id. (default "localhost")
  -generator.last-produced-offset-retry-timeout duration
    	How long to retry a failed request to get the last produced offset. (default 10s)
  -generator.leave-consumer-group-on-shutdown
    	If true, send LeaveGroup to Kafka on shutdown for immediate partition reassignment. Default false; set to true for Deployment rollouts where pod names change on each restart.
  -generator.max-consumer-lag-at-startup duration
    	The guaranteed maximum lag before a consumer is considered to have caught up reading from a partition at startup, becomes ACTIVE in the hash ring and passes the readiness check. Set both -generator.target-consumer-lag-at-startup and -generator.max-consumer-lag-at-startup to 0 to disable waiting for maximum consumer lag being honored at startup. (default 15s)
  -generator.producer-max-buffered-bytes int
    	The maximum size of (uncompressed) buffered and unacknowledged produced records sent to Kafka. The produce request fails once this limit is reached. This limit is per Kafka client. 0 to disable the limit. (default 1073741824)
  -generator.producer-max-record-size-bytes int
    	The maximum size of a Kafka record data that should be generated by the producer. An incoming write request larger than this size is split into multiple Kafka records. We strongly recommend to not change this setting unless for testing purposes. (default 15983616)
  -generator.sasl-password value
    	The SASL password for authentication.
  -generator.sasl-username string
    	The SASL username for authentication.
  -generator.target-consumer-lag-at-startup duration
    	The best-effort maximum lag a consumer tries to achieve at startup. Set both -generator.target-consumer-lag-at-startup and -generator.max-consumer-lag-at-startup to 0 to disable waiting for maximum consumer lag being honored at startup. (default 2s)
  -generator.topic string
    	The Kafka topic name.
  -generator.write-timeout duration
    	How long to wait for an incoming write request to be successfully committed to the Kafka backend. (default 10s)
  -generatorconsul.acl-token value
    	ACL Token used to interact with Consul.
  -generatorconsul.cas-retry-delay duration
    	Maximum duration to wait before retrying a Compare And Swap (CAS) operation. (default 1s)
  -generatorconsul.client-timeout duration
    	HTTP timeout when talking to Consul (default 20s)
  -generatorconsul.consistent-reads
    	Enable consistent reads to Consul.
  -generatorconsul.hostname string
    	Hostname and port of Consul. (default "localhost:8500")
  -generatorconsul.watch-burst-size int
    	Burst size used in rate limit. Values less than 1 are treated as 1. (default 1)
  -generatorconsul.watch-rate-limit float
    	Rate limit when watching key or prefix in Consul, in requests per second. 0 disables the rate limit. (default 1)
  -generatoretcd.dial-timeout duration
    	The dial timeout for the etcd connection. (default 10s)
  -generatoretcd.endpoints value
    	The etcd endpoints to connect to.
  -generatoretcd.max-retries int
    	The maximum number of retries to do for failed ops. (default 10)
  -generatoretcd.password value
    	Etcd password.
  -generatoretcd.tls-ca-path string
    	Path to the CA certificates to validate server certificate against. If not set, the host's root CA certificates are used.
  -generatoretcd.tls-cert-path string
    	Path to the client certificate, which will be used for authenticating with the server. Also requires the key path to be configured.
  -generatoretcd.tls-cipher-suites string
    	Override the default cipher suite list (separated by commas).
  -generatoretcd.tls-enabled
    	Enable TLS.
  -generatoretcd.tls-insecure-skip-verify
    	Skip validating server certificate.
  -generatoretcd.tls-key-path string
    	Path to the key for the client certificate. Also requires the client certificate to be configured.
  -generatoretcd.tls-min-version string
    	Override the default minimum TLS version. Allowed values: VersionTLS10, VersionTLS11, VersionTLS12, VersionTLS13
  -generatoretcd.tls-server-name string
    	Override the expected name on the server certificate.
  -generatoretcd.username string
    	Etcd username.
  -generatormulti.mirror-enabled
    	Mirror writes to the secondary store.
  -generatormulti.mirror-timeout duration
    	Timeout for storing a value to the secondary store. (default 2s)
  -generatormulti.primary string
    	Primary backend storage used by multi-client.
  -generatormulti.secondary string
    	Secondary backend storage used by multi-client.
  -generatorprefix string
    	The prefix for the keys in the store. Should end with a /. (default "collectors/")
  -generatorstore string
    	Backend storage to use for the ring. Supported values are: consul, etcd, inmemory, memberlist, multi. (default "consul")
  -health
    	Run a health check against the /ready endpoint and exit
  -health.url string
    	URL to check when running health check (default "http://localhost:3200/ready")
  -http-api-prefix string
    	String prefix for all http api endpoints.
  -ingest.address string
    	The Kafka backend address. (default "localhost:9092")
  -ingest.auto-create-topic-default-partitions int
    	When auto-creation of Kafka topic is enabled and this value is positive, Kafka's num.partitions configuration option is set on Kafka brokers with this value when Tempo component that uses Kafka starts. This configuration option specifies the default number of partitions that the Kafka broker uses for auto-created topics. Note that this is a Kafka-cluster wide setting, and applies to any auto-created topic. If the setting of num.partitions fails, Tempo proceeds anyways, but auto-created topics could have an incorrect number of partitions. (default 1000)
  -ingest.auto-create-topic-enabled
    	Enable auto-creation of Kafka topic if it doesn't exist. (default true)
  -ingest.client-id string
    	The Kafka client ID.
  -ingest.consumer-group string
    	The consumer group used by the consumer to track the last consumed offset. The consumer group must be different for each ingester. If the configured consumer group contains the '<partition>' placeholder, it is replaced with the actual partition ID owned by the ingester. When empty (recommended), Tempo uses the ingester instance ID to guarantee uniqueness.
  -ingest.consumer-group-offset-commit-interval duration
    	How frequently a consumer should commit the consumed offset to Kafka. The last committed offset is used at startup to continue the consumption from where it was left. (default 1s)
  -ingest.consumer_group_lag_metric_update_interval duration
    	How often the lag metric is updated. Set to 0 to disable metric calculation and export  (default 1m0s)
  -ingest.dial-timeout duration
    	The maximum time allowed to open a connection to a Kafka broker. (default 2s)
  -ingest.disable-kafka-telemetry
    	Disable KIP-714 Kafka client metrics
  -ingest.last-produced-offset-retry-timeout duration
    	How long to retry a failed request to get the last produced offset. (default 10s)
  -ingest.max-consumer-lag-at-startup duration
    	The guaranteed maximum lag before a consumer is considered to have caught up reading from a partition at startup, becomes ACTIVE in the hash ring and passes the readiness check. Set both -ingest.target-consumer-lag-at-startup and -ingest.max-consumer-lag-at-startup to 0 to disable waiting for maximum consumer lag being honored at startup. (default 15s)
  -ingest.producer-max-buffered-bytes int
    	The maximum size of (uncompressed) buffered and unacknowledged produced records sent to Kafka. The produce request fails once this limit is reached. This limit is per Kafka client. 0 to disable the limit. (default 1073741824)
  -ingest.producer-max-record-size-bytes int
    	The maximum size of a Kafka record data that should be generated by the producer. An incoming write request larger than this size is split into multiple Kafka records. We strongly recommend to not change this setting unless for testing purposes. (default 15983616)
  -ingest.sasl-password value
    	The SASL password for authentication.
  -ingest.sasl-username string
    	The SASL username for authentication.
  -ingest.target-consumer-lag-at-startup duration
    	The best-effort maximum lag a consumer tries to achieve at startup. Set both -ingest.target-consumer-lag-at-startup and -ingest.max-consumer-lag-at-startup to 0 to disable waiting for maximum consumer lag being honored at startup. (default 2s)
  -ingest.topic string
    	The Kafka topic name.
  -ingest.write-timeout duration
    	How long to wait for an incoming write request to be successfully committed to the Kafka backend. (default 10s)
  -ingester.max-bytes-per-trace int
    	Maximum size of a trace in bytes.  0 to disable. (default 5000000)
  -ingester.max-global-traces-per-user int
    	Maximum number of active traces per user, across the cluster. 0 to disable.
  -ingester.max-traces-per-user int
    	Maximum number of active traces per user, per ingester. 0 to disable. (default 10000)
  -live-store.complete-block-timeout duration
    	Duration to keep blocks in the live store after they have been flushed. (default 20m0s)
  -live-store.concurrent-blocks uint
    	Number of concurrent blocks to query for metrics. (default 10)
  -live-store.instance-availability-zone string
    	Define Availability Zone in which this instance is running.
  -live-store.metrics.time-overlap-cutoff float
    	Time overlap cutoff ratio for metrics queries (0.0-1.0). (default 0.2)
  -live-store.partition-ring.consul.acl-token value
    	ACL Token used to interact with Consul.
  -live-store.partition-ring.consul.cas-retry-delay duration
    	Maximum duration to wait before retrying a Compare And Swap (CAS) operation. (default 1s)
  -live-store.partition-ring.consul.client-timeout duration
    	HTTP timeout when talking to Consul (default 20s)
  -live-store.partition-ring.consul.consistent-reads
    	Enable consistent reads to Consul.
  -live-store.partition-ring.consul.hostname string
    	Hostname and port of Consul. (default "localhost:8500")
  -live-store.partition-ring.consul.watch-burst-size int
    	Burst size used in rate limit. Values less than 1 are treated as 1. (default 1)
  -live-store.partition-ring.consul.watch-rate-limit float
    	Rate limit when watching key or prefix in Consul, in requests per second. 0 disables the rate limit. (default 1)
  -live-store.partition-ring.delete-inactive-partition-after duration
    	How long to wait before an INACTIVE partition is eligible for deletion. The partition is deleted only if it has been in INACTIVE state for at least the configured duration and it has no owners registered. A value of 0 disables partitions deletion. (default 13h0m0s)
  -live-store.partition-ring.etcd.dial-timeout duration
    	The dial timeout for the etcd connection. (default 10s)
  -live-store.partition-ring.etcd.endpoints value
    	The etcd endpoints to connect to.
  -live-store.partition-ring.etcd.max-retries int
    	The maximum number of retries to do for failed ops. (default 10)
  -live-store.partition-ring.etcd.password value
    	Etcd password.
  -live-store.partition-ring.etcd.tls-ca-path string
    	Path to the CA certificates to validate server certificate against. If not set, the host's root CA certificates are used.
  -live-store.partition-ring.etcd.tls-cert-path string
    	Path to the client certificate, which will be used for authenticating with the server. Also requires the key path to be configured.
  -live-store.partition-ring.etcd.tls-cipher-suites string
    	Override the default cipher suite list (separated by commas).
  -live-store.partition-ring.etcd.tls-enabled
    	Enable TLS.
  -live-store.partition-ring.etcd.tls-insecure-skip-verify
    	Skip validating server certificate.
  -live-store.partition-ring.etcd.tls-key-path string
    	Path to the key for the client certificate. Also requires the client certificate to be configured.
  -live-store.partition-ring.etcd.tls-min-version string
    	Override the default minimum TLS version. Allowed values: VersionTLS10, VersionTLS11, VersionTLS12, VersionTLS13
  -live-store.partition-ring.etcd.tls-server-name string
    	Override the expected name on the server certificate.
  -live-store.partition-ring.etcd.username string
    	Etcd username.
  -live-store.partition-ring.min-partition-owners-count int
    	Minimum number of owners to wait before a PENDING partition gets switched to ACTIVE. (default 1)
  -live-store.partition-ring.min-partition-owners-duration duration
    	How long the minimum number of owners are enforced before a PENDING partition gets switched to ACTIVE. (default 10s)
  -live-store.partition-ring.multi.mirror-enabled
    	Mirror writes to the secondary store.
  -live-store.partition-ring.multi.mirror-timeout duration
    	Timeout for storing a value to the secondary store. (default 2s)
  -live-store.partition-ring.multi.primary string
    	Primary backend storage used by multi-client.
  -live-store.partition-ring.multi.secondary string
    	Secondary backend storage used by multi-client.
  -live-store.partition-ring.prefix string
    	The prefix for the keys in the store. Should end with a /. (default "collectors/")
  -live-store.partition-ring.store string
    	Backend storage to use for the ring. Supported values are: consul, etcd, inmemory, memberlist, multi. (default "memberlist")
  -live-store.readiness-max-wait duration
    	Maximum time to wait for catching up at startup. Only used if readiness-target-lag > 0. (default 30m0s)
  -live-store.readiness-target-lag duration
    	Target lag threshold before live-store is ready. 0 disables waiting (backward compatible).
  -live-store.remove-owner-on-shutdown
    	Remove partition owner from the ring on shutdown. (default true)
  -live-store.shutdown_marker_dir string
    	Path to the shutdown marker directory. (default "/var/tempo/live-store/shutdown-marker")
  -live-store.wal.path string
    	Path at which store WAL blocks. (default "/var/tempo/live-store/traces")
  -live-storeconsul.acl-token value
    	ACL Token used to interact with Consul.
  -live-storeconsul.cas-retry-delay duration
    	Maximum duration to wait before retrying a Compare And Swap (CAS) operation. (default 1s)
  -live-storeconsul.client-timeout duration
    	HTTP timeout when talking to Consul (default 20s)
  -live-storeconsul.consistent-reads
    	Enable consistent reads to Consul.
  -live-storeconsul.hostname string
    	Hostname and port of Consul. (default "localhost:8500")
  -live-storeconsul.watch-burst-size int
    	Burst size used in rate limit. Values less than 1 are treated as 1. (default 1)
  -live-storeconsul.watch-rate-limit float
    	Rate limit when watching key or prefix in Consul, in requests per second. 0 disables the rate limit. (default 1)
  -live-storeetcd.dial-timeout duration
    	The dial timeout for the etcd connection. (default 10s)
  -live-storeetcd.endpoints value
    	The etcd endpoints to connect to.
  -live-storeetcd.max-retries int
    	The maximum number of retries to do for failed ops. (default 10)
  -live-storeetcd.password value
    	Etcd password.
  -live-storeetcd.tls-ca-path string
    	Path to the CA certificates to validate server certificate against. If not set, the host's root CA certificates are used.
  -live-storeetcd.tls-cert-path string
    	Path to the client certificate, which will be used for authenticating with the server. Also requires the key path to be configured.
  -live-storeetcd.tls-cipher-suites string
    	Override the default cipher suite list (separated by commas).
  -live-storeetcd.tls-enabled
    	Enable TLS.
  -live-storeetcd.tls-insecure-skip-verify
    	Skip validating server certificate.
  -live-storeetcd.tls-key-path string
    	Path to the key for the client certificate. Also requires the client certificate to be configured.
  -live-storeetcd.tls-min-version string
    	Override the default minimum TLS version. Allowed values: VersionTLS10, VersionTLS11, VersionTLS12, VersionTLS13
  -live-storeetcd.tls-server-name string
    	Override the expected name on the server certificate.
  -live-storeetcd.username string
    	Etcd username.
  -live-storemulti.mirror-enabled
    	Mirror writes to the secondary store.
  -live-storemulti.mirror-timeout duration
    	Timeout for storing a value to the secondary store. (default 2s)
  -live-storemulti.primary string
    	Primary backend storage used by multi-client.
  -live-storemulti.secondary string
    	Secondary backend storage used by multi-client.
  -live-storeprefix string
    	The prefix for the keys in the store. Should end with a /. (default "collectors/")
  -live-storestore string
    	Backend storage to use for the ring. Supported values are: consul, etcd, inmemory, memberlist, multi. (default "consul")
  -log.level value
    	Only log messages with the given severity or above. Valid levels: [debug, info, warn, error] (default info)
  -memberlist.bind-port int
    	Port for memberlist to communicate on (default 7946)
  -memberlist.host-port value
    	Host port to connect to memberlist cluster.
  -memberlist.message-history-buffer-bytes int

  -metrics-generator.native-histogram-bucket-factor float
    	The growth factor between buckets for native histograms. (default 1.1)
  -metrics-generator.native-histogram-max-bucket-number value
    	The maximum number of buckets for native histograms. (default 100)
  -metrics-generator.native-histogram-min-reset-duration duration
    	The minimum duration before a native histogram can be reset. (default 15m0s)
  -multitenancy.enabled
    	Set to true to enable multitenancy.
  -mutex-profile-fraction int
    	Override default mutex profiling fraction.
  -querier.frontend-address string
    	Address of query frontend service, in host:port format.
  -querier.max-blocks-per-tag-values-query int
    	Maximum number of blocks to query for a tag-values query. 0 to disable.
  -querier.max-bytes-per-tag-values-query int
    	Maximum size of response for a tag-values query. Used mainly to limit large the number of values associated with a particular tag (default 1000000)
  -querier.max-condition-groups-per-tag-query int
    	Maximum number of OR-expanded condition groups allowed in a tag search query. Queries that expand beyond this limit will be rejected. (default 100)
  -query-frontend.mcp-server.enabled
    	Set to true to enable the MCP server
  -reporting.backoff-max-period duration
    	Maximum delay when backing off. (default 10s)
  -reporting.backoff-min-period duration
    	Minimum delay when backing off. (default 100ms)
  -reporting.backoff-retries int
    	Number of times to backoff and retry before failing. (default 10)
  -reporting.enabled
    	Enable anonymous usage reporting. (default true)
  -server.grpc-listen-port int
    	gRPC server listen port. (default 9095)
  -server.http-listen-port int
    	HTTP server listen port. (default 3200)
  -shutdown-delay duration
    	How long to wait between SIGTERM and shutdown. After receiving SIGTERM, Tempo will report not-ready status via /ready endpoint.
  -span-profiling
    	Set to true to enable span profiling (pyroscope pprof labels on OTel spans).
  -storage.trace.azure.container_name string
    	Azure container name to store blocks in.
  -storage.trace.azure.endpoint string
    	Azure endpoint to push blocks to. (default "blob.core.windows.net")
  -storage.trace.azure.max_buffers int
    	Number of simultaneous uploads. (default 4)
  -storage.trace.azure.prefix string
    	Azure container prefix to store blocks in.
  -storage.trace.azure.storage_account_key value
    	Azure storage access key.
  -storage.trace.azure.storage_account_name string
    	Azure storage account name.
  -storage.trace.backend string
    	Trace backend (s3, azure, gcs, local)
  -storage.trace.block.v2-bloom-filter-false-positive float
    	Bloom Filter False Positive. (default 0.01)
  -storage.trace.block.v2-bloom-filter-shard-size-bytes int
    	Bloom Filter Shard Size in bytes. (default 102400)
  -storage.trace.blocklist_poll duration
    	Period at which to run the maintenance cycle. (default 5m0s)
  -storage.trace.gcs.bucket string
    	gcs bucket to store traces in.
  -storage.trace.gcs.list_blocks_concurrency int
    	number of concurrent list calls to make to backend (default 3)
  -storage.trace.gcs.max_retries int
    	number of times to retry failed compaction/retention operations (default 3)
  -storage.trace.gcs.prefix string
    	gcs bucket prefix to store traces in.
  -storage.trace.local.path string
    	path to store traces at.
  -storage.trace.pool.max-workers int
    	Workers in the worker pool. (default 400)
  -storage.trace.pool.queue-depth int
    	Work item queue depth. (default 20000)
  -storage.trace.s3.access_key string
    	s3 access key.
  -storage.trace.s3.bucket string
    	s3 bucket to store blocks in.
  -storage.trace.s3.endpoint string
    	s3 endpoint to push blocks to.
  -storage.trace.s3.list_blocks_concurrency int
    	number of concurrent list calls to make to backend (default 3)
  -storage.trace.s3.prefix string
    	s3 root directory to store blocks in.
  -storage.trace.s3.secret_key value
    	s3 secret key.
  -storage.trace.s3.session_token value
    	s3 session token.
  -storage.trace.s3.sse.encryption-key value
    	SSE-C Encryption Key used for object encryption.
  -storage.trace.s3.sse.kms-encryption-context string
    	KMS Encryption Context used for object encryption. It expects JSON formatted string.
  -storage.trace.s3.sse.kms-key-id string
    	KMS Key ID used to encrypt objects in S3
  -storage.trace.s3.sse.type string
    	Enable AWS Server Side Encryption. Supported values: SSE-KMS, SSE-S3, SSE-C.
  -storage.trace.s3.tls_min_version string
    	minimum version of TLS to use when connecting to s3. (default "VersionTLS12")
  -storage.trace.wal.path string
    	Path at which store WAL blocks. (default "/var/tempo/wal")
  -target string
    	target module (default "all")
  -version
    	Print this builds version information
Options (242)
OptionDescriptionSource
-auth.enabledSet to true to enable auth (deprecated: use multitenancy.enabled)help
-backend-scheduler.provider.work.compaction.block-retention durationDuration to keep blocks/traces.help
-backend-scheduler.provider.work.compaction.compaction-window durationMaximum time window across which to compact blocks.help
-backend-scheduler.provider.work.compaction.max-block-bytes uintMaximum size of a compacted block.help
-backend-scheduler.provider.work.compaction.max-objects-per-block intMaximum number of traces in a compacted block.help
-backend-scheduler.provider.work.max-compaction-level intMaximum compaction level to include in compaction jobs.help
-backend-scheduler.provider.work.max-input-blocks intMaximum number of blocks to compact in a single job.help
-backend-scheduler.provider.work.min-cycle-interval durationMinimum time between tenant prioritization cycles to prevent excessive CPU usage when no work is available.help
-backend-scheduler.provider.work.min-input-blocks intMinimum number of blocks to compact in a single job.help
-backend-scheduler.provider.workbackend-scheduler.compaction-provider.measure-interval durationInterval at which to metric tenant blocklist (default 1m0s)help
-backend-scheduler.provider.workbackend-scheduler.max-jobs-per-tenant intMaximum number of jobs to run per tenant before moving on to the next tenant (default 1000)help
-backend-scheduler.provider.workbackend-scheduler.redaction-provider.max-rescan-generations intMaximum number of rescan generations before giving up and requiring operator resubmission (default 5)help
-backend-scheduler.provider.workbackend-scheduler.redaction-provider.poll-interval durationInterval at which to check for pending redaction jobs when the queue is empty (default 2s)help
-backend-scheduler.provider.workbackend-scheduler.redaction-provider.rescan-delay durationHow long to wait before rescanning for output blocks from compaction jobs active at submission time (default 5m0s)help
-backend-scheduler.provider.workbackend-scheduler.retention-interval durationInterval at which to perform tenant retention (default 1h0m0s)help
-backend-scheduler.workdead-job-timeout durationTime after which a job is considered dead and marked as failed (default 24h0m0s)help
-backend-scheduler.workprune-age durationAge at which to prune completed jobs (default 1h0m0s)help
-backend-schedulerbackend-scheduler.backend-flush-interval durationInterval at which to flush the work cache to the backend storage (default 1m0s)help
-backend-schedulerbackend-scheduler.job-timeout durationInternal duration to wait for a job before telling the worker to try again (default 15s)help
-backend-schedulerbackend-scheduler.local-work-path stringPath to store local work cache.help
-backend-schedulerbackend-scheduler.maintenance-interval durationInterval at which to perform scheduler maintenance tasks (default 1m0s)help
-backend-worker.backoff-max-period durationMaximum delay when backing off.help
-backend-worker.backoff-min-period durationMinimum delay when backing off.help
-backend-worker.backoff-retries intNumber of times to backoff and retry before failing.help
-backend-worker.compaction.block-retention durationDuration to keep blocks/traces.help
-backend-worker.compaction.compaction-window durationMaximum time window across which to compact blocks.help
-backend-worker.compaction.max-block-bytes uintMaximum size of a compacted block.help
-backend-worker.compaction.max-objects-per-block intMaximum number of traces in a compacted block.help
-backend-worker.finish-on-shutdown-timeout durationTimeout for finishing the current job before shutting down the worker.help
-block-builder.assigned-partitions valueList of partitions assigned to this block builder.help
-block-builder.block.max-block-bytes uintMaximum size of a block.help
-block-builder.consume-cycle-duration durationInterval between consumption cycles.help
-block-builder.instance-id stringInstance id.help
-block-builder.max-bytes-per-cycle uintMaximum number of bytes that can be consumed in a single cycle.help
-block-builder.partitions-per-instance intNumber of partitions assigned to this block builder.help
-block-builder.wal.path stringPath at which store WAL blocks.help
-block-profile-threshold intOverride default block profiling threshold.help
-config.enable-legacy-overridesEnable the deprecated legacy overrides format.help
-config.expand-env valueWhether to expand environment variables in config filehelp
-config.file valueConfiguration file to loadhelp
-config.per-user-override-config stringFile name of per-user Overrides.help
-config.per-user-override-period valuePeriod with this to reload the Overrides.help
-config.verify valueVerify configuration and exithelp
-distributor.ingestion-burst-size-bytes intPer-user ingestion burst size in bytes.help
-distributor.ingestion-rate-limit-bytes intPer-user ingestion rate limit in bytes per second.help
-distributor.log-discarded-spans.enabledEnable to log every discarded span to help debug ingestion or calculate span error distributions using the logs.help
-distributor.log-discarded-spans.filter-by-status-errorEnable to filter out spans without status error.help
-distributor.log-discarded-spans.include-attributesEnable to include span attributes in the logs.help
-distributor.log-received-spans.enabledEnable to log every received span to help debug ingestion or calculate span error distributions using the logs.help
-distributor.log-received-spans.filter-by-status-errorEnable to filter out spans without status error.help
-distributor.log-received-spans.include-attributesEnable to include span attributes in the logs.help
-distributor.rate-limit-strategy stringWhether the various ingestion rate limits should be applied individually to each distributor instance (local), or evenly shared across the cluster (global).help
-enable-go-runtime-metricsSet to true to enable all Go runtime metricshelp
-generator.address stringThe Kafka backend address.help
-generator.auto-create-topic-default-partitions intWhen auto-creation of Kafka topic is enabled and this value is positive, Kafka's num.partitions configuration option is set on Kafka brokers with this value when Tempo component that uses Kafka…help
-generator.auto-create-topic-enabledEnable auto-creation of Kafka topic if it doesn't exist.help
-generator.client-id stringThe Kafka client ID.help
-generator.consumer-group stringThe consumer group used by the consumer to track the last consumed offset.help
-generator.consumer-group-offset-commit-interval durationHow frequently a consumer should commit the consumed offset to Kafka.help
-generator.consumer_group_lag_metric_update_interval durationHow often the lag metric is updated.help
-generator.dial-timeout durationThe maximum time allowed to open a connection to a Kafka broker.help
-generator.disable-kafka-telemetryDisable KIP-714 Kafka client metricshelp
-generator.instance-availability-zone stringDefine Availability Zone in which this instance is running.help
-generator.instance-id stringInstance id.help
-generator.last-produced-offset-retry-timeout durationHow long to retry a failed request to get the last produced offset.help
-generator.leave-consumer-group-on-shutdownIf true, send LeaveGroup to Kafka on shutdown for immediate partition reassignment.help
-generator.max-consumer-lag-at-startup durationThe guaranteed maximum lag before a consumer is considered to have caught up reading from a partition at startup, becomes ACTIVE in the hash ring and passes the readiness check.help
-generator.producer-max-buffered-bytes intThe maximum size of (uncompressed) buffered and unacknowledged produced records sent to Kafka.help
-generator.producer-max-record-size-bytes intThe maximum size of a Kafka record data that should be generated by the producer.help
-generator.sasl-password valueThe SASL password for authentication.help
-generator.sasl-username stringThe SASL username for authentication.help
-generator.target-consumer-lag-at-startup durationThe best-effort maximum lag a consumer tries to achieve at startup.help
-generator.topic stringThe Kafka topic name.help
-generator.write-timeout durationHow long to wait for an incoming write request to be successfully committed to the Kafka backend.help
-generatorconsul.acl-token valueACL Token used to interact with Consul.help
-generatorconsul.cas-retry-delay durationMaximum duration to wait before retrying a Compare And Swap (CAS) operation.help
-generatorconsul.client-timeout durationHTTP timeout when talking to Consul (default 20s)help
-generatorconsul.consistent-readsEnable consistent reads to Consul.help
-generatorconsul.hostname stringHostname and port of Consul.help
-generatorconsul.watch-burst-size intBurst size used in rate limit.help
-generatorconsul.watch-rate-limit floatRate limit when watching key or prefix in Consul, in requests per second.help
-generatoretcd.dial-timeout durationThe dial timeout for the etcd connection.help
-generatoretcd.endpoints valueThe etcd endpoints to connect to.help
-generatoretcd.max-retries intThe maximum number of retries to do for failed ops.help
-generatoretcd.password valueEtcd password.help
-generatoretcd.tls-ca-path stringPath to the CA certificates to validate server certificate against.help
-generatoretcd.tls-cert-path stringPath to the client certificate, which will be used for authenticating with the server.help
-generatoretcd.tls-cipher-suites stringOverride the default cipher suite list (separated by commas).help
-generatoretcd.tls-enabledEnable TLS.help
-generatoretcd.tls-insecure-skip-verifySkip validating server certificate.help
-generatoretcd.tls-key-path stringPath to the key for the client certificate.help
-generatoretcd.tls-min-version stringOverride the default minimum TLS version.help
-generatoretcd.tls-server-name stringOverride the expected name on the server certificate.help
-generatoretcd.username stringEtcd username.help
-generatormulti.mirror-enabledMirror writes to the secondary store.help
-generatormulti.mirror-timeout durationTimeout for storing a value to the secondary store.help
-generatormulti.primary stringPrimary backend storage used by multi-client.help
-generatormulti.secondary stringSecondary backend storage used by multi-client.help
-generatorprefix stringThe prefix for the keys in the store.help
-generatorstore stringBackend storage to use for the ring.help
-healthRun a health check against the /ready endpoint and exithelp
-health.url stringURL to check when running health check (default "http://localhost:3200/ready")help
-http-api-prefix stringString prefix for all http api endpoints.help
-ingest.address stringThe Kafka backend address.help
-ingest.auto-create-topic-default-partitions intWhen auto-creation of Kafka topic is enabled and this value is positive, Kafka's num.partitions configuration option is set on Kafka brokers with this value when Tempo component that uses Kafka…help
-ingest.auto-create-topic-enabledEnable auto-creation of Kafka topic if it doesn't exist.help
-ingest.client-id stringThe Kafka client ID.help
-ingest.consumer-group stringThe consumer group used by the consumer to track the last consumed offset.help
-ingest.consumer-group-offset-commit-interval durationHow frequently a consumer should commit the consumed offset to Kafka.help
-ingest.consumer_group_lag_metric_update_interval durationHow often the lag metric is updated.help
-ingest.dial-timeout durationThe maximum time allowed to open a connection to a Kafka broker.help
-ingest.disable-kafka-telemetryDisable KIP-714 Kafka client metricshelp
-ingest.last-produced-offset-retry-timeout durationHow long to retry a failed request to get the last produced offset.help
-ingest.max-consumer-lag-at-startup durationThe guaranteed maximum lag before a consumer is considered to have caught up reading from a partition at startup, becomes ACTIVE in the hash ring and passes the readiness check.help
-ingest.producer-max-buffered-bytes intThe maximum size of (uncompressed) buffered and unacknowledged produced records sent to Kafka.help
-ingest.producer-max-record-size-bytes intThe maximum size of a Kafka record data that should be generated by the producer.help
-ingest.sasl-password valueThe SASL password for authentication.help
-ingest.sasl-username stringThe SASL username for authentication.help
-ingest.target-consumer-lag-at-startup durationThe best-effort maximum lag a consumer tries to achieve at startup.help
-ingest.topic stringThe Kafka topic name.help
-ingest.write-timeout durationHow long to wait for an incoming write request to be successfully committed to the Kafka backend.help
-ingester.max-bytes-per-trace intMaximum size of a trace in bytes.help
-ingester.max-global-traces-per-user intMaximum number of active traces per user, across the cluster.help
-ingester.max-traces-per-user intMaximum number of active traces per user, per ingester.help
-live-store.complete-block-timeout durationDuration to keep blocks in the live store after they have been flushed.help
-live-store.concurrent-blocks uintNumber of concurrent blocks to query for metrics.help
-live-store.instance-availability-zone stringDefine Availability Zone in which this instance is running.help
-live-store.metrics.time-overlap-cutoff floatTime overlap cutoff ratio for metrics queries (0.0-1.0).help
-live-store.partition-ring.consul.acl-token valueACL Token used to interact with Consul.help
-live-store.partition-ring.consul.cas-retry-delay durationMaximum duration to wait before retrying a Compare And Swap (CAS) operation.help
-live-store.partition-ring.consul.client-timeout durationHTTP timeout when talking to Consul (default 20s)help
-live-store.partition-ring.consul.consistent-readsEnable consistent reads to Consul.help
-live-store.partition-ring.consul.hostname stringHostname and port of Consul.help
-live-store.partition-ring.consul.watch-burst-size intBurst size used in rate limit.help
-live-store.partition-ring.consul.watch-rate-limit floatRate limit when watching key or prefix in Consul, in requests per second.help
-live-store.partition-ring.delete-inactive-partition-after durationHow long to wait before an INACTIVE partition is eligible for deletion.help
-live-store.partition-ring.etcd.dial-timeout durationThe dial timeout for the etcd connection.help
-live-store.partition-ring.etcd.endpoints valueThe etcd endpoints to connect to.help
-live-store.partition-ring.etcd.max-retries intThe maximum number of retries to do for failed ops.help
-live-store.partition-ring.etcd.password valueEtcd password.help
-live-store.partition-ring.etcd.tls-ca-path stringPath to the CA certificates to validate server certificate against.help
-live-store.partition-ring.etcd.tls-cert-path stringPath to the client certificate, which will be used for authenticating with the server.help
-live-store.partition-ring.etcd.tls-cipher-suites stringOverride the default cipher suite list (separated by commas).help
-live-store.partition-ring.etcd.tls-enabledEnable TLS.help
-live-store.partition-ring.etcd.tls-insecure-skip-verifySkip validating server certificate.help
-live-store.partition-ring.etcd.tls-key-path stringPath to the key for the client certificate.help
-live-store.partition-ring.etcd.tls-min-version stringOverride the default minimum TLS version.help
-live-store.partition-ring.etcd.tls-server-name stringOverride the expected name on the server certificate.help
-live-store.partition-ring.etcd.username stringEtcd username.help
-live-store.partition-ring.min-partition-owners-count intMinimum number of owners to wait before a PENDING partition gets switched to ACTIVE.help
-live-store.partition-ring.min-partition-owners-duration durationHow long the minimum number of owners are enforced before a PENDING partition gets switched to ACTIVE.help
-live-store.partition-ring.multi.mirror-enabledMirror writes to the secondary store.help
-live-store.partition-ring.multi.mirror-timeout durationTimeout for storing a value to the secondary store.help
-live-store.partition-ring.multi.primary stringPrimary backend storage used by multi-client.help
-live-store.partition-ring.multi.secondary stringSecondary backend storage used by multi-client.help
-live-store.partition-ring.prefix stringThe prefix for the keys in the store.help
-live-store.partition-ring.store stringBackend storage to use for the ring.help
-live-store.readiness-max-wait durationMaximum time to wait for catching up at startup.help
-live-store.readiness-target-lag durationTarget lag threshold before live-store is ready.help
-live-store.remove-owner-on-shutdownRemove partition owner from the ring on shutdown.help
-live-store.shutdown_marker_dir stringPath to the shutdown marker directory.help
-live-store.wal.path stringPath at which store WAL blocks.help
-live-storeconsul.acl-token valueACL Token used to interact with Consul.help
-live-storeconsul.cas-retry-delay durationMaximum duration to wait before retrying a Compare And Swap (CAS) operation.help
-live-storeconsul.client-timeout durationHTTP timeout when talking to Consul (default 20s)help
-live-storeconsul.consistent-readsEnable consistent reads to Consul.help
-live-storeconsul.hostname stringHostname and port of Consul.help
-live-storeconsul.watch-burst-size intBurst size used in rate limit.help
-live-storeconsul.watch-rate-limit floatRate limit when watching key or prefix in Consul, in requests per second.help
-live-storeetcd.dial-timeout durationThe dial timeout for the etcd connection.help
-live-storeetcd.endpoints valueThe etcd endpoints to connect to.help
-live-storeetcd.max-retries intThe maximum number of retries to do for failed ops.help
-live-storeetcd.password valueEtcd password.help
-live-storeetcd.tls-ca-path stringPath to the CA certificates to validate server certificate against.help
-live-storeetcd.tls-cert-path stringPath to the client certificate, which will be used for authenticating with the server.help
-live-storeetcd.tls-cipher-suites stringOverride the default cipher suite list (separated by commas).help
-live-storeetcd.tls-enabledEnable TLS.help
-live-storeetcd.tls-insecure-skip-verifySkip validating server certificate.help
-live-storeetcd.tls-key-path stringPath to the key for the client certificate.help
-live-storeetcd.tls-min-version stringOverride the default minimum TLS version.help
-live-storeetcd.tls-server-name stringOverride the expected name on the server certificate.help
-live-storeetcd.username stringEtcd username.help
-live-storemulti.mirror-enabledMirror writes to the secondary store.help
-live-storemulti.mirror-timeout durationTimeout for storing a value to the secondary store.help
-live-storemulti.primary stringPrimary backend storage used by multi-client.help
-live-storemulti.secondary stringSecondary backend storage used by multi-client.help
-live-storeprefix stringThe prefix for the keys in the store.help
-live-storestore stringBackend storage to use for the ring.help
-log.level valueOnly log messages with the given severity or above.help
-memberlist.bind-port intPort for memberlist to communicate on (default 7946)help
-memberlist.host-port valueHost port to connect to memberlist cluster.help
-memberlist.message-history-buffer-bytes inthelp
-metrics-generator.native-histogram-bucket-factor floatThe growth factor between buckets for native histograms.help
-metrics-generator.native-histogram-max-bucket-number valueThe maximum number of buckets for native histograms.help
-metrics-generator.native-histogram-min-reset-duration durationThe minimum duration before a native histogram can be reset.help
-multitenancy.enabledSet to true to enable multitenancy.help
-mutex-profile-fraction intOverride default mutex profiling fraction.help
-querier.frontend-address stringAddress of query frontend service, in host:port format.help
-querier.max-blocks-per-tag-values-query intMaximum number of blocks to query for a tag-values query.help
-querier.max-bytes-per-tag-values-query intMaximum size of response for a tag-values query.help
-querier.max-condition-groups-per-tag-query intMaximum number of OR-expanded condition groups allowed in a tag search query.help
-query-frontend.mcp-server.enabledSet to true to enable the MCP serverhelp
-reporting.backoff-max-period durationMaximum delay when backing off.help
-reporting.backoff-min-period durationMinimum delay when backing off.help
-reporting.backoff-retries intNumber of times to backoff and retry before failing.help
-reporting.enabledEnable anonymous usage reporting.help
-server.grpc-listen-port intgRPC server listen port.help
-server.http-listen-port intHTTP server listen port.help
-shutdown-delay durationHow long to wait between SIGTERM and shutdown.help
-span-profilingSet to true to enable span profiling (pyroscope pprof labels on OTel spans).help
-storage.trace.azure.container_name stringAzure container name to store blocks in.help
-storage.trace.azure.endpoint stringAzure endpoint to push blocks to.help
-storage.trace.azure.max_buffers intNumber of simultaneous uploads.help
-storage.trace.azure.prefix stringAzure container prefix to store blocks in.help
-storage.trace.azure.storage_account_key valueAzure storage access key.help
-storage.trace.azure.storage_account_name stringAzure storage account name.help
-storage.trace.backend stringTrace backend (s3, azure, gcs, local)help
-storage.trace.block.v2-bloom-filter-false-positive floatBloom Filter False Positive.help
-storage.trace.block.v2-bloom-filter-shard-size-bytes intBloom Filter Shard Size in bytes.help
-storage.trace.blocklist_poll durationPeriod at which to run the maintenance cycle.help
-storage.trace.gcs.bucket stringgcs bucket to store traces in.help
-storage.trace.gcs.list_blocks_concurrency intnumber of concurrent list calls to make to backend (default 3)help
-storage.trace.gcs.max_retries intnumber of times to retry failed compaction/retention operations (default 3)help
-storage.trace.gcs.prefix stringgcs bucket prefix to store traces in.help
-storage.trace.local.path stringpath to store traces at.help
-storage.trace.pool.max-workers intWorkers in the worker pool.help
-storage.trace.pool.queue-depth intWork item queue depth.help
-storage.trace.s3.access_key strings3 access key.help
-storage.trace.s3.bucket strings3 bucket to store blocks in.help
-storage.trace.s3.endpoint strings3 endpoint to push blocks to.help
-storage.trace.s3.list_blocks_concurrency intnumber of concurrent list calls to make to backend (default 3)help
-storage.trace.s3.prefix strings3 root directory to store blocks in.help
-storage.trace.s3.secret_key values3 secret key.help
-storage.trace.s3.session_token values3 session token.help
-storage.trace.s3.sse.encryption-key valueSSE-C Encryption Key used for object encryption.help
-storage.trace.s3.sse.kms-encryption-context stringKMS Encryption Context used for object encryption.help
-storage.trace.s3.sse.kms-key-id stringKMS Key ID used to encrypt objects in S3help
-storage.trace.s3.sse.type stringEnable AWS Server Side Encryption.help
-storage.trace.s3.tls_min_version stringminimum version of TLS to use when connecting to s3.help
-storage.trace.wal.path stringPath at which store WAL blocks.help
-target stringtarget module (default "all")help
-versionPrint this builds version informationhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.