版本:v1.93.15

端口配置

应用

端口

描述

vmstorage

8482

vmui端口

8400

insert默认端口

8401

select 默认端口

vmselect

8481

select 默认端口

8501

Rpc 指标查询,联邦查询

-


联邦查询端口,可以通过clusternativeListenAddr参数指定,通常用: 8401,没有配置的话不会开启

vminsert

8480

insert默认端口

-

联邦写入端口,可以通过clusternativeListenAddr参数指定,通常用: 8400,没有配置的话不会开启

vmagent

8429

insert默认端口




分类

分类

数量

4个应用都有的参数

42

3个应用都有的参数

2

2个应用都有的参数

37

只有1个应用有的参数

174

配置详情

4个应用都有的参数

cacheExpireDuration

应用: agent, insert, select, storage

默认值: 30m0s

单位: duration

描述: 在这段时间内未访问项后,将从内存缓存中删除这些项。较低的值可能会以较高的CPU使用率为代价降低内存使用率. See also -prevCacheRemovalPercent (default 30m0s)

denyQueryTracing

应用: agent, insert, select, storage

默认值:

单位:

描述: 是否禁用跟踪查询的功能. See https://docs.victoriametrics.com/#query-tracing

enableTCP6

应用: agent, insert, select, storage

默认值:

单位:

描述: Whether to enable IPv6 for listening and dialing. By default, only IPv4 TCP and UDP are used

envflag.enable

应用: agent, insert, select, storage

默认值:

单位:

描述: 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/#environment-variables for more details

envflag.prefix

应用: agent, insert, select, storage

默认值:

单位: string

描述: Prefix for environment variables if -envflag.enable is set

flagsAuthKey

应用: agent, insert, select, storage

默认值:

单位: string

描述: Auth key for /flags endpoint. It must be passed via authKey query arg. It overrides httpAuth.* settings

fs.disableMmap

应用: agent, insert, select, storage

默认值:

单位:

描述: 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()

http.connTimeout

应用: agent, insert, select, storage

默认值: 2m0s

单位: duration

描述: Incoming http connections are closed after the configured timeout. This may help to spread the incoming load among a cluster of services behind a load balancer. Please note that the real timeout may be bigger by up to 10% as a protection against the thundering herd problem (default 2m0s)

http.disableResponseCompression

应用: agent, insert, select, storage

默认值:

单位:

描述: Disable compression of HTTP responses to save CPU resources. By default, compression is enabled to save network bandwidth

http.idleConnTimeout

应用: agent, insert, select, storage

默认值: 1m0s

单位: duration

描述: Timeout for incoming idle http connections (default 1m0s)

http.maxGracefulShutdownDuration

应用: agent, insert, select, storage

默认值: 7s

单位: duration

描述: The maximum duration for a graceful shutdown of the HTTP server. A highly loaded server may require increased value for a graceful shutdown (default 7s)

http.pathPrefix

应用: agent, insert, select, storage

默认值:

单位: 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

应用: agent, insert, select, storage

默认值:

单位: 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

应用: agent, insert, select, storage

默认值:

单位: string

描述: Password for HTTP server's Basic Auth. The authentication is disabled if -httpAuth.username is empty

httpAuth.username

应用: agent, insert, select, storage

默认值:

单位: string

描述: Username for HTTP server's Basic Auth. The authentication is disabled if empty. See also -httpAuth.password

httpListenAddr

应用: agent

默认值: ":8429"

单位: string

描述: TCP address to listen for http connections. Set this flag to empty value in order to disable listening on any port. This mode may be useful for running multiple vmagent instances on the same server. Note that /targets and /metrics pages aren't available if -httpListenAddr=''. See also -httpListenAddr.useProxyProtocol (default ":8429")

httpListenAddr

应用: insert

默认值: ":8480"

单位: string

描述: Address to listen for http connections. See also -httpListenAddr.useProxyProtocol (default ":8480")

httpListenAddr

应用: select

默认值: ":8481"

单位: string

描述: Address to listen for http connections. See also -httpListenAddr.useProxyProtocol (default ":8481")

httpListenAddr

应用: storage

默认值: ":8482"

单位: string

描述: Address to listen for http connections. See also -httpListenAddr.useProxyProtocol (default ":8482")

httpListenAddr.useProxyProtocol

应用: agent, insert, select, storage

默认值:

单位:

描述: Whether to use proxy protocol for connections accepted at -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

internStringCacheExpireDuration

应用: agent, insert, select, storage

默认值: 6m0s

单位: 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

应用: agent, insert, select, storage

默认值:

单位:

描述: 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

应用: agent, insert, select, storage

默认值: 500

单位: 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)

loggerDisableTimestamps

应用: agent, insert, select, storage

默认值:

单位:

描述: Whether to disable writing timestamps in logs

loggerErrorsPerSecondLimit

应用: agent, insert, select, storage

默认值:

单位: 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

应用: agent, insert, select, storage

默认值: "default"

单位: string

描述: Format for logs. Possible values: default, json (default "default")

loggerJSONFields

应用: agent, insert, select, storage

默认值:

单位: 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

应用: agent, insert, select, storage

默认值: "INFO"

单位: string

描述: Minimum level of errors to log. Possible values: INFO, WARN, ERROR, FATAL, PANIC (default "INFO")

loggerOutput

应用: agent, insert, select, storage

默认值: "stderr"

单位: string

描述: Output for the logs. Supported values: stderr, stdout (default "stderr")

loggerTimezone

应用: agent, insert, select, storage

默认值: "UTC"

单位: 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

应用: agent, insert, select, storage

默认值:

单位: 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

memory.allowedBytes

应用: agent, insert, select, storage

默认值: 0

单位: 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 usageSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 0)

memory.allowedPercent

应用: agent, insert, select, storage

默认值: 60

单位: 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)

metricsAuthKey

应用: agent, insert, select, storage

默认值:

单位: string

描述: Auth key for /metrics endpoint. It must be passed via authKey query arg. It overrides httpAuth.* settings

pprofAuthKey

应用: agent, insert, select, storage

默认值:

单位: string

描述: Auth key for /debug/pprof/* endpoints. It must be passed via authKey query arg. It overrides httpAuth.* settings

prevCacheRemovalPercent

应用: agent, insert, select, storage

默认值: 0.1

单位: float

描述: Items in the previous caches are removed when the percent of requests it serves becomes lower than this value. Higher values reduce memory usage at the cost of higher CPU usage. See also -cacheExpireDuration (default 0.1)

pushmetrics.extraLabel

应用: agent, insert, select, storage

默认值:

单位: array

描述: Optional labels to add to metrics pushed to -pushmetrics.url . For example, -pushmetrics.extraLabel='instance="foo"' adds instance="foo" label to all the metrics pushed to -pushmetrics.urlSupports an array of values separated by comma or specified via multiple flags.

pushmetrics.interval

应用: agent, insert, select, storage

默认值: 10s

单位: duration

描述: Interval for pushing metrics to -pushmetrics.url (default 10s)

pushmetrics.url

应用: agent, insert, select, storage

默认值:

单位: array

描述: Optional URL to push metrics exposed at /metrics page. See https://docs.victoriametrics.com/#push-metrics . By default, metrics exposed at /metrics page aren't pushed to any remote storageSupports an array of values separated by comma or specified via multiple flags.

tls

应用: agent, insert, select, storage

默认值:

单位:

描述: Whether to enable TLS for incoming HTTP requests at -httpListenAddr (aka https). -tlsCertFile and -tlsKeyFile must be set if -tls is set

tlsCertFile

应用: agent, insert, select, storage

默认值:

单位: string

描述: Path to file with TLS certificate 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

tlsCipherSuites

应用: agent, insert, select, storage

默认值:

单位: 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-constantsSupports an array of values separated by comma or specified via multiple flags.

tlsKeyFile

应用: agent, insert, select, storage

默认值:

单位: string

描述: Path to file with TLS key if -tls is set. The provided key file is automatically re-read every second, so it can be dynamically updated

tlsMinVersion

应用: agent, insert, select, storage

默认值:

单位: string

描述: Optional minimum TLS version to use for incoming requests over HTTPS if -tls is set. Supported values: TLS10, TLS11, TLS12, TLS13

version

应用: agent, insert, select, storage

默认值:

单位:

描述: Show VictoriaMetrics version

3个应用都有的参数

insert.maxQueueDuration

应用: agent, insert, storage

默认值: 1m0s

单位: duration

描述: The maximum duration to wait in the queue when -maxConcurrentInserts concurrent insert requests are executed (default 1m0s)

maxConcurrentInserts

应用: agent, insert, storage

默认值: 8

单位: int

描述: The maximum number of concurrent insert requests. Default value should work for most cases, since it minimizes the memory usage. The default value can be increased when clients send data over slow networks. See also -insert.maxQueueDuration (default 8)

2个应用都有的参数

clusternativeListenAddr

应用: insert

默认值:

单位: string

描述: TCP address to listen for data from other vminsert nodes in multi-level cluster setup. See https://docs.victoriametrics.com/Cluster-VictoriaMetrics.html#multi-level-cluster-setup . Usually :8400 should be set to match default vmstorage port for vminsert. Disabled work if empty

clusternativeListenAddr

应用: select

默认值:

单位: string

描述: TCP address to listen for requests from other vmselect nodes in multi-level cluster setup. See https://docs.victoriametrics.com/Cluster-VictoriaMetrics.html#multi-level-cluster-setup . Usually :8401 should be set to match default vmstorage port for vmselect. Disabled work if empty

csvTrimTimestamp

应用: agent, insert

默认值: 1ms

单位: duration

描述: Trim timestamps when importing csv data to this duration. Minimum practical duration is 1ms. Higher duration (i.e. 1s) may be used for reducing disk space usage for timestamp data (default 1ms)

datadog.maxInsertRequestSize

应用: agent, insert

默认值: 67108864

单位: size

描述: The maximum size in bytes of a single DataDog POST request to /api/v1/seriesSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 67108864)

datadog.sanitizeMetricName

应用: agent, insert

默认值: true

单位:

描述: Sanitize metric names for the ingested DataDog data to comply with DataDog behaviour described at https://docs.datadoghq.com/metrics/custom_metrics/#naming-custom-metrics (default true)

dedup.minScrapeInterval

应用: select, storage

默认值:

单位: duration

描述: Leave only the last sample in every time series per each discrete interval equal to -dedup.minScrapeInterval > 0. See https://docs.victoriametrics.com/#deduplication for details

graphiteListenAddr

应用: agent, insert

默认值:

单位: string

描述: TCP and UDP address to listen for Graphite plaintext data. Usually :2003 must be set. Doesn't work if empty. See also -graphiteListenAddr.useProxyProtocol

graphiteListenAddr.useProxyProtocol

应用: agent, insert

默认值:

单位:

描述: Whether to use proxy protocol for connections accepted at -graphiteListenAddr . See https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt

graphiteTrimTimestamp

应用: agent, insert

默认值: 1s

单位: duration

描述: Trim timestamps for Graphite data to this duration. Minimum practical duration is 1s. Higher duration (i.e. 1m) may be used for reducing disk space usage for timestamp data (default 1s)

import.maxLineLen

应用: agent, insert

默认值: 104857600

单位: size

描述: The maximum length in bytes of a single line accepted by /api/v1/import; the line length can be limited with 'max_rows_per_line' query arg passed to /api/v1/exportSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 104857600)

influx.databaseNames

应用: agent, insert

默认值:

单位: array

描述: Comma-separated list of database names to return from /query and /influx/query API. This can be needed for accepting data from Telegraf plugins such as https://github.com/fangli/fluent-plugin-influxdbSupports an array of values separated by comma or specified via multiple flags.

influx.maxLineSize

应用: agent, insert

默认值: 262144

单位: size

描述: The maximum size in bytes for a single InfluxDB line during parsingSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 262144)

influxDBLabel

应用: agent, insert

默认值: "db"

单位: string

描述: Default label for the DB name sent over '?db={db_name}' query parameter (default "db")

influxListenAddr

应用: agent

默认值:

单位: string

描述: TCP and UDP address to listen for InfluxDB line protocol data. Usually :8089 must be set. Doesn't work if empty. This flag isn't needed when ingesting data over HTTP - just send it to http://<vmagent>:8429/write . See also -influxListenAddr.useProxyProtocol

influxListenAddr

应用: insert

默认值:

单位: string

描述: TCP and UDP address to listen for InfluxDB line protocol data. Usually :8089 must be set. Doesn't work if empty. This flag isn't needed when ingesting data over HTTP - just send it to http://<victoriametrics>:8428/write . See also -influxListenAddr.useProxyProtocol

influxListenAddr.useProxyProtocol

应用: agent, insert

默认值:

单位:

描述: Whether to use proxy protocol for connections accepted at -influxListenAddr . See https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt

influxMeasurementFieldSeparator

应用: agent, insert

默认值: "_"

单位: string

描述: Separator for '{measurement}{separator}{field_name}' metric name when inserted via InfluxDB line protocol (default "_")

influxSkipMeasurement

应用: agent, insert

默认值:

单位:

描述: Uses '{field_name}' as a metric name while ignoring '{measurement}' and '-influxMeasurementFieldSeparator'

influxSkipSingleField

应用: agent, insert

默认值:

单位:

描述: Uses '{measurement}' instead of '{measurement}{separator}{field_name}' for metric name if InfluxDB line contains only a single field

influxTrimTimestamp

应用: agent, insert

默认值: 1ms

单位: duration

描述: Trim timestamps for InfluxDB line protocol data to this duration. Minimum practical duration is 1ms. Higher duration (i.e. 1s) may be used for reducing disk space usage for timestamp data (default 1ms)

maxInsertRequestSize

应用: agent, insert

默认值: 33554432

单位: size

描述: The maximum size in bytes of a single Prometheus remote_write API requestSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 33554432)

opentsdbHTTPListenAddr

应用: agent, insert

默认值:

单位: string

描述: TCP address to listen for OpenTSDB HTTP put requests. Usually :4242 must be set. Doesn't work if empty. See also -opentsdbHTTPListenAddr.useProxyProtocol

opentsdbHTTPListenAddr.useProxyProtocol

应用: agent, insert

默认值:

单位:

描述: Whether to use proxy protocol for connections accepted at -opentsdbHTTPListenAddr . See https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt

opentsdbListenAddr

应用: agent, insert

默认值:

单位: string

描述: TCP and UDP address to listen for OpenTSDB metrics. Telnet put messages and HTTP /api/put messages are simultaneously served on TCP port. Usually :4242 must be set. Doesn't work if empty. See also -opentsdbListenAddr.useProxyProtocol

opentsdbListenAddr.useProxyProtocol

应用: agent, insert

默认值:

单位:

描述: Whether to use proxy protocol for connections accepted at -opentsdbListenAddr . See https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt

opentsdbTrimTimestamp

应用: agent, insert

默认值: 1s

单位: duration

描述: Trim timestamps for OpenTSDB 'telnet put' data to this duration. Minimum practical duration is 1s. Higher duration (i.e. 1m) may be used for reducing disk space usage for timestamp data (default 1s)

opentsdbhttp.maxInsertRequestSize

应用: agent, insert

默认值: 33554432

单位: size

描述: The maximum size of OpenTSDB HTTP put requestSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 33554432)

opentsdbhttpTrimTimestamp

应用: agent, insert

默认值: 1ms

单位: duration

描述: Trim timestamps for OpenTSDB HTTP data to this duration. Minimum practical duration is 1ms. Higher duration (i.e. 1s) may be used for reducing disk space usage for timestamp data (default 1ms)

replicationFactor

应用: insert

默认值: 1

单位: int

描述: Replication factor for the ingested data, i.e. how many copies to make among distinct -storageNode instances. Note that vmselect must run with -dedup.minScrapeInterval=1ms for data de-duplication when replicationFactor is greater than 1. Higher values for -dedup.minScrapeInterval at vmselect is OK (default 1)

  1. replicationFactor

应用: select

默认值: 1

单位: int

描述: How many copies of every time series is available on the provided -storageNode nodes. vmselect continues returning full responses when up to replicationFactor-1 vmstorage nodes are temporarily unavailable during querying. See also -search.skipSlowReplicas (default 1)

rpc.disableCompression

应用: insert

默认值:

单位:

描述: Whether to disable compression for the data sent from vminsert to vmstorage. This reduces CPU usage at the cost of higher network bandwidth usage

  1. rpc.disableCompression

应用: storage

默认值:

单位:

描述: Whether to disable compression of the data sent from vmstorage to vmselect. This reduces CPU usage at the cost of higher network bandwidth usage

search.maxConcurrentRequests

应用: select

默认值: 8

单位: int

描述: The maximum number of concurrent search requests. It shouldn't be high, since a single request can saturate all the CPU cores, while many concurrently executed requests may require high amounts of memory. See also -search.maxQueueDuration and -search.maxMemoryPerQuery (default 8)

  1. search.maxConcurrentRequests

应用: storage

默认值: 8

单位: int

描述: The maximum number of concurrent vmselect requests the vmstorage can process at -vmselectAddr. It shouldn't be high, since a single request usually saturates a CPU core, and many concurrently executed requests may require high amounts of memory. See also -search.maxQueueDuration (default 8)

search.maxQueueDuration

应用: select

默认值: 10s

单位: duration

描述: The maximum time the request waits for execution when -search.maxConcurrentRequests limit is reached; see also -search.maxQueryDuration (default 10s)

search.maxQueueDuration

应用: storage

默认值: 10s

单位: duration

描述: The maximum time the incoming vmselect request waits for execution when -search.maxConcurrentRequests limit is reached (default 10s)

search.maxTagValueSuffixesPerSearch

应用: select, storage

默认值: 100000

单位: int

描述: The maximum number of tag value suffixes returned from /metrics/find (default 100000)

search.maxUniqueTimeseries

应用: select

默认值: 300000

单位: int

描述: The maximum number of unique time series, which can be selected during /api/v1/query and /api/v1/query_range queries. This option allows limiting memory usage (default 300000)

search.maxUniqueTimeseries

应用: storage

默认值:

单位: int

描述: The maximum number of unique time series, which can be scanned during every query. This allows protecting against heavy queries, which select unexpectedly high number of series. Zero means 'no limit'. See also -search.max* command-line flags at vmselect

sortLabels

应用: agent

默认值:

单位:

描述: Whether to sort labels for incoming samples before writing them to all the configured remote storage systems. This may be needed for reducing memory usage at remote storage when the order of labels in incoming samples is random. For example, if m{k1="v1",k2="v2"} may be sent as m{k2="v2",k1="v1"}Enabled sorting for labels can slow down ingestion performance a bit

sortLabels

应用: insert

默认值:

单位:

描述: Whether to sort labels for incoming samples before writing them to storage. This may be needed for reducing memory usage at storage when the order of labels in incoming samples is random. For example, if m{k1="v1",k2="v2"} may be sent as m{k2="v2",k1="v1"}. Enabled sorting for labels can slow down ingestion performance a bit

storageNode

应用: insert, select

默认值:

单位: array

描述: Comma-separated addresses of vmstorage nodes; usage: -storageNode=vmstorage-host1,...,vmstorage-hostN . Enterprise version of VictoriaMetrics supports automatic discovery of vmstorage addresses via dns+srv records. For example, -storageNode=dns+srv:vmstorage.addrs . See https://docs.victoriametrics.com/Cluster-VictoriaMetrics.html#automatic-vmstorage-discoverySupports an array of values separated by comma or specified via multiple flags.,支持带端口,示例 -storageNode=vmstorage-host1:port1,vmstorage-host2:port2

usePromCompatibleNaming

应用: agent, insert

默认值:

单位:

描述: Whether to replace characters unsupported by Prometheus with underscores in the ingested metric names and label names. For example, foo.bar{a.b='c'} is transformed into foo_bar{a_b='c'} during data ingestion if this flag is set. See https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels

vmstorageDialTimeout

应用: insert

默认值: 5s

单位: duration

描述: Timeout for establishing RPC connections from vminsert to vmstorage (default 5s)

vmstorageDialTimeout

应用: select

默认值: 5s

单位: duration

描述: Timeout for establishing RPC connections from vmselect to vmstorage (default 5s)

只有1个应用有的参数

configAuthKey

应用: agent

默认值:

单位: string

描述: Authorization key for accessing /config page. It must be passed via authKey query arg

dryRun

应用: agent

默认值:

单位:

描述: Whether to check config files without running vmagent. The following files are checked: -promscrape.config, -remoteWrite.relabelConfig, -remoteWrite.urlRelabelConfig, -remoteWrite.streamAggr.config . Unknown config entries aren't allowed in -promscrape.config by default. This can be changed by passing -promscrape.config.strictParse=false command-line flag

promscrape.azureSDCheckInterval

应用: agent

默认值: 1m0s

单位: duration

描述: Interval for checking for changes in Azure. This works only if azure_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#azure_sd_configs for details (default 1m0s)

promscrape.cluster.memberNum

应用: agent

默认值: "0"

单位: string

描述: The number of number in the cluster of scrapers. It must be a unique value in the range 0 ... promscrape.cluster.membersCount-1 across scrapers in the cluster. Can be specified as pod name of Kubernetes StatefulSet - pod-name-Num, where Num is a numeric part of pod name (default "0")

promscrape.cluster.membersCount

应用: agent

默认值:

单位: int

描述: The number of members in a cluster of scrapers. Each member must have a unique -promscrape.cluster.memberNum in the range 0 ... promscrape.cluster.membersCount-1 . Each member then scrapes roughly 1/N of all the targets. By default, cluster scraping is disabled, i.e. a single scraper scrapes all the targets

promscrape.cluster.name

应用: agent

默认值:

单位: string

描述: Optional name of the cluster. If multiple vmagent clusters scrape the same targets, then each cluster must have unique name in order to properly de-duplicate samples received from these clusters. See https://github.com/VictoriaMetrics/VictoriaMetrics/issues/2679

promscrape.cluster.replicationFactor

应用: agent

默认值: 1

单位: int

描述: The number of members in the cluster, which scrape the same targets. If the replication factor is greater than 1, then the deduplication must be enabled at remote storage side. See https://docs.victoriametrics.com/#deduplication (default 1)

promscrape.config

应用: agent

默认值:

单位: string

描述: Optional path to Prometheus config file with 'scrape_configs' section containing targets to scrape. The path can point to local file and to http url. See https://docs.victoriametrics.com/#how-to-scrape-prometheus-exporters-such-as-node-exporter for details

promscrape.config.dryRun

应用: agent

默认值:

单位:

描述: Checks -promscrape.config file for errors and unsupported fields and then exits. Returns non-zero exit code on parsing errors and emits these errors to stderr. See also -promscrape.config.strictParse command-line flag. Pass -loggerLevel=ERROR if you don't need to see info messages in the output.

promscrape.config.strictParse

应用: agent

默认值: true

单位:

描述: Whether to deny unsupported fields in -promscrape.config . Set to false in order to silently skip unsupported fields (default true)

promscrape.configCheckInterval

应用: agent

默认值:

单位: duration

描述: Interval for checking for changes in '-promscrape.config' file. By default, the checking is disabled. Send SIGHUP signal in order to force config check for changes

promscrape.consul.waitTime

应用: agent

默认值:

单位: duration

描述: Wait time used by Consul service discovery. Default value is used if not set

promscrape.consulSDCheckInterval

应用: agent

默认值: 30s

单位: duration

描述: Interval for checking for changes in Consul. This works only if consul_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#consul_sd_configs for details (default 30s)

promscrape.consulagentSDCheckInterval

应用: agent

默认值: 30s

单位: duration

描述: Interval for checking for changes in Consul Agent. This works only if consulagent_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#consulagent_sd_configs for details (default 30s)

promscrape.digitaloceanSDCheckInterval

应用: agent

默认值: 1m0s

单位: duration

描述: Interval for checking for changes in digital ocean. This works only if digitalocean_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#digitalocean_sd_configs for details (default 1m0s)

promscrape.disableCompression

应用: agent

默认值:

单位:

描述: Whether to disable sending 'Accept-Encoding: gzip' request headers to all the scrape targets. This may reduce CPU usage on scrape targets at the cost of higher network bandwidth utilization. It is possible to set 'disable_compression: true' individually per each 'scrape_config' section in '-promscrape.config' for fine-grained control

promscrape.disableKeepAlive

应用: agent

默认值:

单位:

描述: Whether to disable HTTP keep-alive connections when scraping all the targets. This may be useful when targets has no support for HTTP keep-alive connection. It is possible to set 'disable_keepalive: true' individually per each 'scrape_config' section in '-promscrape.config' for fine-grained control. Note that disabling HTTP keep-alive may increase load on both vmagent and scrape targets

promscrape.discovery.concurrency

应用: agent

默认值: 100

单位: int

描述: The maximum number of concurrent requests to Prometheus autodiscovery API (Consul, Kubernetes, etc.) (default 100)

promscrape.discovery.concurrentWaitTime

应用: agent

默认值: 1m0s

单位: duration

描述: The maximum duration for waiting to perform API requests if more than -promscrape.discovery.concurrency requests are simultaneously performed (default 1m0s)

promscrape.dnsSDCheckInterval

应用: agent

默认值: 30s

单位: duration

描述: Interval for checking for changes in dns. This works only if dns_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#dns_sd_configs for details (default 30s)

promscrape.dockerSDCheckInterval

应用: agent

默认值: 30s

单位: duration

描述: Interval for checking for changes in docker. This works only if docker_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#docker_sd_configs for details (default 30s)

promscrape.dockerswarmSDCheckInterval

应用: agent

默认值: 30s

单位: duration

描述: Interval for checking for changes in dockerswarm. This works only if dockerswarm_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#dockerswarm_sd_configs for details (default 30s)

promscrape.dropOriginalLabels

应用: agent

默认值:

单位:

描述: Whether to drop original labels for scrape targets at /targets and /api/v1/targets pages. This may be needed for reducing memory usage when original labels for big number of scrape targets occupy big amounts of memory. Note that this reduces debuggability for improper per-target relabeling configs

promscrape.ec2SDCheckInterval

应用: agent

默认值: 1m0s

单位: duration

描述: Interval for checking for changes in ec2. This works only if ec2_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#ec2_sd_configs for details (default 1m0s)

promscrape.eurekaSDCheckInterval

应用: agent

默认值: 30s

单位: duration

描述: Interval for checking for changes in eureka. This works only if eureka_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#eureka_sd_configs for details (default 30s)

promscrape.fileSDCheckInterval

应用: agent

默认值: 1m0s

单位: duration

描述: Interval for checking for changes in 'file_sd_config'. See https://docs.victoriametrics.com/sd_configs.html#file_sd_configs for details (default 1m0s)

promscrape.gceSDCheckInterval

应用: agent

默认值: 1m0s

单位: duration

描述: Interval for checking for changes in gce. This works only if gce_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#gce_sd_configs for details (default 1m0s)

promscrape.httpSDCheckInterval

应用: agent

默认值: 1m0s

单位: duration

描述: Interval for checking for changes in http endpoint service discovery. This works only if http_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#http_sd_configs for details (default 1m0s)

promscrape.kubernetes.apiServerTimeout

应用: agent

默认值: 30m0s

单位: duration

描述: How frequently to reload the full state from Kubernetes API server (default 30m0s)

promscrape.kubernetesSDCheckInterval

应用: agent

默认值: 30s

单位: duration

描述: Interval for checking for changes in Kubernetes API server. This works only if kubernetes_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#kubernetes_sd_configs for details (default 30s)

promscrape.kumaSDCheckInterval

应用: agent

默认值: 30s

单位: duration

描述: Interval for checking for changes in kuma service discovery. This works only if kuma_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#kuma_sd_configs for details (default 30s)

promscrape.maxDroppedTargets

应用: agent

默认值: 1000

单位: int

描述: The maximum number of droppedTargets to show at /api/v1/targets page. Increase this value if your setup drops more scrape targets during relabeling and you need investigating labels for all the dropped targets. Note that the increased number of tracked dropped targets may result in increased memory usage (default 1000)

promscrape.maxResponseHeadersSize

应用: agent

默认值: 4096

单位: size

描述: The maximum size of http response headers from Prometheus scrape targetsSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 4096)

promscrape.maxScrapeSize

应用: agent

默认值: 16777216

单位: size

描述: The maximum size of scrape response in bytes to process from Prometheus targets. Bigger responses are rejectedSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 16777216)

promscrape.minResponseSizeForStreamParse

应用: agent

默认值: 1000000

单位: size

描述: The minimum target response size for automatic switching to stream parsing mode, which can reduce memory usage. See https://docs.victoriametrics.com/vmagent.html#stream-parsing-modeSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 1000000)

promscrape.noStaleMarkers

应用: agent

默认值:

单位:

描述: Whether to disable sending Prometheus stale markers for metrics when scrape target disappears. This option may reduce memory usage if stale markers aren't needed for your setup. This option also disables populating the scrape_series_added metric. See https://prometheus.io/docs/concepts/jobs_instances/#automatically-generated-labels-and-time-series

promscrape.nomad.waitTime

应用: agent

默认值:

单位: duration

描述: Wait time used by Nomad service discovery. Default value is used if not set

promscrape.nomadSDCheckInterval

应用: agent

默认值: 30s

单位: duration

描述: Interval for checking for changes in Nomad. This works only if nomad_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#nomad_sd_configs for details (default 30s)

promscrape.openstackSDCheckInterval

应用: agent

默认值: 30s

单位: duration

描述: Interval for checking for changes in openstack API server. This works only if openstack_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#openstack_sd_configs for details (default 30s)

promscrape.seriesLimitPerTarget

应用: agent

默认值:

单位: int

描述: Optional limit on the number of unique time series a single scrape target can expose. See https://docs.victoriametrics.com/vmagent.html#cardinality-limiter for more info

promscrape.streamParse

应用: agent

默认值:

单位:

描述: Whether to enable stream parsing for metrics obtained from scrape targets. This may be useful for reducing memory usage when millions of metrics are exposed per each scrape target. It is possible to set 'stream_parse: true' individually per each 'scrape_config' section in '-promscrape.config' for fine-grained control

promscrape.suppressDuplicateScrapeTargetErrors

应用: agent

默认值:

单位:

描述: Whether to suppress 'duplicate scrape target' errors; see https://docs.victoriametrics.com/vmagent.html#troubleshooting for details

promscrape.suppressScrapeErrors

应用: agent

默认值:

单位:

描述: Whether to suppress scrape errors logging. The last error for each target is always available at '/targets' page even if scrape errors logging is suppressed. See also -promscrape.suppressScrapeErrorsDelay

promscrape.suppressScrapeErrorsDelay

应用: agent

默认值:

单位: duration

描述: The delay for suppressing repeated scrape errors logging per each scrape targets. This may be used for reducing the number of log lines related to scrape errors. See also -promscrape.suppressScrapeErrors

promscrape.yandexcloudSDCheckInterval

应用: agent

默认值: 30s

单位: duration

描述: Interval for checking for changes in Yandex Cloud API. This works only if yandexcloud_sd_configs is configured in '-promscrape.config' file. See https://docs.victoriametrics.com/sd_configs.html#yandexcloud_sd_configs for details (default 30s)

remoteWrite.aws.accessKey

应用: agent

默认值:

单位: array

描述: Optional AWS AccessKey to use for the corresponding -remoteWrite.url if -remoteWrite.aws.useSigv4 is setSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.aws.ec2Endpoint

应用: agent

默认值:

单位: array

描述: Optional AWS EC2 API endpoint to use for the corresponding -remoteWrite.url if -remoteWrite.aws.useSigv4 is setSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.aws.region

应用: agent

默认值:

单位: array

描述: Optional AWS region to use for the corresponding -remoteWrite.url if -remoteWrite.aws.useSigv4 is setSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.aws.roleARN

应用: agent

默认值:

单位: array

描述: Optional AWS roleARN to use for the corresponding -remoteWrite.url if -remoteWrite.aws.useSigv4 is setSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.aws.secretKey

应用: agent

默认值:

单位: array

描述: Optional AWS SecretKey to use for the corresponding -remoteWrite.url if -remoteWrite.aws.useSigv4 is setSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.aws.service

应用: agent

默认值:

单位: array

描述: Optional AWS Service to use for the corresponding -remoteWrite.url if -remoteWrite.aws.useSigv4 is set. Defaults to "aps"Supports an array of values separated by comma or specified via multiple flags.

remoteWrite.aws.stsEndpoint

应用: agent

默认值:

单位: array

描述: Optional AWS STS API endpoint to use for the corresponding -remoteWrite.url if -remoteWrite.aws.useSigv4 is setSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.aws.useSigv4

应用: agent

默认值:

单位: array

描述: Enables SigV4 request signing for the corresponding -remoteWrite.url. It is expected that other -remoteWrite.aws.* command-line flags are set if sigv4 request signing is enabledSupports array of values separated by comma or specified via multiple flags.

remoteWrite.basicAuth.password

应用: agent

默认值:

单位: array

描述: Optional basic auth password to use for the corresponding -remoteWrite.urlSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.basicAuth.passwordFile

应用: agent

默认值:

单位: array

描述: Optional path to basic auth password to use for the corresponding -remoteWrite.url. The file is re-read every secondSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.basicAuth.username

应用: agent

默认值:

单位: array

描述: Optional basic auth username to use for the corresponding -remoteWrite.urlSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.bearerToken

应用: agent

默认值:

单位: array

描述: Optional bearer auth token to use for the corresponding -remoteWrite.urlSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.bearerTokenFile

应用: agent

默认值:

单位: array

描述: Optional path to bearer token file to use for the corresponding -remoteWrite.url. The token is re-read from the file every secondSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.flushInterval

应用: agent

默认值: 1s

单位: duration

描述: Interval for flushing the data to remote storage. This option takes effect only when less than 10K data points per second are pushed to -remoteWrite.url (default 1s)

remoteWrite.forcePromProto

应用: agent

默认值:

单位: array

描述: Whether to force Prometheus remote write protocol for sending data to the corresponding -remoteWrite.url . See https://docs.victoriametrics.com/vmagent.html#victoriametrics-remote-write-protocolSupports array of values separated by comma or specified via multiple flags.

remoteWrite.forceVMProto

应用: agent

默认值:

单位: array

描述: Whether to force VictoriaMetrics remote write protocol for sending data to the corresponding -remoteWrite.url . See https://docs.victoriametrics.com/vmagent.html#victoriametrics-remote-write-protocolSupports array of values separated by comma or specified via multiple flags.

remoteWrite.headers

应用: agent

默认值:

单位: 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.

remoteWrite.keepDanglingQueues

应用: agent

默认值:

单位:

描述: Keep persistent queues contents at -remoteWrite.tmpDataPath in case there are no matching -remoteWrite.url. Useful when -remoteWrite.url is changed temporarily and persistent queue files will be needed later on.

remoteWrite.label

应用: agent

默认值:

单位: array

描述: Optional label in the form 'name=value' to add to all the metrics before sending them to -remoteWrite.url. Pass multiple -remoteWrite.label flags in order to add multiple labels to metrics before sending them to remote storageSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.maxBlockSize

应用: agent

默认值: 8388608

单位: size

描述: The maximum block size to send to remote storage. Bigger blocks may improve performance at the cost of the increased memory usage. See also -remoteWrite.maxRowsPerBlockSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 8388608)

remoteWrite.maxDailySeries

应用: agent

默认值:

单位: int

描述: The maximum number of unique series vmagent can send to remote storage systems during the last 24 hours. Excess series are logged and dropped. This can be useful for limiting series churn rate. See https://docs.victoriametrics.com/vmagent.html#cardinality-limiter

remoteWrite.maxDiskUsagePerURL

应用: agent

默认值: 0

单位: 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 0Supports 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.

remoteWrite.maxHourlySeries

应用: agent

默认值:

单位: int

描述: The maximum number of unique series vmagent can send to remote storage systems during the last hour. Excess series are logged and dropped. This can be useful for limiting series cardinality. See https://docs.victoriametrics.com/vmagent.html#cardinality-limiter

remoteWrite.maxRowsPerBlock

应用: agent

默认值: 10000

单位: int

描述: The maximum number of samples to send in each block to remote storage. Higher number may improve performance at the cost of the increased memory usage. See also -remoteWrite.maxBlockSize (default 10000)

remoteWrite.multitenantURL

应用: agent

默认值:

单位: array

描述: Base path for multitenant remote storage URL to write data to. See https://docs.victoriametrics.com/vmagent.html#multitenancy for details. Example url: http://<vminsert>:8480 . Pass multiple -remoteWrite.multitenantURL flags in order to replicate data to multiple remote storage systems. See also -remoteWrite.urlSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.oauth2.clientID

应用: agent

默认值:

单位: array

描述: Optional OAuth2 clientID to use for the corresponding -remoteWrite.urlSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.oauth2.clientSecret

应用: agent

默认值:

单位: array

描述: Optional OAuth2 clientSecret to use for the corresponding -remoteWrite.urlSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.oauth2.clientSecretFile

应用: agent

默认值:

单位: array

描述: Optional OAuth2 clientSecretFile to use for the corresponding -remoteWrite.urlSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.oauth2.scopes

应用: agent

默认值:

单位: 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.

remoteWrite.oauth2.tokenUrl

应用: agent

默认值:

单位: array

描述: Optional OAuth2 tokenURL to use for the corresponding -remoteWrite.urlSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.proxyURL

应用: agent

默认值:

单位: array

描述: Optional proxy URL for writing data to the corresponding -remoteWrite.url. Supported proxies: http, https, socks5. Example: -remoteWrite.proxyURL=socks5://proxy:1234Supports an array of values separated by comma or specified via multiple flags.

remoteWrite.queues

应用: agent

默认值: 8

单位: 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 is 2 * numberOfAvailableCPUs (default 8)

remoteWrite.rateLimit

应用: agent

默认值: 0

单位: 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 is sent after temporary unavailability of the remote storage (default 0)Supports array of values separated by comma or specified via multiple flags.

remoteWrite.relabelConfig

应用: agent

默认值:

单位: string

描述: Optional path to file with relabeling configs, which are applied to all the metrics before sending them to -remoteWrite.url. See also -remoteWrite.urlRelabelConfig. The path can point either to local file or to http url. See https://docs.victoriametrics.com/vmagent.html#relabeling

remoteWrite.roundDigits

应用: agent

默认值: 100

单位: array

描述: Round metric values to this number of decimal digits after the point before writing them to remote storage. Examples: -remoteWrite.roundDigits=2 would round 1.236 to 1.24, while -remoteWrite.roundDigits=-1 would round 126.78 to 130. By default, digits rounding is disabled. Set it to 100 for disabling it for a particular remote storage. This option may be used for improving data compression for the stored metrics (default 100)Supports array of values separated by comma or specified via multiple flags.

remoteWrite.sendTimeout

应用: agent

默认值: 1m0s

单位: 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.

remoteWrite.shardByURL

应用: agent

默认值:

单位:

描述: Whether to shard outgoing series across all the remote storage systems enumerated via -remoteWrite.url . By default the data is replicated across all the -remoteWrite.url . See https://docs.victoriametrics.com/vmagent.html#sharding-among-remote-storages

remoteWrite.showURL

应用: agent

默认值:

单位:

描述: 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.significantFigures

应用: agent

默认值: 0

单位: array

描述: The number of significant figures to leave in metric values before writing them to remote storage. See https://en.wikipedia.org/wiki/Significant_figures . Zero value saves all the significant figures. This option may be used for improving data compression for the stored metrics. See also -remoteWrite.roundDigits (default 0)Supports array of values separated by comma or specified via multiple flags.

remoteWrite.streamAggr.config

应用: agent

默认值:

单位: array

描述: Optional path to file with stream aggregation config. See https://docs.victoriametrics.com/stream-aggregation.html . See also -remoteWrite.streamAggr.keepInput, -remoteWrite.streamAggr.dropInput and -remoteWrite.streamAggr.dedupIntervalSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.streamAggr.dedupInterval

应用: agent

默认值: 0s

单位: array

描述: Input samples are de-duplicated with this interval before being aggregated. Only the last sample per each time series per each interval is aggregated if the interval is greater than zero (default 0s)Supports array of values separated by comma or specified via multiple flags.

remoteWrite.streamAggr.dropInput

应用: agent

默认值:

单位: array

描述: Whether to drop all the input samples after the aggregation with -remoteWrite.streamAggr.config. By default, only aggregates samples are dropped, while the remaining samples are written to the corresponding -remoteWrite.url . See also -remoteWrite.streamAggr.keepInput and https://docs.victoriametrics.com/stream-aggregation.htmlSupports array of values separated by comma or specified via multiple flags.

remoteWrite.streamAggr.keepInput

应用: agent

默认值:

单位: array

描述: Whether to keep all the input samples after the aggregation with -remoteWrite.streamAggr.config. By default, only aggregates samples are dropped, while the remaining samples are written to the corresponding -remoteWrite.url . See also -remoteWrite.streamAggr.dropInput and https://docs.victoriametrics.com/stream-aggregation.htmlSupports array of values separated by comma or specified via multiple flags.

remoteWrite.tlsCAFile

应用: agent

默认值:

单位: array

描述: Optional path to TLS CA file to use for verifying connections to the corresponding -remoteWrite.url. By default, system CA is usedSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.tlsCertFile

应用: agent

默认值:

单位: array

描述: Optional path to client-side TLS certificate file to use when connecting to the corresponding -remoteWrite.urlSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.tlsInsecureSkipVerify

应用: agent

默认值:

单位: array

描述: Whether to skip tls verification when connecting to the corresponding -remoteWrite.urlSupports array of values separated by comma or specified via multiple flags.

remoteWrite.tlsKeyFile

应用: agent

默认值:

单位: array

描述: Optional path to client-side TLS certificate key to use when connecting to the corresponding -remoteWrite.urlSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.tlsServerName

应用: agent

默认值:

单位: array

描述: Optional TLS server name to use for connections to the corresponding -remoteWrite.url. By default, the server name from -remoteWrite.url is usedSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.tmpDataPath

应用: agent

默认值: "vmagent-remotewrite-data"

单位: string

描述: Path to directory where temporary data for remote write component is stored. See also -remoteWrite.maxDiskUsagePerURL (default "vmagent-remotewrite-data")

remoteWrite.url

应用: agent

默认值:

单位: array

描述: Remote storage URL to write data to. It must support either VictoriaMetrics remote write protocol or Prometheus remote_write protocol. Example url: http://<victoriametrics-host>:8428/api/v1/write . Pass multiple -remoteWrite.url options in order to replicate the collected data to multiple remote storage systems. The data can be sharded among the configured remote storage systems if -remoteWrite.shardByURL flag is set. See also -remoteWrite.multitenantURLSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.urlRelabelConfig

应用: agent

默认值:

单位: array

描述: Optional path to relabel configs for the corresponding -remoteWrite.url. See also -remoteWrite.relabelConfig. The path can point either to local file or to http url. See https://docs.victoriametrics.com/vmagent.html#relabelingSupports an array of values separated by comma or specified via multiple flags.

remoteWrite.vmProtoCompressLevel

应用: agent

默认值:

单位: int

描述: The compression level for VictoriaMetrics remote write protocol. Higher values reduce network traffic at the cost of higher CPU usage. Negative values reduce CPU usage at the cost of increased network traffic. See https://docs.victoriametrics.com/vmagent.html#victoriametrics-remote-write-protocol

disableRerouting

应用: insert

默认值: true

单位:

描述: Whether to disable re-routing when some of vmstorage nodes accept incoming data at slower speed compared to other storage nodes. Disabled re-routing limits the ingestion rate by the slowest vmstorage node. On the other side, disabled re-routing minimizes the number of active time series in the cluster during rolling restarts and during spikes in series churn rate. See also -dropSamplesOnOverload (default true)

dropSamplesOnOverload

应用: insert

默认值:

单位:

描述: Whether to drop incoming samples if the destination vmstorage node is overloaded and/or unavailable. This prioritizes cluster availability over consistency, e.g. the cluster continues accepting all the ingested samples, but some of them may be dropped if vmstorage nodes are temporarily unavailable and/or overloaded. The drop of samples happens before the replication, so it's not recommended to use this flag with -replicationFactor enabled.

maxLabelValueLen

应用: insert

默认值: 16384

单位: int

描述: The maximum length of label values in the accepted time series. Longer label values are truncated. In this case the vm_too_long_label_values_total metric at /metrics page is incremented (default 16384)

maxLabelsPerTimeseries

应用: insert

默认值: 30

单位: int

描述: The maximum number of labels accepted per time series. Superfluous labels are dropped. In this case the vm_metrics_with_dropped_labels_total metric at /metrics page is incremented (default 30)

relabelConfig

应用: insert

默认值:

单位: string

描述: Optional path to a file with relabeling rules, which are applied to all the ingested metrics. The path can point either to local file or to http url. See https://docs.victoriametrics.com/#relabeling for details. The config is reloaded on SIGHUP signal

cacheDataPath

应用: select

默认值:

单位: string

描述: Path to directory for cache files. Cache isn't saved if empty

clusternative.disableCompression

应用: select

默认值:

单位:

描述: Whether to disable compression of the data sent to vmselect via -clusternativeListenAddr. This reduces CPU usage at the cost of higher network bandwidth usage

clusternative.maxConcurrentRequests

应用: select

默认值: 8

单位: int

描述: The maximum number of concurrent vmselect requests the server can process at -clusternativeListenAddr. It shouldn't be high, since a single request usually saturates a CPU core at the underlying vmstorage nodes, and many concurrently executed requests may require high amounts of memory. See also -clusternative.maxQueueDuration (default 8)

clusternative.maxQueueDuration

应用: select

默认值: 10s

单位: duration

描述: The maximum time the incoming query to -clusternativeListenAddr waits for execution when -clusternative.maxConcurrentRequests limit is reached (default 10s)

clusternative.maxTagKeys

应用: select

默认值: 100000

单位: int

描述: The maximum number of tag keys returned per search at -clusternativeListenAddr (default 100000)

clusternative.maxTagValueSuffixesPerSearch

应用: select

默认值: 100000

单位: int

描述: The maximum number of tag value suffixes returned from /metrics/find at -clusternativeListenAddr (default 100000)

clusternative.maxTagValues

应用: select

默认值: 100000

单位: int

描述: The maximum number of tag values returned per search at -clusternativeListenAddr (default 100000)

search.cacheTimestampOffset

应用: select

默认值: 5m0s

单位: duration

描述: The maximum duration since the current time for response data, which is always queried from the original raw data, without using the response cache. Increase this value if you see gaps in responses due to time synchronization issues between VictoriaMetrics and data sources (default 5m0s)

search.denyPartialResponse

应用: select

默认值:

单位:

描述: Whether to deny partial responses if a part of -storageNode instances fail to perform queries; this trades availability over consistency; see also -search.maxQueryDuration

search.disableCache

应用: select

默认值:

单位:

描述: Whether to disable response caching. This may be useful during data backfilling

search.graphiteMaxPointsPerSeries

应用: select

默认值: 1000000

单位: int

描述: The maximum number of points per series Graphite render API can return (default 1000000)

search.graphiteStorageStep

应用: select

默认值: 10s

单位: duration

描述: The interval between datapoints stored in the database. It is used at Graphite Render API handler for normalizing the interval between datapoints in case it isn't normalized. It can be overridden by sending 'storage_step' query arg to /render API or by sending the desired interval via 'Storage-Step' http header during querying /render API (default 10s)

search.latencyOffset

应用: select

默认值: 30s

单位: duration

描述: The time when data points become visible in query results after the collection. It can be overridden on per-query basis via latency_offset arg. Too small value can result in incomplete last points for query results (default 30s)

search.logQueryMemoryUsage

应用: select

默认值: 0

单位: size

描述: Log queries, which require more memory than specified by this flag. This may help detecting and optimizing heavy queries. Query logging is disabled by default. See also -search.logSlowQueryDuration and -search.maxMemoryPerQuerySupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 0)

search.logSlowQueryDuration

应用: select

默认值: 5s

单位: duration

描述: Log queries with execution time exceeding this value. Zero disables slow query logging. See also -search.logQueryMemoryUsage (default 5s)

search.maxExportDuration

应用: select

默认值: 720h0m0s

单位: duration

描述: The maximum duration for /api/v1/export call (default 720h0m0s)

search.maxExportSeries

应用: select

默认值: 10000000

单位: int

描述: The maximum number of time series, which can be returned from /api/v1/export* APIs. This option allows limiting memory usage (default 10000000)

search.maxFederateSeries

应用: select

默认值: 1000000

单位: int

描述: The maximum number of time series, which can be returned from /federate. This option allows limiting memory usage (default 1000000)

search.maxGraphiteSeries

应用: select

默认值: 300000

单位: int

描述: The maximum number of time series, which can be scanned during queries to Graphite Render API. See https://docs.victoriametrics.com/#graphite-render-api-usage (default 300000)

search.maxGraphiteTagKeys

应用: select

默认值: 100000

单位: int

描述: The maximum number of tag keys returned from Graphite API, which returns tags. See https://docs.victoriametrics.com/#graphite-tags-api-usage (default 100000)

search.maxGraphiteTagValues

应用: select

默认值: 100000

单位: int

描述: The maximum number of tag values returned from Graphite API, which returns tag values. See https://docs.victoriametrics.com/#graphite-tags-api-usage (default 100000)

search.maxLookback

应用: select

默认值:

单位: duration

描述: Synonym to -search.lookback-delta from Prometheus. The value is dynamically detected from interval between time series datapoints if not set. It can be overridden on per-query basis via max_lookback arg. See also '-search.maxStalenessInterval' flag, which has the same meaning due to historical reasons

search.maxMemoryPerQuery

应用: select

默认值: 0

单位: size

描述: The maximum amounts of memory a single query may consume. Queries requiring more memory are rejected. The total memory limit for concurrently executed queries can be estimated as -search.maxMemoryPerQuery multiplied by -search.maxConcurrentRequests . See also -search.logQueryMemoryUsageSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 0)

search.maxPointsPerTimeseries

应用: select

默认值: 30000

单位: int

描述: The maximum points per a single timeseries returned from /api/v1/query_range. This option doesn't limit the number of scanned raw samples in the database. The main purpose of this option is to limit the number of per-series points returned to graphing UI such as VMUI or Grafana. There is no sense in setting this limit to values bigger than the horizontal resolution of the graph (default 30000)

search.maxPointsSubqueryPerTimeseries

应用: select

默认值: 100000

单位: int

描述: The maximum number of points per series, which can be generated by subquery. See https://valyala.medium.com/prometheus-subqueries-in-victoriametrics-9b1492b720b3 (default 100000)

search.maxQueryDuration

应用: select

默认值: 30s

单位: duration

描述: The maximum duration for query execution (default 30s)

search.maxQueryLen

应用: select

默认值: 16384

单位: size

描述: The maximum search query length in bytesSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 16384)

search.maxSamplesPerQuery

应用: select

默认值: 1000000000

单位: int

描述: The maximum number of raw samples a single query can process across all time series. This protects from heavy queries, which select unexpectedly high number of raw samples. See also -search.maxSamplesPerSeries (default 1000000000)

search.maxSamplesPerSeries

应用: select

默认值: 30000000

单位: int

描述: The maximum number of raw samples a single query can scan per each time series. See also -search.maxSamplesPerQuery (default 30000000)

search.maxSeries

应用: select

默认值: 30000

单位: int

描述: The maximum number of time series, which can be returned from /api/v1/series. This option allows limiting memory usage (default 30000)

search.maxSeriesPerAggrFunc

应用: select

默认值: 1000000

单位: int

描述: The maximum number of time series an aggregate MetricsQL function can generate (default 1000000)

search.maxStalenessInterval

应用: select

默认值:

单位: duration

描述: The maximum interval for staleness calculations. By default, it is automatically calculated from the median interval between samples. This flag could be useful for tuning Prometheus data model closer to Influx-style data model. See https://prometheus.io/docs/prometheus/latest/querying/basics/#staleness for details. See also '-search.setLookbackToStep' flag

search.maxStatusRequestDuration

应用: select

默认值: 5m0s

单位: duration

描述: The maximum duration for /api/v1/status/* requests (default 5m0s)

search.maxStepForPointsAdjustment

应用: select

默认值: 1m0s

单位: duration

描述: The maximum step when /api/v1/query_range handler adjusts points with timestamps closer than -search.latencyOffset to the current time. The adjustment is needed because such points may contain incomplete data (default 1m0s)

search.maxTSDBStatusSeries

应用: select

默认值: 10000000

单位: int

描述: The maximum number of time series, which can be processed during the call to /api/v1/status/tsdb. This option allows limiting memory usage (default 10000000)

search.maxWorkersPerQuery

应用: select

默认值: 4

单位: int

描述: The maximum number of CPU cores a single query can use. The default value should work good for most cases. The flag can be set to lower values for improving performance of big number of concurrently executed queries. The flag can be set to bigger values for improving performance of heavy queries, which scan big number of time series (>10K) and/or big number of samples (>100M). There is no sense in setting this flag to values bigger than the number of CPU cores available on the system (default 4)

search.minStalenessInterval

应用: select

默认值:

单位: duration

描述: The minimum interval for staleness calculations. This flag could be useful for removing gaps on graphs generated from time series with irregular intervals between samples. See also '-search.maxStalenessInterval'

search.noStaleMarkers

应用: select

默认值:

单位:

描述: Set this flag to true if the database doesn't contain Prometheus stale markers, so there is no need in spending additional CPU time on its handling. Staleness markers may exist only in data obtained from Prometheus scrape targets

search.queryStats.lastQueriesCount

应用: select

默认值: 20000

单位: int

描述: Query stats for /api/v1/status/top_queries is tracked on this number of last queries. Zero value disables query stats tracking (default 20000)

search.queryStats.minQueryDuration

应用: select

默认值: 1ms

单位: duration

描述: The minimum duration for queries to track in query stats at /api/v1/status/top_queries. Queries with lower duration are ignored in query stats (default 1ms)

search.resetCacheAuthKey

应用: select

默认值:

单位: string

描述: Optional authKey for resetting rollup cache via /internal/resetRollupResultCache call

search.setLookbackToStep

应用: select

默认值:

单位:

描述: Whether to fix lookback interval to 'step' query arg value. If set to true, the query model becomes closer to InfluxDB data model. If set to true, then -search.maxLookback and -search.maxStalenessInterval are ignored

search.skipSlowReplicas

应用: select

默认值:

单位:

描述: Whether to skip -replicationFactor - 1 slowest vmstorage nodes during querying. Enabling this setting may improve query speed, but it could also lead to incomplete results if some queried data has less than -replicationFactor copies at vmstorage nodes. Consider enabling this setting only if all the queried data contains -replicationFactor copies in the cluster

search.treatDotsAsIsInRegexps

应用: select

默认值:

单位:

描述: Whether to treat dots as is in regexp label filters used in queries. For example, foo{bar=~"a.b.c"} will be automatically converted to foo{bar=~"a\\.b\\.c"}, i.e. all the dots in regexp filters will be automatically escaped in order to match only dot char instead of matching any char. Dots in ".+", ".*" and ".{n}" regexps aren't escaped. This option is DEPRECATED in favor of {**__graphite*__*="a.*.c"} syntax for selecting metrics matching the given Graphite metrics filter

selectNode

应用: select

默认值:

单位: array

描述: Comma-separated addresses of vmselect nodes; usage: -selectNode=vmselect-host1,...,vmselect-hostNSupports an array of values separated by comma or specified via multiple flags.

vmalert.proxyURL

应用: select

默认值:

单位: string

描述: Optional URL for proxying requests to vmalert. For example, if -vmalert.proxyURL=http://vmalert:8880 , then alerting API requests such as /api/v1/rules from Grafana will be proxied to http://vmalert:8880/api/v1/rules

vmui.customDashboardsPath

应用: select

默认值:

单位: string

描述: Optional path to vmui dashboards. See https://github.com/VictoriaMetrics/VictoriaMetrics/tree/master/app/vmui/packages/vmui/public/dashboards

bigMergeConcurrency

应用: storage

默认值:

单位: int

描述: Deprecated: this flag does nothing. Please use -smallMergeConcurrency for controlling the concurrency of background merges. See https://docs.victoriametrics.com/#storage

denyQueriesOutsideRetention

应用: storage

默认值:

单位:

描述: Whether to deny queries outside of the configured -retentionPeriod. When set, then /api/v1/query_range would return '503 Service Unavailable' error for queries with 'from' value outside -retentionPeriod. This may be useful when multiple data sources with distinct retentions are hidden behind query-tee

finalMergeDelay

应用: storage

默认值:

单位: duration

描述: The delay before starting final merge for per-month partition after no new data is ingested into it. Final merge may require additional disk IO and CPU resources. Final merge may increase query speed and reduce disk space usage in some cases. Zero value disables final merge

forceFlushAuthKey

应用: storage

默认值:

单位: string

描述: authKey, which must be passed in query string to /internal/force_flush pages

forceMergeAuthKey

应用: storage

默认值:

单位: string

描述: authKey, which must be passed in query string to /internal/force_merge pages

inmemoryDataFlushInterval

应用: storage

默认值: 5s

单位: duration

描述: The interval for guaranteed saving of in-memory data to disk. The saved data survives unclean shutdowns such as OOM crash, hardware reset, SIGKILL, etc. Bigger intervals may help increase the lifetime of flash storage with limited write cycles (e.g. Raspberry PI). Smaller intervals increase disk IO load. Minimum supported value is 1s (default 5s)

logNewSeries

应用: storage

默认值:

单位:

描述: Whether to log new series. This option is for debug purposes only. It can lead to performance issues when big number of new series are ingested into VictoriaMetrics

precisionBits

应用: storage

默认值: 64

单位: int

描述: The number of precision(精度) bits to store per each value. Lower precision bits improves data compression at the cost of precision loss (default 64)

retentionPeriod

应用: storage

默认值: 1

单位: value

描述: Data with timestamps outside the retentionPeriod is automatically deleted. The minimum retentionPeriod is 24h or 1d. See also -retentionFilterThe following optional suffixes are supported: h (hour), d (day), w (week), y (year). If suffix isn't set, then the duration is counted in months (default 1)

retentionTimezoneOffset

应用: storage

默认值:

单位: duration

描述: The offset for performing indexdb rotation. If set to 0, then the indexdb rotation is performed at 4am UTC time per each -retentionPeriod. If set to 2h, then the indexdb rotation is performed at 4am EET time (the timezone with +2h offset)

search.maxTagKeys

应用: storage

默认值: 100000

单位: int

描述: The maximum number of tag keys returned per search (default 100000)

search.maxTagValues

应用: storage

默认值: 100000

单位: int

描述: The maximum number of tag values returned per search (default 100000)

smallMergeConcurrency

应用: storage

默认值:

单位: int

描述: The maximum number of workers for background merges. See https://docs.victoriametrics.com/#storage . It isn't recommended tuning this flag in general case, since this may lead to uncontrolled increase in the number of parts and increased CPU usage during queries

snapshotAuthKey

应用: storage

默认值:

单位: string

描述: authKey, which must be passed in query string to /snapshot* pages

snapshotCreateTimeout

应用: storage

默认值:

单位: duration

描述: The timeout for creating new snapshot. If set, make sure that timeout is lower than backup period

snapshotsMaxAge

应用: storage

默认值: 0

单位: value

描述: Automatically delete snapshots older than -snapshotsMaxAge if it is set to non-zero duration. Make sure that backup process has enough time to finish the backup before the corresponding snapshot is automatically deletedThe following optional suffixes are supported: h (hour), d (day), w (week), y (year). If suffix isn't set, then the duration is counted in months (default 0)

storage.cacheSizeIndexDBDataBlocks

应用: storage

默认值: 0

单位: size

描述: Overrides max size for indexdb/dataBlocks cache. See https://docs.victoriametrics.com/Single-server-VictoriaMetrics.html#cache-tuningSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 0)

storage.cacheSizeIndexDBIndexBlocks

应用: storage

默认值: 0

单位: size

描述: Overrides max size for indexdb/indexBlocks cache. See https://docs.victoriametrics.com/Single-server-VictoriaMetrics.html#cache-tuningSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 0)

storage.cacheSizeIndexDBTagFilters

应用: storage

默认值: 0

单位: size

描述: Overrides max size for indexdb/tagFiltersToMetricIDs cache. See https://docs.victoriametrics.com/Single-server-VictoriaMetrics.html#cache-tuningSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 0)

storage.cacheSizeStorageTSID

应用: storage

默认值: 0

单位: size

描述: Overrides max size for storage/tsid cache. See https://docs.victoriametrics.com/Single-server-VictoriaMetrics.html#cache-tuningSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 0)

storage.maxDailySeries

应用: storage

默认值:

单位: int

描述: The maximum number of unique series can be added to the storage during the last 24 hours. Excess series are logged and dropped. This can be useful for limiting series churn rate. See https://docs.victoriametrics.com/#cardinality-limiter . See also -storage.maxHourlySeries

storage.maxHourlySeries

应用: storage

默认值:

单位: int

描述: The maximum number of unique series can be added to the storage during the last hour. Excess series are logged and dropped. This can be useful for limiting series cardinality. See https://docs.victoriametrics.com/#cardinality-limiter . See also -storage.maxDailySeries

storage.minFreeDiskSpaceBytes

应用: storage

默认值: 10000000

单位: size

描述: The minimum free disk space at -storageDataPath after which the storage stops accepting new dataSupports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 10000000)

storageDataPath

应用: storage

默认值: "vmstorage-data"

单位: string

描述: Path to storage data (default "vmstorage-data")

vminsertAddr

应用: storage

默认值: ":8400"

单位: string

描述: TCP address to accept connections from vminsert services (default ":8400")

vmselectAddr

应用: storage

默认值: ":8401"

单位: string

描述: TCP address to accept connections from vmselect services (default ":8401")

附件