Usage of /usr/bin/query-tee:
-backend.config-file string
Path to a file with YAML or JSON configuration for each backend. Each key in the YAML/JSON document is a backend hostname. This is an example configuration value for a backend in JSON: {"request_headers":{"Cache-Control":["no-store"]}}
-backend.endpoints string
Comma-separated list of backend endpoints to query. If the client request contains basic auth, it will be forwarded to the backend. Basic auth is also accepted as part of the endpoint URL and takes precedence over the basic auth in the client request. If the endpoint URL doesn't contain basic auth password, then the basic auth password from the client request is used. If the endpoint basic auth username is __REQUEST_HEADER_X_SCOPE_ORGID__, then the value of the X-Scope-OrgID header will be used as the username.
-backend.preferred string
The hostname of the preferred backend when selecting the response to send back to the client. If no preferred backend is configured then the query-tee will send back to the client the first successful response received without waiting for other backends.
-backend.read-timeout duration
The timeout when reading the response from a backend. (default 2m30s)
-backend.skip-tls-verify
Skip TLS verification on backend targets.
-log.level value
Only log messages with the given severity or above. Valid levels: [debug, info, warn, error] (default info)
-proxy.add-missing-time-parameter-to-instant-queries
Add a 'time' parameter to proxied instant query requests if they do not have one. (default true)
-proxy.compare-exact-error-matching
If true, errors will be considered the same only if they are exactly the same. If false, errors will be considered the same if they are considered equivalent.
-proxy.compare-responses
Compare responses between preferred and secondary endpoints for supported routes.
-proxy.compare-skip-preferred-backend-failures
If true, the proxy will 'skip' result comparisons where the preferred backend returned a 5xx status code. This is useful in the case where the secondary backend is more reliable.
-proxy.compare-skip-recent-samples duration
The window from now to skip comparing samples. 0 to disable. (default 2m0s)
-proxy.compare-skip-samples-before value
Skip the samples before the given time for comparison. The time can be in RFC3339 format (or) RFC3339 without the timezone and seconds (or) date only.
-proxy.compare-use-relative-error
Use relative error tolerance when comparing floating point values.
-proxy.log-slow-query-response-threshold duration
The minimum difference in response time between slowest and fastest back-end over which to log the query. 0 to disable. (default 10s)
-proxy.passthrough-non-registered-routes
Passthrough requests for non-registered routes to preferred backend.
-proxy.secondary-backends-request-proportion float
Proportion of requests to send to secondary backends. Must be between 0 and 1 (inclusive), and if not 1, then -backend.preferred must be set. (default 1)
-proxy.value-comparison-tolerance float
The tolerance to apply when comparing floating point values in the responses. 0 to disable tolerance and require exact match (not recommended). (default 1e-06)
-server.graceful-shutdown-timeout duration
Time to wait for inflight requests to complete when shutting down. Setting this to 0 will terminate all inflight requests immediately when a shutdown signal is received. (default 30s)
-server.grpc-service-address string
Bind address for server where query-tee service listens for HTTP over gRPC requests.
-server.grpc-service-port int
The GRPC port where the query-tee service listens for HTTP over gRPC messages. (default 9095)
-server.http-service-address string
Bind address for server where query-tee service listens for HTTP requests.
-server.http-service-port int
The HTTP port where the query-tee service listens for HTTP requests. (default 80)
-server.metrics-port int
The port where metrics are exposed. (default 9900)
-server.path-prefix string
Path prefix for API paths (query-tee will accept Prometheus API calls at <prefix>/api/v1/...). Example: -server.path-prefix=/prometheus
Options (24)
| Option | Description | Source |
|---|---|---|
-backend.config-file string | Path to a file with YAML or JSON configuration for each backend. | help |
-backend.endpoints string | Comma-separated list of backend endpoints to query. | help |
-backend.preferred string | The hostname of the preferred backend when selecting the response to send back to the client. | help |
-backend.read-timeout duration | The timeout when reading the response from a backend. | help |
-backend.skip-tls-verify | Skip TLS verification on backend targets. | help |
-log.level value | Only log messages with the given severity or above. | help |
-proxy.add-missing-time-parameter-to-instant-queries | Add a 'time' parameter to proxied instant query requests if they do not have one. | help |
-proxy.compare-exact-error-matching | If true, errors will be considered the same only if they are exactly the same. | help |
-proxy.compare-responses | Compare responses between preferred and secondary endpoints for supported routes. | help |
-proxy.compare-skip-preferred-backend-failures | If true, the proxy will 'skip' result comparisons where the preferred backend returned a 5xx status code. | help |
-proxy.compare-skip-recent-samples duration | The window from now to skip comparing samples. | help |
-proxy.compare-skip-samples-before value | Skip the samples before the given time for comparison. | help |
-proxy.compare-use-relative-error | Use relative error tolerance when comparing floating point values. | help |
-proxy.log-slow-query-response-threshold duration | The minimum difference in response time between slowest and fastest back-end over which to log the query. | help |
-proxy.passthrough-non-registered-routes | Passthrough requests for non-registered routes to preferred backend. | help |
-proxy.secondary-backends-request-proportion float | Proportion of requests to send to secondary backends. | help |
-proxy.value-comparison-tolerance float | The tolerance to apply when comparing floating point values in the responses. | help |
-server.graceful-shutdown-timeout duration | Time to wait for inflight requests to complete when shutting down. | help |
-server.grpc-service-address string | Bind address for server where query-tee service listens for HTTP over gRPC requests. | help |
-server.grpc-service-port int | The GRPC port where the query-tee service listens for HTTP over gRPC messages. | help |
-server.http-service-address string | Bind address for server where query-tee service listens for HTTP requests. | help |
-server.http-service-port int | The HTTP port where the query-tee service listens for HTTP requests. | help |
-server.metrics-port int | The port where metrics are exposed. | help |
-server.path-prefix string | Path prefix for API paths (query-tee will accept Prometheus API calls at <prefix>/api/v1/...). | help |