配置 InfluxDB OSS

InfluxDB 开源 (OSS) 配置文件包含特定于本地节点的配置设置。

内容

• 配置概述
• 环境变量
  • InfluxDB 环境变量 (INFLUXDB_*)
  • GOMAXPROCS 环境变量
• 使用配置文件
• 配置设置
  • 全局设置
  • 元存储 [meta]
  • 数据 [data]
  • 查询管理 [coordinator]
  • Flux 查询管理 [flux-controller]
  • 保留策略 [retention]
  • 分片预创建 [shard-precreation]
  • 监控 [monitor]
  • HTTP 端点 [http]
  • 订阅 [subscriber]
  • Graphite [[graphite]]
  • CollectD [[collectd]]
  • OpenTSB [[opentsdb]]
  • UDP [[udp]]
  • 连续查询 [continuous_queries]
  • TLS [tls]

配置概述

InfluxDB 使用配置文件 (influxdb.conf) 和环境变量进行配置。如果您不取消注释配置选项，系统将使用其默认设置。本文档中的配置设置设置为其默认设置。

指定持续时间的配置设置支持以下持续时间单位

• ns （纳秒）
• us 或 µs （微秒）
• ms （毫秒）
• s （秒）
• m （分钟）
• h （小时）
• d （天）
• w （周）

注意： 此处记录的配置文件设置适用于最新的官方版本 - GitHub 上的示例配置文件 可能会稍新一些。

环境变量

配置文件中的所有配置设置都可以在配置文件或环境变量中指定。环境变量会覆盖配置文件中的等效选项。如果未在配置文件或环境变量中指定配置选项，则 InfluxDB 将使用其内部默认配置。

注意： 如果已设置环境变量，则配置文件中的等效配置设置将被忽略。

InfluxDB 环境变量 (INFLUXDB_*)

InfluxDB 环境变量在下面与相应的配置文件设置一起记录。所有特定于 InfluxDB 的环境变量都以 INFLUXDB_ 为前缀。

GOMAXPROCS 环境变量

注意： GOMAXPROCS 环境变量无法像其他环境变量一样使用 InfluxDB 配置文件设置进行设置。

GOMAXPROCS Go 语言环境变量 可用于设置可以同时执行的最大 CPU 数量。

GOMAXPROCS 的默认值是程序在启动时可见的 CPU 数量（操作系统认为的 CPU）。对于 32 核机器，GOMAXPROCS 值将为 32。您可以将此值覆盖为小于最大值，这在您在同一台机器上运行 InfluxDB 以及其他进程，并希望确保数据库不会完全饿死这些进程的情况下非常有用。

注意： 设置 GOMAXPROCS=1 将消除所有并行化。

使用配置文件

InfluxDB 系统对配置文件中的所有设置都有内部默认值。要查看默认配置设置，请使用 influxd config 命令。

本地 InfluxDB 配置文件位于此处

• Linux: /etc/influxdb/influxdb.conf
• macOS: /usr/local/etc/influxdb.conf
• Windows: 与 influxd.exe 相同的目录

注释掉的设置设置为内部系统默认值。未注释的设置会覆盖内部默认值。请注意，本地配置文件不需要包含每个配置设置。

有两种方法可以使用您的配置文件启动 InfluxDB

• 使用 -config 选项将进程指向配置文件。例如

  influxd -config /etc/influxdb/influxdb.conf
  

• 将环境变量 INFLUXDB_CONFIG_PATH 设置为您的配置文件的路径并启动进程。例如

  echo $INFLUXDB_CONFIG_PATH
  /etc/influxdb/influxdb.conf
  
  influxd
  

InfluxDB 首先检查 -config 选项，然后检查环境变量。

配置设置

注意： 要在允许进行多项配置的配置部分（任何标题中带有 [[双括号]] 的部分都支持多项配置）中设置或覆盖设置，必须按序号指定所需的配置。例如，对于第一组 [[graphite]] 环境变量，请在环境变量中配置设置名称的前缀加上相关的位置编号（在本例中为：0）

INFLUXDB_GRAPHITE_0_BATCH_PENDING
INFLUXDB_GRAPHITE_0_BATCH_SIZE
INFLUXDB_GRAPHITE_0_BATCH_TIMEOUT
INFLUXDB_GRAPHITE_0_BIND_ADDRESS
INFLUXDB_GRAPHITE_0_CONSISTENCY_LEVEL
INFLUXDB_GRAPHITE_0_DATABASE
INFLUXDB_GRAPHITE_0_ENABLED
INFLUXDB_GRAPHITE_0_PROTOCOL
INFLUXDB_GRAPHITE_0_RETENTION_POLICY
INFLUXDB_GRAPHITE_0_SEPARATOR
INFLUXDB_GRAPHITE_0_TAGS
INFLUXDB_GRAPHITE_0_TEMPLATES
INFLUXDB_GRAPHITE_0_UDP_READ_BUFFER

对于配置文件中的第 N 个 Graphite 配置，相关的环境变量将采用 INFLUXDB_GRAPHITE_(N-1)_BATCH_PENDING 的形式。对于配置文件的每个部分，编号从零重新开始。

全局设置

reporting-disabled = false

InfluxData 使用来自运行 InfluxDB 节点的自愿报告数据，主要用于跟踪不同 InfluxDB 版本的采用率。此数据有助于 InfluxData 支持 InfluxDB 的持续开发。

reporting-disabled 选项切换每 24 小时向 usage.influxdata.com 报告数据。每个报告都包含一个随机生成的标识符、操作系统、架构、InfluxDB 版本以及 数据库、测量 和唯一 序列 的数量。将此选项设置为 true 将禁用报告。

注意： 永远不会传输用户数据库中的任何数据。

环境变量：INFLUXDB_REPORTING_DISABLED

bind-address = "127.0.0.1:8088"

用于 备份和恢复 的 RPC 服务的绑定地址。

环境变量：INFLUXDB_BIND_ADDRESS

compact-series-file = false

确定是否应在启动时压缩序列文件。如果为 true，则 InfluxDB 在启动 influxd 服务器之前运行 influxd_inspect -compact-series-file。默认为 false。

元存储设置

[meta]

此部分控制 InfluxDB 元存储的参数，该元存储存储有关用户、数据库、保留策略、分片和连续查询的信息。

dir = "/var/lib/influxdb/meta"

存储元数据/raft 数据库的目录。meta 目录中的文件包括 meta.db，即 InfluxDB 元存储文件。

注意： macOS 安装的默认目录为 /Users/<username>/.influxdb/meta

环境变量：INFLUXDB_META_DIR

retention-autocreate = true

启用在创建数据库时自动创建 DEFAULT 保留策略 autogen。保留策略 autogen 具有无限持续时间，并且还设置为数据库的 DEFAULT 保留策略，当写入或查询未指定保留策略时使用该策略。禁用此设置可防止在创建数据库时创建此保留策略。

环境变量：INFLUXDB_META_RETENTION_AUTOCREATE

logging-enabled = true

启用来自元服务的消息日志记录。

环境变量：INFLUXDB_META_LOGGING_ENABLED

数据设置

[data]

[data] 设置控制 InfluxDB 的实际分片数据的位置以及如何从预写日志 (WAL) 中刷新数据。dir 可能需要更改为适合您系统的位置，但 WAL 设置是高级配置。默认值应适用于大多数系统。

dir = "/var/lib/influxdb/data"

TSM 引擎存储 TSM 文件的 InfluxDB 目录。可以更改此目录。

注意： macOS 安装的默认目录为 /Users/<username>/.influxdb/data。

环境变量：INFLUXDB_DATA_DIR

wal-dir = "/var/lib/influxdb/wal"

预写日志 (WAL) 文件的目录位置。

注意： 对于 macOS 安装，默认 WAL 目录为 /Users/<username>/.influxdb/wal。

环境变量：INFLUXDB_DATA_WAL_DIR

wal-fsync-delay = "0s"

写入等待 fsync 的时间量。使用大于 0 的持续时间来批量处理多个 fsync 调用。这对于较慢的磁盘或遇到 WAL 写入争用时很有用。默认值 0s 将每次写入 fsync 到 WAL。

注意： 对于非 SSD 磁盘，InfluxData 建议使用 0ms-100ms 范围内的值。

环境变量：INFLUXDB_DATA_WAL_FSYNC_DELAY

index-version = "inmem"

用于新分片的分片索引类型。默认 (inmem) 索引是启动时重新创建的内存索引。要启用基于磁盘的时间序列索引 (TSI)，请将值设置为 tsi1。

环境变量：INFLUXDB_DATA_INDEX_VERSION

trace-logging-enabled = false

启用 TSM 引擎和 WAL 中附加调试信息的详细日志记录。跟踪日志记录为调试 TSM 引擎问题提供了更有用的输出。

环境变量：INFLUXDB_DATA_TRACE_LOGGING_ENABLED

query-log-enabled = true

启用执行前解析查询的日志记录。查询日志对于故障排除很有用，但会记录查询中包含的任何敏感数据。

环境变量：INFLUXDB_DATA_QUERY_LOG_ENABLED

validate-keys = false

验证传入的写入，以确保测量键和标签键仅具有有效的 Unicode 字符。此设置会产生少量开销，因为必须检查每个键。这不会验证字段键。

TSM 引擎的设置

cache-max-memory-size = "1g"

分片缓存可以达到的最大大小，超过此大小将开始拒绝写入。

有效的内存大小后缀为：k、m 或 g（不区分大小写，1024 = 1k）。没有大小后缀的值以字节为单位。

如果遇到 cache maximum memory size exceeded 错误，请考虑增加此值。

环境变量：INFLUXDB_DATA_CACHE_MAX_MEMORY_SIZE

cache-snapshot-memory-size = "25m"

引擎将快照缓存并将其写入 TSM 文件以释放内存的大小。

有效的内存大小后缀为：k、m 或 g（不区分大小写，1024 = 1k）。没有大小后缀的值以字节为单位。

环境变量：INFLUXDB_DATA_CACHE_SNAPSHOT_MEMORY_SIZE

cache-snapshot-write-cold-duration = "10m"

如果分片未收到写入或删除，引擎将快照缓存并将其写入新 TSM 文件的时间间隔。

环境变量：INFLUXDB_DATA_CACHE_SNAPSHOT_WRITE_COLD_DURATION

compact-full-write-cold-duration = "4h"

如果 TSM 引擎的分片未收到写入或删除，则 TSM 引擎将压缩分片中所有 TSM 文件的时间间隔。

环境变量：INFLUXDB_DATA_COMPACT_FULL_WRITE_COLD_DURATION

max-concurrent-compactions = 0

一次可以运行的最大并发完全和级别 压缩 数。默认值 0 会导致在运行时使用 50% 的 CPU 内核进行压缩。如果显式设置，则用于压缩的内核数将限制为指定的值。此设置不适用于缓存快照。有关 GOMAXPROCS 环境变量的更多信息，请参阅此页面上的 GOMAXPROCS 环境变量。

环境变量：INFLUXDB_DATA_MAX_CONCURRENT_COMPACTIONS

max-concurrent-deletes = 1

分片上同时 DELETE 调用的最大数量。默认为 1，对于大多数用例应保持不变。

环境变量：INFLUXDB_DATA_MAX_CONCURRENT_DELETES

compact-throughput = "48m"

TSM 压缩每秒写入磁盘的最大字节数。默认为 "48m"（4800 万）。请注意，允许短时突发以可能更大的值发生，由 compact-throughput-burst 设置。

环境变量：INFLUXDB_DATA_COMPACT_THROUGHPUT

compact-throughput-burst = "48m"

TSM 压缩在短暂突发期间每秒写入磁盘的最大字节数。默认为 "48m"（4800 万）。

环境变量：INFLUXDB_DATA_COMPACT_THROUGHPUT_BURST

tsm-use-madv-willneed = false

如果为 true，则 MMap Advise 值 MADV_WILLNEED 会告知内核如何处理输入/输出分页方面的映射内存区域，并期望在不久的将来访问映射内存区域（相对于 TSM 文件）。由于此设置在某些内核（包括 CentOS 和 RHEL）上存在问题，因此默认值为 false。在某些情况下，将值更改为 true 可能会帮助使用慢速磁盘的用户。

环境变量：INFLUXDB_DATA_TSM_USE_MADV_WILLNEED

内存 (inmem) 索引设置

max-series-per-database = 1000000

每个数据库允许的最大 序列 数，超过此数量将丢弃写入。默认设置为 1000000（一百万）。将设置更改为 0 以允许每个数据库的序列数量不受限制。

如果一个点导致数据库中的序列数超过 max-series-per-database，则 InfluxDB 将不会写入该点，并且会返回 500 并显示以下错误

{"error":"max series per database exceeded: <series>"}

注意： 任何现有数据库的序列计数超过 max-series-per-database，将继续接受对现有序列的写入，但创建新序列的写入将失败。

环境变量：INFLUXDB_DATA_MAX_SERIES_PER_DATABASE

max-values-per-tag = 100000

每个 标签键 允许的最大 标签值 数。默认值为 100000（十万）。将设置更改为 0 以允许每个标签键的标签值数量不受限制。如果一个标签值导致标签键的标签值数量超过 max-values-per-tag，则 InfluxDB 将不会写入该点，并且会返回 partial write 错误。

任何现有标签键的标签值超过 max-values-per-tag，将继续接受写入，但创建新标签值的写入将失败。

环境变量：INFLUXDB_DATA_MAX_VALUES_PER_TAG

TSI (tsi1) 索引设置

max-index-log-file-size = "1m"

索引预写日志 (WAL) 文件压缩为索引文件的阈值（以字节为单位）。较低的大小将导致日志文件更快地压缩，并以写入吞吐量为代价降低堆使用率。较高的大小将减少压缩频率，在内存中存储更多序列，并提供更高的写入吞吐量。有效的大小后缀为 k、m 或 g（不区分大小写，1024 = 1k）。没有大小后缀的值以字节为单位。

环境变量：INFLUXDB_DATA_MAX_INDEX_LOG_FILE_SIZE

series-id-set-cache-size = 100

TSI 索引中用于存储先前计算的序列结果的内部缓存大小。缓存的结果将从缓存中快速返回，而无需在执行具有匹配标签键值谓词的后续查询时重新计算。将此值设置为 0 将禁用缓存，这可能会导致查询性能问题。仅当已知数据库的所有测量中经常使用的标签键值谓词集大于 100 时，才应增加此值。增加缓存大小可能会导致堆使用率增加。

环境变量：INFLUXDB_DATA_SERIES_ID_SET_CACHE_SIZE

查询管理设置

[coordinator]

此部分包含查询管理的配置设置。有关管理查询的更多信息，请参阅 查询管理。

write-timeout = "10s"

写入请求等待直到向调用者返回“超时”错误的时间。默认值为 10 秒。

环境变量：INFLUXDB_COORDINATOR_WRITE_TIMEOUT

max-concurrent-queries = 0

您的实例上允许的最大运行查询数。默认设置 (0) 允许无限数量的查询。

环境变量：INFLUXDB_COORDINATOR_MAX_CONCURRENT_QUERIES

query-timeout = "0s"

查询允许执行的最长时间，超过此时间 InfluxDB 将终止查询。默认设置 (0) 允许查询无限时运行。此设置是持续时间。

环境变量：INFLUXDB_COORDINATOR_QUERY_TIMEOUT

log-queries-after = "0s"

查询可以运行的最长时间，超过此时间 InfluxDB 将使用 Detected slow query 消息记录查询。默认设置 ("0") 永远不会告诉 InfluxDB 记录查询。此设置是持续时间。

环境变量：INFLUXDB_COORDINATOR_LOG_QUERIES_AFTER

max-select-point = 0

SELECT 语句可以处理的最大 点 数。默认设置 (0) 允许 SELECT 语句处理无限数量的点。

环境变量：INFLUXDB_COORDINATOR_MAX_SELECT_POINT

max-select-series = 0

SELECT 语句可以处理的最大 序列 数。默认设置 (0) 允许 SELECT 语句处理无限数量的序列。

环境变量：INFLUXDB_COORDINATOR_MAX_SELECT_SERIES

max-select-buckets = 0

查询可以处理的最大 GROUP BY time() 存储桶数。默认设置 (0) 允许查询处理无限数量的存储桶。

环境变量：INFLUXDB_COORDINATOR_MAX_SELECT_BUCKETS

termination-query-log = false

当 InfluxDB 收到 SIGTERM 时（当进程超出容器内存限制或由 kill 命令发送时），打印正在运行的查询列表。

环境变量：INFLUXDB_COORDINATOR_TERMINATE_QUERY_LOG

Flux 查询管理设置

[flux-controller]

flux-controller 设置控制 Flux 查询的行为。

query-concurrency = 0

允许并发执行的 Flux 查询数。0 表示无限制。默认为 0。

环境变量：INFLUXDB_FLUX_CONTROLLER_QUERY_CONCURRENCY

query-initial-memory-bytes = 0

Flux 查询启动时为其分配的初始字节数。如果未设置，则使用 query-max-memory-bytes。0 表示无限制。默认为 0。

环境变量：INFLUXDB_FLUX_CONTROLLER_QUERY_INITIAL_MEMORY_BYTES

query-max-memory-bytes = 0

Flux 查询在任何给定时间允许使用的最大字节数（以表内存为单位）。0 表示无限制。默认为 0。

如果请求更多内存会与控制器可以请求的最大内存量冲突，则查询可能无法使用其全部内存配额。

环境变量：INFLUXDB_FLUX_CONTROLLER_QUERY_MAX_MEMORY_BYTES

total-max-memory-bytes = 0

Flux 查询控制器允许为 Flux 查询分配的最大内存量。0 表示无限制。默认为 0。

如果未设置，则此数字为 query-concurrency * query-max-memory-bytes。此数字必须大于或等于 query-concurrency * query-initial-memory-bytes，并且可能小于 query-concurrency * query-max-memory-bytes。

环境变量：INFLUXDB_FLUX_CONTROLLER_TOTAL_MAX_MEMORY_BYTES

query-queue-size = 0

允许排队等待执行的 Flux 查询数，超过此数量将拒绝新查询。0 表示无限制。默认为 0。

环境变量：INFLUXDB_FLUX_CONTROLLER_QUERY_QUEUE_SIZE

保留策略设置

[retention]

[retention] 设置控制保留策略的执行，以驱逐旧数据。

enabled = true

设置为 false 可防止 InfluxDB 执行保留策略。

环境变量：INFLUXDB_RETENTION_ENABLED

check-interval = "30m0s"

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

环境变量：INFLUXDB_RETENTION_CHECK_INTERVAL

分片预创建设置

[shard-precreation]

[shard-precreation] 设置控制分片的预创建，以便分片在数据到达之前可用。仅创建那些在创建后将同时具有未来开始时间和结束时间的分片。永远不会预创建完全或部分在过去的分片。

enabled = true

确定是否启用分片预创建服务。

环境变量：INFLUXDB_SHARD_PRECREATION_ENABLED

check-interval = "10m"

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

环境变量：INFLUXDB_SHARD_PRECREATION_CHECK_INTERVAL

advance-period = "30m"

InfluxDB 预创建分片的最大未来周期。30m 默认值应适用于大多数系统。将此设置在未来设置得太远可能会导致效率低下。

环境变量：INFLUXDB_SHARD_PRECREATION_ADVANCE_PERIOD

监控设置

[monitor]

[monitor] 部分设置控制 InfluxDB 系统自我监控。

默认情况下，InfluxDB 将数据写入 _internal 数据库。如果该数据库不存在，InfluxDB 会自动创建它。_internal 数据库上的 DEFAULT 保留策略为七天。如果您想使用七天保留策略以外的保留策略，则必须创建它。

store-enabled = true

设置为 false 以禁用内部记录统计信息。如果设置为 false，则会使诊断安装问题变得更加困难。

环境变量：INFLUXDB_MONITOR_STORE_ENABLED

store-database = "_internal"

记录统计信息的目标数据库。

环境变量：INFLUXDB_MONITOR_STORE_DATABASE

store-interval = "10s"

InfluxDB 记录统计信息的时间间隔。默认值为每十秒 (10s)。

环境变量：INFLUXDB_MONITOR_STORE_INTERVAL

HTTP 端点设置

[http]

[http] 部分设置控制 InfluxDB 如何配置 HTTP 端点。这些是将数据传入和传出 InfluxDB 的主要机制。编辑此部分中的设置以启用 HTTPS 和身份验证。

有关启用 HTTPS 和身份验证的详细信息，请参阅 身份验证和授权。

enabled = true

确定是否启用 HTTP 端点。要禁用对 HTTP 端点的访问，请将值设置为 false。请注意，InfluxDB 命令行界面 (CLI) 使用 InfluxDB API 连接到数据库。

环境变量：INFLUXDB_HTTP_ENABLED

flux-enabled = false

确定是否启用 Flux 查询端点。要启用 Flux 查询的使用，请将值设置为 true。

环境变量：INFLUXDB_HTTP_FLUX_ENABLED

bind-address = ":8086"

HTTP 服务使用的绑定地址（端口）。

环境变量：INFLUXDB_HTTP_BIND_ADDRESS

auth-enabled = false

确定是否在 HTTP 和 HTTPS 上启用用户身份验证。要强制进行身份验证，请将值设置为 true。

环境变量：INFLUXDB_HTTP_AUTH_ENABLED

realm = "InfluxDB"

在发出基本身份验证质询时发送回的默认 realm。realm 是 HTTP 端点使用的 JWT realm。

环境变量：INFLUXDB_HTTP_REALM

log-enabled = true

确定是否启用 HTTP 请求日志记录。要禁用日志记录，请将值设置为 false。

环境变量：INFLUXDB_HTTP_LOG_ENABLED

suppress-write-log = false

确定在启用日志记录时是否应禁止 HTTP 写入请求日志。

access-log-path = ""

访问日志的路径，它确定是否使用 log-enabled = true 启用了详细的写入日志记录。指定启用 HTTP 请求日志记录时是否将其写入到指定路径。如果 influxd 无法访问指定路径，它将记录错误并回退到 stderr。启用 HTTP 请求日志记录后，此选项指定应在其中写入日志条目的路径。如果未指定，则默认写入 stderr，这会将 HTTP 日志与内部 InfluxDB 日志混合在一起。如果 influxd 无法访问指定路径，它将记录错误并回退到将请求日志写入 stderr。

环境变量：INFLUXDB_HTTP_ACCESS_LOG_PATH

access-log-status-filters = []

筛选应记录哪些请求。每个筛选器的模式为 nnn、nnx 或 nxx，其中 n 是数字，x 是任意数字的通配符。要筛选所有 5xx 响应，请使用字符串 5xx。如果使用多个筛选器，则只需匹配一个。默认值是没有筛选器，打印每个请求。

环境变量：INFLUXDB_HTTP_ACCESS_LOG_STATUS_FILTERS_x

示例

使用配置设置设置访问日志状态筛选器

access-log-status-filters = ["4xx", "5xx"]

"4xx" 在数组位置 0，"5xx" 在数组位置 1

使用环境变量设置访问日志状态筛选器

access-log-status-filters 的输入值是一个数组。当使用环境变量时，可以按如下方式提供值。

INFLUXDB_HTTP_ACCESS_LOG_STATUS_FILTERS_0=4xx

INFLUXDB_HTTP_ACCESS_LOG_STATUS_FILTERS_1=5xx

环境变量末尾的 _n 表示条目的数组位置。

write-tracing = false

确定是否启用详细的写入日志记录。设置为 true 以启用写入负载的日志记录。如果设置为 true，这将复制日志中的每个写入语句，因此不建议用于常规用途。

环境变量：INFLUXDB_HTTP_WRITE_TRACING

pprof-enabled = true

确定是否启用 /net/http/pprof HTTP 端点。对于故障排除和监控很有用。

环境变量：INFLUXDB_HTTP_PPROF_ENABLED

pprof-auth-enabled = false

在 /debug 端点上启用身份验证。如果启用，用户需要管理员权限才能访问以下端点

• /debug/pprof
• /debug/requests
• /debug/vars

如果 auth-enabled 或 pprof-enabled 设置为 false，则此设置无效。

环境变量：INFLUXDB_HTTP_PPROF_AUTH_ENABLED

debug-pprof-enabled = false

启用默认的 /pprof 端点并绑定到 localhost:6060。对于调试启动性能问题很有用。

环境变量：INFLUXDB_HTTP_DEBUG_PPROF_ENABLED

ping-auth-enabled = false

在 /ping、/metrics 和已弃用的 /status 端点上启用身份验证。如果 auth-enabled 设置为 false，则此设置无效。

环境变量：INFLUXDB_HTTP_PING_AUTH_ENABLED

prom-read-auth-enabled = false

在 Prometheus 远程读取 API 上启用身份验证。默认为 false。如果 auth-enabled 设置为 false，则此设置无效。

环境变量：INFLUXDB_HTTP_PROM_READ_AUTH_ENABLED

http-headers

用户提供的 HTTP 响应标头。配置此部分以返回 安全标头，例如 X-Frame-Options 或 Content Security Policy（如果需要）。

示例

[http.headers]
  X-Frame-Options = "DENY"

https-enabled = false

确定是否启用 HTTPS。要启用 HTTPS，请将值设置为 true。

环境变量：INFLUXDB_HTTP_HTTPS_ENABLED

https-certificate = "/etc/ssl/influxdb.pem"

启用 HTTPS 时要使用的 SSL 证书文件的路径。

环境变量：INFLUXDB_HTTP_HTTPS_CERTIFICATE

https-private-key = ""

使用单独的私钥位置。如果仅指定了 https-certificate，则 httpd 服务将尝试从 https-certificate 文件加载私钥。如果指定了单独的 https-private-key 文件，则 httpd 服务将从 https-private-key 文件加载私钥。

环境变量：INFLUXDB_HTTP_HTTPS_PRIVATE_KEY

shared-secret = ""

用于使用 JWT 令牌验证公共 API 请求的共享密钥。

环境变量：INFLUXDB_HTTP_SHARED_SECRET

max-row-limit = 0

系统可以在 非分块 查询中返回的最大行数。默认设置 (0) 允许无限数量的行。如果查询结果超过指定值，则 InfluxDB 在响应正文中包含 "partial":true 标记。

环境变量：INFLUXDB_HTTP_MAX_ROW_LIMIT

max-connection-limit = 0

可以同时打开的最大连接数。将丢弃超出限制的新连接。
默认值 0 禁用限制。

环境变量：INFLUXDB_HTTP_MAX_CONNECTION_LIMIT

unix-socket-enabled = false

通过 UNIX 域套接字启用 HTTP 服务。要通过 UNIX 域套接字启用 HTTP 服务，请将值设置为 true。

环境变量：INFLUXDB_HTTP_UNIX_SOCKET_ENABLED

bind-socket = "/var/run/influxdb.sock"

UNIX 域套接字的路径。

环境变量：INFLUXDB_HTTP_UNIX_BIND_SOCKET

max-body-size = 25000000

客户端请求主体的最大大小（以字节为单位）。当 HTTP 客户端发送的数据超过配置的最大大小时，将返回 413 Request Entity Too Large HTTP 响应。要禁用限制，请将值设置为 0。

环境变量：INFLUXDB_HTTP_MAX_BODY_SIZE

max-concurrent-write-limit = 0

可以并发处理的最大写入数。要禁用限制，请将值设置为 0。

环境变量：INFLUXDB_HTTP_MAX_CONCURRENT_WRITE_LIMIT

max-enqueued-write-limit = 0

排队等待处理的最大写入数。要禁用限制，请将值设置为 0。

环境变量：INFLUXDB_HTTP_MAX_ENQUEUED_WRITE_LIMIT

enqueued-write-timeout = 0

写入在队列中等待处理的最长持续时间。要禁用限制，请将其设置为 0 或将 max-concurrent-write-limit 值设置为 0。

环境变量：INFLUXDB_HTTP_ENQUEUED_WRITE_TIMEOUT

[http.headers]

使用 [http.headers] 部分配置用户提供的 HTTP 响应标头。

# [http.headers]
#   X-Header-1 = "Header Value 1"
#   X-Header-2 = "Header Value 2"

日志记录设置

[logging]

控制记录器如何将日志发送到输出。

format = "auto"

确定用于日志的日志编码器。有效值为 auto（默认）、logfmt 和 json。使用默认的 auto 选项，如果输出到 TTY 设备（例如，终端），则使用更用户友好的控制台编码。如果输出到文件，则 auto 选项使用 logfmt 编码。logfmt 和 json 选项对于与外部工具集成很有用。

环境变量：INFLUXDB_LOGGING_FORMAT

level = "info"

要发送的日志级别。有效值为 error、warn、info（默认）和 debug。将发送等于或高于指定级别的日志。

环境变量：INFLUXDB_LOGGING_LEVEL

suppress-logo = false

禁止在程序启动时打印的徽标输出。如果 STDOUT 不是 TTY，则始终禁止显示徽标。

环境变量：INFLUXDB_LOGGING_SUPPRESS_LOGO

订阅设置

[subscriber]

[subscriber] 部分控制 Kapacitor 将如何接收数据。

enabled = true

确定是否启用订阅者服务。要禁用订阅者服务，请将值设置为 false。

环境变量：INFLUXDB_SUBSCRIBER_ENABLED

http-timeout = "30s"

HTTP 写入订阅者的运行持续时间，直到超时。

环境变量：INFLUXDB_SUBSCRIBER_HTTP_TIMEOUT

insecure-skip-verify = false

确定是否允许与订阅者建立不安全的 HTTPS 连接。这在测试自签名证书时很有用。

环境变量：INFLUXDB_SUBSCRIBER_INSECURE_SKIP_VERIFY

ca-certs = ""

PEM 编码的 CA 证书文件的路径。如果值为空字符串 ("")，则将使用默认系统证书。

环境变量：INFLUXDB_SUBSCRIBER_CA_CERTS

write-concurrency = 40

处理写入通道的写入器 goroutine 的数量。

环境变量：INFLUXDB_SUBSCRIBER_WRITE_CONCURRENCY

write-buffer-size = 1000

写入通道中缓冲的正在进行的写入数。

环境变量：INFLUXDB_SUBSCRIBER_WRITE_BUFFER_SIZE

total-buffer-bytes = 0

分配给所有订阅的缓冲的总大小（以字节为单位）。每个命名的订阅都获得总数的平均分配。默认为 0。

环境变量：INFLUXDB_SUBSCRIBER_TOTAL_BUFFER_BYTES

Graphite 设置

[[graphite]]

此部分控制一个或多个 Graphite 数据的侦听器。有关更多信息，请参阅 InfluxDB 中的 Graphite 协议支持。

enabled = false

设置为 true 以启用 Graphite 输入。

环境变量：INFLUXDB_GRAPHITE_0_ENABLED

database = "graphite"

要写入的数据库的名称。

环境变量：INFLUXDB_GRAPHITE_0_DATABASE

retention-policy = ""

相关的保留策略。空字符串等同于数据库的 DEFAULT 保留策略。

环境变量：INFLUXDB_GRAPHITE_0_RETENTION_POLICY

bind-address = ":2003"

默认端口。

环境变量：INFLUXDB_GRAPHITE_0_BIND_ADDRESS

protocol = "tcp"

设置为 tcp 或 udp。

环境变量：INFLUXDB_GRAPHITE_PROTOCOL

consistency-level = "one"

必须确认写入的节点数。如果未满足要求，则返回值将是 partial write（如果批处理中的某些点失败）或 write failure（如果批处理中的所有点都失败）。有关更多信息，请参阅 InfluxDB 行协议语法参考中“写入的查询字符串参数”部分。

环境变量：INFLUXDB_GRAPHITE_CONSISTENCY_LEVEL

以下三个设置控制批处理的工作方式。您应该启用此功能，否则可能会丢失指标或性能不佳。如果您有很多传入的点，批处理将在内存中缓冲点。

batch-size = 5000

如果缓冲的点数达到此数量，输入将刷新。

环境变量：INFLUXDB_GRAPHITE_BATCH_SIZE

batch-pending = 10

可能在内存中挂起的批处理数。

环境变量：INFLUXDB_GRAPHITE_BATCH_PENDING

batch-timeout = "1s"

即使尚未达到配置的 batch-size，输入也至少会以如此频率刷新。

环境变量：INFLUXDB_GRAPHITE_BATCH_TIMEOUT

udp-read-buffer = 0

UDP 读取缓冲区大小，0 表示操作系统默认值。如果设置高于操作系统最大值，UDP 侦听器将失败。

环境变量：INFLUXDB_GRAPHITE_UDP_READ_BUFFER

separator = "."

此字符串连接多个匹配的“measurement”值，从而可以更好地控制最终的 measurement 名称。

环境变量：INFLUXDB_GRAPHITE_SEPARATOR

CollectD 设置

[[collectd]]

[[collectd]] 设置控制 collectd 数据的侦听器。有关更多信息，请参阅 InfluxDB 中的 CollectD 协议支持。

enabled = false

设置为 true 以启用 collectd 写入。

环境变量：INFLUXDB_COLLECTD_ENABLED

bind-address = ":25826"

端口。

环境变量：INFLUXDB_COLLECTD_BIND_ADDRESS

database = "collectd"

要写入的数据库的名称。默认为 collectd。

环境变量：INFLUXDB_COLLECTD_DATABASE

retention-policy = ""

相关的保留策略。空字符串等同于数据库的 DEFAULT 保留策略。

环境变量：INFLUXDB_COLLECTD_RETENTION_POLICY

typesdb = "/usr/local/share/collectd"

collectd 服务支持扫描目录以查找多个 types db 文件，或指定单个 db 文件。可以在 此处找到示例 types.db 文件。

环境变量：INFLUXDB_COLLECTD_TYPESDB

security-level = "none"

环境变量：INFLUXDB_COLLECTD_SECURITY_LEVEL

auth-file = "/etc/collectd/auth_file"

环境变量：INFLUXDB_COLLECTD_AUTH_FILE

以下三个设置控制批处理的工作方式。您应该启用此功能，否则可能会丢失指标或性能不佳。如果您有很多传入的点，批处理将在内存中缓冲点。

batch-size = 5000

如果缓冲的点数达到此数量，输入将刷新。

环境变量：INFLUXDB_COLLECTD_BATCH_SIZE

batch-pending = 10

可能在内存中挂起的批处理数。

环境变量：INFLUXDB_COLLECTD_BATCH_PENDING

batch-timeout = "10s"

即使尚未达到配置的 batch-size，输入也至少会以如此频率刷新。

环境变量：INFLUXDB_COLLECTD_BATCH_TIMEOUT

read-buffer = 0

UDP 读取缓冲区大小，0 表示操作系统默认值。如果设置高于操作系统最大值，UDP 侦听器将失败。

环境变量：INFLUXDB_COLLECTD_READ_BUFFER

parse-multivalue-plugin = "split"

当设置为 split 时，多值插件数据（例如 df free:5000,used:1000）将拆分为单独的 measurement（例如，(df_free, value=5000) (df_used, value=1000)）。当设置为 join 时，多值插件将存储为单个多值 measurement（例如，(df, free=5000,used=1000)）。默认为 split。

OpenTSDB 设置

[[opentsdb]]

控制 OpenTSDB 数据的侦听器。有关更多信息，请参阅 InfluxDB 中的 OpenTSDB 协议支持。

enabled = false

设置为 true 以启用 openTSDB 写入。

环境变量：INFLUXDB_OPENTSDB_0_ENABLED

bind-address = ":4242"

默认端口。

环境变量：INFLUXDB_OPENTSDB_BIND_ADDRESS

database = "opentsdb"

要写入的数据库的名称。如果数据库不存在，则在初始化输入时将自动创建该数据库。

环境变量：INFLUXDB_OPENTSDB_DATABASE

retention-policy = ""

相关的保留策略。空字符串等同于数据库的 DEFAULT 保留策略。

环境变量：INFLUXDB_OPENTSDB_RETENTION_POLICY

consistency-level = "one"

设置写入一致性级别：any、one、quorum 或 all 用于写入。

环境变量：INFLUXDB_OPENTSDB_CONSISTENCY_LEVEL

tls-enabled = false

环境变量：INFLUXDB_OPENTSDB_TLS_ENABLED

certificate = "/etc/ssl/influxdb.pem"

环境变量：INFLUXDB_OPENTSDB_CERTIFICATE

log-point-errors = true

为每个格式错误的点记录错误。

环境变量：INFLUXDB_OPENTSDB_0_LOG_POINT_ERRORS

以下三个设置控制批处理的工作方式。您应该启用此功能，否则可能会丢失指标或性能不佳。只有通过 telnet 协议接收的点指标才会进行批处理。

batch-size = 1000

如果缓冲的点数达到此数量，输入将刷新。

环境变量：INFLUXDB_OPENTSDB_BATCH_SIZE

batch-pending = 5

可能在内存中挂起的批处理数。

环境变量：INFLUXDB_OPENTSDB_BATCH_PENDING

batch-timeout = "1s"

即使尚未达到配置的 batch-size，输入也至少会以如此频率刷新。

环境变量：INFLUXDB_OPENTSDB_BATCH_TIMEOUT

UDP 设置

[[udp]]

[[udp]] 设置控制使用 UDP 的 InfluxDB 行协议数据的侦听器。有关更多信息，请参阅 InfluxDB 中的 UDP 协议支持。

enabled = false

确定是否启用 UDP 侦听器。要通过 UDP 启用写入，请将值设置为 true。

环境变量：INFLUXDB_UDP_ENABLED

bind-address = ":8089"

空字符串等同于 0.0.0.0。

环境变量：INFLUXDB_UDP_BIND_ADDRESS

database = "udp"

要写入的数据库的名称。

环境变量：INFLUXDB_UDP_DATABASE

retention-policy = ""

数据的相关保留策略。空字符串等同于数据库的 DEFAULT 保留策略。

环境变量：INFLUXDB_UDP_RETENTION_POLICY

以下三个设置控制批处理的工作方式。您应该启用此功能，否则可能会丢失指标或性能不佳。如果您有很多传入的点，批处理将在内存中缓冲点。

batch-size = 5000

如果缓冲的点数达到此数量，输入将刷新。

环境变量：INFLUXDB_UDP_0_BATCH_SIZE

batch-pending = 10

可能在内存中挂起的批处理数。

环境变量：INFLUXDB_UDP_0_BATCH_PENDING

batch-timeout = "1s"

即使尚未达到配置的 batch-size，输入也至少会以如此频率刷新。

环境变量：INFLUXDB_UDP_BATCH_TIMEOUT

read-buffer = 0

UDP 读取缓冲区大小，0 表示操作系统默认值。如果设置高于操作系统最大值，UDP 侦听器将失败。

环境变量：INFLUXDB_UDP_BATCH_SIZE

precision = ""

时间精度，在解码时间值时使用。默认为 nanoseconds，这是数据库的默认值。

环境变量：INFLUXDB_UDP_PRECISION

连续查询设置

[continuous_queries]

[continuous_queries] 设置控制 连续查询 (CQ) 在 InfluxDB 中的运行方式。连续查询是在最近的时间间隔内执行的自动批量查询。InfluxDB 为每个 GROUP BY time() 间隔执行一个自动生成的查询。

enabled = true

设置为 false 以禁用 CQ。

环境变量：INFLUXDB_CONTINUOUS_QUERIES_ENABLED

log-enabled = true

设置为 false 以禁用 CQ 事件的日志记录。

环境变量：INFLUXDB_CONTINUOUS_QUERIES_LOG_ENABLED

query-stats-enabled = false

设置为 true 时，连续查询执行统计信息将写入默认监视器存储。

环境变量：INFLUXDB_CONTINUOUS_QUERIES_QUERY_STATS_ENABLED

run-interval = "1s"

InfluxDB 检查以查看是否需要运行 CQ 的间隔。将此选项设置为 CQ 运行的最低间隔。例如，如果最频繁的 CQ 每分钟运行一次，请将 run-interval 设置为 1m。

环境变量：INFLUXDB_CONTINUOUS_QUERIES_RUN_INTERVAL

传输层安全 (TLS) 设置

[tls]

InfluxDB 中传输层安全 (TLS) 的全局配置设置。有关更多信息，请参阅 启用 HTTPS。

如果未指定 TLS 配置设置，则 InfluxDB 支持 Go crypto/tls 包文档的 常量部分 中列出的所有密码套件 ID 和所有 TLS 版本，具体取决于用于构建 InfluxDB 的 Go 版本。使用 SHOW DIAGNOSTICS 命令查看用于构建 InfluxDB 的 Go 版本。

“现代兼容性”的推荐服务器配置

InfluxData 建议将 InfluxDB 服务器的 TLS 设置配置为“现代兼容性”。这提供了更高的安全性，并假定不需要向后兼容性。我们推荐的 ciphers、min-version 和 max-version TLS 配置设置基于 Mozilla 在 安全/服务器端 TLS 中描述的“现代兼容性”TLS 服务器配置。

InfluxData 推荐的“现代兼容性”TLS 设置在以下配置设置示例中指定

ciphers = [ "TLS_AES_128_GCM_SHA256",
            "TLS_AES_256_GCM_SHA384",
            "TLS_CHACHA20_POLY1305_SHA256"
]

min-version = "tls1.3"

max-version = "tls1.3"

重要提示： ciphers 设置中密码套件 ID 的顺序决定了按优先级选择哪些算法。TLS min-version 和 max-version 设置将支持限制为 TLS 1.3。

ciphers = [ "TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305", "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256", ]

指定要协商的密码套件 ID 集。如果未指定，ciphers 支持 Go crypto/tls 包中列出的所有现有密码套件 ID。这与以前版本中的行为一致。在此示例中，仅支持指定的两个密码套件 ID。

环境变量：INFLUXDB_TLS_CIPHERS

min-version = "tls1.0"

将协商的 TLS 协议的最低版本。有效值包括：tls1.0、tls1.1、tls1.2 和 tls1.3。如果未指定，min-version 是 Go crypto/tls 包中指定的最低 TLS 版本。在此示例中，tls1.0 将最低版本指定为 TLS 1.0，这与以前 InfluxDB 版本的行为一致。

环境变量：INFLUXDB_TLS_MIN_VERSION

max-version = "tls1.3"

将协商的 TLS 协议的最高版本。有效值包括：tls1.0、tls1.1、tls1.2 和 tls1.3。如果未指定，max-version 是 Go crypto/tls 包中指定的最高 TLS 版本。在此示例中，tls1.3 将最高版本指定为 TLS 1.3，这与以前 InfluxDB 版本的行为一致。

环境变量：INFLUXDB_TLS_MAX_VERSION