InfluxDB 配置选项

通过使用 influxd 配置标志、设置环境变量或在配置文件中定义配置选项来自定义您的 InfluxDB 配置。

查看您的运行时服务器配置
配置优先级
InfluxDB 配置文件
配置选项

查看您的运行时服务器配置

使用 influx CLI 或 InfluxDB API 获取您的 InfluxDB 实例的运行时服务器配置。

服务器配置命令需要操作员令牌。

使用 CLI 查看服务器配置

使用 influx server-config 命令获取您的运行时服务器配置。

influx server-config

使用 API 查看服务器配置

使用 InfluxDB API 的 /api/v2/config 端点获取您的运行时服务器配置。

GET https://127.0.0.1:8086/api/v2/config

配置优先级

InfluxDB 使用以下优先级尊重配置设置

influxd 标志
环境变量
配置文件设置

InfluxDB 配置文件

当 influxd 启动时，它会在当前工作目录中查找名为 config.* 的文件。文件扩展名取决于配置文件的语法。InfluxDB 配置文件支持以下语法

YAML (.yaml, .yml)
TOML (.toml)
JSON (.json)

要自定义配置文件的目录路径，请将 INFLUXD_CONFIG_PATH 环境变量设置为您的自定义路径。

export INFLUXD_CONFIG_PATH=/path/to/custom/config/directory

在启动时，influxd 将在 INFLUXD_CONFIG_PATH 目录中查找 config.*。

示例配置文件

YAML TOML JSON

query-concurrency: 20
query-queue-size: 15
secret-store: vault
session-length: 120
tls-cert: /path/to/influxdb.crt
tls-key: /path/to/influxdb.key

query-concurrency = 20
query-queue-size = 15
secret-store = "vault"
session-length = 120
tls-cert = "/path/to/influxdb.crt"
tls-key = "/path/to/influxdb.key"

{
  "query-concurrency": 20,
  "query-queue-size": 15,
  "secret-store": "vault",
  "session-length": 120,
  "tls-cert": "/path/to/influxdb.crt",
  "tls-key": "/path/to/influxdb.key"
}

配置文件中只需要定义非默认设置。

配置选项

要配置 InfluxDB，在启动 influxd 服务时使用以下配置选项

assets-path
bolt-path
e2e-testing
engine-path
feature-flags
flux-log-enabled
hardening-enabled
http-bind-address
http-idle-timeout
http-read-header-timeout
http-read-timeout
http-write-timeout
influxql-max-select-buckets
influxql-max-select-point
influxql-max-select-series
instance-id
log-level
metrics-disabled
nats-max-payload-bytes - (已弃用)
nats-port - (已弃用)
no-tasks
pprof-disabled
query-concurrency
query-initial-memory-bytes
query-max-memory-bytes
query-memory-bytes
query-queue-size
reporting-disabled
secret-store
session-length
session-renew-disabled
sqlite-path
storage-cache-max-memory-size
storage-cache-snapshot-memory-size
storage-cache-snapshot-write-cold-duration
storage-compact-full-write-cold-duration
storage-compact-throughput-burst
storage-max-concurrent-compactions
storage-max-index-log-file-size
storage-no-validate-field-size
storage-retention-check-interval
storage-series-file-max-concurrent-snapshot-compactions
storage-series-id-set-cache-size
storage-shard-precreator-advance-period
storage-shard-precreator-check-interval
storage-tsm-use-madv-willneed
storage-validate-keys
storage-wal-fsync-delay
storage-wal-max-concurrent-writes
storage-wal-max-write-delay
storage-write-timeout
store
strong-passwords
testing-always-allow-setup
tls-cert
tls-key
tls-min-version
tls-strict-ciphers
tracing-type
ui-disabled
vault-addr
vault-cacert
vault-capath
vault-client-cert
vault-client-key
vault-client-timeout
vault-max-retries
vault-skip-verify
vault-tls-server-name
vault-token

assets-path

通过从指定的目录提供资源来覆盖默认的 InfluxDB 用户界面（UI）资源。 通常仅用于 InfluxData 内部。

influxd 标志	环境变量	配置键
`--assets-path`	`INFLUXD_ASSETS_PATH`	`assets-path`

influxd 标志

influxd --assets-path=/path/to/custom/assets-dir

环境变量

export INFLUXD_ASSETS_PATH=/path/to/custom/assets-dir

配置文件

YAML TOML JSON

assets-path: /path/to/custom/assets-dir

assets-path = "/path/to/custom/assets-dir"

{
  "assets-path": "/path/to/custom/assets-dir"
}

bolt-path

到 BoltDB 数据库的路径。BoltDB 是用 Go 编写的键值存储。InfluxDB 使用 BoltDB 存储数据，包括组织和个人信息、UI 数据、REST 资源和其他键值数据。

默认： ~/.influxdbv2/influxd.bolt

influxd 标志	环境变量	配置键
`--bolt-path`	`INFLUXD_BOLT_PATH`	`bolt-path`

influxd 标志

influxd --bolt-path=~/.influxdbv2/influxd.bolt

环境变量

export INFLUXD_BOLT_PATH=~/.influxdbv2/influxd.bolt

配置文件

YAML TOML JSON

bolt-path: ~/.influxdbv2/influxd.bolt

bolt-path = "~/.influxdbv2/influxd.bolt"

{
  "bolt-path": "~/.influxdbv2/influxd.bolt"
}

e2e-testing

向 InfluxDB HTTP API 添加 /debug/flush 端点以清除存储。InfluxData 在端到端测试中使用此端点。

influxd 标志	环境变量	配置键
`--e2e-testing`	`INFLUXD_E2E_TESTING`	`e2e-testing`

influxd 标志

influxd --e2e-testing

环境变量

export INFLUXD_E2E_TESTING=true

配置文件

YAML TOML JSON

e2e-testing: true

e2e-testing = true

{
  "e2e-testing": true
}

engine-path

InfluxDB 存储所有时间结构合并树 (TSM) 数据的磁盘上持久存储引擎文件的路径。

默认： ~/.influxdbv2/engine

influxd 标志	环境变量	配置键
`--engine-path`	`INFLUXD_ENGINE_PATH`	`engine-path`

influxd 标志

influxd --engine-path=~/.influxdbv2/engine

环境变量

export INFLUXD_ENGINE_PATH=~/.influxdbv2/engine

配置文件

YAML TOML JSON

engine-path: ~/.influxdbv2/engine

engine-path = "~/.influxdbv2/engine"

{
  "engine-path": "~/.influxdbv2/engine"
}

feature-flags

启用、禁用或覆盖功能标志的默认值。

功能标志用于开发和测试实验性功能，仅限内部使用。

influxd 标志	环境变量	配置键
`--feature-flags`	`INFLUXD_FEATURE_FLAGS`	`feature-flags`

influxd 标志

influxd --feature-flags flag1=value2,flag2=value2

环境变量

export INFLUXD_FEATURE_FLAGS="{\"flag1\":\value1\",\"flag2\":\"value2\"}"

配置文件

YAML TOML JSON

feature-flags:
  flag1: "value1"
  flag2: "value2"

[feature-flags]
  flag1 = "value1"
  glag2 = "value2"

{
  "feature-flags": {
    "flag1": "value1",
    "flag2": "value2"
  }
}

flux-log-enabled

包括显示 Flux 查询详细日志的选项，包括以下日志字段

compiler_type：用于处理查询的编译器（始终是 Flux）。
response_size：响应大小，以字节为单位。
query：查询的文本表示。
err：处理查询时遇到的错误。
stat_total_duration：处理查询的总持续时间。
stat_compile_duration：编译查询的持续时间。
stat_execute_duration：执行查询的持续时间。
stat_max_allocated：处理查询时分配的最大内存量，以字节为单位。
stat_total_allocated：处理查询时分配的总内存量，以字节为单位。这包括释放后再次使用的内存。

默认： false

influxd 标志	环境变量	配置键
`--flux-log-enabled`	`INFLUXD_FLUX_LOG_ENABLED`	`flux-log-enabled`

influxd 标志

influxd --flux-log-enabled

环境变量

export INFLUXD_FLUX_LOG_ENABLED=true

配置文件

YAML TOML JSON

flux-log-enabled: true

flux-log-enabled = "true"

{
  "flux-log-enabled": "true"
}

hardening-enabled

在 InfluxDB 中启用附加安全功能。 默认： false

influxd 标志	环境变量	配置键
`--hardening-enabled`	`INFLUXD_HARDENING_ENABLED`	`hardening-enabled`

influxd 标志

influxd --hardening-enabled

环境变量

export INFLUXD_HARDENING_ENABLED=true

配置文件

YAML TOML JSON

hardening-enabled: true

hardening-enabled = true

{
  "hardening-enabled": true
}

http-bind-address

绑定地址用于 InfluxDB HTTP API。自定义 InfluxDB API 和 UI 的 URL 和端口。

默认： :8086

influxd 标志	环境变量	配置键
`--http-bind-address`	`INFLUXD_HTTP_BIND_ADDRESS`	`http-bind-address`

influxd 标志

influxd --http-bind-address=:8086

环境变量

export INFLUXD_HTTP_BIND_ADDRESS=:8086

配置文件

YAML TOML JSON

http-bind-address: ":8086"

http-bind-address = ":8086"

{
  "http-bind-address": ":8086"
}

http-idle-timeout

服务器在等待新请求时保持已建立的连接的最大持续时间。设置为 0 以无超时。

默认： 3m0s

influxd 标志	环境变量	配置键
`--http-idle-timeout`	`INFLUXD_HTTP_IDLE_TIMEOUT`	`http-idle-timeout`

influxd 标志

influxd --http-idle-timeout=3m0s

环境变量

export INFLUXD_HTTP_IDLE_TIMEOUT=3m0s

配置文件

YAML TOML JSON

http-idle-timeout: 3m0s

http-idle-timeout = "3m0s"

{
  "http-idle-timeout": "3m0s"
}

http-read-header-timeout

服务器尝试读取新请求 HTTP 标头的最大持续时间。设置为 0 以无超时。

默认： 10s

influxd 标志	环境变量	配置键
`--http-read-header-timeout`	`INFLUXD_HTTP_READ_HEADER_TIMEOUT`	`http-read-header-timeout`

influxd 标志

influxd --http-read-header-timeout=10s

环境变量

export INFLUXD_HTTP_READ_HEADER_TIMEOUT=10s

配置文件

YAML TOML JSON

http-read-header-timeout: 10s

http-read-header-timeout = "10s"

{
  "http-read-header-timeout": "10s"
}

http-read-timeout

服务器尝试读取新请求全部内容的最大持续时间。设置为 0 以无超时。

默认： 0

设置特定于您工作负载的超时

尽管默认没有设置 http-read-timeout，但我们 强烈建议 为您的工作负载设置特定的超时。HTTP 超时可防止大量打开的连接可能损害性能。

influxd 标志	环境变量	配置键
`--http-read-timeout`	`INFLUXD_HTTP_READ_TIMEOUT`	`http-read-timeout`

influxd 标志

influxd --http-read-timeout=10s

环境变量

export INFLUXD_HTTP_READ_TIMEOUT=10s

配置文件

YAML TOML JSON

http-read-timeout: 10s

http-read-timeout = "10s"

{
  "http-read-timeout": "10s"
}

http-write-timeout

在超时写入响应之前等待的最大持续时间。它不允许处理器根据每个请求决定持续时间。

在读取新请求的头部时重置超时。

设置为 0 以无超时。

默认： 0

设置特定于您工作负载的超时

尽管默认没有设置 http-write-timeout，但我们 强烈建议 为您的工作负载设置特定的超时。HTTP 超时可防止大量打开的连接可能损害性能。

influxd 标志	环境变量	配置键
`--http-write-timeout`	`INFLUXD_HTTP_WRITE_TIMEOUT`	`http-write-timeout`

influxd 标志

influxd --http-write-timeout=10s

环境变量

export INFLUXD_HTTP_WRITE_TIMEOUT=10s

配置文件

YAML TOML JSON

http-write-timeout: 10s

http-write-timeout = "10s"

{
  "http-write-timeout": "10s"
}

influxql-max-select-buckets

SELECT 语句可以创建的最大分组时间桶数。0 允许无限数量的桶。

默认： 0

influxd 标志	环境变量	配置键
`--influxql-max-select-buckets`	`INFLUXD_INFLUXQL_MAX_SELECT_BUCKETS`	`influxql-max-select-buckets`

influxd 标志

influxd --influxql-max-select-buckets=0

环境变量

export INFLUXD_INFLUXQL_MAX_SELECT_BUCKETS=0

配置文件

YAML TOML JSON

influxql-max-select-buckets: 0

influxql-max-select-buckets = 0

{
  "influxql-max-select-buckets": 0
}

influxql-max-select-point

SELECT 语句可以处理的最大点数。0 允许无限数量的点。InfluxDB 每秒检查点数（因此超出最大值的查询不会立即终止）。

默认： 0

influxd 标志	环境变量	配置键
`--influxql-max-select-point`	`INFLUXD_INFLUXQL_MAX_SELECT_POINT`	`influxql-max-select-point`

influxd 标志

influxd --influxql-max-select-point=0

环境变量

export INFLUXD_INFLUXQL_MAX_SELECT_POINT=0

配置文件

YAML TOML JSON

influxql-max-select-point: 0

influxql-max-select-point = 0

{
  "influxql-max-select-point": 0
}

influxql-max-select-series

SELECT 语句可以返回的最大系列数。0 允许无限数量的系列。

默认： 0

influxd 标志	环境变量	配置键
`--influxql-max-select-series`	`INFLUXD_INFLUXQL_MAX_SELECT_SERIES`	`influxql-max-select-series`

influxd 标志

influxd --influxql-max-select-series=0

环境变量

export INFLUXD_INFLUXQL_MAX_SELECT_SERIES=0

配置文件

YAML TOML JSON

influxql-max-select-series: 0

influxql-max-select-series = 0

{
  "influxql-max-select-series": 0
}

instance-id

在复制过程中识别边缘节点，如果两个边缘节点写入相同的 测量值，标签集，则防止冲突。

influxd 标志	环境变量	配置键
`--instance-id`	`INFLUXD_INSTANCE_ID`	`instance-id`

influxd 标志

influxd --instance-id=:8086

环境变量

export INFLUXD_INSTANCE_ID=:8086

配置文件

YAML TOML JSON

instance-id: ":8086"

instance-id = ":8086"

{
  "instance-id": ":8086"
}

log-level

日志输出级别。InfluxDB 会输出指定级别及以上严重性的日志条目。

选项： debug，info，error
默认： info

influxd 标志	环境变量	配置键
`--log-level`	`INFLUXD_LOG_LEVEL`	`log-level`

influxd 标志

influxd --log-level=info

环境变量

export INFLUXD_LOG_LEVEL=info

配置文件

YAML TOML JSON

log-level: info

log-level = "info"

{
  "log-level": "info"
}

metrics-disabled

禁用暴露内部 InfluxDB 指标的 HTTP /metrics 端点。

默认： false

influxd 标志	环境变量	配置键
`--metrics-disabled`	`INFLUXD_METRICS_DISABLED`	`metrics-disabled`

influxd 标志

influxd --metrics-disabled

环境变量

export INFLUXD_METRICS_DISABLED=true

配置文件

YAML TOML JSON

metrics-disabled: true

metrics-disabled = true

{
  "metrics-disabled": true
}

nats-max-payload-bytes

nats-max-payload-bytes 在 InfluxDB 2.2 中已被弃用，并且不再有任何影响。

NATS 消息有效负载中允许的最大字节数。

默认： 1048576

influxd 标志	环境变量	配置键
`--nats-max-payload-bytes`	`INFLUXD_NATS_MAX_PAYLOAD_BYTES`	`nats-max-payload-bytes`

influxd 标志

influxd --nats-max-payload-bytes=1048576

环境变量

export INFLUXD_NATS_MAX_PAYLOAD_BYTES=1048576

配置文件

YAML TOML JSON

nats-max-payload-bytes: 1048576

nats-max-payload-bytes = 1048576

{
  "nats-max-payload-bytes": 1048576
}

nats-port

nats-port 在 InfluxDB 2.2 中已被弃用，并且不再有任何影响。

NATS 流服务器端口。使用 -1 选择一个随机端口。

默认： -1

influxd 标志	环境变量	配置键
`--nats-port`	`INFLUXD_NATS_PORT`	`nats-port`

influxd 标志

influxd --nats-port=-1

环境变量

export INFLUXD_NATS_PORT=-1

配置文件

YAML TOML JSON

nats-port: -1

nats-port = -1

{
  "nats-port": -1
}

no-tasks

禁用任务调度器。如果存在问题的任务阻止 InfluxDB 启动，则使用此选项启动 InfluxDB 而不进行调度或执行任务。

默认： false

influxd 标志	环境变量	配置键
`--no-tasks`	`INFLUXD_NO_TASKS`	`no-tasks`

influxd 标志

influxd --no-tasks

环境变量

export INFLUXD_NO_TASKS=true

配置文件

YAML TOML JSON

no-tasks: true

no-tasks = true

{
  "no-tasks": true
}

pprof-disabled

禁用 /debug/pprof HTTP 端点。此端点提供运行时分析数据，在调试时可能很有用。

默认： false

influxd 标志	环境变量	配置键
`--pprof-disabled`	`INFLUXD_PPROF_DISABLED`	`pprof-disabled`

influxd 标志

influxd --pprof-disabled

环境变量

export INFLUXD_PPROF_DISABLED=true

配置文件

YAML TOML JSON

pprof-disabled: true

pprof-disabled = true

{
  "pprof-disabled": true
}

query-concurrency

允许并发执行的查询数。将值设置为 0 允许无限数量的并发查询。

默认： 0

influxd 标志	环境变量	配置键
`--query-concurrency`	`INFLUXD_QUERY_CONCURRENCY`	`query-concurrency`

influxd 标志

influxd --query-concurrency=10

环境变量

export INFLUXD_QUERY_CONCURRENCY=10

配置文件

YAML TOML JSON

query-concurrency: 10

query-concurrency = 10

{
  "query-concurrency": 10
}

query-initial-memory-bytes

查询分配的初始内存字节数。

默认： 与 query-memory-bytes 相等

influxd 标志	环境变量	配置键
`--query-initial-memory-bytes`	`INFLUXD_QUERY_INITIAL_MEMORY_BYTES`	`query-initial-memory-bytes`

influxd 标志

influxd --query-initial-memory-bytes=10485760

环境变量

export INFLUXD_QUERY_INITIAL_MEMORY_BYTES=10485760

配置文件

YAML TOML JSON

query-initial-memory-bytes: 10485760

query-initial-memory-bytes = 10485760

{
  "query-initial-memory-bytes": 10485760
}

query-max-memory-bytes

查询允许的最大总内存字节数。

默认： 与 query-concurrency × query-memory-bytes 相等

influxd 标志	环境变量	配置键
`--query-max-memory-bytes`	`INFLUXD_QUERY_MAX_MEMORY_BYTES`	`query-max-memory-bytes`

influxd 标志

influxd --query-max-memory-bytes=104857600

环境变量

export INFLUXD_QUERY_MAX_MEMORY_BYTES=104857600

配置文件

YAML TOML JSON

query-max-memory-bytes: 104857600

query-max-memory-bytes = 104857600

{
  "query-max-memory-bytes": 104857600
}

query-memory-bytes

单个查询允许的最大内存字节数。

默认： 无限制

必须大于或等于 query-initial-memory-bytes。

influxd 标志	环境变量	配置键
`--query-memory-bytes`	`INFLUXD_QUERY_MEMORY_BYTES`	`query-memory-bytes`

influxd 标志

influxd --query-memory-bytes=10485760

环境变量

export INFLUXD_QUERY_MEMORY_BYTES=10485760

配置文件

YAML TOML JSON

query-memory-bytes: 10485760

query-memory-bytes = 10485760

{
  "query-memory-bytes": 10485760
}

query-queue-size

执行队列中允许的最大查询数。当队列达到限制时，新的查询将被拒绝。将值设置为 0 允许队列中无限数量的查询。

默认： 0

influxd 标志	环境变量	配置键
`--query-queue-size`	`INFLUXD_QUERY_QUEUE_SIZE`	`query-queue-size`

influxd 标志

influxd --query-queue-size=10

环境变量

export INFLUXD_QUERY_QUEUE_SIZE=10

配置文件

YAML TOML JSON

query-queue-size: 10

query-queue-size = 10

{
  "query-queue-size": 10
}

reporting-disabled

禁用向 InfluxData 发送遥测数据。InfluxData 遥测页面提供了有关收集的数据和使用方式的详细信息。

默认： false

influxd 标志	环境变量	配置键
`--reporting-disabled`	`INFLUXD_REPORTING_DISABLED`	`reporting-disabled`

influxd 标志

influxd --reporting-disabled

环境变量

export INFLUXD_REPORTING_DISABLED=true

配置文件

YAML TOML JSON

reporting-disabled: true

reporting-disabled = true

{
  "reporting-disabled": true
}

secret-store

指定用于密码和令牌等机密数据的存储库。将机密数据存储在 InfluxDB 内部的 BoltDB（bolt-path）或 Vault（Vault）中。

选项： bolt，vault
默认： bolt

influxd 标志	环境变量	配置键
`--secret-store`	`INFLUXD_SECRET_STORE`	`secret-store`

influxd 标志

influxd --secret-store=bolt

环境变量

export INFLUXD_SECRET_STORE=bolt

配置文件

YAML TOML JSON

secret-store: bolt

secret-store = "bolt"

{
  "secret-store": "bolt"
}

session-length

指定新创建用户会话的生存时间（TTL）（以分钟为单位）。

默认： 60

influxd 标志	环境变量	配置键
`--session-length`	`INFLUXD_SESSION_LENGTH`	`session-length`

influxd 标志

influxd --session-length=60

环境变量

export INFLUXD_SESSION_LENGTH=60

配置文件

YAML TOML JSON

session-length: 60

session-length = 60

{
  "session-length": 60
}

session-renew-disabled

禁用在每个请求中自动扩展用户的会话 TTL。默认情况下，每个请求都将会话的过期时间设置为从现在起五分钟。当禁用时，会话在指定的会话长度后过期，并且用户将被重定向到登录页面，即使最近很活跃。

默认： false

influxd 标志	环境变量	配置键
`--session-renew-disabled`	`INFLUXD_SESSION_RENEW_DISABLED`	`session-renew-disabled`

influxd 标志

influxd --session-renew-disabled

环境变量

export INFLUXD_SESSION_RENEW_DISABLED=true

配置文件

YAML TOML JSON

session-renew-disabled: true

session-renew-disabled = true

{
  "session-renew-disabled": true
}

sqlite-path

SQLite 数据库文件的路径。SQLite 数据库用于存储笔记本和注释的元数据。

默认： 与 bolt-path 相同目录下的 influxd.sqlite

influxd 标志	环境变量	配置键
`--sqlite-path`	`INFLUXD_SQLITE_PATH`	`sqlite-path`

influxd 标志

influxd --sqlite-path ~/.influxdbv2/influxd.sqlite

环境变量

export INFLUXD_SQLITE_PATH=~/.influxdbv2/influxd.sqlite

配置文件

YAML TOML JSON

sqlite-path: ~/.influxdbv2/influxd.sqlite

sqlite-path = "~/.influxdbv2/influxd.sqlite"

{
  "sqlite-path": "~/.influxdbv2/influxd.sqlite"
}

storage-cache-max-memory-size

在开始拒绝写入之前，分片缓存可以达到的最大大小（以字节为单位）。

默认： 1073741824

influxd 标志	环境变量	配置键
`--storage-cache-max-memory-size`	`INFLUXD_STORAGE_CACHE_MAX_MEMORY_SIZE`	`storage-cache-max-memory-size`

influxd 标志

influxd --storage-cache-max-memory-size=1073741824

环境变量

export INFLUXD_STORAGE_CACHE_MAX_MEMORY_SIZE=1073741824

配置文件

YAML TOML JSON

storage-cache-max-memory-size: 1073741824

storage-cache-max-memory-size = 1073741824

{
  "storage-cache-max-memory-size": 1073741824
}

storage-cache-snapshot-memory-size

存储引擎在哪个大小（以字节为单位）上快照缓存并将其写入TSM文件以释放更多内存。

默认值: 26214400

influxd 标志	环境变量	配置键
`--storage-cache-snapshot-memory-size`	`INFLUXD_STORAGE_CACHE_SNAPSHOT_MEMORY_SIZE`	`storage-cache-snapshot-memory-size`

influxd 标志

influxd --storage-cache-snapshot-memory-size=26214400

环境变量

export INFLUXD_STORAGE_CACHE_SNAPSHOT_MEMORY_SIZE=26214400

配置文件

YAML TOML JSON

storage-cache-snapshot-memory-size: 26214400

storage-cache-snapshot-memory-size = 26214400

{
  "storage-cache-snapshot-memory-size": 26214400
}

storage-cache-snapshot-write-cold-duration

存储引擎快照缓存并写入新TSM文件的时间间隔，如果分片没有接收到写入或删除操作。

默认值: 10m0s

influxd 标志	环境变量	配置键
`--storage-cache-snapshot-write-cold-duration`	`INFLUXD_STORAGE_CACHE_SNAPSHOT_WRITE_COLD_DURATION`	`storage-cache-snapshot-write-cold-duration`

influxd 标志

influxd --storage-cache-snapshot-write-cold-duration=10m0s

环境变量

export INFLUXD_STORAGE_CACHE_SNAPSHOT_WRITE_COLD_DURATION=10m0s

配置文件

YAML TOML JSON

storage-cache-snapshot-write-cold-duration: 10m0s

storage-cache-snapshot-write-cold-duration = "10m0s"

{
  "storage-cache-snapshot-write-cold-duration": "10m0s"
}

storage-compact-full-write-cold-duration

如果分片没有接收到写入或删除操作，存储引擎将在多长时间内压缩分片中的所有TSM文件。

默认值: 4h0m0s

influxd 标志	环境变量	配置键
`--storage-compact-full-write-cold-duration`	`INFLUXD_STORAGE_COMPACT_FULL_WRITE_COLD_DURATION`	`storage-compact-full-write-cold-duration`

influxd 标志

influxd --storage-compact-full-write-cold-duration=4h0m0s

环境变量

export INFLUXD_STORAGE_COMPACT_FULL_WRITE_COLD_DURATION=4h0m0s

配置文件

YAML TOML JSON

storage-compact-full-write-cold-duration: 4h0m0s

storage-compact-full-write-cold-duration = "4h0m0s"

{
  "storage-compact-full-write-cold-duration": "4h0m0s"
}

storage-compact-throughput-burst

TSM压缩写入磁盘的字节每秒的速率限制。

默认值: 50331648

influxd 标志	环境变量	配置键
`--storage-compact-throughput-burst`	`INFLUXD_STORAGE_COMPACT_THROUGHPUT_BURST`	`storage-compact-throughput-burst`

influxd 标志

influxd --storage-compact-throughput-burst=50331648

环境变量

export INFLUXD_STORAGE_COMPACT_THROUGHPUT_BURST=50331648

配置文件

YAML TOML JSON

storage-compact-throughput-burst: 50331648

storage-compact-throughput-burst = 50331648

{
  "storage-compact-throughput-burst": 50331648
}

storage-max-concurrent-compactions

可以同时运行的完整和层级压缩的最大数量。值为0时，在运行时使用runtime.GOMAXPROCS(0)的50%。任何大于零的数字都将限制压缩到该值。此设置不适用于缓存快照。

默认： 0

influxd 标志	环境变量	配置键
`--storage-max-concurrent-compactions`	`INFLUXD_STORAGE_MAX_CONCURRENT_COMPACTIONS`	`storage-max-concurrent-compactions`

influxd 标志

influxd --storage-max-concurrent-compactions=0

环境变量

export INFLUXD_STORAGE_MAX_CONCURRENT_COMPACTIONS=0

配置文件

YAML TOML JSON

storage-max-concurrent-compactions: 0

storage-max-concurrent-compactions = 0

{
  "storage-max-concurrent-compactions": 0
}

storage-max-index-log-file-size

索引写入前日志（WAL）文件压缩成索引文件的大小。较小的尺寸会导致日志文件更快地压缩，从而以牺牲写入吞吐量为代价减少堆的使用。

默认： 1048576

influxd 标志	环境变量	配置键
`--storage-max-index-log-file-size`	`INFLUXD_STORAGE_MAX_INDEX_LOG_FILE_SIZE`	`storage-max-index-log-file-size`

influxd 标志

influxd --storage-max-index-log-file-size=1048576

环境变量

export INFLUXD_STORAGE_MAX_INDEX_LOG_FILE_SIZE=1048576

配置文件

YAML TOML JSON

storage-max-index-log-file-size: 1048576

storage-max-index-log-file-size = 1048576

{
  "storage-max-index-log-file-size": 1048576
}

storage-no-validate-field-size

跳过对传入写入请求的字段大小验证。

默认： false

influxd 标志	环境变量	配置键
`--storage-no-validate-field-size`	`INFLUXD_STORAGE_NO_VALIDATE_FIELD_SIZE`	`storage-no-validate-field-size`

influxd 标志

influxd --storage-no-validate-field-size

环境变量

export INFLUXD_STORAGE_NO_VALIDATE_FIELD_SIZE=true

配置文件

YAML TOML JSON

storage-no-validate-field-size: true

storage-no-validate-field-size = true

{
  "storage-no-validate-field-size": true
}

storage-retention-check-interval

保留策略执行检查的间隔。

默认值: 30m0s

influxd 标志	环境变量	配置键
`--storage-retention-check-interval`	`INFLUXD_STORAGE_RETENTION_CHECK_INTERVAL`	`storage-retention-check-interval`

influxd 标志

influxd --storage-retention-check-interval=30m0s

环境变量

export INFLUXD_STORAGE_RETENTION_CHECK_INTERVAL=30m0s

配置文件

YAML TOML JSON

storage-retention-check-interval: 30m0s

storage-retention-check-interval = "30m0s"

{
  "storage-retention-check-interval": "30m0s"
}

storage-series-file-max-concurrent-snapshot-compactions

在整个数据库中所有系列分区可以同时运行的快照压缩的最大数量。

默认： 0

influxd 标志	环境变量	配置键
`--storage-series-file-max-concurrent-snapshot-compactions`	`INFLUXD_STORAGE_SERIES_FILE_MAX_CONCURRENT_SNAPSHOT_COMPACTIONS`	`storage-series-file-max-concurrent-snapshot-compactions`

influxd 标志

influxd --storage-series-file-max-concurrent-snapshot-compactions=0

环境变量

export INFLUXD_STORAGE_SERIES_FILE_MAX_CONCURRENT_SNAPSHOT_COMPACTIONS=0

配置文件

YAML TOML JSON

storage-series-file-max-concurrent-snapshot-compactions: 0

storage-series-file-max-concurrent-snapshot-compactions = 0

{
  "storage-series-file-max-concurrent-snapshot-compactions": 0
}

storage-series-id-set-cache-size

在TSI索引内部缓存中存储先前计算系列结果的大小。缓存的结果在执行后续查询时快速返回，而不是需要重新计算。将此值设置为0将禁用缓存并可能降低查询性能。

默认值: 100

只有当数据库中所有测量值使用的常规标签键/值谓词集合大于100时，才应增加此值。增加缓存大小可能导致堆使用量增加。

influxd 标志	环境变量	配置键
`--storage-series-id-set-cache-size`	`INFLUXD_STORAGE_SERIES_ID_SET_CACHE_SIZE`	`storage-series-id-set-cache-size`

influxd 标志

influxd --storage-series-id-set-cache-size=100

环境变量

export INFLUXD_STORAGE_SERIES_ID_SET_CACHE_SIZE=100

配置文件

YAML TOML JSON

storage-series-id-set-cache-size: 100

storage-series-id-set-cache-size = 100

{
  "storage-series-id-set-cache-size": 100
}

storage-shard-precreator-advance-period

在分片组结束时间之前创建后续分片组的时间。

默认值: 30m0s

influxd 标志	环境变量	配置键
`--storage-shard-precreator-advance-period`	`INFLUXD_STORAGE_SHARD_PRECREATOR_ADVANCE_PERIOD`	`storage-shard-precreator-advance-period`

influxd 标志

influxd --storage-shard-precreator-advance-period=30m0s

环境变量

export INFLUXD_STORAGE_SHARD_PRECREATOR_ADVANCE_PERIOD=30m0s

配置文件

YAML TOML JSON

storage-shard-precreator-advance-period: 30m0s

storage-shard-precreator-advance-period = "30m0s"

{
  "storage-shard-precreator-advance-period": "30m0s"
}

storage-shard-precreator-check-interval

预创建新分片检查的间隔。

默认值: 10m0s

influxd 标志	环境变量	配置键
`--storage-shard-precreator-check-interval`	`INFLUXD_STORAGE_SHARD_PRECREATOR_CHECK_INTERVAL`	`storage-shard-precreator-check-interval`

influxd 标志

influxd --storage-shard-precreator-check-interval=10m0s

环境变量

export INFLUXD_STORAGE_SHARD_PRECREATOR_CHECK_INTERVAL=10m0s

配置文件

YAML TOML JSON

storage-shard-precreator-check-interval: 10m0s

storage-shard-precreator-check-interval = "10m0s"

{
  "storage-shard-precreator-check-interval": "10m0s"
}

storage-tsm-use-madv-willneed

通知内核InfluxDB打算将TSM文件中mmap’d部分页入内存。

默认： false

influxd 标志	环境变量	配置键
`--storage-tsm-use-madv-willneed`	`INFLUXD_STORAGE_TSM_USE_MADV_WILLNEED`	`storage-tsm-use-madv-willneed`

influxd 标志

influxd --storage-tsm-use-madv-willneed

环境变量

export INFLUXD_STORAGE_TSM_USE_MADV_WILLNEED=true

配置文件

YAML TOML JSON

storage-tsm-use-madv-willneed: true

storage-tsm-use-madv-willneed = true

{
  "storage-tsm-use-madv-willneed": true
}

storage-validate-keys

验证传入的写入以确保键只包含有效的Unicode字符。

默认： false

influxd 标志	环境变量	配置键
`--storage-validate-keys`	`INFLUXD_STORAGE_VALIDATE_KEYS`	`storage-validate-keys`

influxd 标志

influxd --storage-validate-keys

环境变量

export INFLUXD_STORAGE_VALIDATE_KEYS=true

配置文件

YAML TOML JSON

storage-validate-keys: true

storage-validate-keys = true

{
  "storage-validate-keys": true
}

storage-wal-fsync-delay

写入等待fsync的时间。大于0的时间将多个fsync调用批处理。这对于较慢的磁盘或在WAL写入竞争存在时很有用。

默认值: 0s

influxd 标志	环境变量	配置键
`--storage-wal-fsync-delay`	`INFLUXD_STORAGE_WAL_FSYNC_DELAY`	`storage-wal-fsync-delay`

influxd 标志

influxd --storage-wal-fsync-delay=0s

环境变量

export INFLUXD_STORAGE_WAL_FSYNC_DELAY=0s

配置文件

YAML TOML JSON

storage-wal-fsync-delay: 0s

storage-wal-fsync-delay = "0s"

{
  "storage-wal-fsync-delay": "0s"
}

storage-wal-max-concurrent-writes

尝试同时写入WAL目录的最大写入数。

默认值: 0 （处理单元数量 × 2）

influxd 标志	环境变量	配置键
`--storage-wal-max-concurrent-writes`	`INFLUXD_STORAGE_WAL_MAX_CONCURRENT_WRITES`	`storage-wal-max-concurrent-writes`

influxd 标志

influxd --storage-wal-max-concurrent-writes=0

环境变量

export INFLUXD_STORAGE_WAL_MAX_CONCURRENT_WRITES=0

配置文件

YAML TOML JSON

storage-wal-max-concurrent-writes: 0

storage-wal-max-concurrent-writes = 0

{
  "storage-wal-max-concurrent-writes": 0
}

storage-wal-max-write-delay

当达到WAL目录最大并发写入数时，写入请求将等待的最大时间。将值设置为0以禁用超时。

默认值： 10m

influxd 标志	环境变量	配置键
`--storage-wal-max-write-delay`	`INFLUXD_STORAGE_WAL_MAX_WRITE_DELAY`	`storage-wal-max-write-delay`

influxd 标志

influxd --storage-wal-max-write-delay=10m

环境变量

export INFLUXD_STORAGE_WAL_MAX_WRITE_DELAY=10m

配置文件

YAML TOML JSON

storage-wal-max-write-delay: 10m

storage-wal-max-write-delay = "10m"

{
  "storage-wal-max-write-delay": "10m"
}

storage-write-timeout

存储引擎处理写入请求并在超时之前所能等待的最大时间。

默认： 10s

influxd 标志	环境变量	配置键
`--storage-write-timeout`	`INFLUXD_STORAGE_WRITE_TIMEOUT`	`storage-write-timeout`

influxd 标志

influxd --storage-write-timeout=10s

环境变量

export INFLUXD_STORAGE_WRITE_TIMEOUT=10s

配置文件

YAML TOML JSON

storage-write-timeout: 10s

storage-write-timeout = "10s"

{
  "storage-write-timeout": "10s"
}

store

指定REST资源的存储位置。

选项： disk，memory
默认值： disk

为了向后兼容，此标志也接受bolt作为值。当使用disk时，REST资源将使用bolt-path和sqlite-path存储在磁盘上。

memory适用于临时环境，如测试环境，其中数据持久性不重要。InfluxData不推荐在生产环境中使用memory。

influxd 标志	环境变量	配置键
`--store`	`INFLUXD_STORE`	`store`

influxd 标志

influxd --store=bolt

环境变量

export INFLUXD_STORE=bolt

配置文件

YAML TOML JSON

store: bolt

store = "bolt"

{
  "store": "bolt"
}

strong-passwords

要求密码至少有八个字符，并且至少包含以下四个字符类别中的三个字符

大写字母 (A-Z)
小写字母 (a-z)
数字 (0-9)
特殊字符 (!@#$%^&*()_+)

influxd 标志	环境变量	配置键
`--strong-passwords`	`INFLUXD_STRONG_PASSWORDS`	`strong-passwords`

influxd 标志

influxd --strong-passwords

环境变量

export INFLUXD_STRONG_PASSWORDS=true

配置文件

YAML TOML JSON

strong-passwords: true

strong-passwords = true

{
  "strong-passwords": true
}

testing-always-allow-setup

确保/api/v2/setup端点始终返回true以允许加入。此配置选项主要用于持续集成测试。

默认： false

influxd 标志	环境变量	配置键
`--testing-always-allow-setup`	`INFLUXD_TESTING_ALWAYS_ALLOW_SETUP`	`testing-always-allow-setup`

influxd 标志

influxd --testing-always-allow-setup

环境变量

export INFLUXD_TESTING_ALWAYS_ALLOW_SETUP=true

配置文件

YAML TOML JSON

testing-always-allow-setup: true

testing-always-allow-setup = true

{
  "testing-always-allow-setup": true
}

tls-cert

TLS证书文件路径。需要设置tls-key。

有关更多信息，请参阅启用TLS加密。

influxd 标志	环境变量	配置键
`--tls-cert`	`INFLUXD_TLS_CERT`	`tls-cert`

influxd 标志

influxd --tls-cert=/path/to/influxdb.crt

环境变量

export INFLUXD_TLS_CERT=/path/to/influxdb.crt

配置文件

YAML TOML JSON

tls-cert: /path/to/influxdb.crt

tls-cert = "/path/to/influxdb.crt"

{
  "tls-cert": "/path/to/influxdb.crt"
}

tls-key

TLS密钥文件路径。需要设置tls-cert。

有关更多信息，请参阅启用TLS加密。

influxd 标志	环境变量	配置键
`--tls-key`	`INFLUXD_TLS_KEY`	`tls-key`

influxd 标志

influxd --tls-key=/path/to/influxdb.key

环境变量

export INFLUXD_TLS_KEY=/path/to/influxdb.key

配置文件

YAML TOML JSON

tls-key: /path/to/influxdb.key

tls-key = "/path/to/influxdb.key"

{
  "tls-key": "/path/to/influxdb.key"
}

tls-min-version

接受的最低TLS版本。

默认值： 1.2

influxd 标志	环境变量	配置键
`--tls-min-version`	`INFLUXD_TLS_MIN_VERSION`	`tls-min-version`

influxd 标志

influxd --tls-min-version=1.2

环境变量

export INFLUXD_TLS_MIN_VERSION=1.2

配置文件

YAML TOML JSON

tls-min-version: "1.2"

tls-min-version = "1.2"

{
  "tls-min-version": "1.2"
}

tls-strict-ciphers

限制接受的TLS加密套件为

ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
ECDHE_RSA_WITH_AES_128_GCM_SHA256
ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
ECDHE_RSA_WITH_AES_256_GCM_SHA384
ECDHE_ECDSA_WITH_CHACHA20_POLY1305
ECDHE_RSA_WITH_CHACHA20_POLY1305

默认： false

influxd 标志	环境变量	配置键
`--tls-strict-ciphers`	`INFLUXD_TLS_STRICT_CIPHERS`	`tls-strict-ciphers`

influxd 标志

influxd --tls-strict-ciphers

环境变量

export INFLUXD_TLS_STRICT_CIPHERS=true

配置文件

YAML TOML JSON

tls-strict-ciphers: true

tls-strict-ciphers = true

{
  "tls-strict-ciphers": true
}

tracing-type

在InfluxDB中启用跟踪并指定跟踪类型。默认情况下，跟踪是禁用的。

选项： log，jaeger

influxd 标志	环境变量	配置键
`--tracing-type`	`INFLUXD_TRACING_TYPE`	`tracing-type`

influxd 标志

influxd --tracing-type=log

环境变量

export INFLUXD_TRACING_TYPE=log

配置文件

YAML TOML JSON

tracing-type: log

tracing-type = "log"

{
  "tracing-type": "log"
}

ui-disabled

禁用InfluxDB用户界面（UI）。默认情况下，UI是启用的。

默认： false

influxd 标志	环境变量	配置键
`--ui-disabled`	`INFLUXD_UI_DISABLED`	`ui-disabled`

influxd 标志

influxd --ui-disabled

环境变量

export INFLUXD_UI_DISABLED=true

配置文件

YAML TOML JSON

ui-disabled: true

ui-disabled = true

{
  "ui-disabled": true
}

vault-addr

指定Vault服务器地址，以URL和端口号的形式表达。例如：https://127.0.0.1:8200/。

influxd 标志	环境变量	配置键
`--vault-addr`	`VAULT_ADDR`	`vault-addr`

influxd 标志

influxd --vault-addr=https://127.0.0.1:8200/

环境变量

export VAULT_ADDR=https://127.0.0.1:8200/

配置文件

YAML TOML JSON

vault-addr: https://127.0.0.1:8200/

vault-addr = "https://127.0.0.1:8200/"

{
  "vault-addr": "https://127.0.0.1:8200/"
}

vault-cacert

指定本地磁盘上PEM编码的CA证书文件的路径。此文件用于验证Vault服务器的SSL证书。此设置优先于--vault-capath设置。

influxd 标志	环境变量	配置键
`--vault-cacert`	`VAULT_CACERT`	`vault-cacert`

influxd 标志

influxd  --vault-cacert=/path/to/ca.pem

环境变量

export VAULT_CACERT=/path/to/ca.pem

配置文件

YAML TOML JSON

vault-cacert: /path/to/ca.pem

vault-cacert = "/path/to/ca.pem"

{
  "vault-cacert": "/path/to/ca.pem"
}

vault-capath

指定本地磁盘上PEM编码的CA证书文件目录的路径。这些证书用于验证Vault服务器的SSL证书。

influxd 标志	环境变量	配置键
`--vault-capath`	`VAULT_CAPATH`	`vault-capath`

influxd 标志

influxd --vault-capath=/path/to/certs/

环境变量

export VAULT_CAPATH=/path/to/certs/

配置文件

YAML TOML JSON

vault-capath: /path/to/certs/

vault-capath = "/path/to/certs/"

{
  "vault-capath": "/path/to/certs/"
}

vault-client-cert

指定本地磁盘上PEM编码的客户证书的路径。此文件用于与Vault服务器进行TLS通信。

influxd 标志	环境变量	配置键
`--vault-client-cert`	`VAULT_CLIENT_CERT`	`vault-client-cert`

influxd 标志

influxd --vault-client-cert=/path/to/client_cert.pem

环境变量

export VAULT_CLIENT_CERT=/path/to/client_cert.pem

配置文件

YAML TOML JSON

vault-client-cert: /path/to/client_cert.pem

vault-client-cert = "/path/to/client_cert.pem"

{
  "vault-client-cert": "/path/to/client_cert.pem"
}

vault-client-key

指定磁盘上与匹配客户端证书对应的未加密PEM编码私钥的路径。

influxd 标志	环境变量	配置键
`--vault-client-key`	`VAULT_CLIENT_KEY`	`vault-client-key`

influxd 标志

influxd --vault-client-key=/path/to/private_key.pem

环境变量

export VAULT_CLIENT_KEY=/path/to/private_key.pem

配置文件

YAML TOML JSON

vault-client-key: /path/to/private_key.pem

vault-client-key = "/path/to/private_key.pem"

{
  "vault-client-key": "/path/to/private_key.pem"
}

vault-max-retries

指定遇到5xx错误代码时的最大重试次数。默认值为2（总共尝试三次）。将其设置为0或更小以禁用重试。

默认： 2

influxd 标志	环境变量	配置键
`--vault-max-retries`	`VAULT_MAX_RETRIES`	`vault-max-retries`

influxd 标志

influxd --vault-max-retries=2

环境变量

export VAULT_MAX_RETRIES=2

配置文件

YAML TOML JSON

vault-max-retries: 2

vault-max-retries = 2

{
  "vault-max-retries": 2
}

vault-client-timeout

指定Vault客户端超时时间。

默认： 60s

influxd 标志	环境变量	配置键
`--vault-client-timeout`	`VAULT_CLIENT_TIMEOUT`	`vault-client-timeout`

influxd 标志

influxd --vault-client-timeout=60s

环境变量

export VAULT_CLIENT_TIMEOUT=60s

配置文件

YAML TOML JSON

vault-client-timeout: 60s

vault-client-timeout = "60s"

{
  "vault-client-timeout": "60s"
}

vault-skip-verify

在与Vault通信时跳过证书验证。设置此变量将使Vault的安全模型失效，并且**不建议**这样做。

默认： false

influxd 标志	环境变量	配置键
`--vault-skip-verify`	`VAULT_SKIP_VERIFY`	`vault-skip-verify`

influxd 标志

influxd --vault-skip-verify

环境变量

export VAULT_SKIP_VERIFY=true

配置文件

YAML TOML JSON

vault-skip-verify: true

vault-skip-verify = true

{
  "vault-skip-verify": true
}

vault-tls-server-name

指定通过TLS连接时使用的作为服务器名称指示（SNI）的主机名。

influxd 标志	环境变量	配置键
`--vault-tls-server-name`	`VAULT_TLS_SERVER_NAME`	`vault-tls-server-name`

influxd 标志

influxd --vault-tls-server-name=secure.example.com

环境变量

export VAULT_TLS_SERVER_NAME=secure.example.com

配置文件

YAML TOML JSON

vault-tls-server-name: secure.example.com

vault-tls-server-name = "secure.example.com"

{
  "vault-tls-server-name": "secure.example.com"
}

vault-token

指定用于与Vault进行身份验证的Vault令牌。

influxd 标志	环境变量	配置键
`--vault-token`	`VAULT_TOKEN`	`vault-token`

influxd 标志

influxd --vault-token=exAmple-t0ken-958a-f490-c7fd0eda5e9e

环境变量

export VAULT_TOKEN=exAmple-t0ken-958a-f490-c7fd0eda5e9e

配置文件

YAML TOML JSON

vault-token: exAmple-t0ken-958a-f490-c7fd0eda5e9e

vault-token = "exAmple-t0ken-958a-f490-c7fd0eda5e9e"

{
  "vault-token": "exAmple-t0ken-958a-f490-c7fd0eda5e9e"
}

这个页面有帮助吗？

感谢您的反馈！

支持和反馈

感谢您成为我们社区的一部分！我们欢迎并鼓励您对InfluxDB和此文档的反馈和错误报告。要获取支持，请使用以下资源

拥有年度或支持合同的客户可以通过联系InfluxData支持。

编辑此页面提交文档问题提交InfluxDB问题