pd-server

来源 1 浏览 360 扫码打印 2023-05-09 09:09:04

- flow-round-by-digit 从 v5.1 版本开始引入
log
log.file
metric
schedule
replication
label-property

PD 配置文件描述

本文档只阐述未包含在命令行参数中的参数，命令行参数参见 PD 配置参数。

小贴士

如果你需要调整配置项的值，请参考进行操作。

PD 节点名称。
默认值："pd"
如果你需要启动多个 PD，一定要给 PD 使用不同的名字。

`data-dir`

PD 存储数据路径。

`client-urls`

PD 监听的客户端 URL 列表。
默认值："http://127.0.0.1:2379"
如果部署一个集群，client URLs 必须指定当前主机的 IP 地址，例如 "http://192.168.100.113:2379"，如果是运行在 Docker 则需要指定为 "http://0.0.0.0:2379"。

`advertise-client-urls`

用于外部访问 PD 的 URL 列表。
默认值："${client-urls}"
在某些情况下，例如 Docker 或者 NAT 网络环境，客户端并不能通过 PD 自己监听的 client URLs 来访问到 PD，这时候，你就可以设置 advertise URLs 来让客户端访问。
例如，Docker 内部 IP 地址为 172.17.0.1，而宿主机的 IP 地址为 192.168.100.113 并且设置了端口映射 -p 2379:2379，那么可以设置为 advertise-client-urls="http://192.168.100.113:2379"，客户端可以通过 http://192.168.100.113:2379 来找到这个服务。

`peer-urls`

PD 节点监听其他 PD 节点的 URL 列表。
默认："http://127.0.0.1:2380"
如果部署一个集群，peer URLs 必须指定当前主机的 IP 地址，例如 "http://192.168.100.113:2380"，如果是运行在 Docker 则需要指定为 "http://0.0.0.0:2380"。

`advertise-peer-urls`

用于其他 PD 节点访问某个 PD 节点的 URL 列表。
默认值："${peer-urls}"
在某些情况下，例如 Docker 或者 NAT 网络环境，其他节点并不能通过 PD 自己监听的 peer URLs 来访问到 PD，这时候，你就可以设置 advertise URLs 来让其他节点访问
例如，Docker 内部 IP 地址为 172.17.0.1，而宿主机的 IP 地址为 192.168.100.113 并且设置了端口映射 -p 2380:2380，那么可以设置为 advertise-peer-urls="http://192.168.100.113:2380"，其他 PD 节点可以通过 http://192.168.100.113:2380 来找到这个服务。

`initial-cluster`

初始化 PD 集群配置。
默认值："{name}=http://{advertise-peer-url}"
例如，如果 name 是 “pd”，并且 advertise-peer-urls 是 "http://192.168.100.113:2380"，那么 initial-cluster 就是 "pd=http://192.168.100.113:2380"。
如果启动三台 PD，那么 initial-cluster 可能就是 pd1=http://192.168.100.113:2380, pd2=http://192.168.100.114:2380, pd3=192.168.100.115:2380。

`initial-cluster-state`

集群初始状态
默认值：”new”

`initial-cluster-token`

用于在集群初始化阶段标识不同的集群。
默认值：”pd-cluster”
如果先后部署多个集群，且多个集群有相同配置的节点，应指定不同的 token 来隔离不同的集群。

`lease`

PD Leader Key 租约超时时间，超时系统重新选举 Leader。
默认值：3
单位：秒

`quota-backend-bytes`

元信息数据库存储空间的大小，默认 8GiB。
默认值：8589934592

`auto-compaction-mod`

元信息数据库自动压缩的模式，可选项为 periodic（按周期），revision（按版本数）。
默认值：periodic

`auto-compaction-retention`

compaction-mode 为 periodic 时为元信息数据库自动压缩的间隔时间；compaction-mode 设置为 revision 时为自动压缩的版本数。
默认值：1h

`force-new-cluster`

强制让该 PD 以一个新集群启动，且修改 raft 成员数为 1。
默认值：false

`tso-update-physical-interval`

TSO 物理时钟更新周期。
在默认的一个 TSO 物理时钟更新周期内 (50ms)，PD 最多提供 262144 个 TSO。如果需要更多的 TSO，可以将这个参数调小。最小值为 1ms。
缩短这个参数会增加 PD 的 CPU 消耗。根据测试，相比 50ms 更新周期，更新周期为 1ms 时，PD 的 CPU 占用率 () 将增加约 10%。
默认值：50ms
最小值：1ms

pd-server 相关配置项。

`flow-round-by-digit` 从 v5.1 版本开始引入

默认值：3
PD 会对流量信息的末尾数字进行四舍五入处理，减少 Region 流量信息变化引起的统计信息更新。该配置项用于指定对 Region 流量信息的末尾进行四舍五入的位数。例如流量 100512 会归约到 101000。默认值为 3。该配置替换了 trace-region-flow。

注意

security

安全相关配置项。

`cacert-path`

CA 文件路径
默认值：””

`cert-path`

包含 X509 证书的 PEM 文件路径
默认值：””

`key-path`

包含 X509 key 的 PEM 文件路径
默认值：””

`redact-info-log` 从 v5.0 版本开始引入

控制 PD 日志脱敏的开关
该配置项值设为 true 时将对 PD 日志脱敏，遮蔽日志中的用户信息。
默认值：false

log

日志相关的配置项。

指定日志的输出级别。
可选值：”debug”，”info”，”warn”，”error”，”fatal”
默认值：”info”

`format`

日志格式。
可选值：”text”，”json”
默认值：”text”

`disable-timestamp`

是否禁用日志中自动生成的时间戳。
默认值：false

日志文件相关的配置项。

`max-size`

单个日志文件最大大小，超过该值系统自动切分成多个文件。
默认值：300
单位：MiB
最小值为 1

`max-days`

日志保留的最长天数。
如果未设置本参数或把本参数设置为默认值 0，PD 不清理日志文件。
默认：0

`max-backups`

日志文件保留的最大个数。
如果未设置本参数或把本参数设置为默认值 0，PD 会保留所有的日志文件。
默认：0

metric

监控相关的配置项。

`interval`

向 Prometheus 推送监控指标数据的间隔时间。
默认：15s

schedule

调度相关的配置项。

`max-merge-region-size`

控制 Region Merge 的 size 上限，当 Region Size 大于指定值时 PD 不会将其与相邻的 Region 合并。
默认：20
单位：MiB

`max-merge-region-keys`

控制 Region Merge 的 key 上限，当 Region key 大于指定值时 PD 不会将其与相邻的 Region 合并。
默认：200000

`patrol-region-interval`

默认：10ms

`split-merge-interval`

控制对同一个 Region 做 split 和 merge 操作的间隔，即对于新 split 的 Region 一段时间内不会被 merge。
默认：1h

`max-snapshot-count`

控制单个 store 最多同时接收或发送的 snapshot 数量，调度受制于这个配置来防止抢占正常业务的资源。
默认：64

`max-pending-peer-count`

控制单个 store 的 pending peer 上限，调度受制于这个配置来防止在部分节点产生大量日志落后的 Region。
默认值：64

`max-store-down-time`

PD 认为失联 store 无法恢复的时间，当超过指定的时间没有收到 store 的心跳后，PD 会在其他节点补充副本。
默认值：30m

`max-store-preparing-time` 从 v6.1.0 版本开始引入

控制 store 上线阶段的最长等待时间。在 store 的上线阶段，PD 可以查询该 store 的上线进度。当超过该配置项指定的时间后，PD 会认为该 store 已完成上线，无法再次查询这个 store 的上线进度，但是不影响 Region 向这个新上线 store 的迁移。通常用户无需修改该配置项。
默认值：48h

`leader-schedule-limit`

同时进行 leader 调度的任务个数。
默认值：4

`region-schedule-limit`

同时进行 Region 调度的任务个数
默认值：2048

`hot-region-schedule-limit`

控制同时进行的 hot Region 任务。该配置项独立于 Region 调度。
默认值：4

`hot-region-cache-hits-threshold`

设置识别热点 Region 所需的分钟数。只有当 Region 处于热点状态持续时间超过此分钟数时，PD 才会参与热点调度。
默认值：3

`replica-schedule-limit`

同时进行 replica 调度的任务个数。
默认值：64

同时进行的 Region Merge 调度的任务，设置为 0 则关闭 Region Merge。
默认值：8

`high-space-ratio`

设置 store 空间充裕的阈值。当节点的空间占用比例小于该阈值时，PD 调度时会忽略节点的剩余空间，主要根据实际数据量进行均衡。此配置仅在 region-score-formula-version = v1 时生效。
默认值：0.7
最小值：大于 0
最大值：小于 1

`low-space-ratio`

设置 store 空间不足的阈值。当某个节点的空间占用比例超过该阈值时，PD 会尽可能避免往该节点迁移数据，同时主要根据节点剩余空间大小进行调度，避免对应节点的磁盘空间被耗尽。
默认值：0.8
最小值：大于 0
最大值：小于 1

`tolerant-size-ratio`

控制 balance 缓冲区大小。
默认值：0（为 0 为自动调整缓冲区大小）
最小值：0

`enable-cross-table-merge`

设置是否开启跨表 merge。
默认值：true

`region-score-formula-version` 从 v5.0 版本开始引入

设置 Region 算分公式版本。
默认值：v2
可选值：v1，v2。v2 相比于 v1，变化会更平滑，空间回收引起的调度抖动情况会得到改善。

如果是从 v4.0 升级至当前版本，默认不自动开启该算分公式新版本，以保证升级前后 PD 行为一致。若想切换算分公式的版本，使用需要手动通过 pd-ctl 设置切换，详见文档。

`enable-joint-consensus` 从 v5.0 版本开始引入

是否使用 Joint Consensus 进行副本调度。关闭该特性时，PD 将采用一次调度一个副本的方式进行调度。
默认值：true

`enable-diagnostic` 从 v6.3.0 版本开始引入

是否开启诊断功能。开启特性时，PD 将会记录调度中的一些状态来帮助诊断。开启时会略微影响调度速度，在 Store 数量较多时会消耗较大内存。
默认值：false

`hot-regions-write-interval` 从 v5.4.0 版本开始引入

设置 PD 存储 Hot Region 信息时间间隔。
默认值：10m

注意

Hot Region 的信息一般 3 分钟更新一次。如果设置时间间隔小于 3 分钟，中间部分的更新可能没有意义。

`hot-regions-reserved-days` 从 v5.4.0 版本开始引入

设置 PD 保留的 Hot Region 信息的最长时间。单位为天。
默认值: 7

副本相关的配置项。

`max-replicas`

所有副本数量，即 leader 与 follower 数量之和。默认为 3，即 1 个 leader 和 2 个 follower。当此配置被在线修改后，PD 会在后台通过调度使得 Region 的副本数量符合配置。
默认值：3

`location-labels`

TiKV 集群的拓扑信息。
默认值：[]

`isolation-level`

TiKV 集群的最小强制拓扑隔离级别。
默认值：””

`strictly-match-label`

打开强制 TiKV Label 和 PD 的 location-labels 是否匹配的检查
默认值：false

`enable-placement-rules`

打开 placement-rules
默认值：true
参考 Placement Rules 使用文档

label-property

标签相关的配置项。

`key`

拒绝 leader 的 store 带有的 label key。
默认值：””

`value`

拒绝 leader 的 store 带有的 label value。
默认值：””

dashboard

`tidb-cacert-path`

CA 根证书文件路径。可配置该路径来使用 TLS 连接 TiDB 的 SQL 服务。
默认值：””

`tidb-cert-path`

SSL 证书文件路径。可配置该路径来使用 TLS 连接 TiDB 的 SQL 服务。
默认值：””

`tidb-key-path`

SSL 私钥文件路径。可配置该路径来使用 TLS 连接 TiDB 的 SQL 服务。
默认值：””

通过反向代理访问 TiDB Dashboard 时，配置反向代理提供服务的路径前缀。
默认值：”/dashboard”
若不通过反向代理访问 TiDB Dashboard，请勿配置该项，否则可能导致 TiDB Dashboard 无法正常访问。关于该配置的详细使用场景，参见。

`enable-telemetry`

是否启用 TiDB Dashboard 遥测功能。
默认值：对于 TiDB v6.5.0，默认值为 true；对于 v6.5.1 以及之后的 v6.5.x 版本，默认值为 false。

本文档使用全库网构建