OS Manuals

/usr/bin/victoria-traces

VictoriaTraces is a fast, easy-to-use database for distributed tracing spans, built on the VictoriaLogs storage engine.

From victoriatraces-fips 0.13.0-r2 (enterprise-packages), captured 2026-11-09 by running victoria-traces --help (exit 0) · terse output. permalink

2026/11/09 15:22:40 INFO: metrics: disable exposing PSI metrics because of failed init: open /sys/fs/cgroup/cpu.pressure: no such file or directory

victoria-traces is a traces storage and analytics service.

See the docs at https://docs.victoriametrics.com/victoriatraces/

  -blockcache.missesBeforeCaching int
    	The number of cache misses before putting the block into cache. Higher values may reduce indexdb/dataBlocks cache size at the cost of higher CPU and disk read usage (default 2)
  -defaultMsgValue string
    	Default value for _msg field; see https://docs.victoriametrics.com/victorialogs/keyconcepts/#message-field (default "-")
  -defaultParallelReaders int
    	Default number of parallel data readers to use for executing every query; higher number of readers may help increasing query performance on high-latency storage such as NFS or S3 at the cost of higher RAM usage; see https://docs.victoriametrics.com/victorialogs/logsql/#parallel_readers-query-option (default 128 = 2x CPU cores)
  -delete.enable
    	Whether to enable /delete/* HTTP endpoints
  -deleteAuthKey value
    	authKey, which must be passed in query string to /delete/* . It overrides -httpAuth.* .
    	Flag value can be read from the given file when using -deleteAuthKey=file:///abs/path/to/file or -deleteAuthKey=file://./relative/path/to/file.
    	Flag value can be read from the given http/https url when using -deleteAuthKey=http://host/path or -deleteAuthKey=https://host/path
  -enableTCP6
    	Whether to enable IPv6 for listening and dialing. By default, only IPv4 TCP and UDP are used
  -envflag.enable
    	Whether to enable reading flags from environment variables in addition to the command line. Command line flag values have priority over values from environment vars. Flags are read only from the command line if this flag isn't set. See https://docs.victoriametrics.com/victoriametrics/single-server-victoriametrics/#environment-variables for more details
  -envflag.prefix string
    	Prefix for environment variables if -envflag.enable is set
  -filestream.disableFadvise
    	Whether to disable fadvise() syscall when reading large data files. The fadvise() syscall prevents from eviction of recently accessed data from OS page cache during background merges and backups. In some rare cases it is better to disable the syscall if it uses too much CPU
  -flagsAuthKey value
    	Auth key for /flags endpoint. It must be passed via authKey query arg. It overrides -httpAuth.*
    	Flag value can be read from the given file when using -flagsAuthKey=file:///abs/path/to/file or -flagsAuthKey=file://./relative/path/to/file.
    	Flag value can be read from the given http/https url when using -flagsAuthKey=http://host/path or -flagsAuthKey=https://host/path
  -forceFlushAuthKey value
    	authKey, which must be passed in query string to /internal/force_flush . It overrides -httpAuth.* . See https://docs.victoriametrics.com/victoriatraces/#forced-flush
    	Flag value can be read from the given file when using -forceFlushAuthKey=file:///abs/path/to/file or -forceFlushAuthKey=file://./relative/path/to/file.
    	Flag value can be read from the given http/https url when using -forceFlushAuthKey=http://host/path or -forceFlushAuthKey=https://host/path
  -forceMergeAuthKey value
    	authKey, which must be passed in query string to /internal/force_merge . It overrides -httpAuth.* . See https://docs.victoriametrics.com/victoriatraces/#forced-merge
    	Flag value can be read from the given file when using -forceMergeAuthKey=file:///abs/path/to/file or -forceMergeAuthKey=file://./relative/path/to/file.
    	Flag value can be read from the given http/https url when using -forceMergeAuthKey=http://host/path or -forceMergeAuthKey=https://host/path
  -fs.disableAdviseRandomRead
    	Whether to disable FADV_RANDOM and MADV_RANDOM hints for data part files. Typical queries with selectors access data part files at random offsets, so FADV_RANDOM is enforced to reduce excessive disk readahead.Use this flag if your query read pattern benefits from sequential read (e.g. query by metric name without selectors) to prefer FADV_NORMAL. (default true)
  -fs.disableMincore
    	Whether to disable the mincore() syscall for checking mmap()ed files. By default, mincore() is used to detect whether mmap()ed file pages are resident in memory. Disabling mincore() may be needed on older ZFS filesystems (below 2.1.5), since it may trigger ZFS bug. See https://github.com/VictoriaMetrics/VictoriaMetrics/issues/10327 for details.
  -fs.disableMmap
    	Whether to use pread() instead of mmap() for reading data files. By default, mmap() is used for 64-bit arches and pread() is used for 32-bit arches, since they cannot read data files bigger than 2^32 bytes in memory. mmap() is usually faster for reading small data chunks than pread()
  -fs.maxConcurrency int
    	The maximum number of concurrent goroutines to work with files; smaller values may help reducing Go scheduling latency on systems with small number of CPU cores; higher values may help reducing data ingestion latency on systems with high-latency storage such as NFS or Ceph (default 256 = 16x CPU cores, capped at 256)
  -futureRetention value
    	Log entries with timestamps bigger than now+futureRetention are rejected during data ingestion; see https://docs.victoriametrics.com/victoriatraces/#retention
    	The following optional suffixes are supported: s (second), h (hour), d (day), w (week), M (month), y (year). If suffix isn't set, then the duration is counted in months (default 2d)
  -healthcheck
    	Whether to check that the running process accepts connections at -httpListenAddr and exit. The exit code is non-zero if the check fails. This is useful for Docker HEALTHCHECK in images without curl or wget. Pass the same -httpListenAddr as the checked process has
  -http.connTimeout duration
    	Incoming connections to -httpListenAddr are closed after the configured timeout. This may help evenly spreading load among a cluster of services behind TCP-level load balancer. Zero value disables closing of incoming connections (default 2m0s)
  -http.disableCORS
    	Disable CORS for all origins (*)
  -http.disableKeepAlive
    	Whether to disable HTTP keep-alive for incoming connections at -httpListenAddr
  -http.disableResponseCompression
    	Disable compression of HTTP responses to save CPU resources. By default, compression is enabled to save network bandwidth
  -http.header.csp string
    	Value for 'Content-Security-Policy' header, recommended: "default-src 'self'"
  -http.header.disableServerHostname
    	Whether to disable 'X-Server-Hostname' header in HTTP responses
  -http.header.frameOptions string
    	Value for 'X-Frame-Options' header
  -http.header.hsts string
    	Value for 'Strict-Transport-Security' header, recommended: 'max-age=31536000; includeSubDomains'
  -http.idleConnTimeout duration
    	Timeout for incoming idle http connections (default 1m0s)
  -http.maxGracefulShutdownDuration duration
    	The maximum duration for a graceful shutdown of the HTTP server. During this period the server stops accepting new connections, but it will continue serving existing connections. The remaining in-flight requests are canceled before the deadline, so the shutdown can finish within this duration. A highly loaded server may require increased value for a graceful shutdown (default 7s)
  -http.pathPrefix string
    	An optional prefix to add to all the paths handled by http server. For example, if '-http.pathPrefix=/foo/bar' is set, then all the http requests will be handled on '/foo/bar/*' paths. This may be useful for proxied requests. See https://www.robustperception.io/using-external-urls-and-proxies-with-prometheus
  -http.shutdownDelay duration
    	Optional delay before http server shutdown. During this delay, the server returns non-OK responses from /health page, so load balancers can route new requests to other servers
  -httpAuth.password value
    	Password for HTTP server's Basic Auth. The authentication is disabled if -httpAuth.username is empty
    	Flag value can be read from the given file when using -httpAuth.password=file:///abs/path/to/file or -httpAuth.password=file://./relative/path/to/file.
    	Flag value can be read from the given http/https url when using -httpAuth.password=http://host/path or -httpAuth.password=https://host/path
  -httpAuth.username string
    	Username for HTTP server's Basic Auth. The authentication is disabled if empty. See also -httpAuth.password
  -httpListenAddr array
    	Addresses to listen for incoming http requests. Use unix:/path/to/socket to listen on Unix domain socket. Note that -tls and -httpListenAddr.useProxyProtocol cannot be used with Unix sockets
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -httpListenAddr.useProxyProtocol array
    	Whether to use proxy protocol for connections accepted at the given -httpListenAddr . See https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt . With enabled proxy protocol http server cannot serve regular /metrics endpoint. Use -pushmetrics.url for metrics pushing
    	Supports array of values separated by comma or specified via multiple flags.
    	Empty values are set to false.
  -inmemoryDataFlushInterval duration
    	The interval for guaranteed saving of in-memory data to disk. The saved data survives unclean shutdowns such as OOM crash, hardware reset, SIGKILL, etc. Bigger intervals may help increase the lifetime of flash storage with limited write cycles (e.g. Raspberry PI). Smaller intervals increase disk IO load. Minimum supported value is 1s (default 5s)
  -insert.concurrency int
    	The average number of concurrent data ingestion requests, which can be sent to every -storageNode (default 2)
  -insert.disable
    	Whether to disable both /insert/* and /internal/insert HTTP endpoints and OpenTelemetry gRPC ingestion endpoint. Useful for dedicated vtselect nodes. See also -internalinsert.disable. See https://docs.victoriametrics.com/victoriatraces/cluster/#security
  -insert.disableCompression
    	Whether to disable compression when sending the ingested data to -storageNode nodes. Disabled compression reduces CPU usage at the cost of higher network usage
  -insert.drainTimeout duration
    	The maximum duration for draining the in-memory buffered spans to -storageNode nodes on graceful shutdown; the spans, which cannot be drained within this duration, are dropped (default 5s)
  -insert.indexFlushInterval duration
    	Amount of time after which the index of a trace is flushed. VictoriaTraces creates an index for each trace ID based on its start and end times.Each trace ID must wait in the queue for -insert.indexFlushInterval, continuously updating its start and end times before being flushed into the index. (default 20s)
  -insert.maxFieldsPerLine int
    	The maximum number of log fields per line, which can be read by /insert/* handlers; see https://docs.victoriametrics.com/victorialogs/faq/#how-many-fields-a-single-log-entry-may-contain (default 1000)
  -insert.maxQueueDuration duration
    	The maximum duration to wait in the queue when -maxConcurrentInserts concurrent insert requests are executed (default 1m0s)
  -internStringCacheExpireDuration duration
    	The expiry duration for caches for interned strings. See https://en.wikipedia.org/wiki/String_interning . See also -internStringMaxLen and -internStringDisableCache (default 6m0s)
  -internStringDisableCache
    	Whether to disable caches for interned strings. This may reduce memory usage at the cost of higher CPU usage. See https://en.wikipedia.org/wiki/String_interning . See also -internStringCacheExpireDuration and -internStringMaxLen
  -internStringMaxLen int
    	The maximum length for strings to intern. A lower limit may save memory at the cost of higher CPU usage. See https://en.wikipedia.org/wiki/String_interning . See also -internStringDisableCache and -internStringCacheExpireDuration (default 500)
  -internaldelete.enable
    	Whether to enable /internal/delete/* HTTP endpoints, which are used by vtselect for deleting spans via delete API at vtstorage nodes
  -internalinsert.disable
    	Whether to disable /internal/insert HTTP endpoint. See also -insert.disable. See https://docs.victoriametrics.com/victoriatraces/cluster/#security
  -internalinsert.maxRequestSize size
    	The maximum size in bytes of a single request, which can be accepted at /internal/insert HTTP endpoint
    	Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 67108864)
  -internalselect.disable
    	Whether to disable /internal/select/* HTTP endpoints
  -internalselect.maxConcurrentRequests int
    	The limit on the number of concurrent requests to /internal/select/* endpoints; other requests are put into the wait queue; see https://docs.victoriametrics.com/victoriatraces/cluster/ (default 8)
  -logIngestedRows
    	Whether to log all the ingested trace spans; this can be useful for debugging of data ingestion; see https://docs.victoriametrics.com/victoriatraces/data-ingestion/ ; see also -logNewStreams
  -logNewStreams
    	Whether to log creation of new streams; this can be useful for debugging of high cardinality issues with log streams; see https://docs.victoriametrics.com/victoriatraces/keyconcepts/#stream-fields ; see also -logIngestedRows
  -logNewStreamsAuthKey value
    	authKey, which must be passed in query string to /internal/log_new_streams . It overrides -httpAuth.* . See https://docs.victoriametrics.com/victorialogs/#logging-new-streams
    	Flag value can be read from the given file when using -logNewStreamsAuthKey=file:///abs/path/to/file or -logNewStreamsAuthKey=file://./relative/path/to/file.
    	Flag value can be read from the given http/https url when using -logNewStreamsAuthKey=http://host/path or -logNewStreamsAuthKey=https://host/path
  -loggerDisableTimestamps
    	Whether to disable writing timestamps in logs
  -loggerErrorsPerSecondLimit int
    	Per-second limit on the number of ERROR messages. If more than the given number of errors are emitted per second, the remaining errors are suppressed. Zero values disable the rate limit
  -loggerFormat string
    	Format for logs. Possible values: default, json (default "default")
  -loggerJSONFields string
    	Allows renaming fields in JSON formatted logs. Example: "ts:timestamp,msg:message" renames "ts" to "timestamp" and "msg" to "message". Supported fields: ts, level, caller, msg
  -loggerLevel string
    	Minimum level of errors to log. Possible values: INFO, WARN, ERROR, FATAL, PANIC (default "INFO")
  -loggerMaxArgLen int
    	The maximum length of a single logged argument. Longer arguments are replaced with 'arg_start..arg_end', where 'arg_start' and 'arg_end' is prefix and suffix of the arg with the length not exceeding -loggerMaxArgLen / 2 (default 5000)
  -loggerOutput string
    	Output for the logs. Supported values: stderr, stdout (default "stderr")
  -loggerTimezone string
    	Timezone to use for timestamps in logs. Timezone must be a valid IANA Time Zone. For example: America/New_York, Europe/Berlin, Etc/GMT+3 or Local (default "UTC")
  -loggerWarnsPerSecondLimit int
    	Per-second limit on the number of WARN messages. If more than the given number of warns are emitted per second, then the remaining warns are suppressed. Zero values disable the rate limit
  -maxBackfillAge value
    	Trace spans with timestamps older than now-maxBackfillAge are rejected during data ingestion; see https://docs.victoriametrics.com/victorialogs/#backfilling
    	The following optional suffixes are supported: s (second), h (hour), d (day), w (week), M (month), y (year). If suffix isn't set, then the duration is counted in months (default 0)
  -maxConcurrentInserts int
    	The maximum number of concurrent insert requests. Set higher value when clients send data over slow networks. Default value depends on the number of available CPU cores. It should work fine in most cases since it minimizes resource usage. See also -insert.maxQueueDuration (default 128 = 2x CPU cores)
  -memory.allowedBytes size
    	Allowed size of system memory VictoriaMetrics caches may occupy. This option overrides -memory.allowedPercent if set to a non-zero value. Too low a value may increase the cache miss rate usually resulting in higher CPU and disk IO usage. Too high a value may evict too much data from the OS page cache resulting in higher disk IO usage. The process may behave unexpectedly if this flag is set too small (e.g., 1 byte).
    	Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 0)
  -memory.allowedPercent float
    	Allowed percent of system memory VictoriaMetrics caches may occupy. See also -memory.allowedBytes. Too low a value may increase cache miss rate usually resulting in higher CPU and disk IO usage. Too high a value may evict too much data from the OS page cache which will result in higher disk IO usage (default 60)
  -metrics.exposeMetadata
    	Whether to expose TYPE and HELP metadata at the /metrics page, which is exposed at -httpListenAddr . The metadata may be needed when the /metrics page is consumed by systems, which require this information. For example, Managed Prometheus in Google Cloud - https://cloud.google.com/stackdriver/docs/managed-prometheus/troubleshooting#missing-metric-type
  -metricsAuthKey value
    	Auth key for /metrics endpoint. It must be passed via authKey query arg. It overrides -httpAuth.*
    	Flag value can be read from the given file when using -metricsAuthKey=file:///abs/path/to/file or -metricsAuthKey=file://./relative/path/to/file.
    	Flag value can be read from the given http/https url when using -metricsAuthKey=http://host/path or -metricsAuthKey=https://host/path
  -nativeinsert.maxRequestSize size
    	The maximum size in bytes of a single request, which can be accepted at /insert/native and /insert/multitenant/native HTTP endpoints
    	Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 67108864)
  -opentelemetry.traces.maxRequestSize size
    	The maximum size in bytes of a single OpenTelemetry trace export request.
    	Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 33554432)
  -otlpGRPC.tls array
    	Whether to enable TLS for incoming gRPC requests at the given -otlpGRPCListenAddr. -otlpGRPC.tlsCertFile and -otlpGRPC.tlsKeyFile must be set if -otlpGRPC.tls is set
    	Supports array of values separated by comma or specified via multiple flags.
    	Empty values are set to false.
  -otlpGRPC.tlsCertFile array
    	Path to file with TLS certificate for the corresponding -otlpGRPCListenAddr if -otlpGRPC.tls is set. Prefer ECDSA certs instead of RSA certs as RSA certs are slower. The provided certificate file is automatically re-read every second, so it can be dynamically updated
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -otlpGRPC.tlsCipherSuites array
    	Optional list of TLS cipher suites for incoming requests over HTTPS if -otlpGRPC.tls is set. See the list of supported cipher suites at https://pkg.go.dev/crypto/tls#pkg-constants
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -otlpGRPC.tlsKeyFile array
    	Path to file with TLS key for the corresponding -otlpGRPCListenAddr if -otlpGRPC.tls is set. The provided key file is automatically re-read every second, so it can be dynamically updated
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -otlpGRPC.tlsMinVersion array
    	Optional minimum TLS version to use for the corresponding -otlpGRPCListenAddr if -otlpGRPC.tls is set. Supported values: TLS10, TLS11, TLS12, TLS13
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -otlpGRPCListenAddr string
    	TCP address for accepting OTLP gRPC requests. Defaults to empty, which means it is disabled. The recommended port is ":4317". See also -otlpGRPC.tls
  -partitionManageAuthKey value
    	authKey, which must be passed in query string to /internal/partition/* . It overrides -httpAuth.* . See https://docs.victoriametrics.com/victoriatraces/#partitions-lifecycle
    	Flag value can be read from the given file when using -partitionManageAuthKey=file:///abs/path/to/file or -partitionManageAuthKey=file://./relative/path/to/file.
    	Flag value can be read from the given http/https url when using -partitionManageAuthKey=http://host/path or -partitionManageAuthKey=https://host/path
  -pprofAuthKey value
    	Auth key for /debug/pprof/* endpoints. It must be passed via authKey query arg. It overrides -httpAuth.*
    	Flag value can be read from the given file when using -pprofAuthKey=file:///abs/path/to/file or -pprofAuthKey=file://./relative/path/to/file.
    	Flag value can be read from the given http/https url when using -pprofAuthKey=http://host/path or -pprofAuthKey=https://host/path
  -pushmetrics.disableCompression
    	Whether to disable request body compression when pushing metrics to every -pushmetrics.url
  -pushmetrics.extraLabel array
    	Optional labels to add to metrics pushed to every -pushmetrics.url . For example, -pushmetrics.extraLabel='instance="foo"' adds instance="foo" label to all the metrics pushed to every -pushmetrics.url
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -pushmetrics.header array
    	Optional HTTP request header to send to every -pushmetrics.url . For example, -pushmetrics.header='Authorization: Basic foobar' adds 'Authorization: Basic foobar' header to every request to every -pushmetrics.url
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -pushmetrics.interval duration
    	Interval for pushing metrics to every -pushmetrics.url (default 10s)
  -pushmetrics.url array
    	Optional URL to push metrics exposed at /metrics page. See https://docs.victoriametrics.com/victoriametrics/single-server-victoriametrics/#push-metrics . By default, metrics exposed at /metrics page aren't pushed to any remote storage
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -retention.maxDiskSpaceUsageBytes size
    	The maximum disk space usage at -storageDataPath before older per-day partitions are automatically dropped; see https://docs.victoriametrics.com/victoriatraces/#retention-by-disk-space-usage ; see also -retentionPeriod
    	Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 0)
  -retention.maxDiskUsagePercent int
    	The maximum allowed disk usage percentage (1-100) for the filesystem that contains -storageDataPath before older per-day partitions are automatically dropped; mutually exclusive with -retention.maxDiskSpaceUsageBytes; see https://docs.victoriametrics.com/victoriatraces/#retention-by-disk-space-usage-percent
  -retentionPeriod value
    	Trace spans with timestamps older than now-retentionPeriod are automatically deleted; trace spans with timestamps outside the retention are also rejected during data ingestion; the minimum supported retention is 1d (one day); see https://docs.victoriametrics.com/victoriatraces/#retention ; see also -retention.maxDiskSpaceUsageBytes and -retention.maxDiskUsagePercent
    	The following optional suffixes are supported: s (second), h (hour), d (day), w (week), M (month), y (year). If suffix isn't set, then the duration is counted in months (default 7d)
  -search.allowPartialResponse
    	Whether to allow returning partial responses when some of vtstorage nodes from the -storageNode list are unavailable for querying. This flag works only for cluster setup of VictoriaTraces. See https://docs.victoriametrics.com/victoriatraces/querying/#partial-responses
  -search.fieldsLookbehind duration
    	The default time range of searching for normal fields (tags and attributes).It affects various Tempo tag-related APIs. (default 2h0m0s)
  -search.latencyOffset duration
    	The time when a trace become visible in query results after the collection. see -insert.indexFlushInterval as well. (default 30s)
  -search.logSlowQueryDuration duration
    	Log queries with execution time exceeding this value. Zero disables slow query logging (default 5s)
  -search.maxConcurrentRequests int
    	The maximum number of concurrent search requests. It shouldn't be high, since a single request can saturate all the CPU cores, while many concurrently executed requests may require high amounts of memory. See also -search.maxQueueDuration (default 16 = 2x CPU cores when there are 4 or fewer; otherwise CPU cores, capped at 16)
  -search.maxQueryDuration duration
    	The maximum duration for query execution. It can be overridden to a smaller value on a per-query basis via 'timeout' query arg (default 30s)
  -search.maxQueryLen size
    	The maximum query length in bytes, which can be passed to /select/* endpoints
    	Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 16384)
  -search.maxQueryTimeRange value
    	The maximum time range, which can be set in the query sent to querying APIs. Queries with bigger time ranges are rejected. See https://docs.victoriametrics.com/victorialogs/querying/#resource-usage-limits
    	The following unit suffixes are required: s (second), m (minute), h (hour), d (day), w (week), y (year). Bare numbers without units are not allowed (except 0) (default 0)
  -search.maxQueueDuration duration
    	The maximum time the search request waits for execution when -search.maxConcurrentRequests limit is reached; see also -search.maxQueryDuration (default 10s)
  -search.maxTags int
    	The maximum number of tags (including service name, span name) that can be returned in a single search request. This limit applies to Jaeger’s /api/services, /api/services/*/operations APIs, and various Tempo tag-related APIs. (default 1000)
  -search.maxTraces int
    	The maximum number of traces that can be returned in a single search request. Users may request with different limit value via query argument which shouldn't exceed this limit. This limit applies to Jaeger’s /api/traces API and Tempo's /api/search API. (default 1000)
  -search.streamFieldsLookbehind duration
    	The default time range of searching for stream fields (service name and span name).It affects Jaeger's /api/services and /api/services/*/operations APIs. (default 72h0m0s)
  -search.traceMaxDurationWindow duration
    	The window of searching for the rest trace spans after finding one span.It allows extending the search start time and end time by -search.traceMaxDurationWindow to make sure all spans are included.It affects both Jaeger's /api/traces and /api/traces/<trace_id> APIs. (default 1m0s)
  -search.traceMaxServiceNameList uint
    	Deprecated, see -search.maxTags. (default 1000)
  -search.traceMaxSpanNameList uint
    	Deprecated, see -search.maxTags. (default 1000)
  -search.traceSearchStep duration
    	Splits the [0, now] time range into many small time ranges by -search.traceSearchStep when searching for spans by trace_id. Once it finds spans in a time range, it performs an additional search according to -search.traceMaxDurationWindow and then stops. It affects Jaeger's /api/traces/<trace_id> API. (default 24h0m0s)
  -search.traceServiceAndSpanNameLookbehind duration
    	Deprecated, see -search.tagsLookbehind. (default 72h0m0s)
  -secret.flags array
    	Comma-separated list of flag names with secret values. Values for these flags are hidden in logs and on /metrics page
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -select.disable
    	Whether to disable both /select/* and /internal/select/* HTTP endpoints. Useful for dedicated vtinsert nodes; see also -internalselect.disable
  -select.disableCompression
    	Whether to disable compression for select query responses received from -storageNode nodes. Disabled compression reduces CPU usage at the cost of higher network usage
  -servicegraph.databaseTaskLimit uint
    	How many service-database graph relations each task could fetch for each tenant. It requires setting -servicegraph.enableTask=true. Setting it to 0 will stop VictoriaTraces from generating service-database graph relations. (default 1000)
  -servicegraph.enableTask
    	Whether to enable background task for generating service graph. It should only be enabled on VictoriaTraces single-node or vtstorage.
  -servicegraph.taskInterval duration
    	The background task interval for generating service graph data. It requires setting -servicegraph.enableTask=true. (default 1m0s)
  -servicegraph.taskLimit uint
    	How many service graph relations each task could fetch for each tenant. It requires setting -servicegraph.enableTask=true. (default 1000)
  -servicegraph.taskLookbehind duration
    	The lookbehind window for each time service graph background task run. It requires setting -servicegraph.enableTask=true. (default 1m0s)
  -servicegraph.taskTimeout duration
    	The background task timeout duration for generating service graph data. It requires setting -servicegraph.enableTask=true. (default 30s)
  -snapshotsMaxAge value
    	Snapshots are automatically deleted after the given duration if it is set to positive value. Make sure that the backup process has enough time for backing up the snapshot before its' deletion. See https://docs.victoriametrics.com/victorialogs/#how-to-remove-snapshots
    	The following optional suffixes are supported: s (second), h (hour), d (day), w (week), M (month), y (year). If suffix isn't set, then the duration is counted in months (default 3d)
  -storage.minFreeDiskSpaceBytes size
    	The minimum free disk space at -storageDataPath after which the storage stops accepting new data
    	Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 10000000)
  -storageDataPath string
    	Path to directory where to store VictoriaTraces data; see https://docs.victoriametrics.com/victoriatraces/#storage (default "victoria-traces-data")
  -storageNode array
    	Comma-separated list of TCP addresses for storage nodes to route the ingested spans to and to send select queries to. If the list is empty, then the ingested spans are stored and queried locally from -storageDataPath
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -storageNode.bearerToken array
    	Optional bearer auth token to use for the corresponding -storageNode
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -storageNode.bearerTokenFile array
    	Optional path to bearer token file to use for the corresponding -storageNode. The token is re-read from the file every second
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -storageNode.password array
    	Optional basic auth password to use for the corresponding -storageNode
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -storageNode.passwordFile array
    	Optional path to basic auth password to use for the corresponding -storageNode. The file is re-read every second
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -storageNode.tls array
    	Whether to use TLS (HTTPS) protocol for communicating with the corresponding -storageNode. By default communication is performed via HTTP
    	Supports array of values separated by comma or specified via multiple flags.
    	Empty values are set to false.
  -storageNode.tlsCAFile array
    	Optional path to TLS CA file to use for verifying connections to the corresponding -storageNode. By default, system CA is used
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -storageNode.tlsCertFile array
    	Optional path to client-side TLS certificate file to use when connecting to the corresponding -storageNode
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -storageNode.tlsInsecureSkipVerify array
    	Whether to skip tls verification when connecting to the corresponding -storageNode
    	Supports array of values separated by comma or specified via multiple flags.
    	Empty values are set to false.
  -storageNode.tlsKeyFile array
    	Optional path to client-side TLS certificate key to use when connecting to the corresponding -storageNode
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -storageNode.tlsServerName array
    	Optional TLS server name to use for connections to the corresponding -storageNode. By default, the server name from -storageNode is used
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -storageNode.username array
    	Optional basic auth username to use for the corresponding -storageNode
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -storageNode.usernameFile array
    	Optional path to basic auth username to use for the corresponding -storageNode. The file is re-read every second
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -tls array
    	Whether to enable TLS for incoming HTTP requests at the given -httpListenAddr (aka https). -tlsCertFile and -tlsKeyFile must be set if -tls is set. See also -mtls
    	Supports array of values separated by comma or specified via multiple flags.
    	Empty values are set to false.
  -tlsCertFile array
    	Path to file with TLS certificate for the corresponding -httpListenAddr if -tls is set. Prefer ECDSA certs instead of RSA certs as RSA certs are slower. The provided certificate file is automatically re-read every second, so it can be dynamically updated. See also -tlsAutocertHosts
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -tlsCipherSuites array
    	Optional list of TLS cipher suites for incoming requests over HTTPS if -tls is set. See the list of supported cipher suites at https://pkg.go.dev/crypto/tls#pkg-constants
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -tlsKeyFile array
    	Path to file with TLS key for the corresponding -httpListenAddr if -tls is set. The provided key file is automatically re-read every second, so it can be dynamically updated. See also -tlsAutocertHosts
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -tlsMinVersion array
    	Optional minimum TLS version to use for the corresponding -httpListenAddr if -tls is set. Supported values: TLS10, TLS11, TLS12, TLS13
    	Supports an array of values separated by comma or specified via multiple flags.
    	Each array item can contain comma inside single-quoted or double-quoted string, {}, [] and () braces.
  -version
    	Show VictoriaMetrics version
  -vmalert.proxyURL string
    	Optional URL for proxying requests to vmalert; see https://docs.victoriametrics.com/victoriatraces/#vmalert
Options (135)
OptionDescriptionSource
-blockcache.missesBeforeCaching intThe number of cache misses before putting the block into cache.help
-defaultMsgValue stringDefault value for _msg field;help
-defaultParallelReaders intDefault number of parallel data readers to use for executing every query;help
-delete.enableWhether to enable /delete/* HTTP endpointshelp
-deleteAuthKey valueauthKey, which must be passed in query string to /delete/* .help
-enableTCP6Whether to enable IPv6 for listening and dialing.help
-envflag.enableWhether to enable reading flags from environment variables in addition to the command line.help
-envflag.prefix stringPrefix for environment variables if -envflag.enable is sethelp
-filestream.disableFadviseWhether to disable fadvise() syscall when reading large data files.help
-flagsAuthKey valueAuth key for /flags endpoint.help
-forceFlushAuthKey valueauthKey, which must be passed in query string to /internal/force_flush .help
-forceMergeAuthKey valueauthKey, which must be passed in query string to /internal/force_merge .help
-fs.disableAdviseRandomReadWhether to disable FADV_RANDOM and MADV_RANDOM hints for data part files.help
-fs.disableMincoreWhether to disable the mincore() syscall for checking mmap()ed files.help
-fs.disableMmapWhether to use pread() instead of mmap() for reading data files.help
-fs.maxConcurrency intThe maximum number of concurrent goroutines to work with files;help
-futureRetention valueLog entries with timestamps bigger than now+futureRetention are rejected during data ingestion;help
-healthcheckWhether to check that the running process accepts connections at -httpListenAddr and exit.help
-http.connTimeout durationIncoming connections to -httpListenAddr are closed after the configured timeout.help
-http.disableCORSDisable CORS for all origins (*)help
-http.disableKeepAliveWhether to disable HTTP keep-alive for incoming connections at -httpListenAddrhelp
-http.disableResponseCompressionDisable compression of HTTP responses to save CPU resources.help
-http.header.csp stringValue for 'Content-Security-Policy' header, recommended: "default-src 'self'"help
-http.header.disableServerHostnameWhether to disable 'X-Server-Hostname' header in HTTP responseshelp
-http.header.frameOptions stringValue for 'X-Frame-Options' headerhelp
-http.header.hsts stringValue for 'Strict-Transport-Security' header, recommended: 'max-age=31536000;help
-http.idleConnTimeout durationTimeout for incoming idle http connections (default 1m0s)help
-http.maxGracefulShutdownDuration durationThe maximum duration for a graceful shutdown of the HTTP server.help
-http.pathPrefix stringAn optional prefix to add to all the paths handled by http server.help
-http.shutdownDelay durationOptional delay before http server shutdown.help
-httpAuth.password valuePassword for HTTP server's Basic Auth.help
-httpAuth.username stringUsername for HTTP server's Basic Auth.help
-httpListenAddr arrayAddresses to listen for incoming http requests.help
-httpListenAddr.useProxyProtocol arrayWhether to use proxy protocol for connections accepted at the given -httpListenAddr .help
-inmemoryDataFlushInterval durationThe interval for guaranteed saving of in-memory data to disk.help
-insert.concurrency intThe average number of concurrent data ingestion requests, which can be sent to every -storageNode (default 2)help
-insert.disableWhether to disable both /insert/* and /internal/insert HTTP endpoints and OpenTelemetry gRPC ingestion endpoint.help
-insert.disableCompressionWhether to disable compression when sending the ingested data to -storageNode nodes.help
-insert.drainTimeout durationThe maximum duration for draining the in-memory buffered spans to -storageNode nodes on graceful shutdown;help
-insert.indexFlushInterval durationAmount of time after which the index of a trace is flushed.help
-insert.maxFieldsPerLine intThe maximum number of log fields per line, which can be read by /insert/* handlers;help
-insert.maxQueueDuration durationThe maximum duration to wait in the queue when -maxConcurrentInserts concurrent insert requests are executed (default 1m0s)help
-internStringCacheExpireDuration durationThe expiry duration for caches for interned strings.help
-internStringDisableCacheWhether to disable caches for interned strings.help
-internStringMaxLen intThe maximum length for strings to intern.help
-internaldelete.enableWhether to enable /internal/delete/* HTTP endpoints, which are used by vtselect for deleting spans via delete API at vtstorage nodeshelp
-internalinsert.disableWhether to disable /internal/insert HTTP endpoint.help
-internalinsert.maxRequestSize sizeThe maximum size in bytes of a single request, which can be accepted at /internal/insert HTTP endpoint Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB…help
-internalselect.disableWhether to disable /internal/select/* HTTP endpointshelp
-internalselect.maxConcurrentRequests intThe limit on the number of concurrent requests to /internal/select/* endpoints;help
-logIngestedRowsWhether to log all the ingested trace spans;help
-logNewStreamsWhether to log creation of new streams;help
-logNewStreamsAuthKey valueauthKey, which must be passed in query string to /internal/log_new_streams .help
-loggerDisableTimestampsWhether to disable writing timestamps in logshelp
-loggerErrorsPerSecondLimit intPer-second limit on the number of ERROR messages.help
-loggerFormat stringFormat for logs.help
-loggerJSONFields stringAllows renaming fields in JSON formatted logs.help
-loggerLevel stringMinimum level of errors to log.help
-loggerMaxArgLen intThe maximum length of a single logged argument.help
-loggerOutput stringOutput for the logs.help
-loggerTimezone stringTimezone to use for timestamps in logs.help
-loggerWarnsPerSecondLimit intPer-second limit on the number of WARN messages.help
-maxBackfillAge valueTrace spans with timestamps older than now-maxBackfillAge are rejected during data ingestion;help
-maxConcurrentInserts intThe maximum number of concurrent insert requests.help
-memory.allowedBytes sizeAllowed size of system memory VictoriaMetrics caches may occupy.help
-memory.allowedPercent floatAllowed percent of system memory VictoriaMetrics caches may occupy.help
-metrics.exposeMetadataWhether to expose TYPE and HELP metadata at the /metrics page, which is exposed at -httpListenAddr .help
-metricsAuthKey valueAuth key for /metrics endpoint.help
-nativeinsert.maxRequestSize sizeThe maximum size in bytes of a single request, which can be accepted at /insert/native and /insert/multitenant/native HTTP endpoints Supports the following optional suffixes for size values: KB, MB,…help
-opentelemetry.traces.maxRequestSize sizeThe maximum size in bytes of a single OpenTelemetry trace export request.help
-otlpGRPC.tls arrayWhether to enable TLS for incoming gRPC requests at the given -otlpGRPCListenAddr.help
-otlpGRPC.tlsCertFile arrayPath to file with TLS certificate for the corresponding -otlpGRPCListenAddr if -otlpGRPC.tls is set.help
-otlpGRPC.tlsCipherSuites arrayOptional list of TLS cipher suites for incoming requests over HTTPS if -otlpGRPC.tls is set.help
-otlpGRPC.tlsKeyFile arrayPath to file with TLS key for the corresponding -otlpGRPCListenAddr if -otlpGRPC.tls is set.help
-otlpGRPC.tlsMinVersion arrayOptional minimum TLS version to use for the corresponding -otlpGRPCListenAddr if -otlpGRPC.tls is set.help
-otlpGRPCListenAddr stringTCP address for accepting OTLP gRPC requests.help
-partitionManageAuthKey valueauthKey, which must be passed in query string to /internal/partition/* .help
-pprofAuthKey valueAuth key for /debug/pprof/* endpoints.help
-pushmetrics.disableCompressionWhether to disable request body compression when pushing metrics to every -pushmetrics.urlhelp
-pushmetrics.extraLabel arrayOptional labels to add to metrics pushed to every -pushmetrics.url .help
-pushmetrics.header arrayOptional HTTP request header to send to every -pushmetrics.url .help
-pushmetrics.interval durationInterval for pushing metrics to every -pushmetrics.url (default 10s)help
-pushmetrics.url arrayOptional URL to push metrics exposed at /metrics page.help
-retention.maxDiskSpaceUsageBytes sizeThe maximum disk space usage at -storageDataPath before older per-day partitions are automatically dropped;help
-retention.maxDiskUsagePercent intThe maximum allowed disk usage percentage (1-100) for the filesystem that contains -storageDataPath before older per-day partitions are automatically dropped;help
-retentionPeriod valueTrace spans with timestamps older than now-retentionPeriod are automatically deleted;help
-search.allowPartialResponseWhether to allow returning partial responses when some of vtstorage nodes from the -storageNode list are unavailable for querying.help
-search.fieldsLookbehind durationThe default time range of searching for normal fields (tags and attributes).It affects various Tempo tag-related APIs.help
-search.latencyOffset durationThe time when a trace become visible in query results after the collection.help
-search.logSlowQueryDuration durationLog queries with execution time exceeding this value.help
-search.maxConcurrentRequests intThe maximum number of concurrent search requests.help
-search.maxQueryDuration durationThe maximum duration for query execution.help
-search.maxQueryLen sizeThe maximum query length in bytes, which can be passed to /select/* endpoints Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 16384)help
-search.maxQueryTimeRange valueThe maximum time range, which can be set in the query sent to querying APIs.help
-search.maxQueueDuration durationThe maximum time the search request waits for execution when -search.maxConcurrentRequests limit is reached;help
-search.maxTags intThe maximum number of tags (including service name, span name) that can be returned in a single search request.help
-search.maxTraces intThe maximum number of traces that can be returned in a single search request.help
-search.streamFieldsLookbehind durationThe default time range of searching for stream fields (service name and span name).It affects Jaeger's /api/services and /api/services/*/operations APIs.help
-search.traceMaxDurationWindow durationThe window of searching for the rest trace spans after finding one span.It allows extending the search start time and end time by -search.traceMaxDurationWindow to make sure all spans are included.It…help
-search.traceMaxServiceNameList uintDeprecated, see -search.maxTags.help
-search.traceMaxSpanNameList uintDeprecated, see -search.maxTags.help
-search.traceSearchStep durationSplits the [0, now] time range into many small time ranges by -search.traceSearchStep when searching for spans by trace_id.help
-search.traceServiceAndSpanNameLookbehind durationDeprecated, see -search.tagsLookbehind.help
-secret.flags arrayComma-separated list of flag names with secret values.help
-select.disableWhether to disable both /select/* and /internal/select/* HTTP endpoints.help
-select.disableCompressionWhether to disable compression for select query responses received from -storageNode nodes.help
-servicegraph.databaseTaskLimit uintHow many service-database graph relations each task could fetch for each tenant.help
-servicegraph.enableTaskWhether to enable background task for generating service graph.help
-servicegraph.taskInterval durationThe background task interval for generating service graph data.help
-servicegraph.taskLimit uintHow many service graph relations each task could fetch for each tenant.help
-servicegraph.taskLookbehind durationThe lookbehind window for each time service graph background task run.help
-servicegraph.taskTimeout durationThe background task timeout duration for generating service graph data.help
-snapshotsMaxAge valueSnapshots are automatically deleted after the given duration if it is set to positive value.help
-storage.minFreeDiskSpaceBytes sizeThe minimum free disk space at -storageDataPath after which the storage stops accepting new data Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default…help
-storageDataPath stringPath to directory where to store VictoriaTraces data;help
-storageNode arrayComma-separated list of TCP addresses for storage nodes to route the ingested spans to and to send select queries to.help
-storageNode.bearerToken arrayOptional bearer auth token to use for the corresponding -storageNode Supports an array of values separated by comma or specified via multiple flags.help
-storageNode.bearerTokenFile arrayOptional path to bearer token file to use for the corresponding -storageNode.help
-storageNode.password arrayOptional basic auth password to use for the corresponding -storageNode Supports an array of values separated by comma or specified via multiple flags.help
-storageNode.passwordFile arrayOptional path to basic auth password to use for the corresponding -storageNode.help
-storageNode.tls arrayWhether to use TLS (HTTPS) protocol for communicating with the corresponding -storageNode.help
-storageNode.tlsCAFile arrayOptional path to TLS CA file to use for verifying connections to the corresponding -storageNode.help
-storageNode.tlsCertFile arrayOptional path to client-side TLS certificate file to use when connecting to the corresponding -storageNode Supports an array of values separated by comma or specified via multiple flags.help
-storageNode.tlsInsecureSkipVerify arrayWhether to skip tls verification when connecting to the corresponding -storageNode Supports array of values separated by comma or specified via multiple flags.help
-storageNode.tlsKeyFile arrayOptional path to client-side TLS certificate key to use when connecting to the corresponding -storageNode Supports an array of values separated by comma or specified via multiple flags.help
-storageNode.tlsServerName arrayOptional TLS server name to use for connections to the corresponding -storageNode.help
-storageNode.username arrayOptional basic auth username to use for the corresponding -storageNode Supports an array of values separated by comma or specified via multiple flags.help
-storageNode.usernameFile arrayOptional path to basic auth username to use for the corresponding -storageNode.help
-tls arrayWhether to enable TLS for incoming HTTP requests at the given -httpListenAddr (aka https).help
-tlsCertFile arrayPath to file with TLS certificate for the corresponding -httpListenAddr if -tls is set.help
-tlsCipherSuites arrayOptional list of TLS cipher suites for incoming requests over HTTPS if -tls is set.help
-tlsKeyFile arrayPath to file with TLS key for the corresponding -httpListenAddr if -tls is set.help
-tlsMinVersion arrayOptional minimum TLS version to use for the corresponding -httpListenAddr if -tls is set.help
-versionShow VictoriaMetrics versionhelp
-vmalert.proxyURL stringOptional URL for proxying requests to vmalert;help

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