Storage服务配置

Storage服务配置

Storage服务提供了两份初始配置文件nebula-storaged.conf.default和nebula-storaged.conf.production，方便您在不同场景中使用。文件的默认路径为/usr/local/nebula/etc/。

说明：Raft Listener的配置和Storage服务配置不同，详情请参见部署Raft listener。

配置文件使用方式

首次启动时，Storage服务会从配置文件nebula-storaged.conf中读取配置信息。您需要把初始配置文件的后缀.default或.production删除，Storage服务才能将其识别为配置文件。

如果修改了配置文件，希望新配置生效，请在配置文件开头添加--local_config=true再重启服务，否则会从缓存中读取过期配置。

配置文件参数值说明

如果配置文件内没有设置某个参数，表示参数使用的是默认值。

配置文件内只预设了部分参数的值，而且两份初始配置文件内的参数值也略有不同，本文的预设值以nebula-storaged.conf.default为准。

basics配置

名称	预设值	说明
`daemonize`	`true`	是否启动守护进程。
`pid_file`	`pids/nebula-storaged.pid`	记录进程ID的文件。
`timezone_name`	-	指定Nebula Graph的时区。初始配置文件中未设置该参数，如需使用请手动添加。系统默认值为`UTC+00:00:00`。格式请参见Specifying the Time Zone with TZ。例如，东八区的设置方式为`—timezone_name=CST-8`。

说明：

在插入时间类型的属性值时，Nebula Graph会根据timezone_name设置的时区将该时间值转换成相应的UTC时间，因此在查询中返回的时间类型属性值为UTC时间。
timezone_name参数只用于转换Nebula Graph中存储的数据，Nebula Graph进程中其它时区相关数据，例如日志打印的时间等，仍然使用主机系统默认的时区。

logging配置

名称	预设值	说明
`log_dir`	`logs`	存放Storage服务日志的目录，建议和数据保存在不同硬盘。
`minloglevel`	`0`	最小日志级别，即不会记录低于这个级别的日志。可选值为`0`（INFO）、`1`（WARNING）、`2`（ERROR）、`3`（FATAL）。建议您在调试时设置为`0`，生产环境中设置为`1`。如果设置为`4`，Nebula Graph不会记录任何日志。
`v`	`0`	日志详细级别，值越大，日志记录越详细。可选值为`0`、`1`、`2`、`3`。
`logbufsecs`	`0`	缓冲日志的最大时间，超时后输出到日志文件。`0`表示实时输出。单位：秒。
`redirect_stdout`	`true`	是否将标准输出和标准错误重定向到单独的输出文件。
`stdout_log_file`	`storaged-stdout.log`	标准输出日志文件名称。
`stderr_log_file`	`storaged-stderr.log`	标准错误日志文件名称。
`stderrthreshold`	`2`	要复制到标准错误中的最小日志级别（`minloglevel`）。

networking配置

名称	预设值	说明
`meta_server_addrs`	`127.0.0.1:9559`	全部Meta服务的IP地址和端口。多个Meta服务用英文逗号（,）分隔。
`local_ip`	`127.0.0.1`	Storage服务的本地IP地址。本地IP地址用于识别nebula-storaged进程，如果是分布式集群或需要远程访问，请修改为对应地址。
`port`	`9779`	Storage服务的RPC守护进程监听端口。Storage服务对外端口为`9779`，对内端口为`9777`、`9778`和`9780`，Nebula Graph使用内部端口进行多副本间的交互。
`ws_ip`	`0.0.0.0`	HTTP服务的IP地址。
`ws_http_port`	`19779`	HTTP服务的端口。
`ws_h2_port`	`19780`	HTTP2服务的端口。
`heartbeat_interval_secs`	`10`	默认心跳间隔。请确保所有服务的`heartbeat_interval_secs`取值相同，否则会导致系统无法正常工作。单位：秒。

NOTE: 建议您在配置文件中使用真实的IP地址，因为某些情况下127.0.0.1无法正确解析。

raft配置

名称	预设值	说明
`raft_heartbeat_interval_secs`	`30`	Raft选举超时时间。单位：秒。
`raft_rpc_timeout_ms`	`500`	Raft客户端的远程过程调用（RPC）超时时间。单位：毫秒。
`wal_ttl`	`14400`	Raft WAL的生存时间。单位：秒。

disk配置

名称	默认值	说明
`data_path`	`data/storage`	数据存储路径，多个路径用英文逗号（,）分隔。一个RocksDB实例对应一个路径。
`rocksdb_batch_size`	`4096`	批量操作的缓存大小。单位：字节。
`rocksdb_block_cache`	`4`	BlockBasedTable的默认块缓存大小。单位：兆（MB）。
`engine_type`	`rocksdb`	存储引擎类型。
`rocksdb_compression`	`lz4`	压缩算法，可选值为`no`、`snappy`、`lz4`、`lz4hc`、`zlib`、`bzip2`和`zstd`。
`rocksdb_compression_per_level`	-	为不同级别设置不同的压缩算法。
`enable_rocksdb_statistics`	`false`	是否启用RocksDB的数据统计。
`rocksdb_stats_level`	`kExceptHistogramOrTimers`	RocksDB的数据统计级别。可选值为`kExceptHistogramOrTimers`（禁用计时器统计，跳过柱状图统计）、`kExceptTimers`（跳过计时器统计）、`kExceptDetailedTimers`（收集除互斥锁和压缩花费时间之外的所有统计数据）、`kExceptTimeForMutex`收集除互斥锁花费时间之外的所有统计数据）和`kAll`（收集所有统计数据）。
`enable_rocksdb_prefix_filtering`	`false`	是否启用prefix bloom filter。
`enable_rocksdb_whole_key_filtering`	`true`	是否启用whole key bloom filter。
`rocksdb_filtering_prefix_length`	`12`	每个key的prefix长度。可选值为`12`（分片ID+点ID）和`16`（分片ID+点ID+标签ID/边类型ID）。单位：字节。

rocksdb options配置

名称	预设值	说明
`rocksdb_db_options`	`{}`	RocksDB database选项。
`rocksdb_column_family_options`	`{“write_buffer_size”:”67108864”,` `“max_write_buffer_number”:”4”,` `“max_bytes_for_level_base”:”268435456”}`	RocksDB column family选项。
`rocksdb_block_based_table_options`	`{“block_size”:”8192”}`	RocksDB block based table选项。

rocksdb options配置的格式为{"<option_name>":"<option_value>"}，多个选项用英文逗号（,）隔开。

rocksdb_db_options和rocksdb_column_family_options支持的选项如下：

rocksdb_db_options

max_total_wal_size
delete_obsolete_files_period_micros
max_background_jobs
stats_dump_period_sec
compaction_readahead_size
writable_file_max_buffer_size
bytes_per_sync
wal_bytes_per_sync
delayed_write_rate
avoid_flush_during_shutdown
max_open_files
stats_persist_period_sec
stats_history_buffer_size
strict_bytes_per_sync
enable_rocksdb_prefix_filtering
enable_rocksdb_whole_key_filtering
rocksdb_filtering_prefix_length
num_compaction_threads
rate_limit

rocksdb_column_family_options

write_buffer_size
max_write_buffer_number
level0_file_num_compaction_trigger
level0_slowdown_writes_trigger
level0_stop_writes_trigger
target_file_size_base
target_file_size_multiplier
max_bytes_for_level_base
max_bytes_for_level_multiplier
disable_auto_compactions

参数的详细说明请参见RocksDB官方文档。