OS Manuals

/usr/bin/query

From jaeger-1-query 1.76.0-r14 (enterprise-packages), captured 2026-11-08 by running query --help (exit 0). permalink

2026/11/08 04:20:11 maxprocs: Leaving GOMAXPROCS=64: CPU quota undefined

*******************************************************************************

🛑  WARNING: End-of-life Notice for Jaeger v1

You are currently running a v1 version of Jaeger, which is deprecated and will
reach end-of-life on December 31st, 2025. This means there will be no further
development, bug fixes, or security patches for v1 after this date.

We strongly recommend migrating to Jaeger v2 for continued support and access
to new features.

For detailed migration instructions, please refer to the official Jaeger
documentation:  https://www.jaegertracing.io/docs/latest/migration/

Tracking issue: https://github.com/jaegertracing/jaeger/issues/6321

🛑  WARNING: End-of-life Notice for Jaeger v1

*******************************************************************************
2026/11/08 04:20:11 application version: git-commit=63b27e1810a710ac54dc4522da0538e540bdc545, git-version=v1.76.0, build-date=2026-06-03T05:24:09Z
Jaeger query service provides a Web UI and an API for accessing trace data.

Usage:
  jaeger-query [flags]
  jaeger-query [command]

Available Commands:
  completion   Generate the autocompletion script for the specified shell
  docs         Generates documentation
  env          Help about environment variables.
  featuregate  Display feature gates information
  help         Help about any command
  print-config Print names and values of configuration options
  status       Print the status.
  version      Print the version.

Flags:
      --admin.http.host-port string                             The host:port (e.g. 127.0.0.1:16687 or :16687) for the admin server, including health check, /metrics, etc. (default ":16687")
      --admin.http.tls.cert string                              Path to a TLS Certificate file, used to identify this server to clients
      --admin.http.tls.cipher-suites string                     Comma-separated list of cipher suites for the server, values are from tls package constants (https://golang.org/pkg/crypto/tls/#pkg-constants).
      --admin.http.tls.client-ca string                         Path to a TLS CA (Certification Authority) file used to verify certificates presented by clients (if unset, all clients are permitted)
      --admin.http.tls.enabled                                  Enable TLS on the server
      --admin.http.tls.key string                               Path to a TLS Private Key file, used to identify this server to clients
      --admin.http.tls.max-version string                       Maximum TLS version supported (Possible values: 1.0, 1.1, 1.2, 1.3)
      --admin.http.tls.min-version string                       Minimum TLS version supported (Possible values: 1.0, 1.1, 1.2, 1.3)
      --admin.http.tls.reload-interval duration                 The duration after which the certificate will be reloaded (0s means will not be reloaded) (default 0s)
      --cassandra-archive.basic.allowed-authenticators string   The comma-separated list of allowed password authenticators for Cassandra.If none are specified, there is a default 'approved' list that is used (https://github.com/gocql/gocql/blob/34fdeebefcbf183ed7f916f931aa0586fdaa1b40/conn.go#L27). If a non-empty list is provided, only specified authenticators are allowed.
      --cassandra-archive.connect-timeout duration              Timeout used for connections to Cassandra Servers (default 0s)
      --cassandra-archive.connections-per-host int              The number of Cassandra connections from a single backend instance (default 2)
      --cassandra-archive.consistency string                    The Cassandra consistency level, e.g. ANY, ONE, TWO, THREE, QUORUM, ALL, LOCAL_QUORUM, EACH_QUORUM, LOCAL_ONE (default LOCAL_ONE)
      --cassandra-archive.disable-compression                   Disables the use of the default Snappy Compression while connecting to the Cassandra Cluster if set to true. This is useful for connecting to Cassandra Clusters(like Azure Cosmos Db with Cassandra API) that do not support SnappyCompression
      --cassandra-archive.enabled                               Enable extra storage
      --cassandra-archive.index.logs                            Controls log field indexing. Set to false to disable. (default true)
      --cassandra-archive.index.process-tags                    Controls process tag indexing. Set to false to disable. (default true)
      --cassandra-archive.index.tag-blacklist string            The comma-separated list of span tags to blacklist from being indexed. All other tags will be indexed. Mutually exclusive with the whitelist option.
      --cassandra-archive.index.tag-whitelist string            The comma-separated list of span tags to whitelist for being indexed. All other tags will not be indexed. Mutually exclusive with the blacklist option.
      --cassandra-archive.index.tags                            Controls tag indexing. Set to false to disable. (default true)
      --cassandra-archive.keyspace string                       The Cassandra keyspace for Jaeger data (default "jaeger_dc1")
      --cassandra-archive.local-dc string                       The name of the Cassandra local data center for DC Aware host selection
      --cassandra-archive.max-retry-attempts int                The number of attempts when reading from Cassandra (default 3)
      --cassandra-archive.password string                       Password for password authentication for Cassandra
      --cassandra-archive.port int                              The port for cassandra (default 9042)
      --cassandra-archive.proto-version int                     The Cassandra protocol version (default 4)
      --cassandra-archive.reconnect-interval duration           Reconnect interval to retry connecting to downed hosts (default 1m0s)
      --cassandra-archive.servers string                        The comma-separated list of Cassandra servers (default "127.0.0.1")
      --cassandra-archive.socket-keep-alive duration            Cassandra's keepalive period to use, enabled if > 0 (default 0s)
      --cassandra-archive.span-store-write-cache-ttl duration   The duration to wait before rewriting an existing service or operation name (default 12h0m0s)
      --cassandra-archive.timeout duration                      Timeout used for queries. A Timeout of zero means no timeout (default 0s)
      --cassandra-archive.tls.ca string                         Path to a TLS CA (Certification Authority) file used to verify the remote server(s) (by default will use the system truststore)
      --cassandra-archive.tls.cert string                       Path to a TLS Certificate file, used to identify this process to the remote server(s)
      --cassandra-archive.tls.enabled                           Enable TLS when talking to the remote server(s)
      --cassandra-archive.tls.key string                        Path to a TLS Private Key file, used to identify this process to the remote server(s)
      --cassandra-archive.tls.server-name string                Override the TLS server name we expect in the certificate of the remote server(s)
      --cassandra-archive.tls.skip-host-verify                  (insecure) Skip server's certificate chain and host name verification
      --cassandra-archive.username string                       Username for password authentication for Cassandra
      --cassandra.basic.allowed-authenticators string           The comma-separated list of allowed password authenticators for Cassandra.If none are specified, there is a default 'approved' list that is used (https://github.com/gocql/gocql/blob/34fdeebefcbf183ed7f916f931aa0586fdaa1b40/conn.go#L27). If a non-empty list is provided, only specified authenticators are allowed.
      --cassandra.connect-timeout duration                      Timeout used for connections to Cassandra Servers (default 0s)
      --cassandra.connections-per-host int                      The number of Cassandra connections from a single backend instance (default 2)
      --cassandra.consistency string                            The Cassandra consistency level, e.g. ANY, ONE, TWO, THREE, QUORUM, ALL, LOCAL_QUORUM, EACH_QUORUM, LOCAL_ONE (default LOCAL_ONE)
      --cassandra.disable-compression                           Disables the use of the default Snappy Compression while connecting to the Cassandra Cluster if set to true. This is useful for connecting to Cassandra Clusters(like Azure Cosmos Db with Cassandra API) that do not support SnappyCompression
      --cassandra.index.logs                                    Controls log field indexing. Set to false to disable. (default true)
      --cassandra.index.process-tags                            Controls process tag indexing. Set to false to disable. (default true)
      --cassandra.index.tag-blacklist string                    The comma-separated list of span tags to blacklist from being indexed. All other tags will be indexed. Mutually exclusive with the whitelist option.
      --cassandra.index.tag-whitelist string                    The comma-separated list of span tags to whitelist for being indexed. All other tags will not be indexed. Mutually exclusive with the blacklist option.
      --cassandra.index.tags                                    Controls tag indexing. Set to false to disable. (default true)
      --cassandra.keyspace string                               The Cassandra keyspace for Jaeger data (default "jaeger_dc1")
      --cassandra.local-dc string                               The name of the Cassandra local data center for DC Aware host selection
      --cassandra.max-retry-attempts int                        The number of attempts when reading from Cassandra (default 3)
      --cassandra.password string                               Password for password authentication for Cassandra
      --cassandra.port int                                      The port for cassandra (default 9042)
      --cassandra.proto-version int                             The Cassandra protocol version (default 4)
      --cassandra.reconnect-interval duration                   Reconnect interval to retry connecting to downed hosts (default 1m0s)
      --cassandra.servers string                                The comma-separated list of Cassandra servers (default "127.0.0.1")
      --cassandra.socket-keep-alive duration                    Cassandra's keepalive period to use, enabled if > 0 (default 0s)
      --cassandra.span-store-write-cache-ttl duration           The duration to wait before rewriting an existing service or operation name (default 12h0m0s)
      --cassandra.timeout duration                              Timeout used for queries. A Timeout of zero means no timeout (default 0s)
      --cassandra.tls.ca string                                 Path to a TLS CA (Certification Authority) file used to verify the remote server(s) (by default will use the system truststore)
      --cassandra.tls.cert string                               Path to a TLS Certificate file, used to identify this process to the remote server(s)
      --cassandra.tls.enabled                                   Enable TLS when talking to the remote server(s)
      --cassandra.tls.key string                                Path to a TLS Private Key file, used to identify this process to the remote server(s)
      --cassandra.tls.server-name string                        Override the TLS server name we expect in the certificate of the remote server(s)
      --cassandra.tls.skip-host-verify                          (insecure) Skip server's certificate chain and host name verification
      --cassandra.username string                               Username for password authentication for Cassandra
      --config-file string                                      Configuration file in JSON, TOML, YAML, HCL, or Java properties formats (default none). See spf13/viper for precedence.
      --feature-gates flag                                      Comma-delimited list of feature gate identifiers. Prefix with '-' to disable the feature. '+' or no prefix will enable the feature. (default confighttp.framedSnappy,configoptional.AddEnabledField,-confmap.enableMergeAppendOption,exporter.PersistRequestContext,jaeger.es.disableLegacyId,otelcol.printInitialConfig,pdata.enableRefCounting,pdata.useCustomProtoEncoding,-pdata.useProtoPooling,-service.AllowNoPipelines,-service.profilesSupport,-telemetry.disableHighCardinalityMetrics,-telemetry.newPipelineTelemetry)
  -h, --help                                                    help for jaeger-query
      --log-encoding string                                     Log encoding. Supported values are 'json' and 'console'. (default "json")
      --log-level string                                        Minimal allowed log Level. For more levels see https://github.com/uber-go/zap (default "info")
      --metrics-backend string                                  Defines which metrics backend to use for metrics reporting: prometheus or none (default "prometheus")
      --metrics-http-route string                               Defines the route of HTTP endpoint for metrics backends that support scraping (default "/metrics")
      --multi-tenancy.enabled                                   Enable tenancy header when receiving or querying
      --multi-tenancy.header string                             HTTP header carrying tenant (default "x-tenant")
      --multi-tenancy.tenants string                            comma-separated list of allowed values for --multi-tenancy.header header.  (If not supplied, tenants are not restricted)
      --query.additional-headers strings                        Additional HTTP response headers.  Can be specified multiple times.  Format: "Key: Value" (default [])
      --query.base-path string                                  The base path for all HTTP routes, e.g. /jaeger; useful when running behind a reverse proxy. See https://github.com/jaegertracing/jaeger/blob/main/examples/reverse-proxy/README.md (default "/")
      --query.bearer-token-propagation                          Allow propagation of bearer token to be used by storage plugins
      --query.enable-tracing                                    Enables emitting jaeger-query traces
      --query.grpc-server.host-port string                      The host:port (e.g. 127.0.0.1:14250 or :14250) of the query's gRPC server (default ":16685")
      --query.grpc.tls.cert string                              Path to a TLS Certificate file, used to identify this server to clients
      --query.grpc.tls.cipher-suites string                     Comma-separated list of cipher suites for the server, values are from tls package constants (https://golang.org/pkg/crypto/tls/#pkg-constants).
      --query.grpc.tls.client-ca string                         Path to a TLS CA (Certification Authority) file used to verify certificates presented by clients (if unset, all clients are permitted)
      --query.grpc.tls.enabled                                  Enable TLS on the server
      --query.grpc.tls.key string                               Path to a TLS Private Key file, used to identify this server to clients
      --query.grpc.tls.max-version string                       Maximum TLS version supported (Possible values: 1.0, 1.1, 1.2, 1.3)
      --query.grpc.tls.min-version string                       Minimum TLS version supported (Possible values: 1.0, 1.1, 1.2, 1.3)
      --query.grpc.tls.reload-interval duration                 The duration after which the certificate will be reloaded (0s means will not be reloaded) (default 0s)
      --query.http-server.host-port string                      The host:port (e.g. 127.0.0.1:14268 or :14268) of the query's HTTP server (default ":16686")
      --query.http.tls.cert string                              Path to a TLS Certificate file, used to identify this server to clients
      --query.http.tls.cipher-suites string                     Comma-separated list of cipher suites for the server, values are from tls package constants (https://golang.org/pkg/crypto/tls/#pkg-constants).
      --query.http.tls.client-ca string                         Path to a TLS CA (Certification Authority) file used to verify certificates presented by clients (if unset, all clients are permitted)
      --query.http.tls.enabled                                  Enable TLS on the server
      --query.http.tls.key string                               Path to a TLS Private Key file, used to identify this server to clients
      --query.http.tls.max-version string                       Maximum TLS version supported (Possible values: 1.0, 1.1, 1.2, 1.3)
      --query.http.tls.min-version string                       Minimum TLS version supported (Possible values: 1.0, 1.1, 1.2, 1.3)
      --query.http.tls.reload-interval duration                 The duration after which the certificate will be reloaded (0s means will not be reloaded) (default 0s)
      --query.log-static-assets-access                          Log when static assets are accessed (for debugging)
      --query.max-clock-skew-adjustment duration                The maximum delta by which span timestamps may be adjusted in the UI due to clock skew; set to 0s to disable clock skew adjustments (default 0s)
      --query.static-files string                               The directory path override for the static assets for the UI
      --query.ui-config string                                  The path to the UI configuration file in JSON format
      --span-storage.type string                                (deprecated) please use SPAN_STORAGE_TYPE environment variable. Run this binary with the 'env' command for help.

Use "jaeger-query [command] --help" for more information about a command.
Options (103)
OptionDescriptionSource
--admin.http.host-port stringThe host:port (e.g. 127.0.0.1:16687 or :16687) for the admin server, including health check, /metrics, etc.help
--admin.http.tls.cert stringPath to a TLS Certificate file, used to identify this server to clientshelp
--admin.http.tls.cipher-suites stringComma-separated list of cipher suites for the server, values are from tls package constants (https://golang.org/pkg/crypto/tls/#pkg-constants).help
--admin.http.tls.client-ca stringPath to a TLS CA (Certification Authority) file used to verify certificates presented by clients (if unset, all clients are permitted)help
--admin.http.tls.enabledEnable TLS on the serverhelp
--admin.http.tls.key stringPath to a TLS Private Key file, used to identify this server to clientshelp
--admin.http.tls.max-version stringMaximum TLS version supported (Possible values: 1.0, 1.1, 1.2, 1.3)help
--admin.http.tls.min-version stringMinimum TLS version supported (Possible values: 1.0, 1.1, 1.2, 1.3)help
--admin.http.tls.reload-interval durationThe duration after which the certificate will be reloaded (0s means will not be reloaded) (default 0s)help
--cassandra-archive.basic.allowed-authenticators stringThe comma-separated list of allowed password authenticators for Cassandra.If none are specified, there is a default 'approved' list that is used…help
--cassandra-archive.connect-timeout durationTimeout used for connections to Cassandra Servers (default 0s)help
--cassandra-archive.connections-per-host intThe number of Cassandra connections from a single backend instance (default 2)help
--cassandra-archive.consistency stringThe Cassandra consistency level, e.g. ANY, ONE, TWO, THREE, QUORUM, ALL, LOCAL_QUORUM, EACH_QUORUM, LOCAL_ONE (default LOCAL_ONE)help
--cassandra-archive.disable-compressionDisables the use of the default Snappy Compression while connecting to the Cassandra Cluster if set to true.help
--cassandra-archive.enabledEnable extra storagehelp
--cassandra-archive.index.logsControls log field indexing.help
--cassandra-archive.index.process-tagsControls process tag indexing.help
--cassandra-archive.index.tag-blacklist stringThe comma-separated list of span tags to blacklist from being indexed.help
--cassandra-archive.index.tag-whitelist stringThe comma-separated list of span tags to whitelist for being indexed.help
--cassandra-archive.index.tagsControls tag indexing.help
--cassandra-archive.keyspace stringThe Cassandra keyspace for Jaeger data (default "jaeger_dc1")help
--cassandra-archive.local-dc stringThe name of the Cassandra local data center for DC Aware host selectionhelp
--cassandra-archive.max-retry-attempts intThe number of attempts when reading from Cassandra (default 3)help
--cassandra-archive.password stringPassword for password authentication for Cassandrahelp
--cassandra-archive.port intThe port for cassandra (default 9042)help
--cassandra-archive.proto-version intThe Cassandra protocol version (default 4)help
--cassandra-archive.reconnect-interval durationReconnect interval to retry connecting to downed hosts (default 1m0s)help
--cassandra-archive.servers stringThe comma-separated list of Cassandra servers (default "127.0.0.1")help
--cassandra-archive.socket-keep-alive durationCassandra's keepalive period to use, enabled if > 0 (default 0s)help
--cassandra-archive.span-store-write-cache-ttl durationThe duration to wait before rewriting an existing service or operation name (default 12h0m0s)help
--cassandra-archive.timeout durationTimeout used for queries.help
--cassandra-archive.tls.ca stringPath to a TLS CA (Certification Authority) file used to verify the remote server(s) (by default will use the system truststore)help
--cassandra-archive.tls.cert stringPath to a TLS Certificate file, used to identify this process to the remote server(s)help
--cassandra-archive.tls.enabledEnable TLS when talking to the remote server(s)help
--cassandra-archive.tls.key stringPath to a TLS Private Key file, used to identify this process to the remote server(s)help
--cassandra-archive.tls.server-name stringOverride the TLS server name we expect in the certificate of the remote server(s)help
--cassandra-archive.tls.skip-host-verify(insecure) Skip server's certificate chain and host name verificationhelp
--cassandra-archive.username stringUsername for password authentication for Cassandrahelp
--cassandra.basic.allowed-authenticators stringThe comma-separated list of allowed password authenticators for Cassandra.If none are specified, there is a default 'approved' list that is used…help
--cassandra.connect-timeout durationTimeout used for connections to Cassandra Servers (default 0s)help
--cassandra.connections-per-host intThe number of Cassandra connections from a single backend instance (default 2)help
--cassandra.consistency stringThe Cassandra consistency level, e.g. ANY, ONE, TWO, THREE, QUORUM, ALL, LOCAL_QUORUM, EACH_QUORUM, LOCAL_ONE (default LOCAL_ONE)help
--cassandra.disable-compressionDisables the use of the default Snappy Compression while connecting to the Cassandra Cluster if set to true.help
--cassandra.index.logsControls log field indexing.help
--cassandra.index.process-tagsControls process tag indexing.help
--cassandra.index.tag-blacklist stringThe comma-separated list of span tags to blacklist from being indexed.help
--cassandra.index.tag-whitelist stringThe comma-separated list of span tags to whitelist for being indexed.help
--cassandra.index.tagsControls tag indexing.help
--cassandra.keyspace stringThe Cassandra keyspace for Jaeger data (default "jaeger_dc1")help
--cassandra.local-dc stringThe name of the Cassandra local data center for DC Aware host selectionhelp
--cassandra.max-retry-attempts intThe number of attempts when reading from Cassandra (default 3)help
--cassandra.password stringPassword for password authentication for Cassandrahelp
--cassandra.port intThe port for cassandra (default 9042)help
--cassandra.proto-version intThe Cassandra protocol version (default 4)help
--cassandra.reconnect-interval durationReconnect interval to retry connecting to downed hosts (default 1m0s)help
--cassandra.servers stringThe comma-separated list of Cassandra servers (default "127.0.0.1")help
--cassandra.socket-keep-alive durationCassandra's keepalive period to use, enabled if > 0 (default 0s)help
--cassandra.span-store-write-cache-ttl durationThe duration to wait before rewriting an existing service or operation name (default 12h0m0s)help
--cassandra.timeout durationTimeout used for queries.help
--cassandra.tls.ca stringPath to a TLS CA (Certification Authority) file used to verify the remote server(s) (by default will use the system truststore)help
--cassandra.tls.cert stringPath to a TLS Certificate file, used to identify this process to the remote server(s)help
--cassandra.tls.enabledEnable TLS when talking to the remote server(s)help
--cassandra.tls.key stringPath to a TLS Private Key file, used to identify this process to the remote server(s)help
--cassandra.tls.server-name stringOverride the TLS server name we expect in the certificate of the remote server(s)help
--cassandra.tls.skip-host-verify(insecure) Skip server's certificate chain and host name verificationhelp
--cassandra.username stringUsername for password authentication for Cassandrahelp
--config-file stringConfiguration file in JSON, TOML, YAML, HCL, or Java properties formats (default none).help
--feature-gates flagComma-delimited list of feature gate identifiers.help
-h, --helphelp for jaeger-queryhelp
--log-encoding stringLog encoding.help
--log-level stringMinimal allowed log Level.help
--metrics-backend stringDefines which metrics backend to use for metrics reporting: prometheus or none (default "prometheus")help
--metrics-http-route stringDefines the route of HTTP endpoint for metrics backends that support scraping (default "/metrics")help
--multi-tenancy.enabledEnable tenancy header when receiving or queryinghelp
--multi-tenancy.header stringHTTP header carrying tenant (default "x-tenant")help
--multi-tenancy.tenants stringcomma-separated list of allowed values for --multi-tenancy.header header.help
--query.additional-headers stringsAdditional HTTP response headers.help
--query.base-path stringThe base path for all HTTP routes, e.g. /jaeger;help
--query.bearer-token-propagationAllow propagation of bearer token to be used by storage pluginshelp
--query.enable-tracingEnables emitting jaeger-query traceshelp
--query.grpc-server.host-port stringThe host:port (e.g. 127.0.0.1:14250 or :14250) of the query's gRPC server (default ":16685")help
--query.grpc.tls.cert stringPath to a TLS Certificate file, used to identify this server to clientshelp
--query.grpc.tls.cipher-suites stringComma-separated list of cipher suites for the server, values are from tls package constants (https://golang.org/pkg/crypto/tls/#pkg-constants).help
--query.grpc.tls.client-ca stringPath to a TLS CA (Certification Authority) file used to verify certificates presented by clients (if unset, all clients are permitted)help
--query.grpc.tls.enabledEnable TLS on the serverhelp
--query.grpc.tls.key stringPath to a TLS Private Key file, used to identify this server to clientshelp
--query.grpc.tls.max-version stringMaximum TLS version supported (Possible values: 1.0, 1.1, 1.2, 1.3)help
--query.grpc.tls.min-version stringMinimum TLS version supported (Possible values: 1.0, 1.1, 1.2, 1.3)help
--query.grpc.tls.reload-interval durationThe duration after which the certificate will be reloaded (0s means will not be reloaded) (default 0s)help
--query.http-server.host-port stringThe host:port (e.g. 127.0.0.1:14268 or :14268) of the query's HTTP server (default ":16686")help
--query.http.tls.cert stringPath to a TLS Certificate file, used to identify this server to clientshelp
--query.http.tls.cipher-suites stringComma-separated list of cipher suites for the server, values are from tls package constants (https://golang.org/pkg/crypto/tls/#pkg-constants).help
--query.http.tls.client-ca stringPath to a TLS CA (Certification Authority) file used to verify certificates presented by clients (if unset, all clients are permitted)help
--query.http.tls.enabledEnable TLS on the serverhelp
--query.http.tls.key stringPath to a TLS Private Key file, used to identify this server to clientshelp
--query.http.tls.max-version stringMaximum TLS version supported (Possible values: 1.0, 1.1, 1.2, 1.3)help
--query.http.tls.min-version stringMinimum TLS version supported (Possible values: 1.0, 1.1, 1.2, 1.3)help
--query.http.tls.reload-interval durationThe duration after which the certificate will be reloaded (0s means will not be reloaded) (default 0s)help
--query.log-static-assets-accessLog when static assets are accessed (for debugging)help
--query.max-clock-skew-adjustment durationThe maximum delta by which span timestamps may be adjusted in the UI due to clock skew;help
--query.static-files stringThe directory path override for the static assets for the UIhelp
--query.ui-config stringThe path to the UI configuration file in JSON formathelp
--span-storage.type string(deprecated) please use SPAN_STORAGE_TYPE environment variable.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.