版本: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)
- 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
- 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)
- 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")