2026/11/09 15:23:00 INFO: metrics: disable exposing PSI metrics because of failed init: open /sys/fs/cgroup/cpu.pressure: no such file or directory
vlagent collects logs via popular data ingestion protocols and routes it to VictoriaLogs.
See the docs at https://docs.victoriametrics.com/victorialogs/vlagent/ .
-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)
-datadog.ignoreFields array
Comma-separated list of fields to ignore for logs ingested via DataDog protocol. See https://docs.victoriametrics.com/victorialogs/data-ingestion/datadog-agent/#dropping-fields
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.
-datadog.maxRequestSize size
The maximum size in bytes of a single DataDog request
Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 67108864)
-datadog.streamFields array
Comma-separated list of fields to use as log stream fields for logs ingested via DataDog protocol. See https://docs.victoriametrics.com/victorialogs/data-ingestion/datadog-agent/#stream-fields
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.
-defaultMsgValue string
Default value for _msg field if the ingested log entry doesn't contain it; see https://docs.victoriametrics.com/victorialogs/keyconcepts/#message-field (default "missing _msg field; see https://docs.victoriametrics.com/victorialogs/keyconcepts/#message-field")
-elasticsearch.version string
Elasticsearch version to report to client (default "8.9.0")
-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
-fileCollector.checkpointsPath string
Path to the file where vlagent stores its read position for each collected file. By default, stored in the directory specified by -tmpDataPath. Example: -fileCollector.checkpointsPath=/var/lib/vlagent/file-checkpoints.json
-fileCollector.decolorizeFields array
Fields to remove ANSI color codes across logs ingested from files
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.
-fileCollector.excludeGlob array
Glob pattern for log files to exclude from collection. Can be specified multiple times. Example: -fileCollector.excludeGlob="/var/log/my_app/*.gz"
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.
-fileCollector.extraFields array
Extra fields in JSON format to add to each log line collected from files. For example, -fileCollector.extraFields='{"app":"nginx", "hostname":"%{HOST}"}'. The "hostname" and "file" fields are injected automatically; see -fileCollector.hostnameField and -fileCollector.fileField for details
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.
-fileCollector.fileField string
Field name used to store the source file path in collected log entries. Set to empty string to disable (default "file")
-fileCollector.glob array
Glob pattern for log files to collect. Can be specified multiple times. The pattern must match files, not directories. Example: -fileCollector.glob="/var/log/my_app/*.log"
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.
-fileCollector.hostnameField string
Field name used to store the hostname in collected log entries. Set to empty string to disable (default "hostname")
-fileCollector.ignoreFields array
Fields to ignore across logs ingested from files
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.
-fileCollector.msgField array
Fields that may contain the _msg field. Default: message, msg, log. See https://docs.victoriametrics.com/victorialogs/keyconcepts/#message-field
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.
-fileCollector.refreshInterval duration
How often vlagent checks for new files matching the glob pattern (default 10s)
-fileCollector.streamFields array
Comma-separated list of fields to use as log stream fields for logs ingested from files. Default: -fileCollector.fileField and -fileCollector.hostnameField. See: https://docs.victoriametrics.com/victorialogs/keyconcepts/#stream-fields
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.
-fileCollector.tenantID array
Default tenant ID to use for logs collected from files in format: <accountID>:<projectID>. See https://docs.victoriametrics.com/victorialogs/vlagent/#multitenancy
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.
-fileCollector.timeField array
Fields that may contain the _time field. Default: time, timestamp, ts. If none of the specified fields is found in the log line, then the read time will be used. See https://docs.victoriametrics.com/victorialogs/keyconcepts/#time-field
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.
-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
-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)
-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. Set this flag to empty value in order to disable listening on any port. This mode may be useful for running multiple vlagent instances on the same server. Note that /targets and /metrics pages aren't available if -httpListenAddr=''. 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 corresponding -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.
-insert.disable
Whether to disable both /insert/* and /internal/insert HTTP endpoints. Useful for dedicated vlselect nodes. See also -internalinsert.disable. See https://docs.victoriametrics.com/victorialogs/cluster/#security
-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.maxLineSizeBytes size
The maximum size of a single line that can be read by /insert/* handlers. Regardless of this flag, entries above the 2 MB limit are ignored, see https://docs.victoriametrics.com/victorialogs/faq/#what-length-a-log-record-is-expected-to-have
Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 262144)
-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)
-internalinsert.disable
Whether to disable /internal/insert HTTP endpoint. See also -insert.disable. See https://docs.victoriametrics.com/victorialogs/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)
-journald.ignoreFields array
Comma-separated list of fields to ignore for logs ingested over journald protocol. See https://docs.victoriametrics.com/victorialogs/data-ingestion/journald/#dropping-fields
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.
-journald.includeEntryMetadata
Include Journald fields with double underscore prefixes
-journald.streamFields array
Comma-separated list of fields to use as log stream fields for logs ingested over journald protocol. See https://docs.victoriametrics.com/victorialogs/data-ingestion/journald/#stream-fields
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.
-journald.tenantID string
TenantID for logs ingested via the Journald endpoint. See https://docs.victoriametrics.com/victorialogs/data-ingestion/journald/#multitenancy (default "0:0")
-journald.timeField string
Field to use as a log timestamp for logs ingested via journald protocol. See https://docs.victoriametrics.com/victorialogs/data-ingestion/journald/#time-field (default "__REALTIME_TIMESTAMP")
-journald.useRemoteIP
Whether to add the remote IP address as the remote_ip log field for ingested journald messages.
-kubernetesCollector
Whether to enable collecting logs from Kubernetes
-kubernetesCollector.checkpointsPath string
Path to file with checkpoints for Kubernetes logs. Checkpoints are used to persist the read offsets for Kubernetes container logs. When vlagent is restarted, it resumes reading logs from the stored offsets to avoid log duplication; if this flag isn't set, then checkpoints are saved into vlagent-kubernetes-checkpoints.json under -tmpDataPath directory
-kubernetesCollector.decolorizeFields array
Fields to remove ANSI color codes across logs ingested from Kubernetes
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.
-kubernetesCollector.excludeFilter string
Optional LogsQL filter for excluding container logs. The filter is applied to container metadata fields (e.g., kubernetes.pod_namespace, kubernetes.container_name) before reading the log files. This significantly reduces CPU and I/O usage by skipping logs from unwanted containers. See https://docs.victoriametrics.com/victorialogs/vlagent/#filtering-kubernetes-logs
-kubernetesCollector.extraFields string
Extra fields in JSON format to add to each log line collected from Kubernetes Pods. For example: -kubernetesCollector.extraFields='{"cluster":"cluster-1","env":"production"}'
-kubernetesCollector.ignoreFields array
Fields to ignore across logs ingested from Kubernetes
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.
-kubernetesCollector.includeNamespaceAnnotations
Include Namespace annotations as additional fields in the log entries. Even this setting is disabled, Namespace annotations are available for filtering via -kubernetesCollector.excludeFilter flag
-kubernetesCollector.includeNamespaceLabels
Include Namespace labels as additional fields in the log entries. Even this setting is disabled, Namespace labels are available for filtering via -kubernetesCollector.excludeFilter flag
-kubernetesCollector.includeNodeAnnotations
Include Node annotations as additional fields in the log entries. Even this setting is disabled, Node annotations are available for filtering via -kubernetesCollector.excludeFilter flag
-kubernetesCollector.includeNodeLabels
Include Node labels as additional fields in the log entries. Even this setting is disabled, Node labels are available for filtering via -kubernetesCollector.excludeFilter flag
-kubernetesCollector.includePodAnnotations
Include Pod annotations as additional fields in the log entries. Even this setting is disabled, Pod annotations are available for filtering via -kubernetesCollector.excludeFilter flag
-kubernetesCollector.includePodLabels
Include Pod labels as additional fields in the log entries. Even this setting is disabled, Pod labels are available for filtering via -kubernetesCollector.excludeFilter flag (default true)
-kubernetesCollector.logsPath string
Path to the directory with Kubernetes container logs (usually /var/log/containers). This should point to the kubelet-managed directory containing symlinks to pod logs. vlagent must have read access to this directory and to the target log files, typically located under /var/log/pods and /var/lib on the host (default "/var/log/containers")
-kubernetesCollector.msgField array
Fields that may contain the _msg field. Default: message,msg,log. See https://docs.victoriametrics.com/victorialogs/keyconcepts/#message-field
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.
-kubernetesCollector.streamFields array
Comma-separated list of fields to use as log stream fields for logs ingested from Kubernetes Pods. Default: kubernetes.container_name,kubernetes.pod_name,kubernetes.pod_namespace. See: https://docs.victoriametrics.com/victorialogs/keyconcepts/#stream-fields
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.
-kubernetesCollector.tenantID string
Default tenant ID to use for logs collected from Kubernetes pods in format: <accountID>:<projectID>. See https://docs.victoriametrics.com/victorialogs/vlagent/#multitenancy (default "0:0")
-kubernetesCollector.timeField array
Fields that may contain the _time field. Default: time,timestamp,ts. If none of the specified fields is found in the log line, then the write time will be used. See https://docs.victoriametrics.com/victorialogs/keyconcepts/#time-field
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.
-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
-loki.disableMessageParsing
Whether to disable automatic parsing of JSON-encoded log fields inside Loki log message into distinct log fields; see https://docs.victoriametrics.com/victorialogs/data-ingestion/promtail/#parsing-log-message
-loki.maxRequestSize size
The maximum size in bytes of a single Loki request
Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 67108864)
-loki.messageFieldsPrefix string
Optional prefix to add to field names parsed from JSON-encoded log message at Loki protocol; this can be used for avoiding potential clash between the parsed field names and the log stream labels; see https://docs.victoriametrics.com/victorialogs/data-ingestion/promtail/#parsing-log-message
-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.maxRequestSize size
The maximum size in bytes of a single OpenTelemetry request
Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 67108864)
-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.
-remoteWrite.basicAuth.password array
Optional basic auth password to use for the corresponding -remoteWrite.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.
-remoteWrite.basicAuth.passwordFile array
Optional path to basic auth password to use for the corresponding -remoteWrite.url. 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.
-remoteWrite.basicAuth.username array
Optional basic auth username to use for the corresponding -remoteWrite.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.
-remoteWrite.basicAuth.usernameFile array
Optional path to basic auth username to use for the corresponding -remoteWrite.url. 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.
-remoteWrite.bearerToken array
Optional bearer auth token to use for the corresponding -remoteWrite.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.
-remoteWrite.bearerTokenFile array
Optional path to bearer token file to use for the corresponding -remoteWrite.url. 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.
-remoteWrite.flushInterval duration
Interval for flushing the data to remote storage. This option takes effect only when less than 2MB of data per second are pushed to -remoteWrite.url (default 1s)
-remoteWrite.format array
The data format to use for sending data to the corresponding -remoteWrite.url. Available formats: native, jsonline. Default is native. See https://docs.victoriametrics.com/victorialogs/vlagent/#remote-write-format
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.
-remoteWrite.headers array
Optional HTTP headers to send with each request to the corresponding -remoteWrite.url. For example, -remoteWrite.headers='My-Auth:foobar' would send 'My-Auth: foobar' HTTP header with every request to the corresponding -remoteWrite.url. Multiple headers must be delimited by '^^': -remoteWrite.headers='header1:value1^^header2:value2'
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.
-remoteWrite.maxBlockSize size
The maximum block size to send to remote storage. Bigger blocks may improve performance at the cost of the increased memory usage.
Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 8388608)
-remoteWrite.maxDiskUsagePerURL array
The maximum file-based buffer size in bytes at -remoteWrite.tmpDataPath for each -remoteWrite.url. When buffer size reaches the configured maximum, then old data is dropped when adding new data to the buffer. Buffered data is stored in ~500MB chunks. It is recommended to set the value for this flag to a multiple of the block size 500MB. Disk usage is unlimited if the value is set to 0
Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB. (default 0)
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to default value.
-remoteWrite.oauth2.clientID array
Optional OAuth2 clientID to use for the corresponding -remoteWrite.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.
-remoteWrite.oauth2.clientSecret array
Optional OAuth2 clientSecret to use for the corresponding -remoteWrite.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.
-remoteWrite.oauth2.clientSecretFile array
Optional OAuth2 clientSecretFile to use for the corresponding -remoteWrite.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.
-remoteWrite.oauth2.endpointParams array
Optional OAuth2 endpoint parameters to use for the corresponding -remoteWrite.url . The endpoint parameters must be set in JSON format: {"param1":"value1",...,"paramN":"valueN"}
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.
-remoteWrite.oauth2.scopes array
Optional OAuth2 scopes to use for the corresponding -remoteWrite.url. Scopes must be delimited by ';'
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.
-remoteWrite.oauth2.tokenUrl array
Optional OAuth2 tokenURL to use for the corresponding -remoteWrite.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.
-remoteWrite.proxyURL array
Optional proxy URL for writing data to the corresponding -remoteWrite.url. Supported proxies: http, https, socks5. Example: -remoteWrite.proxyURL=socks5://proxy:1234
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.
-remoteWrite.queues int
The number of concurrent queues to each -remoteWrite.url. Set more queues if default number of queues isn't enough for sending high volume of collected data to remote storage. Default value depends on the number of available CPU cores. It should work fine in most cases since it minimizes resource usage (default 128 = 2x CPU cores)
-remoteWrite.rateLimit array
Optional rate limit in bytes per second for data sent to the corresponding -remoteWrite.url. By default, the rate limit is disabled. It can be useful for limiting load on remote storage when big amounts of buffered data (default 0)
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to default value.
-remoteWrite.retryMaxTime array
The max time spent on retry attempts to send a block of data to the corresponding -remoteWrite.url. Change this value if it is expected for -remoteWrite.url to be unreachable for more than -remoteWrite.retryMaxTime. See also -remoteWrite.retryMinInterval (default 1m0s)
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to default value.
-remoteWrite.retryMinInterval array
The minimum delay between retry attempts to send a block of data to the corresponding -remoteWrite.url. Every next retry attempt will double the delay to prevent hammering of remote database. See also -remoteWrite.retryMaxTime (default 1s)
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to default value.
-remoteWrite.sendTimeout array
Timeout for sending a single block of data to the corresponding -remoteWrite.url (default 1m0s)
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to default value.
-remoteWrite.showURL
Whether to show -remoteWrite.url in the exported metrics. It is hidden by default, since it can contain sensitive info such as auth key
-remoteWrite.tlsCAFile array
Optional path to TLS CA file to use for verifying connections to the corresponding -remoteWrite.url. 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.
-remoteWrite.tlsCertFile array
Optional path to client-side TLS certificate file to use when connecting to the corresponding -remoteWrite.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.
-remoteWrite.tlsHandshakeTimeout array
The timeout for establishing tls connections to the corresponding -remoteWrite.url (default 20s)
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to default value.
-remoteWrite.tlsInsecureSkipVerify array
Whether to skip tls verification when connecting to the corresponding -remoteWrite.url
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to false.
-remoteWrite.tlsKeyFile array
Optional path to client-side TLS certificate key to use when connecting to the corresponding -remoteWrite.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.
-remoteWrite.tlsServerName array
Optional TLS server name to use for connections to the corresponding -remoteWrite.url. By default, the server name from -remoteWrite.url 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.
-remoteWrite.tmpDataPath string
Path to directory for storing pending data, which isn't sent to the configured -remoteWrite.url. If this flag isn't set, then pending data is stored in the vlagent-remotewrite-data subdirectory under the -tmpDataPath directory; see also -remoteWrite.maxDiskUsagePerURL
-remoteWrite.url array
Remote storage URL to write data to. Example url: http://<victorialogs-host>:9428/insert/native. Pass multiple -remoteWrite.url options in order to replicate the collected data to multiple remote storage systems. See also -remoteWrite.maxDiskUsagePerURL and -remoteWrite.format
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.
-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.
-splunk.ignoreFields array
Comma-separated list of fields to ignore for logs ingested over Splunk protocol. See https://docs.victoriametrics.com/victorialogs/data-ingestion/splunk/#dropping-fields
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.
-splunk.maxRequestSize size
The maximum size in bytes of a single Splunk request; see https://docs.victoriametrics.com/victorialogs/data-ingestion/splunk/
Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 67108864)
-splunk.msgField array
Field to use as a log message for logs ingested via Splunk protocol. See https://docs.victoriametrics.com/victorialogs/data-ingestion/splunk/#message-field
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.
-splunk.preserveJSONKeys array
Comma-separated list of JSON keys that should be preserved from flattening when ingested via Splunk protocol. See https://docs.victoriametrics.com/victorialogs/data-ingestion/splunk/ and https://docs.victoriametrics.com/victorialogs/keyconcepts/#data-model
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.
-splunk.streamFields array
Comma-separated list of fields to use as log stream fields for logs ingested over Splunk protocol. See https://docs.victoriametrics.com/victorialogs/data-ingestion/splunk/#stream-fields
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.
-splunk.tenantID string
TenantID for logs ingested via the Splunk endpoint. See https://docs.victoriametrics.com/victorialogs/data-ingestion/splunk/#multitenancy (default "0:0")
-splunk.timeField string
Field to use as a log timestamp for logs ingested via Splunk protocol. See https://docs.victoriametrics.com/victorialogs/data-ingestion/splunk/#time-field (default "time")
-syslog.compressMethod.tcp array
Compression method for syslog messages received at the corresponding -syslog.listenAddr.tcp. Supported values: none, gzip, deflate. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#compression
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.
-syslog.compressMethod.udp array
Compression method for syslog messages received at the corresponding -syslog.listenAddr.udp. Supported values: none, gzip, deflate. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#compression
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.
-syslog.compressMethod.unix array
Compression method for syslog messages received at the corresponding -syslog.listenAddr.unix. Supported values: none, gzip, deflate. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#compression
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.
-syslog.decolorizeFields.tcp array
Fields to remove ANSI color codes across logs ingested via the corresponding -syslog.listenAddr.tcp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#decolorizing-fields
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.
-syslog.decolorizeFields.udp array
Fields to remove ANSI color codes across logs ingested via the corresponding -syslog.listenAddr.udp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#decolorizing-fields
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.
-syslog.decolorizeFields.unix array
Fields to remove ANSI color codes across logs ingested via the corresponding -syslog.listenAddr.unix. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#decolorizing-fields
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.
-syslog.extraFields.tcp array
Fields to add to logs ingested via the corresponding -syslog.listenAddr.tcp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#adding-extra-fields
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.
-syslog.extraFields.udp array
Fields to add to logs ingested via the corresponding -syslog.listenAddr.udp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#adding-extra-fields
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.
-syslog.extraFields.unix array
Fields to add to logs ingested via the corresponding -syslog.listenAddr.unix. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#adding-extra-fields
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.
-syslog.ignoreFields.tcp array
Fields to ignore at logs ingested via the corresponding -syslog.listenAddr.tcp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#dropping-fields
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.
-syslog.ignoreFields.udp array
Fields to ignore at logs ingested via the corresponding -syslog.listenAddr.udp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#dropping-fields
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.
-syslog.ignoreFields.unix array
Fields to ignore at logs ingested via the corresponding -syslog.listenAddr.unix. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#dropping-fields
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.
-syslog.listenAddr.tcp array
Comma-separated list of TCP addresses to listen to for Syslog messages. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/
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.
-syslog.listenAddr.udp array
Comma-separated list of UDP addresses to listen to for Syslog messages. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/
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.
-syslog.listenAddr.unix array
Comma-separated list of Unix socket filepaths to listen to for Syslog messages. Filepaths may be prepended with 'unixgram:' for listening for SOCK_DGRAM sockets. By default SOCK_STREAM sockets are used. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/
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.
-syslog.streamFields.tcp array
Fields to use as log stream labels for logs ingested via the corresponding -syslog.listenAddr.tcp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#stream-fields
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.
-syslog.streamFields.udp array
Fields to use as log stream labels for logs ingested via the corresponding -syslog.listenAddr.udp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#stream-fields
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.
-syslog.streamFields.unix array
Fields to use as log stream labels for logs ingested via the corresponding -syslog.listenAddr.unix. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#stream-fields
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.
-syslog.tenantID.tcp array
TenantID for logs ingested via the corresponding -syslog.listenAddr.tcp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#multitenancy
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.
-syslog.tenantID.udp array
TenantID for logs ingested via the corresponding -syslog.listenAddr.udp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#multitenancy
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.
-syslog.tenantID.unix array
TenantID for logs ingested via the corresponding -syslog.listenAddr.unix. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#multitenancy
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.
-syslog.timezone string
Timezone to use when parsing timestamps in RFC3164 syslog messages. Timezone must be a valid IANA Time Zone. For example: America/New_York, Europe/Berlin, Etc/GMT+3 . See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/ (default "Local")
-syslog.tls array
Whether to enable TLS for receiving syslog messages at the corresponding -syslog.listenAddr.tcp. The corresponding -syslog.tlsCertFile and -syslog.tlsKeyFile must be set if -syslog.tls is set. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#security
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to false.
-syslog.tlsCertFile array
Path to file with TLS certificate for the corresponding -syslog.listenAddr.tcp if the corresponding -syslog.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 https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#security
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.
-syslog.tlsCipherSuites array
Optional list of TLS cipher suites for -syslog.listenAddr.tcp if -syslog.tls is set. See the list of supported cipher suites at https://pkg.go.dev/crypto/tls#pkg-constants . See also https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#security
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.
-syslog.tlsKeyFile array
Path to file with TLS key for the corresponding -syslog.listenAddr.tcp if the corresponding -syslog.tls is set. The provided key file is automatically re-read every second, so it can be dynamically updated. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#security
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.
-syslog.tlsMinVersion string
The minimum TLS version to use for -syslog.listenAddr.tcp if -syslog.tls is set. Supported values: TLS10, TLS11, TLS12, TLS13. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#security (default "TLS13")
-syslog.useLocalTimestamp.tcp array
Whether to use local timestamp instead of the original timestamp for the ingested syslog messages at the corresponding -syslog.listenAddr.tcp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#log-timestamps
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to false.
-syslog.useLocalTimestamp.udp array
Whether to use local timestamp instead of the original timestamp for the ingested syslog messages at the corresponding -syslog.listenAddr.udp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#log-timestamps
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to false.
-syslog.useLocalTimestamp.unix array
Whether to use local timestamp instead of the original timestamp for the ingested syslog messages at the corresponding -syslog.listenAddr.unix. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#log-timestamps
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to false.
-syslog.useRemoteIP.tcp array
Whether to add remote ip address as 'remote_ip' log field for syslog messages ingested via the corresponding -syslog.listenAddr.tcp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#capturing-remote-ip-address
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to false.
-syslog.useRemoteIP.udp array
Whether to add remote ip address as 'remote_ip' log field for syslog messages ingested via the corresponding -syslog.listenAddr.udp. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#capturing-remote-ip-address
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to false.
-syslog.useRemoteIP.unix array
Whether to add remote ip address as 'remote_ip' log field for syslog messages ingested via the corresponding -syslog.listenAddr.unix. See https://docs.victoriametrics.com/victorialogs/data-ingestion/syslog/#capturing-remote-ip-address
Supports array of values separated by comma or specified via multiple flags.
Empty values are set to false.
-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.
-tmpDataPath string
Base directory for storing vlagent data. Used as default for -remoteWrite.tmpDataPath, -kubernetesCollector.checkpointsPath, and -fileCollector.checkpointsPath unless those flags are set explicitly
-version
Show VictoriaMetrics version
Options (181)
| Option | Description | Source |
|---|---|---|
-blockcache.missesBeforeCaching int | The number of cache misses before putting the block into cache. | help |
-datadog.ignoreFields array | Comma-separated list of fields to ignore for logs ingested via DataDog protocol. | help |
-datadog.maxRequestSize size | The maximum size in bytes of a single DataDog request Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 67108864) | help |
-datadog.streamFields array | Comma-separated list of fields to use as log stream fields for logs ingested via DataDog protocol. | help |
-defaultMsgValue string | Default value for _msg field if the ingested log entry doesn't contain it; | help |
-elasticsearch.version string | Elasticsearch version to report to client (default "8.9.0") | help |
-enableTCP6 | Whether to enable IPv6 for listening and dialing. | help |
-envflag.enable | Whether to enable reading flags from environment variables in addition to the command line. | help |
-envflag.prefix string | Prefix for environment variables if -envflag.enable is set | help |
-fileCollector.checkpointsPath string | Path to the file where vlagent stores its read position for each collected file. | help |
-fileCollector.decolorizeFields array | Fields to remove ANSI color codes across logs ingested from files Supports an array of values separated by comma or specified via multiple flags. | help |
-fileCollector.excludeGlob array | Glob pattern for log files to exclude from collection. | help |
-fileCollector.extraFields array | Extra fields in JSON format to add to each log line collected from files. | help |
-fileCollector.fileField string | Field name used to store the source file path in collected log entries. | help |
-fileCollector.glob array | Glob pattern for log files to collect. | help |
-fileCollector.hostnameField string | Field name used to store the hostname in collected log entries. | help |
-fileCollector.ignoreFields array | Fields to ignore across logs ingested from files Supports an array of values separated by comma or specified via multiple flags. | help |
-fileCollector.msgField array | Fields that may contain the _msg field. | help |
-fileCollector.refreshInterval duration | How often vlagent checks for new files matching the glob pattern (default 10s) | help |
-fileCollector.streamFields array | Comma-separated list of fields to use as log stream fields for logs ingested from files. | help |
-fileCollector.tenantID array | Default tenant ID to use for logs collected from files in format: <accountID>:<projectID>. | help |
-fileCollector.timeField array | Fields that may contain the _time field. | help |
-filestream.disableFadvise | Whether to disable fadvise() syscall when reading large data files. | help |
-flagsAuthKey value | Auth key for /flags endpoint. | help |
-fs.disableAdviseRandomRead | Whether to disable FADV_RANDOM and MADV_RANDOM hints for data part files. | help |
-fs.disableMincore | Whether to disable the mincore() syscall for checking mmap()ed files. | help |
-fs.disableMmap | Whether to use pread() instead of mmap() for reading data files. | help |
-fs.maxConcurrency int | The maximum number of concurrent goroutines to work with files; | help |
-http.connTimeout duration | Incoming connections to -httpListenAddr are closed after the configured timeout. | help |
-http.disableCORS | Disable CORS for all origins (*) | help |
-http.disableKeepAlive | Whether to disable HTTP keep-alive for incoming connections at -httpListenAddr | help |
-http.disableResponseCompression | Disable compression of HTTP responses to save CPU resources. | help |
-http.header.csp string | Value for 'Content-Security-Policy' header, recommended: "default-src 'self'" | help |
-http.header.disableServerHostname | Whether to disable 'X-Server-Hostname' header in HTTP responses | help |
-http.header.frameOptions string | Value for 'X-Frame-Options' header | help |
-http.header.hsts string | Value for 'Strict-Transport-Security' header, recommended: 'max-age=31536000; | help |
-http.idleConnTimeout duration | Timeout for incoming idle http connections (default 1m0s) | help |
-http.maxGracefulShutdownDuration duration | The maximum duration for a graceful shutdown of the HTTP server. | help |
-http.pathPrefix string | An optional prefix to add to all the paths handled by http server. | help |
-http.shutdownDelay duration | Optional delay before http server shutdown. | help |
-httpAuth.password value | Password for HTTP server's Basic Auth. | help |
-httpAuth.username string | Username for HTTP server's Basic Auth. | help |
-httpListenAddr array | Addresses to listen for incoming http requests. | help |
-httpListenAddr.useProxyProtocol array | Whether to use proxy protocol for connections accepted at the corresponding -httpListenAddr . | help |
-insert.disable | Whether to disable both /insert/* and /internal/insert HTTP endpoints. | help |
-insert.maxFieldsPerLine int | The maximum number of log fields per line, which can be read by /insert/* handlers; | help |
-insert.maxLineSizeBytes size | The maximum size of a single line that can be read by /insert/* handlers. | help |
-insert.maxQueueDuration duration | The maximum duration to wait in the queue when -maxConcurrentInserts concurrent insert requests are executed (default 1m0s) | help |
-internStringCacheExpireDuration duration | The expiry duration for caches for interned strings. | help |
-internStringDisableCache | Whether to disable caches for interned strings. | help |
-internStringMaxLen int | The maximum length for strings to intern. | help |
-internalinsert.disable | Whether to disable /internal/insert HTTP endpoint. | help |
-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… | help |
-journald.ignoreFields array | Comma-separated list of fields to ignore for logs ingested over journald protocol. | help |
-journald.includeEntryMetadata | Include Journald fields with double underscore prefixes | help |
-journald.streamFields array | Comma-separated list of fields to use as log stream fields for logs ingested over journald protocol. | help |
-journald.tenantID string | TenantID for logs ingested via the Journald endpoint. | help |
-journald.timeField string | Field to use as a log timestamp for logs ingested via journald protocol. | help |
-journald.useRemoteIP | Whether to add the remote IP address as the remote_ip log field for ingested journald messages. | help |
-kubernetesCollector | Whether to enable collecting logs from Kubernetes | help |
-kubernetesCollector.checkpointsPath string | Path to file with checkpoints for Kubernetes logs. | help |
-kubernetesCollector.decolorizeFields array | Fields to remove ANSI color codes across logs ingested from Kubernetes Supports an array of values separated by comma or specified via multiple flags. | help |
-kubernetesCollector.excludeFilter string | Optional LogsQL filter for excluding container logs. | help |
-kubernetesCollector.extraFields string | Extra fields in JSON format to add to each log line collected from Kubernetes Pods. | help |
-kubernetesCollector.ignoreFields array | Fields to ignore across logs ingested from Kubernetes Supports an array of values separated by comma or specified via multiple flags. | help |
-kubernetesCollector.includeNamespaceAnnotations | Include Namespace annotations as additional fields in the log entries. | help |
-kubernetesCollector.includeNamespaceLabels | Include Namespace labels as additional fields in the log entries. | help |
-kubernetesCollector.includeNodeAnnotations | Include Node annotations as additional fields in the log entries. | help |
-kubernetesCollector.includeNodeLabels | Include Node labels as additional fields in the log entries. | help |
-kubernetesCollector.includePodAnnotations | Include Pod annotations as additional fields in the log entries. | help |
-kubernetesCollector.includePodLabels | Include Pod labels as additional fields in the log entries. | help |
-kubernetesCollector.logsPath string | Path to the directory with Kubernetes container logs (usually /var/log/containers). | help |
-kubernetesCollector.msgField array | Fields that may contain the _msg field. | help |
-kubernetesCollector.streamFields array | Comma-separated list of fields to use as log stream fields for logs ingested from Kubernetes Pods. | help |
-kubernetesCollector.tenantID string | Default tenant ID to use for logs collected from Kubernetes pods in format: <accountID>:<projectID>. | help |
-kubernetesCollector.timeField array | Fields that may contain the _time field. | help |
-loggerDisableTimestamps | Whether to disable writing timestamps in logs | help |
-loggerErrorsPerSecondLimit int | Per-second limit on the number of ERROR messages. | help |
-loggerFormat string | Format for logs. | help |
-loggerJSONFields string | Allows renaming fields in JSON formatted logs. | help |
-loggerLevel string | Minimum level of errors to log. | help |
-loggerMaxArgLen int | The maximum length of a single logged argument. | help |
-loggerOutput string | Output for the logs. | help |
-loggerTimezone string | Timezone to use for timestamps in logs. | help |
-loggerWarnsPerSecondLimit int | Per-second limit on the number of WARN messages. | help |
-loki.disableMessageParsing | Whether to disable automatic parsing of JSON-encoded log fields inside Loki log message into distinct log fields; | help |
-loki.maxRequestSize size | The maximum size in bytes of a single Loki request Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 67108864) | help |
-loki.messageFieldsPrefix string | Optional prefix to add to field names parsed from JSON-encoded log message at Loki protocol; | help |
-maxConcurrentInserts int | The maximum number of concurrent insert requests. | help |
-memory.allowedBytes size | Allowed size of system memory VictoriaMetrics caches may occupy. | help |
-memory.allowedPercent float | Allowed percent of system memory VictoriaMetrics caches may occupy. | help |
-metrics.exposeMetadata | Whether to expose TYPE and HELP metadata at the /metrics page, which is exposed at -httpListenAddr . | help |
-metricsAuthKey value | Auth key for /metrics endpoint. | help |
-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,… | help |
-opentelemetry.maxRequestSize size | The maximum size in bytes of a single OpenTelemetry request Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 67108864) | help |
-pprofAuthKey value | Auth key for /debug/pprof/* endpoints. | help |
-pushmetrics.disableCompression | Whether to disable request body compression when pushing metrics to every -pushmetrics.url | help |
-pushmetrics.extraLabel array | Optional labels to add to metrics pushed to every -pushmetrics.url . | help |
-pushmetrics.header array | Optional HTTP request header to send to every -pushmetrics.url . | help |
-pushmetrics.interval duration | Interval for pushing metrics to every -pushmetrics.url (default 10s) | help |
-pushmetrics.url array | Optional URL to push metrics exposed at /metrics page. | help |
-remoteWrite.basicAuth.password array | Optional basic auth password to use for the corresponding -remoteWrite.url Supports an array of values separated by comma or specified via multiple flags. | help |
-remoteWrite.basicAuth.passwordFile array | Optional path to basic auth password to use for the corresponding -remoteWrite.url. | help |
-remoteWrite.basicAuth.username array | Optional basic auth username to use for the corresponding -remoteWrite.url Supports an array of values separated by comma or specified via multiple flags. | help |
-remoteWrite.basicAuth.usernameFile array | Optional path to basic auth username to use for the corresponding -remoteWrite.url. | help |
-remoteWrite.bearerToken array | Optional bearer auth token to use for the corresponding -remoteWrite.url Supports an array of values separated by comma or specified via multiple flags. | help |
-remoteWrite.bearerTokenFile array | Optional path to bearer token file to use for the corresponding -remoteWrite.url. | help |
-remoteWrite.flushInterval duration | Interval for flushing the data to remote storage. | help |
-remoteWrite.format array | The data format to use for sending data to the corresponding -remoteWrite.url. | help |
-remoteWrite.headers array | Optional HTTP headers to send with each request to the corresponding -remoteWrite.url. | help |
-remoteWrite.maxBlockSize size | The maximum block size to send to remote storage. | help |
-remoteWrite.maxDiskUsagePerURL array | The maximum file-based buffer size in bytes at -remoteWrite.tmpDataPath for each -remoteWrite.url. | help |
-remoteWrite.oauth2.clientID array | Optional OAuth2 clientID to use for the corresponding -remoteWrite.url Supports an array of values separated by comma or specified via multiple flags. | help |
-remoteWrite.oauth2.clientSecret array | Optional OAuth2 clientSecret to use for the corresponding -remoteWrite.url Supports an array of values separated by comma or specified via multiple flags. | help |
-remoteWrite.oauth2.clientSecretFile array | Optional OAuth2 clientSecretFile to use for the corresponding -remoteWrite.url Supports an array of values separated by comma or specified via multiple flags. | help |
-remoteWrite.oauth2.endpointParams array | Optional OAuth2 endpoint parameters to use for the corresponding -remoteWrite.url . | help |
-remoteWrite.oauth2.scopes array | Optional OAuth2 scopes to use for the corresponding -remoteWrite.url. | help |
-remoteWrite.oauth2.tokenUrl array | Optional OAuth2 tokenURL to use for the corresponding -remoteWrite.url Supports an array of values separated by comma or specified via multiple flags. | help |
-remoteWrite.proxyURL array | Optional proxy URL for writing data to the corresponding -remoteWrite.url. | help |
-remoteWrite.queues int | The number of concurrent queues to each -remoteWrite.url. | help |
-remoteWrite.rateLimit array | Optional rate limit in bytes per second for data sent to the corresponding -remoteWrite.url. | help |
-remoteWrite.retryMaxTime array | The max time spent on retry attempts to send a block of data to the corresponding -remoteWrite.url. | help |
-remoteWrite.retryMinInterval array | The minimum delay between retry attempts to send a block of data to the corresponding -remoteWrite.url. | help |
-remoteWrite.sendTimeout array | Timeout for sending a single block of data to the corresponding -remoteWrite.url (default 1m0s) Supports array of values separated by comma or specified via multiple flags. | help |
-remoteWrite.showURL | Whether to show -remoteWrite.url in the exported metrics. | help |
-remoteWrite.tlsCAFile array | Optional path to TLS CA file to use for verifying connections to the corresponding -remoteWrite.url. | help |
-remoteWrite.tlsCertFile array | Optional path to client-side TLS certificate file to use when connecting to the corresponding -remoteWrite.url Supports an array of values separated by comma or specified via multiple flags. | help |
-remoteWrite.tlsHandshakeTimeout array | The timeout for establishing tls connections to the corresponding -remoteWrite.url (default 20s) Supports array of values separated by comma or specified via multiple flags. | help |
-remoteWrite.tlsInsecureSkipVerify array | Whether to skip tls verification when connecting to the corresponding -remoteWrite.url Supports array of values separated by comma or specified via multiple flags. | help |
-remoteWrite.tlsKeyFile array | Optional path to client-side TLS certificate key to use when connecting to the corresponding -remoteWrite.url Supports an array of values separated by comma or specified via multiple flags. | help |
-remoteWrite.tlsServerName array | Optional TLS server name to use for connections to the corresponding -remoteWrite.url. | help |
-remoteWrite.tmpDataPath string | Path to directory for storing pending data, which isn't sent to the configured -remoteWrite.url. | help |
-remoteWrite.url array | Remote storage URL to write data to. | help |
-secret.flags array | Comma-separated list of flag names with secret values. | help |
-splunk.ignoreFields array | Comma-separated list of fields to ignore for logs ingested over Splunk protocol. | help |
-splunk.maxRequestSize size | The maximum size in bytes of a single Splunk request; | help |
-splunk.msgField array | Field to use as a log message for logs ingested via Splunk protocol. | help |
-splunk.preserveJSONKeys array | Comma-separated list of JSON keys that should be preserved from flattening when ingested via Splunk protocol. | help |
-splunk.streamFields array | Comma-separated list of fields to use as log stream fields for logs ingested over Splunk protocol. | help |
-splunk.tenantID string | TenantID for logs ingested via the Splunk endpoint. | help |
-splunk.timeField string | Field to use as a log timestamp for logs ingested via Splunk protocol. | help |
-syslog.compressMethod.tcp array | Compression method for syslog messages received at the corresponding -syslog.listenAddr.tcp. | help |
-syslog.compressMethod.udp array | Compression method for syslog messages received at the corresponding -syslog.listenAddr.udp. | help |
-syslog.compressMethod.unix array | Compression method for syslog messages received at the corresponding -syslog.listenAddr.unix. | help |
-syslog.decolorizeFields.tcp array | Fields to remove ANSI color codes across logs ingested via the corresponding -syslog.listenAddr.tcp. | help |
-syslog.decolorizeFields.udp array | Fields to remove ANSI color codes across logs ingested via the corresponding -syslog.listenAddr.udp. | help |
-syslog.decolorizeFields.unix array | Fields to remove ANSI color codes across logs ingested via the corresponding -syslog.listenAddr.unix. | help |
-syslog.extraFields.tcp array | Fields to add to logs ingested via the corresponding -syslog.listenAddr.tcp. | help |
-syslog.extraFields.udp array | Fields to add to logs ingested via the corresponding -syslog.listenAddr.udp. | help |
-syslog.extraFields.unix array | Fields to add to logs ingested via the corresponding -syslog.listenAddr.unix. | help |
-syslog.ignoreFields.tcp array | Fields to ignore at logs ingested via the corresponding -syslog.listenAddr.tcp. | help |
-syslog.ignoreFields.udp array | Fields to ignore at logs ingested via the corresponding -syslog.listenAddr.udp. | help |
-syslog.ignoreFields.unix array | Fields to ignore at logs ingested via the corresponding -syslog.listenAddr.unix. | help |
-syslog.listenAddr.tcp array | Comma-separated list of TCP addresses to listen to for Syslog messages. | help |
-syslog.listenAddr.udp array | Comma-separated list of UDP addresses to listen to for Syslog messages. | help |
-syslog.listenAddr.unix array | Comma-separated list of Unix socket filepaths to listen to for Syslog messages. | help |
-syslog.streamFields.tcp array | Fields to use as log stream labels for logs ingested via the corresponding -syslog.listenAddr.tcp. | help |
-syslog.streamFields.udp array | Fields to use as log stream labels for logs ingested via the corresponding -syslog.listenAddr.udp. | help |
-syslog.streamFields.unix array | Fields to use as log stream labels for logs ingested via the corresponding -syslog.listenAddr.unix. | help |
-syslog.tenantID.tcp array | TenantID for logs ingested via the corresponding -syslog.listenAddr.tcp. | help |
-syslog.tenantID.udp array | TenantID for logs ingested via the corresponding -syslog.listenAddr.udp. | help |
-syslog.tenantID.unix array | TenantID for logs ingested via the corresponding -syslog.listenAddr.unix. | help |
-syslog.timezone string | Timezone to use when parsing timestamps in RFC3164 syslog messages. | help |
-syslog.tls array | Whether to enable TLS for receiving syslog messages at the corresponding -syslog.listenAddr.tcp. | help |
-syslog.tlsCertFile array | Path to file with TLS certificate for the corresponding -syslog.listenAddr.tcp if the corresponding -syslog.tls is set. | help |
-syslog.tlsCipherSuites array | Optional list of TLS cipher suites for -syslog.listenAddr.tcp if -syslog.tls is set. | help |
-syslog.tlsKeyFile array | Path to file with TLS key for the corresponding -syslog.listenAddr.tcp if the corresponding -syslog.tls is set. | help |
-syslog.tlsMinVersion string | The minimum TLS version to use for -syslog.listenAddr.tcp if -syslog.tls is set. | help |
-syslog.useLocalTimestamp.tcp array | Whether to use local timestamp instead of the original timestamp for the ingested syslog messages at the corresponding -syslog.listenAddr.tcp. | help |
-syslog.useLocalTimestamp.udp array | Whether to use local timestamp instead of the original timestamp for the ingested syslog messages at the corresponding -syslog.listenAddr.udp. | help |
-syslog.useLocalTimestamp.unix array | Whether to use local timestamp instead of the original timestamp for the ingested syslog messages at the corresponding -syslog.listenAddr.unix. | help |
-syslog.useRemoteIP.tcp array | Whether to add remote ip address as 'remote_ip' log field for syslog messages ingested via the corresponding -syslog.listenAddr.tcp. | help |
-syslog.useRemoteIP.udp array | Whether to add remote ip address as 'remote_ip' log field for syslog messages ingested via the corresponding -syslog.listenAddr.udp. | help |
-syslog.useRemoteIP.unix array | Whether to add remote ip address as 'remote_ip' log field for syslog messages ingested via the corresponding -syslog.listenAddr.unix. | help |
-tls array | Whether to enable TLS for incoming HTTP requests at the given -httpListenAddr (aka https). | help |
-tlsCertFile array | Path to file with TLS certificate for the corresponding -httpListenAddr if -tls is set. | help |
-tlsCipherSuites array | Optional list of TLS cipher suites for incoming requests over HTTPS if -tls is set. | help |
-tlsKeyFile array | Path to file with TLS key for the corresponding -httpListenAddr if -tls is set. | help |
-tlsMinVersion array | Optional minimum TLS version to use for the corresponding -httpListenAddr if -tls is set. | help |
-tmpDataPath string | Base directory for storing vlagent data. | help |
-version | Show VictoriaMetrics version | help |