The contents of this file are generated from the output of the --helpxml
flag for each binary, during the build of the documentation. Do not edit this file
or the included files manually.
kudu-master FlagsFlags tagged stable and not advanced are safe to use for common
configuration tasks.
--log_force_fsync_allWhether the Log/WAL should explicitly call fsync() after each write.
Type |
bool |
|---|---|
Default |
|
Tags |
stable |
--fs_data_dirsComma-separated list of directories with data blocks. If this is not specified, fs_wal_dir will be used as the sole data block directory.
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--fs_wal_dirDirectory with write-ahead logs. If this is not specified, the program will not start. May be the same as fs_data_dirs
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--master_addressesComma-separated list of the RPC addresses belonging to all Masters in this cluster. NOTE: if not specified, configures a non-replicated Master.
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--keytab_filePath to the Kerberos Keytab file for this server. Specifying a keytab file will cause the server to kinit, and enable Kerberos to be used to authenticate RPC connections.
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--rpc_bind_addressesComma-separated list of addresses to bind to for RPC connections. Currently, ephemeral ports (i.e. port 0) are not allowed.
Type |
string |
|---|---|
Default |
|
Tags |
stable |
--superuser_aclThe list of usernames to allow as super users, comma-separated. A '*' entry indicates that all authenticated users are allowed. If this is left unset or blank, the default behavior is that the identity of the daemon itself determines the superuser. If the daemon is logged in from a Keytab, then the local username from the Kerberos principal is used; otherwise, the local Unix username is used.
Type |
string |
|---|---|
Default |
none |
Tags |
sensitive,stable |
--user_aclThe list of usernames who may access the cluster, comma-separated. A '*' entry indicates that all authenticated users are allowed.
Type |
string |
|---|---|
Default |
|
Tags |
sensitive,stable |
--webserver_certificate_fileThe location of the debug webserver’s SSL certificate file, in PEM format. If empty, webserver SSL support is not enabled
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--webserver_private_key_fileThe full path to the private key used as a counterpart to the public key contained in --ssl_server_certificate. If --ssl_server_certificate is set, this option must be set as well.
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--webserver_private_key_password_cmdA Unix command whose output returns the password used to decrypt the Webserver’s certificate private key file specified in --webserver_private_key_file. If the PEM key file is not password-protected, this command will not be invoked. The output of the command will be truncated to 1024 bytes, and then all trailing whitespace will be trimmed before it is used to decrypt the private key
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--log_filenamePrefix of log filename - full path is <log_dir>/<log_filename>.[INFO|WARN|ERROR|FATAL]
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--maintenance_manager_num_threadsSize of the maintenance manager thread pool. For spinning disks, the number of threads should not be above the number of devices.
Type |
int32 |
|---|---|
Default |
|
Tags |
stable |
--memory_limit_hard_bytesMaximum amount of memory this daemon should use, in bytes. A value of 0 autosizes based on the total system memory. A value of -1 disables all memory limiting.
Type |
int64 |
|---|---|
Default |
|
Tags |
stable |
--helpshow help on all flags [tip: all flags can have two dashes]
Type |
bool |
|---|---|
Default |
|
Tags |
stable |
--colorlogtostderrcolor messages logged to stderr (if supported by terminal)
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,stable |
--log_dirIf specified, logfiles are written into this directory instead of the default logging directory.
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--logtostderrlog messages go to stderr instead of logfiles
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,stable |
--max_log_sizeapprox. maximum log file size (in MB). A value of 0 will be silently overridden to 1.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,stable |
Flags tagged stable and advanced are supported, but should be considered
"expert" options and should be used carefully and after thorough testing.
--enable_process_lifetime_heap_profilingEnables heap profiling for the lifetime of the process. Profile output will be stored in the directory specified by -heap_profile_path. Enabling this option will disable the on-demand/remote server profile handlers.
Type |
bool |
|---|---|
Default |
|
Tags |
advanced,stable |
--heap_profile_pathOutput path to store heap profiles. If not set profiles are stored in /tmp/<process-name>.<pid>.<n>.heap.
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--unlock_experimental_flagsUnlock flags marked as 'experimental'. These flags are not guaranteed to be maintained across releases of Kudu, and may enable features or behavior known to be unstable. Use at your own risk.
Type |
bool |
|---|---|
Default |
|
Tags |
stable,advanced |
--unlock_unsafe_flagsUnlock flags marked as 'unsafe'. These flags are not guaranteed to be maintained across releases of Kudu, and enable features or behavior known to be unsafe. Use at your own risk.
Type |
bool |
|---|---|
Default |
|
Tags |
stable,advanced |
--fromenvset flags from the environment [use 'export FLAGS_flag1=value']
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--tryfromenvset flags from the environment if present
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--undefokcomma-separated list of flag names that it is okay to specify on the command line even if the program does not define a flag with that name. IMPORTANT: flags in this list that have arguments MUST use the flag=value format
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--helpmatchshow help on modules whose name contains the specified substr
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--helponshow help on the modules named by this flag value
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--helppackageshow help on all modules in the main package
Type |
bool |
|---|---|
Default |
|
Tags |
advanced,stable |
--helpshortshow help on only the main module for this program
Type |
bool |
|---|---|
Default |
|
Tags |
advanced,stable |
--log_linkPut additional links to the log files in this directory
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--log_prefixPrepend the log prefix to the start of each log line
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,advanced,stable |
--minloglevelMessages logged at a lower level than this don’t actually get logged anywhere
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced,stable |
--stderrthresholdlog messages at or above this level are copied to stderr in addition to logfiles. This flag obsoletes --alsologtostderr.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced,stable |
--stop_logging_if_full_diskStop attempting to log to disk if the disk is full.
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,advanced,stable |
--symbolize_stacktraceSymbolize the stack trace in the tombstone
Type |
bool |
|---|---|
Default |
|
Tags |
advanced,runtime,stable |
--vShow all VLOG(m) messages for m ⇐ this. Overridable by --vmodule.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced,stable |
--vmoduleper-module verbose level. Argument is a comma-separated list of <module name>=<log level>. <module name> is a glob pattern, matched against the filename base (that is, name ignoring .cc/.h./-inl.h). <log level> overrides any value given by --v.
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
kudu-tserver FlagsFlags tagged stable and not advanced are safe to use for common
configuration tasks.
--log_force_fsync_allWhether the Log/WAL should explicitly call fsync() after each write.
Type |
bool |
|---|---|
Default |
|
Tags |
stable |
--fs_data_dirsComma-separated list of directories with data blocks. If this is not specified, fs_wal_dir will be used as the sole data block directory.
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--fs_wal_dirDirectory with write-ahead logs. If this is not specified, the program will not start. May be the same as fs_data_dirs
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--keytab_filePath to the Kerberos Keytab file for this server. Specifying a keytab file will cause the server to kinit, and enable Kerberos to be used to authenticate RPC connections.
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--rpc_bind_addressesComma-separated list of addresses to bind to for RPC connections. Currently, ephemeral ports (i.e. port 0) are not allowed.
Type |
string |
|---|---|
Default |
|
Tags |
stable |
--superuser_aclThe list of usernames to allow as super users, comma-separated. A '*' entry indicates that all authenticated users are allowed. If this is left unset or blank, the default behavior is that the identity of the daemon itself determines the superuser. If the daemon is logged in from a Keytab, then the local username from the Kerberos principal is used; otherwise, the local Unix username is used.
Type |
string |
|---|---|
Default |
none |
Tags |
sensitive,stable |
--user_aclThe list of usernames who may access the cluster, comma-separated. A '*' entry indicates that all authenticated users are allowed.
Type |
string |
|---|---|
Default |
|
Tags |
sensitive,stable |
--webserver_certificate_fileThe location of the debug webserver’s SSL certificate file, in PEM format. If empty, webserver SSL support is not enabled
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--webserver_private_key_fileThe full path to the private key used as a counterpart to the public key contained in --ssl_server_certificate. If --ssl_server_certificate is set, this option must be set as well.
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--webserver_private_key_password_cmdA Unix command whose output returns the password used to decrypt the Webserver’s certificate private key file specified in --webserver_private_key_file. If the PEM key file is not password-protected, this command will not be invoked. The output of the command will be truncated to 1024 bytes, and then all trailing whitespace will be trimmed before it is used to decrypt the private key
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--tserver_master_addrsComma separated addresses of the masters which the tablet server should connect to. The masters do not read this flag — configure the masters separately using 'rpc_bind_addresses'.
Type |
string |
|---|---|
Default |
|
Tags |
stable |
--log_filenamePrefix of log filename - full path is <log_dir>/<log_filename>.[INFO|WARN|ERROR|FATAL]
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--maintenance_manager_num_threadsSize of the maintenance manager thread pool. For spinning disks, the number of threads should not be above the number of devices.
Type |
int32 |
|---|---|
Default |
|
Tags |
stable |
--memory_limit_hard_bytesMaximum amount of memory this daemon should use, in bytes. A value of 0 autosizes based on the total system memory. A value of -1 disables all memory limiting.
Type |
int64 |
|---|---|
Default |
|
Tags |
stable |
--helpshow help on all flags [tip: all flags can have two dashes]
Type |
bool |
|---|---|
Default |
|
Tags |
stable |
--colorlogtostderrcolor messages logged to stderr (if supported by terminal)
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,stable |
--log_dirIf specified, logfiles are written into this directory instead of the default logging directory.
Type |
string |
|---|---|
Default |
none |
Tags |
stable |
--logtostderrlog messages go to stderr instead of logfiles
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,stable |
--max_log_sizeapprox. maximum log file size (in MB). A value of 0 will be silently overridden to 1.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,stable |
Flags tagged stable and advanced are supported, but should be considered
"expert" options and should be used carefully and after thorough testing.
--enable_process_lifetime_heap_profilingEnables heap profiling for the lifetime of the process. Profile output will be stored in the directory specified by -heap_profile_path. Enabling this option will disable the on-demand/remote server profile handlers.
Type |
bool |
|---|---|
Default |
|
Tags |
advanced,stable |
--heap_profile_pathOutput path to store heap profiles. If not set profiles are stored in /tmp/<process-name>.<pid>.<n>.heap.
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--unlock_experimental_flagsUnlock flags marked as 'experimental'. These flags are not guaranteed to be maintained across releases of Kudu, and may enable features or behavior known to be unstable. Use at your own risk.
Type |
bool |
|---|---|
Default |
|
Tags |
stable,advanced |
--unlock_unsafe_flagsUnlock flags marked as 'unsafe'. These flags are not guaranteed to be maintained across releases of Kudu, and enable features or behavior known to be unsafe. Use at your own risk.
Type |
bool |
|---|---|
Default |
|
Tags |
stable,advanced |
--fromenvset flags from the environment [use 'export FLAGS_flag1=value']
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--tryfromenvset flags from the environment if present
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--undefokcomma-separated list of flag names that it is okay to specify on the command line even if the program does not define a flag with that name. IMPORTANT: flags in this list that have arguments MUST use the flag=value format
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--helpmatchshow help on modules whose name contains the specified substr
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--helponshow help on the modules named by this flag value
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--helppackageshow help on all modules in the main package
Type |
bool |
|---|---|
Default |
|
Tags |
advanced,stable |
--helpshortshow help on only the main module for this program
Type |
bool |
|---|---|
Default |
|
Tags |
advanced,stable |
--log_linkPut additional links to the log files in this directory
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
--log_prefixPrepend the log prefix to the start of each log line
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,advanced,stable |
--minloglevelMessages logged at a lower level than this don’t actually get logged anywhere
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced,stable |
--stderrthresholdlog messages at or above this level are copied to stderr in addition to logfiles. This flag obsoletes --alsologtostderr.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced,stable |
--stop_logging_if_full_diskStop attempting to log to disk if the disk is full.
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,advanced,stable |
--symbolize_stacktraceSymbolize the stack trace in the tombstone
Type |
bool |
|---|---|
Default |
|
Tags |
advanced,runtime,stable |
--vShow all VLOG(m) messages for m ⇐ this. Overridable by --vmodule.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced,stable |
--vmoduleper-module verbose level. Argument is a comma-separated list of <module name>=<log level>. <module name> is a glob pattern, matched against the filename base (that is, name ignoring .cc/.h./-inl.h). <log level> overrides any value given by --v.
Type |
string |
|---|---|
Default |
none |
Tags |
advanced,stable |
The contents of this file are generated from the output of the --helpxml
flag for each binary, during the build of the documentation. Do not edit this file
or the included files manually.
| These flags are unsupported and are included for informational purposes only. They are subject to change or be removed at any time. |
kudu-master Unsupported FlagsFlags marked advanced or experimental and not marked stable, or flags with no stability tag, are unsupported and are included
for informational purposes only. They are subject to change or be removed without notice.
--block_cache_typeWhich type of block cache to use for caching data. Valid choices are 'DRAM' or 'NVM'. DRAM, the default, caches data in regular memory. 'NVM' caches data in a memory-mapped file using the NVML library.
Type |
string |
|---|---|
Default |
|
Tags |
experimental |
--min_compression_ratioIf a column compression codec is configured, but the codec is unable to achieve a compression ratio at least as good as the configured value, then the data will be written uncompressed. This will reduce CPU overhead on the read side at the expense of a small amount of extra space if the codec encounters portions of data that are not easily compressible.
Type |
double |
|---|---|
Default |
|
Tags |
experimental |
--cfile_default_block_sizeThe default block size to use in cfiles
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--cfile_default_compression_codecDefault cfile block compression codec.
Type |
string |
|---|---|
Default |
|
Tags |
advanced |
--cfile_do_on_finishWhat to do to cfile blocks when writing is finished. Possible values are 'close', 'flush', or 'nothing'.
Type |
string |
|---|---|
Default |
|
Tags |
experimental |
--codegen_dump_functionsWhether to print the LLVM IR for generated functions
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,experimental |
--codegen_dump_mcWhether to dump the disassembly of the machine code for generated functions.
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,experimental |
--codegen_cache_capacityNumber of entries which may be stored in the code generation cache.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--codegen_time_compilationWhether to print time that each code generation request took.
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,experimental |
--consensus_max_batch_size_bytesThe maximum per-tablet RPC batch size when updating peers.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--follower_unavailable_considered_failed_secSeconds that a leader is unable to successfully heartbeat to a follower after which the follower is considered to be failed and evicted from the config.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--group_commit_queue_size_bytesMaximum size of the group commit queue in bytes
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--log_compression_codecCodec to use for compressing WAL segments.
Type |
string |
|---|---|
Default |
|
Tags |
experimental |
--log_max_segments_to_retainThe maximum number of past log segments to keep at all times for the purposes of catching up other peers.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental,advanced,runtime |
--log_min_segments_to_retainThe minimum number of past log segments to keep at all times, regardless of what is required for durability. Must be at least 1.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced,runtime |
--global_log_cache_size_limit_mbServer-wide version of 'log_cache_size_limit_mb'. The total memory used for caching log entries across all tablets is kept under this threshold.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--log_cache_size_limit_mbThe total per-tablet size of consensus entries which may be kept in memory. The log cache attempts to keep all entries which have not yet been replicated to all followers in memory, but if the total size of those entries exceeds this limit within an individual tablet, the oldest will be evicted.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--log_async_preallocate_segmentsWhether the WAL segments preallocation should happen asynchronously
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--log_preallocate_segmentsWhether the WAL should preallocate the entire segment before writing to it
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--log_segment_size_mbThe default segment size for log roll-overs, in MB
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--evict_failed_followersWhether to evict followers from the Raft config that have fallen too far behind the leader’s log to catch up normally or have been unreachable by the leader for longer than follower_unavailable_considered_failed_sec
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--leader_failure_exp_backoff_max_delta_msMaximum time to sleep in between leader election retries, in addition to the regular timeout. When leader election fails the interval in between retries increases exponentially, up to this value.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--leader_failure_max_missed_heartbeat_periodsMaximum heartbeat periods that the leader can fail to heartbeat in before we consider the leader to be failed. The total failure timeout in milliseconds is raft_heartbeat_interval_ms times leader_failure_max_missed_heartbeat_periods. The value passed to this flag may be fractional.
Type |
double |
|---|---|
Default |
|
Tags |
advanced |
--leader_failure_monitor_check_mean_msThe mean failure-checking interval of the randomized failure monitor. If this is configured to -1 (the default), uses the value of 'raft_heartbeat_interval_ms'.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--leader_failure_monitor_check_stddev_msThe standard deviation of the failure-checking interval of the randomized failure monitor. If this is configured to -1 (the default), this is set to half of the mean check interval.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--raft_enable_pre_electionWhen enabled, candidates will call a pre-election before running a real leader election.
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,experimental |
--raft_heartbeat_interval_msThe heartbeat interval for Raft replication. The leader produces heartbeats to followers at this interval. The followers expect a heartbeat at this interval and consider a leader to have failed if it misses several in a row.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--missed_heartbeats_before_rejecting_snapshot_scansThe maximum raft heartbeat periods since the tablet has seen safe time advanced before refusing scans at snapshots that aren’t yet safe and forcing clients to try again.
Type |
double |
|---|---|
Default |
|
Tags |
experimental |
--safe_time_advancement_without_writesWhether to enable the advancement of "safe" time in the absense of write operations
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--safe_time_max_lag_msThe maximum amount of time we allow safe time to lag behind the requested timestampbefore forcing the client to retry, in milliseconds.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--block_coalesce_closeCoalesce synchronization of data during CloseBlocks()
Type |
bool |
|---|---|
Default |
|
Tags |
experimental |
--block_manager_max_open_filesMaximum number of open file descriptors to be used for data blocks. If 0, there is no limit. If -1, Kudu will use 40% of its resource limit as per getrlimit(). This is a soft limit.
Type |
int64 |
|---|---|
Default |
|
Tags |
evolving,advanced |
--fs_data_dirs_full_disk_cache_secondsNumber of seconds we cache the full-disk status in the block manager. During this time, writes to the corresponding root path will not be attempted.
Type |
int32 |
|---|---|
Default |
|
Tags |
evolving,advanced |
--block_managerWhich block manager to use for storage. Valid options are 'file' and 'log'.
Type |
string |
|---|---|
Default |
|
Tags |
advanced |
--log_block_manager_test_hole_punchingEnsure hole punching is supported by the underlying filesystem
Type |
bool |
|---|---|
Default |
|
Tags |
unsafe,advanced |
--log_container_max_blocksMaximum number of blocks (soft) of a log container. Use 0 for no limit. Use -1 for no limit except in the case of a kernel bug with hole punching on ext4 (see KUDU-1508 for details).
Type |
int64 |
|---|---|
Default |
|
Tags |
advanced |
--log_container_max_sizeMaximum size (soft) of a log container
Type |
uint64 |
|---|---|
Default |
|
Tags |
advanced |
--log_container_preallocate_bytesNumber of bytes to preallocate in a log container when creating new blocks. Set to 0 to disable preallocation
Type |
uint64 |
|---|---|
Default |
|
Tags |
advanced |
--catalog_manager_delete_orphaned_tabletsWhether the master should delete tablets reported by tablet servers for which there are no corresponding records in the master’s metadata. Use this option with care; it may cause permanent tablet data loss under specific (and rare) cases of master failures!
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--default_num_replicasDefault number of replicas for tables that do not have the num_replicas set.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--master_failover_catchup_timeout_msAmount of time to give a newly-elected leader master to load the previous master’s metadata and become active. If this time is exceeded, the node crashes.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental,advanced |
--master_ts_rpc_timeout_msTimeout used for the master→TS async rpc calls.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--max_create_tablets_per_tsThe number of tablets per TS that can be requested for a new table.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--table_locations_ttl_msMaximum time in milliseconds which clients may cache table locations. New range partitions may not be visible to existing client instances until after waiting for the ttl period.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--tablet_creation_timeout_msTimeout used by the master when attempting to create tablet replicas during table creation.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--unresponsive_ts_rpc_timeout_msAfter this amount of time, the master will stop attempting to contact a tablet server in order to perform operations such as deleting a tablet.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--authn_token_validity_secondsPeriod of time for which an issued authentication token is valid. It’s not possible to renew a token, hence the token validity interval defines the longest possible lifetime of an external job which uses a token for authentication.
Type |
int64 |
|---|---|
Default |
|
Tags |
experimental |
--master_registration_rpc_timeout_msTimeout for retrieving master registration over RPC.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--tsk_rotation_secondsNumber of seconds between consecutive activations of newly generated TSKs (Token Signing Keys).
Type |
int64 |
|---|---|
Default |
|
Tags |
experimental,advanced |
--ipki_ca_cert_expiration_secondsvalidity interval for self-signed root CA certifcate issued by Kudu IPKI (Internal Private Key Infrastructure, a.k.a. Internal Kudu CA)
Type |
int64 |
|---|---|
Default |
|
Tags |
experimental |
--ipki_ca_key_sizethe number of bits for self-signed root CA cert used by Kudu IPKI (Internal Private Key Infrastructure, a.k.a. Internal Kudu CA)
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--ipki_server_cert_expiration_secondsvalidity interval for server certificates issued by Kudu IPKI (Internal Private Key Infrastructure, a.k.a. Internal Kudu CA)
Type |
int64 |
|---|---|
Default |
|
Tags |
experimental |
--tserver_unresponsive_timeout_msThe period of time that a Master can go without receiving a heartbeat from a tablet server before considering it unresponsive. Unresponsive servers are not selected when assigning replicas during table creation or re-replication.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--rpc_acceptor_listen_backlogSocket backlog parameter used when listening for RPC connections. This defines the maximum length to which the queue of pending TCP connections inbound to the RPC server may grow. If a connection request arrives when the queue is full, the client may receive an error. Higher values may help the server ride over bursts of new inbound connection requests.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--rpc_ca_certificate_filePath to the PEM encoded X509 certificate of the trusted external certificate authority. The provided certificate should be the root issuer of the certificate passed in '--rpc_certificate_file'.
Type |
string |
|---|---|
Default |
none |
Tags |
experimental |
--rpc_certificate_filePath to a PEM encoded X509 certificate to use for securing RPC connections with SSL/TLS. If set, '--rpc_private_key_file' and '--rpc_ca_certificate_file' must be set as well.
Type |
string |
|---|---|
Default |
none |
Tags |
experimental |
--rpc_default_keepalive_time_msIf an RPC connection from a client is idle for this amount of time, the server will disconnect the client.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--rpc_private_key_filePath to a PEM encoded private key paired with the certificate from '--rpc_certificate_file'
Type |
string |
|---|---|
Default |
none |
Tags |
experimental |
--rpc_encrypt_loopback_connectionsWhether to encrypt data transfer on RPC connections that stay within a single host. Encryption here is likely to offer no additional security benefit since only a local 'root' user could intercept the traffic, and wire encryption does not suitably protect against such an attacker.
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--rpc_trace_negotiationIf enabled, dump traces of all RPC negotiations to the log
Type |
bool |
|---|---|
Default |
|
Tags |
experimental,advanced,runtime |
--rpc_callback_max_cyclesThe maximum number of cycles for which an RPC callback should be allowed to run without emitting a warning. (Advanced debugging option)
Type |
int64 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--rpc_negotiation_timeout_msTimeout for negotiating an RPC connection.
Type |
int64 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--remember_clients_ttl_msMaximum amount of time, in milliseconds, the server "remembers" a client for the purpose of caching its responses. After this period without hearing from it, the client is no longer remembered and the memory occupied by its responses is reclaimed. Retries of requests older than 'remember_clients_ttl_ms' are treated as new ones.
Type |
int64 |
|---|---|
Default |
|
Tags |
advanced |
--remember_responses_ttl_msMaximum amount of time, in milliseconds, the server "remembers" a response to a specific request for a client. After this period has elapsed, the response may have been garbage collected and the client might get a response indicating the request is STALE.
Type |
int64 |
|---|---|
Default |
|
Tags |
advanced |
--rpc_dump_all_tracesIf true, dump all RPC traces at INFO level
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,advanced |
--rpc_max_message_sizeThe maximum size of a message that any RPC that the server will accept. Must be at least 1MB.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--principalKerberos principal that this daemon will log in as. The special token _HOST will be replaced with the FQDN of the local host.
Type |
string |
|---|---|
Default |
|
Tags |
unsafe,experimental |
--ipki_server_key_sizethe number of bits for server cert’s private key. The server cert is used for TLS connections to and from clients and other servers.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--rpc_tls_ciphersThe cipher suite preferences to use for TLS-secured RPC connections. Uses the OpenSSL cipher preference list format. See man (1) ciphers for more information.
Type |
string |
|---|---|
Default |
|
Tags |
advanced |
--rpc_tls_min_protocolThe minimum protocol version to allow when for securing RPC connections with TLS. May be one of 'TLSv1', 'TLSv1.1', or 'TLSv1.2'.
Type |
string |
|---|---|
Default |
|
Tags |
advanced |
--tsk_num_rsa_bitsNumber of bits in RSA keys used for token signing.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--web_log_bytesThe maximum number of bytes to display on the debug webserver’s log page
Type |
int64 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--max_clock_sync_error_usecMaximum allowed clock synchronization error as reported by NTP before the server will abort.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--rpc_num_acceptors_per_addressNumber of RPC acceptor threads for each bound address
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--rpc_service_queue_lengthDefault length of queue for incoming RPC requests
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--max_negotiation_threadsMaximum number of connection negotiation threads.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--min_negotiation_threadsMinimum number of connection negotiation threads.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--webserver_enabledWhether to enable the web server on this daemon. NOTE: disabling the web server is also likely to prevent monitoring systems from properly capturing metrics.
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--metrics_log_interval_msInterval (in milliseconds) at which the server will dump its metrics to a local log file. The log files are located in the same directory as specified by the -log_dir flag. If this is not a positive value, then metrics logging will be disabled.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--webserver_max_post_length_bytesThe maximum length of a POST request that will be accepted by the embedded web server.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--webserver_x_frame_optionsThe webserver will add an 'X-Frame-Options' HTTP header with this value to all responses. This can help prevent clickjacking attacks.
Type |
string |
|---|---|
Default |
|
Tags |
advanced |
--webserver_doc_rootFiles under <webserver_doc_root> are accessible via the debug webserver. Defaults to $KUDU_HOME/www, or if $KUDU_HOME is not set, disables the document root
Type |
string |
|---|---|
Default |
none |
Tags |
advanced |
--webserver_enable_doc_rootIf true, webserver may serve static files from the webserver_doc_root
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--webserver_interfaceInterface to start debug webserver on. If blank, webserver binds to 0.0.0.0
Type |
string |
|---|---|
Default |
none |
Tags |
advanced |
--webserver_num_worker_threadsMaximum number of threads to start for handling web server requests
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--budgeted_compaction_target_rowset_sizeThe target size for DiskRowSets during flush/compact when the budgeted compaction policy is used
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced,experimental |
--compaction_approximation_ratioApproximation ratio allowed for optimal compaction calculation. A value of 1.05 indicates that the policy may use an approximate result if it is known to be within 5% of the optimal solution.
Type |
double |
|---|---|
Default |
|
Tags |
experimental |
--deltafile_default_block_sizeBlock size for delta files. In the future, this may become configurable on a per-table basis.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--deltafile_default_compression_codecThe compression codec used when writing deltafiles.
Type |
string |
|---|---|
Default |
|
Tags |
experimental |
--default_composite_key_index_block_size_bytesBlock size used for composite key indexes.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--tablet_delta_store_major_compact_min_ratioMinimum ratio of sizeof(deltas) to sizeof(base data) before a major compaction can run (Advanced option)
Type |
double |
|---|---|
Default |
|
Tags |
experimental |
--tablet_delta_store_minor_compact_maxHow many delta stores are required before forcing a minor delta compaction (Advanced option)
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--tablet_bloom_block_sizeBlock size of the bloom filters used for tablet keys.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--tablet_bloom_target_fp_rateTarget false-positive rate (between 0 and 1) to size tablet key bloom filters. A lower false positive rate may reduce the number of disk seeks required in heavy insert workloads, at the expense of more space and RAM required for bloom filters.
Type |
double |
|---|---|
Default |
|
Tags |
advanced |
--tablet_compaction_budget_mbBudget for a single compaction
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--tablet_history_max_age_secNumber of seconds to retain tablet history. Reads initiated at a snapshot that is older than this age will be rejected. To disable history removal, set to -1.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--tablet_throttler_burst_factorBurst factor for write RPC throttling. The maximum rate the throttler allows within a token refill period (100ms) equals burst factor multiply base rate.
Type |
double |
|---|---|
Default |
|
Tags |
experimental |
--tablet_throttler_bytes_per_secMaximum write RPC IO rate (byte/s) allowed for a tablet, write RPC exceeding this limit will be throttled. 0 means no limit.
Type |
int64 |
|---|---|
Default |
|
Tags |
experimental |
--tablet_throttler_rpc_per_secMaximum write RPC rate (op/s) allowed for a tablet, write RPC exceeding this limit will be throttled. 0 means no limit.
Type |
int64 |
|---|---|
Default |
|
Tags |
experimental |
--undo_delta_block_gc_init_budget_millisThe maximum number of milliseconds we will spend initializing UNDO delta blocks per invocation of UndoDeltaBlockGCOp. Existing delta blocks must be initialized once per process startup to determine when they can be deleted.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced,evolving |
--flush_threshold_mbSize at which MemRowSet flushes are triggered. A MRS can still flush below this threshold if it if hasn’t flushed in a while, or if the server-wide memory limit has been reached.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--flush_threshold_secsNumber of seconds after which a non-empty MemRowSet will become flushable even if it is not large.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--tablet_transaction_memory_limit_mbMaximum amount of memory that may be consumed by all in-flight transactions belonging to a particular tablet. When this limit is reached, new transactions will be rejected and clients will be forced to retry them. If -1, transaction memory tracking is disabled.
Type |
int64 |
|---|---|
Default |
|
Tags |
advanced |
--heartbeat_interval_msInterval at which the TS heartbeats to the master.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--heartbeat_max_failures_before_backoffMaximum number of consecutive heartbeat failures until the Tablet Server backs off to the normal heartbeat interval, rather than retrying.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--heartbeat_rpc_timeout_msTimeout used for the TS→Master heartbeat RPCs.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--scanner_ttl_msNumber of milliseconds of inactivity allowed for a scannerbefore it may be expired
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--scanner_batch_size_rowsThe number of rows to batch for servicing scan requests.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--scanner_default_batch_size_bytesThe default size for batches of scan results
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--scanner_max_batch_size_bytesThe maximum batch size that a client may request for scan results.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--scanner_max_wait_msThe maximum amount of time (in milliseconds) we’ll hang a scanner thread waiting for safe time to advance or transactions to commit, even if its deadline allows waiting longer.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--num_tablets_to_copy_simultaneouslyNumber of threads available to copy tablets from remote servers.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--num_tablets_to_open_simultaneouslyNumber of threads available to open tablets during startup. If this is set to 0 (the default), then the number of bootstrap threads will be set based on the number of data directories. If the data directories are on some very fast storage device such as SSD or a RAID array, it may make sense to manually tune this.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--trace_to_consoleTrace pattern specifying which trace events should be dumped directly to the console
Type |
string |
|---|---|
Default |
none |
Tags |
experimental |
--env_use_fsyncUse fsync(2) instead of fdatasync(2) for synchronizing dirty data to disk.
Type |
bool |
|---|---|
Default |
|
Tags |
evolving,advanced |
--never_fsyncNever fsync() anything to disk. This is used by certain test cases to speed up runtime. This is very unsafe to use in production.
Type |
bool |
|---|---|
Default |
|
Tags |
unsafe,advanced |
--suicide_on_eioKill the process if an I/O operation results in EIO
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--file_cache_expiry_period_msPeriod of time (in ms) between removing expired file cache descriptors
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--disable_core_dumpsDisable core dumps when this process crashes.
Type |
bool |
|---|---|
Default |
|
Tags |
evolving,advanced |
--redactComma-separated list of redactions. Supported redactions are 'flag', 'log' and 'all'. If 'flag' is specified, configuration flags which may include sensitive data will be redacted whenever server configuration is emitted. If 'log' is specified, row data will be redacted from log and error messages. If 'all' is specified, all of above will be redacted.
Type |
string |
|---|---|
Default |
|
Tags |
evolving,advanced |
--umaskThe umask that will be used when creating files and directories. Permissions of top-level data directories will also be modified at start-up to conform to the given umask. Changing this value may enable unauthorized local users to read or modify data stored by Kudu.
Type |
string |
|---|---|
Default |
|
Tags |
advanced |
--max_log_filesMaximum number of log files to retain per severity level. The most recent log files are retained. If set to 0, all log files are retained.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental,runtime |
--data_gc_min_size_mbThe (exclusive) minimum number of megabytes of ancient data on disk, per tablet, needed to prioritize deletion of that data.
Type |
int64 |
|---|---|
Default |
|
Tags |
experimental |
--data_gc_prioritization_probThe probability that we will prioritize data GC over performance improvement operations. If set to 1.0, we will always prefer to delete old data before running performance improvement operations such as delta compaction.
Type |
double |
|---|---|
Default |
|
Tags |
experimental |
--log_target_replay_size_mbThe target maximum size of logs to be replayed at startup. If a tablet has in-memory operations that are causing more than this size of logs to be retained, then the maintenance manager will prioritize flushing these operations to disk.
Type |
int64 |
|---|---|
Default |
|
Tags |
experimental |
--memory_limit_soft_percentagePercentage of the hard memory limit that this daemon may consume before memory throttling of writes begins. The greater the excess, the higher the chance of throttling. In general, a lower soft limit leads to smoother write latencies but decreased throughput, and vice versa for a higher soft limit.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--memory_limit_warn_threshold_percentagePercentage of the hard memory limit that this daemon may consume before WARNING level messages are periodically logged.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--tcmalloc_max_free_bytes_percentageMaximum percentage of the RSS that tcmalloc is allowed to use for reserved but unallocated memory.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--metrics_retirement_age_msThe minimum number of milliseconds a metric will be kept for after it is no longer active. (Advanced option)
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced,runtime |
--enable_minidumpsWhether to enable minidump generation upon process crash or SIGUSR1. Currently only supported on Linux systems.
Type |
bool |
|---|---|
Default |
|
Tags |
evolving,advanced |
--minidump_size_limit_hint_kbSize limit hint for minidump files in KB. If a minidump exceeds this value, then breakpad will reduce the stack memory it collects for each thread from 8KB to 2KB. However it will always include the full stack memory for the first 20 threads, including the thread that crashed.
Type |
int32 |
|---|---|
Default |
|
Tags |
evolving,advanced |
--local_ip_for_outbound_socketsIP to bind to when making outgoing socket connections. This must be an IP address of the form A.B.C.D, not a hostname. Advanced parameter, subject to change.
Type |
string |
|---|---|
Default |
none |
Tags |
experimental |
--nvm_cache_allocation_retry_countThe number of times that the NVM cache will retry attempts to allocate memory for new entries. In between attempts, a cache entry will be evicted.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental,advanced |
--nvm_cache_pathThe path at which the NVM cache will try to allocate its memory. This can be a tmpfs or ramfs for testing purposes.
Type |
string |
|---|---|
Default |
|
Tags |
experimental |
--drop_log_memoryDrop in-memory buffers of log contents. Logs can grow very quickly and they are rarely read before they need to be evicted from memory. Instead, drop them from memory as soon as they are flushed to disk.
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,advanced |
--log_backtrace_atEmit a backtrace when logging at file:linenum.
Type |
string |
|---|---|
Default |
none |
Tags |
advanced |
--logbuflevelBuffer log messages logged at this level or lower (-1 means don’t buffer; 0 means buffer INFO only; …)
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--logbufsecsBuffer log messages for at most this many seconds
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
kudu-tserver Unsupported FlagsFlags marked advanced or experimental and not marked stable, or flags with no stability tag, are unsupported and are included
for informational purposes only. They are subject to change or be removed without notice.
--block_cache_typeWhich type of block cache to use for caching data. Valid choices are 'DRAM' or 'NVM'. DRAM, the default, caches data in regular memory. 'NVM' caches data in a memory-mapped file using the NVML library.
Type |
string |
|---|---|
Default |
|
Tags |
experimental |
--min_compression_ratioIf a column compression codec is configured, but the codec is unable to achieve a compression ratio at least as good as the configured value, then the data will be written uncompressed. This will reduce CPU overhead on the read side at the expense of a small amount of extra space if the codec encounters portions of data that are not easily compressible.
Type |
double |
|---|---|
Default |
|
Tags |
experimental |
--cfile_default_block_sizeThe default block size to use in cfiles
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--cfile_default_compression_codecDefault cfile block compression codec.
Type |
string |
|---|---|
Default |
|
Tags |
advanced |
--cfile_do_on_finishWhat to do to cfile blocks when writing is finished. Possible values are 'close', 'flush', or 'nothing'.
Type |
string |
|---|---|
Default |
|
Tags |
experimental |
--codegen_dump_functionsWhether to print the LLVM IR for generated functions
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,experimental |
--codegen_dump_mcWhether to dump the disassembly of the machine code for generated functions.
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,experimental |
--codegen_cache_capacityNumber of entries which may be stored in the code generation cache.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--codegen_time_compilationWhether to print time that each code generation request took.
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,experimental |
--consensus_max_batch_size_bytesThe maximum per-tablet RPC batch size when updating peers.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--follower_unavailable_considered_failed_secSeconds that a leader is unable to successfully heartbeat to a follower after which the follower is considered to be failed and evicted from the config.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--group_commit_queue_size_bytesMaximum size of the group commit queue in bytes
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--log_compression_codecCodec to use for compressing WAL segments.
Type |
string |
|---|---|
Default |
|
Tags |
experimental |
--log_max_segments_to_retainThe maximum number of past log segments to keep at all times for the purposes of catching up other peers.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental,advanced,runtime |
--log_min_segments_to_retainThe minimum number of past log segments to keep at all times, regardless of what is required for durability. Must be at least 1.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced,runtime |
--global_log_cache_size_limit_mbServer-wide version of 'log_cache_size_limit_mb'. The total memory used for caching log entries across all tablets is kept under this threshold.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--log_cache_size_limit_mbThe total per-tablet size of consensus entries which may be kept in memory. The log cache attempts to keep all entries which have not yet been replicated to all followers in memory, but if the total size of those entries exceeds this limit within an individual tablet, the oldest will be evicted.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--log_async_preallocate_segmentsWhether the WAL segments preallocation should happen asynchronously
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--log_preallocate_segmentsWhether the WAL should preallocate the entire segment before writing to it
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--log_segment_size_mbThe default segment size for log roll-overs, in MB
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--evict_failed_followersWhether to evict followers from the Raft config that have fallen too far behind the leader’s log to catch up normally or have been unreachable by the leader for longer than follower_unavailable_considered_failed_sec
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--leader_failure_exp_backoff_max_delta_msMaximum time to sleep in between leader election retries, in addition to the regular timeout. When leader election fails the interval in between retries increases exponentially, up to this value.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--leader_failure_max_missed_heartbeat_periodsMaximum heartbeat periods that the leader can fail to heartbeat in before we consider the leader to be failed. The total failure timeout in milliseconds is raft_heartbeat_interval_ms times leader_failure_max_missed_heartbeat_periods. The value passed to this flag may be fractional.
Type |
double |
|---|---|
Default |
|
Tags |
advanced |
--leader_failure_monitor_check_mean_msThe mean failure-checking interval of the randomized failure monitor. If this is configured to -1 (the default), uses the value of 'raft_heartbeat_interval_ms'.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--leader_failure_monitor_check_stddev_msThe standard deviation of the failure-checking interval of the randomized failure monitor. If this is configured to -1 (the default), this is set to half of the mean check interval.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--raft_enable_pre_electionWhen enabled, candidates will call a pre-election before running a real leader election.
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,experimental |
--raft_heartbeat_interval_msThe heartbeat interval for Raft replication. The leader produces heartbeats to followers at this interval. The followers expect a heartbeat at this interval and consider a leader to have failed if it misses several in a row.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--missed_heartbeats_before_rejecting_snapshot_scansThe maximum raft heartbeat periods since the tablet has seen safe time advanced before refusing scans at snapshots that aren’t yet safe and forcing clients to try again.
Type |
double |
|---|---|
Default |
|
Tags |
experimental |
--safe_time_advancement_without_writesWhether to enable the advancement of "safe" time in the absense of write operations
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--safe_time_max_lag_msThe maximum amount of time we allow safe time to lag behind the requested timestampbefore forcing the client to retry, in milliseconds.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--block_coalesce_closeCoalesce synchronization of data during CloseBlocks()
Type |
bool |
|---|---|
Default |
|
Tags |
experimental |
--block_manager_max_open_filesMaximum number of open file descriptors to be used for data blocks. If 0, there is no limit. If -1, Kudu will use 40% of its resource limit as per getrlimit(). This is a soft limit.
Type |
int64 |
|---|---|
Default |
|
Tags |
evolving,advanced |
--fs_data_dirs_full_disk_cache_secondsNumber of seconds we cache the full-disk status in the block manager. During this time, writes to the corresponding root path will not be attempted.
Type |
int32 |
|---|---|
Default |
|
Tags |
evolving,advanced |
--block_managerWhich block manager to use for storage. Valid options are 'file' and 'log'.
Type |
string |
|---|---|
Default |
|
Tags |
advanced |
--log_block_manager_test_hole_punchingEnsure hole punching is supported by the underlying filesystem
Type |
bool |
|---|---|
Default |
|
Tags |
unsafe,advanced |
--log_container_max_blocksMaximum number of blocks (soft) of a log container. Use 0 for no limit. Use -1 for no limit except in the case of a kernel bug with hole punching on ext4 (see KUDU-1508 for details).
Type |
int64 |
|---|---|
Default |
|
Tags |
advanced |
--log_container_max_sizeMaximum size (soft) of a log container
Type |
uint64 |
|---|---|
Default |
|
Tags |
advanced |
--log_container_preallocate_bytesNumber of bytes to preallocate in a log container when creating new blocks. Set to 0 to disable preallocation
Type |
uint64 |
|---|---|
Default |
|
Tags |
advanced |
--rpc_acceptor_listen_backlogSocket backlog parameter used when listening for RPC connections. This defines the maximum length to which the queue of pending TCP connections inbound to the RPC server may grow. If a connection request arrives when the queue is full, the client may receive an error. Higher values may help the server ride over bursts of new inbound connection requests.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--rpc_ca_certificate_filePath to the PEM encoded X509 certificate of the trusted external certificate authority. The provided certificate should be the root issuer of the certificate passed in '--rpc_certificate_file'.
Type |
string |
|---|---|
Default |
none |
Tags |
experimental |
--rpc_certificate_filePath to a PEM encoded X509 certificate to use for securing RPC connections with SSL/TLS. If set, '--rpc_private_key_file' and '--rpc_ca_certificate_file' must be set as well.
Type |
string |
|---|---|
Default |
none |
Tags |
experimental |
--rpc_default_keepalive_time_msIf an RPC connection from a client is idle for this amount of time, the server will disconnect the client.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--rpc_private_key_filePath to a PEM encoded private key paired with the certificate from '--rpc_certificate_file'
Type |
string |
|---|---|
Default |
none |
Tags |
experimental |
--rpc_encrypt_loopback_connectionsWhether to encrypt data transfer on RPC connections that stay within a single host. Encryption here is likely to offer no additional security benefit since only a local 'root' user could intercept the traffic, and wire encryption does not suitably protect against such an attacker.
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--rpc_trace_negotiationIf enabled, dump traces of all RPC negotiations to the log
Type |
bool |
|---|---|
Default |
|
Tags |
experimental,advanced,runtime |
--rpc_callback_max_cyclesThe maximum number of cycles for which an RPC callback should be allowed to run without emitting a warning. (Advanced debugging option)
Type |
int64 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--rpc_negotiation_timeout_msTimeout for negotiating an RPC connection.
Type |
int64 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--remember_clients_ttl_msMaximum amount of time, in milliseconds, the server "remembers" a client for the purpose of caching its responses. After this period without hearing from it, the client is no longer remembered and the memory occupied by its responses is reclaimed. Retries of requests older than 'remember_clients_ttl_ms' are treated as new ones.
Type |
int64 |
|---|---|
Default |
|
Tags |
advanced |
--remember_responses_ttl_msMaximum amount of time, in milliseconds, the server "remembers" a response to a specific request for a client. After this period has elapsed, the response may have been garbage collected and the client might get a response indicating the request is STALE.
Type |
int64 |
|---|---|
Default |
|
Tags |
advanced |
--rpc_dump_all_tracesIf true, dump all RPC traces at INFO level
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,advanced |
--rpc_max_message_sizeThe maximum size of a message that any RPC that the server will accept. Must be at least 1MB.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--principalKerberos principal that this daemon will log in as. The special token _HOST will be replaced with the FQDN of the local host.
Type |
string |
|---|---|
Default |
|
Tags |
unsafe,experimental |
--ipki_server_key_sizethe number of bits for server cert’s private key. The server cert is used for TLS connections to and from clients and other servers.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--rpc_tls_ciphersThe cipher suite preferences to use for TLS-secured RPC connections. Uses the OpenSSL cipher preference list format. See man (1) ciphers for more information.
Type |
string |
|---|---|
Default |
|
Tags |
advanced |
--rpc_tls_min_protocolThe minimum protocol version to allow when for securing RPC connections with TLS. May be one of 'TLSv1', 'TLSv1.1', or 'TLSv1.2'.
Type |
string |
|---|---|
Default |
|
Tags |
advanced |
--web_log_bytesThe maximum number of bytes to display on the debug webserver’s log page
Type |
int64 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--max_clock_sync_error_usecMaximum allowed clock synchronization error as reported by NTP before the server will abort.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--rpc_num_acceptors_per_addressNumber of RPC acceptor threads for each bound address
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--rpc_service_queue_lengthDefault length of queue for incoming RPC requests
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--max_negotiation_threadsMaximum number of connection negotiation threads.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--min_negotiation_threadsMinimum number of connection negotiation threads.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--webserver_enabledWhether to enable the web server on this daemon. NOTE: disabling the web server is also likely to prevent monitoring systems from properly capturing metrics.
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--metrics_log_interval_msInterval (in milliseconds) at which the server will dump its metrics to a local log file. The log files are located in the same directory as specified by the -log_dir flag. If this is not a positive value, then metrics logging will be disabled.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--webserver_max_post_length_bytesThe maximum length of a POST request that will be accepted by the embedded web server.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--webserver_x_frame_optionsThe webserver will add an 'X-Frame-Options' HTTP header with this value to all responses. This can help prevent clickjacking attacks.
Type |
string |
|---|---|
Default |
|
Tags |
advanced |
--webserver_doc_rootFiles under <webserver_doc_root> are accessible via the debug webserver. Defaults to $KUDU_HOME/www, or if $KUDU_HOME is not set, disables the document root
Type |
string |
|---|---|
Default |
none |
Tags |
advanced |
--webserver_enable_doc_rootIf true, webserver may serve static files from the webserver_doc_root
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--webserver_interfaceInterface to start debug webserver on. If blank, webserver binds to 0.0.0.0
Type |
string |
|---|---|
Default |
none |
Tags |
advanced |
--webserver_num_worker_threadsMaximum number of threads to start for handling web server requests
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--budgeted_compaction_target_rowset_sizeThe target size for DiskRowSets during flush/compact when the budgeted compaction policy is used
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced,experimental |
--compaction_approximation_ratioApproximation ratio allowed for optimal compaction calculation. A value of 1.05 indicates that the policy may use an approximate result if it is known to be within 5% of the optimal solution.
Type |
double |
|---|---|
Default |
|
Tags |
experimental |
--deltafile_default_block_sizeBlock size for delta files. In the future, this may become configurable on a per-table basis.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--deltafile_default_compression_codecThe compression codec used when writing deltafiles.
Type |
string |
|---|---|
Default |
|
Tags |
experimental |
--default_composite_key_index_block_size_bytesBlock size used for composite key indexes.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--tablet_delta_store_major_compact_min_ratioMinimum ratio of sizeof(deltas) to sizeof(base data) before a major compaction can run (Advanced option)
Type |
double |
|---|---|
Default |
|
Tags |
experimental |
--tablet_delta_store_minor_compact_maxHow many delta stores are required before forcing a minor delta compaction (Advanced option)
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--tablet_bloom_block_sizeBlock size of the bloom filters used for tablet keys.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--tablet_bloom_target_fp_rateTarget false-positive rate (between 0 and 1) to size tablet key bloom filters. A lower false positive rate may reduce the number of disk seeks required in heavy insert workloads, at the expense of more space and RAM required for bloom filters.
Type |
double |
|---|---|
Default |
|
Tags |
advanced |
--tablet_compaction_budget_mbBudget for a single compaction
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--tablet_history_max_age_secNumber of seconds to retain tablet history. Reads initiated at a snapshot that is older than this age will be rejected. To disable history removal, set to -1.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--tablet_throttler_burst_factorBurst factor for write RPC throttling. The maximum rate the throttler allows within a token refill period (100ms) equals burst factor multiply base rate.
Type |
double |
|---|---|
Default |
|
Tags |
experimental |
--tablet_throttler_bytes_per_secMaximum write RPC IO rate (byte/s) allowed for a tablet, write RPC exceeding this limit will be throttled. 0 means no limit.
Type |
int64 |
|---|---|
Default |
|
Tags |
experimental |
--tablet_throttler_rpc_per_secMaximum write RPC rate (op/s) allowed for a tablet, write RPC exceeding this limit will be throttled. 0 means no limit.
Type |
int64 |
|---|---|
Default |
|
Tags |
experimental |
--undo_delta_block_gc_init_budget_millisThe maximum number of milliseconds we will spend initializing UNDO delta blocks per invocation of UndoDeltaBlockGCOp. Existing delta blocks must be initialized once per process startup to determine when they can be deleted.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced,evolving |
--flush_threshold_mbSize at which MemRowSet flushes are triggered. A MRS can still flush below this threshold if it if hasn’t flushed in a while, or if the server-wide memory limit has been reached.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--flush_threshold_secsNumber of seconds after which a non-empty MemRowSet will become flushable even if it is not large.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental |
--tablet_transaction_memory_limit_mbMaximum amount of memory that may be consumed by all in-flight transactions belonging to a particular tablet. When this limit is reached, new transactions will be rejected and clients will be forced to retry them. If -1, transaction memory tracking is disabled.
Type |
int64 |
|---|---|
Default |
|
Tags |
advanced |
--heartbeat_interval_msInterval at which the TS heartbeats to the master.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--heartbeat_max_failures_before_backoffMaximum number of consecutive heartbeat failures until the Tablet Server backs off to the normal heartbeat interval, rather than retrying.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--heartbeat_rpc_timeout_msTimeout used for the TS→Master heartbeat RPCs.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--scanner_ttl_msNumber of milliseconds of inactivity allowed for a scannerbefore it may be expired
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--scanner_batch_size_rowsThe number of rows to batch for servicing scan requests.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--scanner_default_batch_size_bytesThe default size for batches of scan results
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--scanner_max_batch_size_bytesThe maximum batch size that a client may request for scan results.
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--scanner_max_wait_msThe maximum amount of time (in milliseconds) we’ll hang a scanner thread waiting for safe time to advance or transactions to commit, even if its deadline allows waiting longer.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--num_tablets_to_copy_simultaneouslyNumber of threads available to copy tablets from remote servers.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--num_tablets_to_open_simultaneouslyNumber of threads available to open tablets during startup. If this is set to 0 (the default), then the number of bootstrap threads will be set based on the number of data directories. If the data directories are on some very fast storage device such as SSD or a RAID array, it may make sense to manually tune this.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--trace_to_consoleTrace pattern specifying which trace events should be dumped directly to the console
Type |
string |
|---|---|
Default |
none |
Tags |
experimental |
--env_use_fsyncUse fsync(2) instead of fdatasync(2) for synchronizing dirty data to disk.
Type |
bool |
|---|---|
Default |
|
Tags |
evolving,advanced |
--never_fsyncNever fsync() anything to disk. This is used by certain test cases to speed up runtime. This is very unsafe to use in production.
Type |
bool |
|---|---|
Default |
|
Tags |
unsafe,advanced |
--suicide_on_eioKill the process if an I/O operation results in EIO
Type |
bool |
|---|---|
Default |
|
Tags |
advanced |
--file_cache_expiry_period_msPeriod of time (in ms) between removing expired file cache descriptors
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--disable_core_dumpsDisable core dumps when this process crashes.
Type |
bool |
|---|---|
Default |
|
Tags |
evolving,advanced |
--redactComma-separated list of redactions. Supported redactions are 'flag', 'log' and 'all'. If 'flag' is specified, configuration flags which may include sensitive data will be redacted whenever server configuration is emitted. If 'log' is specified, row data will be redacted from log and error messages. If 'all' is specified, all of above will be redacted.
Type |
string |
|---|---|
Default |
|
Tags |
evolving,advanced |
--umaskThe umask that will be used when creating files and directories. Permissions of top-level data directories will also be modified at start-up to conform to the given umask. Changing this value may enable unauthorized local users to read or modify data stored by Kudu.
Type |
string |
|---|---|
Default |
|
Tags |
advanced |
--max_log_filesMaximum number of log files to retain per severity level. The most recent log files are retained. If set to 0, all log files are retained.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental,runtime |
--data_gc_min_size_mbThe (exclusive) minimum number of megabytes of ancient data on disk, per tablet, needed to prioritize deletion of that data.
Type |
int64 |
|---|---|
Default |
|
Tags |
experimental |
--data_gc_prioritization_probThe probability that we will prioritize data GC over performance improvement operations. If set to 1.0, we will always prefer to delete old data before running performance improvement operations such as delta compaction.
Type |
double |
|---|---|
Default |
|
Tags |
experimental |
--log_target_replay_size_mbThe target maximum size of logs to be replayed at startup. If a tablet has in-memory operations that are causing more than this size of logs to be retained, then the maintenance manager will prioritize flushing these operations to disk.
Type |
int64 |
|---|---|
Default |
|
Tags |
experimental |
--memory_limit_soft_percentagePercentage of the hard memory limit that this daemon may consume before memory throttling of writes begins. The greater the excess, the higher the chance of throttling. In general, a lower soft limit leads to smoother write latencies but decreased throughput, and vice versa for a higher soft limit.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--memory_limit_warn_threshold_percentagePercentage of the hard memory limit that this daemon may consume before WARNING level messages are periodically logged.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--tcmalloc_max_free_bytes_percentageMaximum percentage of the RSS that tcmalloc is allowed to use for reserved but unallocated memory.
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced |
--metrics_retirement_age_msThe minimum number of milliseconds a metric will be kept for after it is no longer active. (Advanced option)
Type |
int32 |
|---|---|
Default |
|
Tags |
advanced,runtime |
--enable_minidumpsWhether to enable minidump generation upon process crash or SIGUSR1. Currently only supported on Linux systems.
Type |
bool |
|---|---|
Default |
|
Tags |
evolving,advanced |
--minidump_size_limit_hint_kbSize limit hint for minidump files in KB. If a minidump exceeds this value, then breakpad will reduce the stack memory it collects for each thread from 8KB to 2KB. However it will always include the full stack memory for the first 20 threads, including the thread that crashed.
Type |
int32 |
|---|---|
Default |
|
Tags |
evolving,advanced |
--local_ip_for_outbound_socketsIP to bind to when making outgoing socket connections. This must be an IP address of the form A.B.C.D, not a hostname. Advanced parameter, subject to change.
Type |
string |
|---|---|
Default |
none |
Tags |
experimental |
--nvm_cache_allocation_retry_countThe number of times that the NVM cache will retry attempts to allocate memory for new entries. In between attempts, a cache entry will be evicted.
Type |
int32 |
|---|---|
Default |
|
Tags |
experimental,advanced |
--nvm_cache_pathThe path at which the NVM cache will try to allocate its memory. This can be a tmpfs or ramfs for testing purposes.
Type |
string |
|---|---|
Default |
|
Tags |
experimental |
--drop_log_memoryDrop in-memory buffers of log contents. Logs can grow very quickly and they are rarely read before they need to be evicted from memory. Instead, drop them from memory as soon as they are flushed to disk.
Type |
bool |
|---|---|
Default |
|
Tags |
runtime,advanced |
--log_backtrace_atEmit a backtrace when logging at file:linenum.
Type |
string |
|---|---|
Default |
none |
Tags |
advanced |
--logbuflevelBuffer log messages logged at this level or lower (-1 means don’t buffer; 0 means buffer INFO only; …)
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |
--logbufsecsBuffer log messages for at most this many seconds
Type |
int32 |
|---|---|
Default |
|
Tags |
runtime,advanced |