Kudu Properties in CDH 5.16.0

Role groups:

Master

Categories:

Advanced

Display Name Description Related Name Default Value API Name Required
Master Advanced Configuration Snippet (Safety Valve) for gflagfile For advanced use only. A string to be inserted into gflagfile for this role only. gflagfile_role_safety_valve false
Master Advanced Configuration Snippet (Safety Valve) for kudu-monitoring.properties For advanced use only. A string to be inserted into kudu-monitoring.properties for this role only. kudu-monitoring.properties_role_safety_valve false
Master Environment Advanced Configuration Snippet (Safety Valve) For advanced use only, key-value pairs (one on each line) to be inserted into a role's environment. Applies to configurations of this role except client configuration. KUDU_MASTER_role_env_safety_valve false
Automatically Restart Process When set, this role's process is automatically (and transparently) restarted in the event of an unexpected failure. false process_auto_restart true
Enable Metric Collection Cloudera Manager agent monitors each service and each of its role by publishing metrics to the Cloudera Manager Service Monitor. Setting it to false will stop Cloudera Manager agent from publishing any metric for corresponding service/roles. This is usually helpful for services that generate large amount of metrics which Service Monitor is not able to process. true process_should_monitor true

Logs

Display Name Description Related Name Default Value API Name Required
Master Maximum Log Level to Buffer Log messages logged at this level or lower are buffered in memory. logbuflevel 0 glog_logbuflevel false
Master Maximum Log Size Approximate maximum log file size in megabytes before rolling to a new log file. max_log_size 1800 MiB glog_maxlogsize false
Master Minimum Log Level Messages logged via LOG() at a lower level than this are not logged anywhere. minloglevel 0 glog_minloglevel false
Master Minimum Log Verbosity Messages logged via VLOG() at a lower verbosity than this are not logged anywhere. v 0 glog_verbose false
Master Log Directory The log directory for log files of the role Master. log_dir /var/log/kudu log_dir false

Monitoring

Display Name Description Related Name Default Value API Name Required
Enable Health Alerts for this Role When set, Cloudera Manager will send alerts when the health of this role reaches the threshold specified by the EventServer setting eventserver_health_events_alert_threshold true enable_alerts false
Enable Configuration Change Alerts When set, Cloudera Manager will send alerts when this entity's configuration changes. false enable_config_alerts false
File Descriptor Monitoring Thresholds The health test thresholds of the number of file descriptors used. Specified as a percentage of file descriptor limit. Warning: 50.0 %, Critical: 70.0 % kudu_master_fd_thresholds false
Master Host Health Test When computing the overall Master health, consider the host's health. true kudu_master_host_health_enabled false
Master Process Health Test Enables the health test that the Master's process state is consistent with the role configuration true kudu_master_scm_health_enabled false
Log Directory Free Space Monitoring Absolute Thresholds The health test thresholds for monitoring of free space on the filesystem that contains this role's log directory. Warning: 10 GiB, Critical: 5 GiB log_directory_free_space_absolute_thresholds false
Log Directory Free Space Monitoring Percentage Thresholds The health test thresholds for monitoring of free space on the filesystem that contains this role's log directory. Specified as a percentage of the capacity on that filesystem. This setting is not used if a Log Directory Free Space Monitoring Absolute Thresholds setting is configured. Warning: Never, Critical: Never log_directory_free_space_percentage_thresholds false
Process Swap Memory Thresholds The health test thresholds on the swap memory usage of the process. This takes precedence over the host level threshold. Warning: 200 B, Critical: Never process_swap_memory_thresholds false
Role Triggers The configured triggers for this role. This is a JSON-formatted list of triggers. These triggers are evaluated as part as the health system. Every trigger expression is parsed, and if the trigger condition is met, the list of actions provided in the trigger expression is executed. Each trigger has the following fields:
  • triggerName (mandatory) - The name of the trigger. This value must be unique for the specific role.
  • triggerExpression (mandatory) - A tsquery expression representing the trigger.
  • streamThreshold (optional) - The maximum number of streams that can satisfy a condition of a trigger before the condition fires. By default set to 0, and any stream returned causes the condition to fire.
  • enabled (optional) - By default set to 'true'. If set to 'false', the trigger is not evaluated.
  • expressionEditorConfig (optional) - Metadata for the trigger editor. If present, the trigger should only be edited from the Edit Trigger page; editing the trigger here can lead to inconsistencies.
For example, the following JSON formatted trigger configured for a DataNode fires if the DataNode has more than 1500 file descriptors opened:[{"triggerName": "sample-trigger", "triggerExpression": "IF (SELECT fd_open WHERE roleName=$ROLENAME and last(fd_open) > 1500) DO health:bad", "streamThreshold": 0, "enabled": "true"}]See the trigger rules documentation for more details on how to write triggers using tsquery.The JSON format is evolving and may change and, as a result, backward compatibility is not guaranteed between releases.		 [] role_triggers true
Unexpected Exits Thresholds The health test thresholds for unexpected exits encountered within a recent period specified by the unexpected_exits_window configuration for the role. Warning: Never, Critical: Any unexpected_exits_thresholds false
Unexpected Exits Monitoring Period The period to review when computing unexpected exits. 5 minute(s) unexpected_exits_window false

Other

Display Name Description Related Name Default Value API Name Required
Master Diagnostics Collection Timeout The timeout in milliseconds to wait for diagnostics collection to complete. 1 minute(s) csd_role_diagnostics_timeout false
Default Number of Replicas Default number of replicas for each tablet. default_num_replicas 3 default_num_replicas true
Kudu Master Data Directories Directories where Kudu masters will store data blocks. fs_data_dirs fs_data_dirs true
Kudu Master WAL Directory Directory where Kudu masters will store write-ahead logs. It can be the same as one of the data directories, but not a sub-directory of a data directory. Master and tablet servers must use different directories when co-located on the same machine. fs_wal_dir fs_wal_dir true
Kudu Master WAL Fsyncs All Entries If true, the Master will use the fsync system call to ensure that all modifications to the catalog table are durably written to disk. WARNING: In this release, enabling this option can cause serious issues. log_force_fsync_all false log_force_fsync_all true
Master Address Configuration that's automatically set by Cloudera Manager to propagate the Master's address to the Tablet Servers. server.address master_address false
Kudu Master Core Dump Directory If Enable Core Dump is set, Kudu masters will dump cores to this location. master_core_dump_directory /var/log/kudu master_core_dump_directory true
Kudu Master Web UI Interface The interface of the Kudu Master Web UI. If blank, binds to 0.0.0.0. webserver_interface webserver_interface false

Performance

Display Name Description Related Name Default Value API Name Required
Maximum Process File Descriptors If configured, overrides the process soft and hard rlimits (also called ulimits) for file descriptors to the configured value. rlimit_fds false

Ports and Addresses

Display Name Description Related Name Default Value API Name Required
Kudu Master Web UI Port The port of the Kudu Master Web UI. webserver_port 8051 webserver_port true

Resource Management

Display Name Description Related Name Default Value API Name Required
Cgroup CPU Shares Number of CPU shares to assign to this role. The greater the number of shares, the larger the share of the host's CPUs that will be given to this role when the host experiences CPU contention. Must be between 2 and 262144. Defaults to 1024 for processes not managed by Cloudera Manager. cpu.shares 1024 rm_cpu_shares true
Cgroup I/O Weight Weight for the read I/O requests issued by this role. The greater the weight, the higher the priority of the requests when the host experiences I/O contention. Must be between 100 and 1000. Defaults to 1000 for processes not managed by Cloudera Manager. blkio.weight 500 rm_io_weight true
Cgroup Memory Hard Limit Hard memory limit to assign to this role, enforced by the Linux kernel. When the limit is reached, the kernel will reclaim pages charged to the process. If reclaiming fails, the kernel may kill the process. Both anonymous as well as page cache pages contribute to the limit. Use a value of -1 B to specify no limit. By default processes not managed by Cloudera Manager will have no limit. memory.limit_in_bytes -1 MiB rm_memory_hard_limit true
Cgroup Memory Soft Limit Soft memory limit to assign to this role, enforced by the Linux kernel. When the limit is reached, the kernel will reclaim pages charged to the process if and only if the host is facing memory pressure. If reclaiming fails, the kernel may kill the process. Both anonymous as well as page cache pages contribute to the limit. Use a value of -1 B to specify no limit. By default processes not managed by Cloudera Manager will have no limit. memory.soft_limit_in_bytes -1 MiB rm_memory_soft_limit true

Security

Display Name Description Related Name Default Value API Name Required
Enable TLS/SSL for Master Encrypt communication between clients and Master using Transport Layer Security (TLS) (formerly known as Secure Socket Layer (SSL)). ssl_enabled false ssl_enabled false
Master TLS/SSL Server CA Certificate (PEM Format) The path to the TLS/SSL file containing the certificate of the certificate authority (CA) and any intermediate certificates used to sign the server certificate. Used when Master is acting as a TLS/SSL server. The certificate file must be in PEM format, and is usually created by concatenating all of the appropriate root and intermediate certificates. ssl_server_ca_certificate_location false
Master TLS/SSL Server Certificate File (PEM Format) The path to the TLS/SSL file containing the server certificate key used for TLS/SSL. Used when Master is acting as a TLS/SSL server. The certificate file must be in PEM format. webserver_certificate_file ssl_server_certificate_location false
Master TLS/SSL Server Private Key File (PEM Format) The path to the TLS/SSL file containing the private key used for TLS/SSL. Used when Master is acting as a TLS/SSL server. The certificate file must be in PEM format. webserver_private_key_file ssl_server_privatekey_location false
Master TLS/SSL Private Key Password The password for the private key in the Master TLS/SSL Server Certificate and Private Key file. If left blank, the private key is not protected by a password. webserver_private_key_password_cmd ssl_server_privatekey_password false

Suppressions

Display Name Description Related Name Default Value API Name Required
Suppress Configuration Validator: CDH Version Validator Whether to suppress configuration warnings produced by the CDH Version Validator configuration validator. false role_config_suppression_cdh_version_validator true
Suppress Parameter Validation: Default Number of Replicas Whether to suppress configuration warnings produced by the built-in parameter validation for the Default Number of Replicas parameter. false role_config_suppression_default_num_replicas true
Suppress Parameter Validation: Kudu Master Data Directories Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Master Data Directories parameter. false role_config_suppression_fs_data_dirs true
Suppress Parameter Validation: Kudu Master WAL Directory Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Master WAL Directory parameter. false role_config_suppression_fs_wal_dir true
Suppress Parameter Validation: Master Advanced Configuration Snippet (Safety Valve) for gflagfile Whether to suppress configuration warnings produced by the built-in parameter validation for the Master Advanced Configuration Snippet (Safety Valve) for gflagfile parameter. false role_config_suppression_gflagfile_role_safety_valve true
Suppress Parameter Validation: Master Advanced Configuration Snippet (Safety Valve) for kudu-monitoring.properties Whether to suppress configuration warnings produced by the built-in parameter validation for the Master Advanced Configuration Snippet (Safety Valve) for kudu-monitoring.properties parameter. false role_config_suppression_kudu-monitoring.properties_role_safety_valve true
Suppress Parameter Validation: Master Environment Advanced Configuration Snippet (Safety Valve) Whether to suppress configuration warnings produced by the built-in parameter validation for the Master Environment Advanced Configuration Snippet (Safety Valve) parameter. false role_config_suppression_kudu_master_role_env_safety_valve true
Suppress Parameter Validation: Master Log Directory Whether to suppress configuration warnings produced by the built-in parameter validation for the Master Log Directory parameter. false role_config_suppression_log_dir true
Suppress Parameter Validation: Master Address Whether to suppress configuration warnings produced by the built-in parameter validation for the Master Address parameter. false role_config_suppression_master_address true
Suppress Parameter Validation: Kudu Master Core Dump Directory Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Master Core Dump Directory parameter. false role_config_suppression_master_core_dump_directory true
Suppress Parameter Validation: Role Triggers Whether to suppress configuration warnings produced by the built-in parameter validation for the Role Triggers parameter. false role_config_suppression_role_triggers true
Suppress Parameter Validation: Master TLS/SSL Server CA Certificate (PEM Format) Whether to suppress configuration warnings produced by the built-in parameter validation for the Master TLS/SSL Server CA Certificate (PEM Format) parameter. false role_config_suppression_ssl_server_ca_certificate_location true
Suppress Parameter Validation: Master TLS/SSL Server Certificate File (PEM Format) Whether to suppress configuration warnings produced by the built-in parameter validation for the Master TLS/SSL Server Certificate File (PEM Format) parameter. false role_config_suppression_ssl_server_certificate_location true
Suppress Parameter Validation: Master TLS/SSL Server Private Key File (PEM Format) Whether to suppress configuration warnings produced by the built-in parameter validation for the Master TLS/SSL Server Private Key File (PEM Format) parameter. false role_config_suppression_ssl_server_privatekey_location true
Suppress Parameter Validation: Master TLS/SSL Private Key Password Whether to suppress configuration warnings produced by the built-in parameter validation for the Master TLS/SSL Private Key Password parameter. false role_config_suppression_ssl_server_privatekey_password true
Suppress Parameter Validation: Kudu Master Web UI Interface Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Master Web UI Interface parameter. false role_config_suppression_webserver_interface true
Suppress Parameter Validation: Kudu Master Web UI Port Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Master Web UI Port parameter. false role_config_suppression_webserver_port true
Suppress Health Test: Audit Pipeline Test Whether to suppress the results of the Audit Pipeline Test heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_master_audit_health true
Suppress Health Test: File Descriptors Whether to suppress the results of the File Descriptors heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_master_file_descriptor true
Suppress Health Test: Host Health Whether to suppress the results of the Host Health heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_master_host_health true
Suppress Health Test: Log Directory Free Space Whether to suppress the results of the Log Directory Free Space heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_master_log_directory_free_space true
Suppress Health Test: Process Status Whether to suppress the results of the Process Status heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_master_scm_health true
Suppress Health Test: Swap Memory Usage Whether to suppress the results of the Swap Memory Usage heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_master_swap_memory_usage true
Suppress Health Test: Unexpected Exits Whether to suppress the results of the Unexpected Exits heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_master_unexpected_exits true

Service-Wide

Categories:

Advanced

Display Name Description Related Name Default Value API Name Required
Kudu Service Advanced Configuration Snippet (Safety Valve) for gflagfile For advanced use only, a string to be inserted into gflagfile. Applies to configurations of all roles in this service except client configuration. gflagfile_service_safety_valve false
Kudu Service Advanced Configuration Snippet (Safety Valve) for kudu-monitoring.properties For advanced use only, a string to be inserted into kudu-monitoring.properties. Applies to configurations of all roles in this service except client configuration. kudu-monitoring.properties_service_safety_valve false
Kudu Service Environment Advanced Configuration Snippet (Safety Valve) For advanced use only, key-value pairs (one on each line) to be inserted into a role's environment. Applies to configurations of all roles in this service except client configuration. KUDU_service_env_safety_valve false
System Group The group that this service's processes should run as. kudu process_groupname true
System User The user that this service's processes should run as. kudu process_username true

Monitoring

Display Name Description Related Name Default Value API Name Required
Enable Service Level Health Alerts When set, Cloudera Manager will send alerts when the health of this service reaches the threshold specified by the EventServer setting eventserver_health_events_alert_threshold true enable_alerts false
Enable Configuration Change Alerts When set, Cloudera Manager will send alerts when this entity's configuration changes. false enable_config_alerts false
Healthy Master Monitoring Thresholds The health test thresholds of the overall Master health. The check returns "Concerning" health if the percentage of "Healthy" Masters falls below the warning threshold. The check is unhealthy if the total percentage of "Healthy" and "Concerning" Masters falls below the critical threshold. Warning: 80.1 %, Critical: 60.0 % KUDU_KUDU_MASTER_healthy_thresholds false
Healthy Tablet Server Monitoring Thresholds The health test thresholds of the overall Tablet Server health. The check returns "Concerning" health if the percentage of "Healthy" Tablet Servers falls below the warning threshold. The check is unhealthy if the total percentage of "Healthy" and "Concerning" Tablet Servers falls below the critical threshold. Warning: 75.0 %, Critical: 50.0 % KUDU_KUDU_TSERVER_healthy_thresholds false
Service Triggers The configured triggers for this service. This is a JSON-formatted list of triggers. These triggers are evaluated as part as the health system. Every trigger expression is parsed, and if the trigger condition is met, the list of actions provided in the trigger expression is executed. Each trigger has the following fields:
  • triggerName (mandatory) - The name of the trigger. This value must be unique for the specific service.
  • triggerExpression (mandatory) - A tsquery expression representing the trigger.
  • streamThreshold (optional) - The maximum number of streams that can satisfy a condition of a trigger before the condition fires. By default set to 0, and any stream returned causes the condition to fire.
  • enabled (optional) - By default set to 'true'. If set to 'false', the trigger is not evaluated.
  • expressionEditorConfig (optional) - Metadata for the trigger editor. If present, the trigger should only be edited from the Edit Trigger page; editing the trigger here can lead to inconsistencies.
For example, the followig JSON formatted trigger fires if there are more than 10 DataNodes with more than 500 file descriptors opened:[{"triggerName": "sample-trigger", "triggerExpression": "IF (SELECT fd_open WHERE roleType = DataNode and last(fd_open) > 500) DO health:bad", "streamThreshold": 10, "enabled": "true"}]See the trigger rules documentation for more details on how to write triggers using tsquery.The JSON format is evolving and may change and, as a result, backward compatibility is not guaranteed between releases.		 [] service_triggers true
Service Monitor Derived Configs Advanced Configuration Snippet (Safety Valve) For advanced use only, a list of derived configuration properties that will be used by the Service Monitor instead of the default ones. smon_derived_configs_safety_valve false

Other

Display Name Description Related Name Default Value API Name Required
Enable Core Dump Used to generate a core dump to get more information about a Kudu crash. Unless otherwise configured systemwide using /proc/sys/kernel/core_pattern, the dump is generated in the configured core dump directory. The core file can be very large. enable_core_dump false enable_core_dump true
Enable Secure Authentication And Encryption Enable secure authentication and encryption between all Kudu clients and servers as well as between individual servers. Kerberos must be configured. enable_security false enable_security true
Maximum Number of Per-tablet-server Replica Moves Maximum number of replica moves to perform concurrently on one tablet server: moves of replicas to the server and moves of replicas off of the server count against this limit. rb_max_moves_per_server 5 rb_max_moves_per_server false
Maximum Allowed Runtime of the Rebalancing Tool Maximum time to run the rebalancing, in seconds. Specifying 0 means not imposing any limit on the rebalancing run time. rb_max_run_time_sec 0 rb_max_run_time_sec false
Maximum Allowed Duration Without Rebalancer Progress Maximum duration of the 'staleness' interval where the rebalance can not make progress. If this period elapses without the rebalancer making progress, it will exit indicating failure. This may happen in case of a persistent problem with the cluster or when some unexpected concurrent activity is present (such as automatic recovery of failed replicas, etc.) rb_max_staleness_interval_sec 300 rb_max_staleness_interval_sec false
Superuser Access Control List The 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. superuser_acl superuser_acl false
User Access Control List The list of usernames who may access the cluster, comma-separated. A '*' entry indicates that all authenticated users are allowed. user_acl * user_acl false

Security

Display Name Description Related Name Default Value API Name Required
Kerberos Principal Kerberos principal short name used by all roles of this service. kudu kerberos_princ_name true

Suppressions

Display Name Description Related Name Default Value API Name Required
Suppress Parameter Validation: Kudu Service Advanced Configuration Snippet (Safety Valve) for gflagfile Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Service Advanced Configuration Snippet (Safety Valve) for gflagfile parameter. false service_config_suppression_gflagfile_service_safety_valve true
Suppress Parameter Validation: Kerberos Principal Whether to suppress configuration warnings produced by the built-in parameter validation for the Kerberos Principal parameter. false service_config_suppression_kerberos_princ_name true
Suppress Parameter Validation: Kudu Service Advanced Configuration Snippet (Safety Valve) for kudu-monitoring.properties Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Service Advanced Configuration Snippet (Safety Valve) for kudu-monitoring.properties parameter. false service_config_suppression_kudu-monitoring.properties_service_safety_valve true
Suppress Configuration Validator: Master Count Validator Whether to suppress configuration warnings produced by the Master Count Validator configuration validator. false service_config_suppression_kudu_master_count_validator true
Suppress Parameter Validation: Kudu Service Environment Advanced Configuration Snippet (Safety Valve) Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Service Environment Advanced Configuration Snippet (Safety Valve) parameter. false service_config_suppression_kudu_service_env_safety_valve true
Suppress Configuration Validator: Tablet Server Count Validator Whether to suppress configuration warnings produced by the Tablet Server Count Validator configuration validator. false service_config_suppression_kudu_tserver_count_validator true
Suppress Parameter Validation: System Group Whether to suppress configuration warnings produced by the built-in parameter validation for the System Group parameter. false service_config_suppression_process_groupname true
Suppress Parameter Validation: System User Whether to suppress configuration warnings produced by the built-in parameter validation for the System User parameter. false service_config_suppression_process_username true
Suppress Parameter Validation: Service Triggers Whether to suppress configuration warnings produced by the built-in parameter validation for the Service Triggers parameter. false service_config_suppression_service_triggers true
Suppress Parameter Validation: Service Monitor Derived Configs Advanced Configuration Snippet (Safety Valve) Whether to suppress configuration warnings produced by the built-in parameter validation for the Service Monitor Derived Configs Advanced Configuration Snippet (Safety Valve) parameter. false service_config_suppression_smon_derived_configs_safety_valve true
Suppress Parameter Validation: Superuser Access Control List Whether to suppress configuration warnings produced by the built-in parameter validation for the Superuser Access Control List parameter. false service_config_suppression_superuser_acl true
Suppress Parameter Validation: User Access Control List Whether to suppress configuration warnings produced by the built-in parameter validation for the User Access Control List parameter. false service_config_suppression_user_acl true
Suppress Health Test: Master Health Whether to suppress the results of the Master Health heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false service_health_suppression_kudu_kudu_master_healthy true
Suppress Health Test: Tablet Server Health Whether to suppress the results of the Tablet Server Health heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false service_health_suppression_kudu_kudu_tserver_healthy true

Tablet Server

Categories:

Advanced

Display Name Description Related Name Default Value API Name Required
Tablet Server Advanced Configuration Snippet (Safety Valve) for gflagfile For advanced use only. A string to be inserted into gflagfile for this role only. gflagfile_role_safety_valve false
Tablet Server Advanced Configuration Snippet (Safety Valve) for kudu-monitoring.properties For advanced use only. A string to be inserted into kudu-monitoring.properties for this role only. kudu-monitoring.properties_role_safety_valve false
Tablet Server Environment Advanced Configuration Snippet (Safety Valve) For advanced use only, key-value pairs (one on each line) to be inserted into a role's environment. Applies to configurations of this role except client configuration. KUDU_TSERVER_role_env_safety_valve false
Automatically Restart Process When set, this role's process is automatically (and transparently) restarted in the event of an unexpected failure. false process_auto_restart true
Enable Metric Collection Cloudera Manager agent monitors each service and each of its role by publishing metrics to the Cloudera Manager Service Monitor. Setting it to false will stop Cloudera Manager agent from publishing any metric for corresponding service/roles. This is usually helpful for services that generate large amount of metrics which Service Monitor is not able to process. true process_should_monitor true

Logs

Display Name Description Related Name Default Value API Name Required
Tablet Server Maximum Log Level to Buffer Log messages logged at this level or lower are buffered in memory. logbuflevel 0 glog_logbuflevel false
Tablet Server Maximum Log Size Approximate maximum log file size in megabytes before rolling to a new log file. max_log_size 1800 MiB glog_maxlogsize false
Tablet Server Minimum Log Level Messages logged via LOG() at a lower level than this are not logged anywhere. minloglevel 0 glog_minloglevel false
Tablet Server Minimum Log Verbosity Messages logged via VLOG() at a lower verbosity than this are not logged anywhere. v 0 glog_verbose false
Tablet Server Log Directory The log directory for log files of the role Tablet Server. log_dir /var/log/kudu log_dir false

Monitoring

Display Name Description Related Name Default Value API Name Required
Enable Health Alerts for this Role When set, Cloudera Manager will send alerts when the health of this role reaches the threshold specified by the EventServer setting eventserver_health_events_alert_threshold true enable_alerts false
Enable Configuration Change Alerts When set, Cloudera Manager will send alerts when this entity's configuration changes. false enable_config_alerts false
Enable Failed Data Directories Enables or disables the health test. When disabled, the test does not run at all, nor generate health history. true KUDU-5.16.0-FAILED_DATA_DIRS_test_enable false
Enable Full Data Directories Enables or disables the health test. When disabled, the test does not run at all, nor generate health history. true KUDU-5.16.0-FULL_DATA_DIRS_test_enable false
File Descriptor Monitoring Thresholds The health test thresholds of the number of file descriptors used. Specified as a percentage of file descriptor limit. Warning: 50.0 %, Critical: 70.0 % kudu_tserver_fd_thresholds false
Tablet Server Host Health Test When computing the overall Tablet Server health, consider the host's health. true kudu_tserver_host_health_enabled false
Tablet Server Process Health Test Enables the health test that the Tablet Server's process state is consistent with the role configuration true kudu_tserver_scm_health_enabled false
Log Directory Free Space Monitoring Absolute Thresholds The health test thresholds for monitoring of free space on the filesystem that contains this role's log directory. Warning: 10 GiB, Critical: 5 GiB log_directory_free_space_absolute_thresholds false
Log Directory Free Space Monitoring Percentage Thresholds The health test thresholds for monitoring of free space on the filesystem that contains this role's log directory. Specified as a percentage of the capacity on that filesystem. This setting is not used if a Log Directory Free Space Monitoring Absolute Thresholds setting is configured. Warning: Never, Critical: Never log_directory_free_space_percentage_thresholds false
Process Swap Memory Thresholds The health test thresholds on the swap memory usage of the process. This takes precedence over the host level threshold. Warning: 200 B, Critical: Never process_swap_memory_thresholds false
Role Triggers The configured triggers for this role. This is a JSON-formatted list of triggers. These triggers are evaluated as part as the health system. Every trigger expression is parsed, and if the trigger condition is met, the list of actions provided in the trigger expression is executed. Each trigger has the following fields:
  • triggerName (mandatory) - The name of the trigger. This value must be unique for the specific role.
  • triggerExpression (mandatory) - A tsquery expression representing the trigger.
  • streamThreshold (optional) - The maximum number of streams that can satisfy a condition of a trigger before the condition fires. By default set to 0, and any stream returned causes the condition to fire.
  • enabled (optional) - By default set to 'true'. If set to 'false', the trigger is not evaluated.
  • expressionEditorConfig (optional) - Metadata for the trigger editor. If present, the trigger should only be edited from the Edit Trigger page; editing the trigger here can lead to inconsistencies.
For example, the following JSON formatted trigger configured for a DataNode fires if the DataNode has more than 1500 file descriptors opened:[{"triggerName": "sample-trigger", "triggerExpression": "IF (SELECT fd_open WHERE roleName=$ROLENAME and last(fd_open) > 1500) DO health:bad", "streamThreshold": 0, "enabled": "true"}]See the trigger rules documentation for more details on how to write triggers using tsquery.The JSON format is evolving and may change and, as a result, backward compatibility is not guaranteed between releases.		 [] role_triggers true
Unexpected Exits Thresholds The health test thresholds for unexpected exits encountered within a recent period specified by the unexpected_exits_window configuration for the role. Warning: Never, Critical: Any unexpected_exits_thresholds false
Unexpected Exits Monitoring Period The period to review when computing unexpected exits. 5 minute(s) unexpected_exits_window false

Other

Display Name Description Related Name Default Value API Name Required
Kudu Tablet Server Block Cache Capacity Maximum amount of memory allocated to the Kudu Tablet Server's block cache. block_cache_capacity_mb 512 MiB block_cache_capacity_mb true
Tablet Server Diagnostics Collection Timeout The timeout in milliseconds to wait for diagnostics collection to complete. 1 minute(s) csd_role_diagnostics_timeout false
Kudu Tablet Server Data Directories Directories where Kudu tablet servers will store data blocks. fs_data_dirs fs_data_dirs true
Kudu Tablet Server WAL Directory Directory where Kudu tablet servers will store write-ahead logs. It can be the same as one of the data directories, but not a sub-directory of a data directory. Master and tablet servers must use different directories when co-located on the same machine. fs_wal_dir fs_wal_dir true
Kudu Tablet Server WAL Fsyncs All Entries If true, the Tablet Server will use the fsync system call to ensure that all writes are durably written to to the write-ahead log (WAL) before responding. If false, edits will be written to the Linux buffer cache on a majority of replicas before responding. log_force_fsync_all false log_force_fsync_all true
Kudu Tablet Server Maintenance Threads The number of threads devoted to background maintenance operations such as flushes and compactions. If the tablet server appears to be falling behind on write operations (inserts, updates, and deletes) but CPU and disk resources are not saturated, increasing this thread count will devote more resources to these background operations. maintenance_manager_num_threads 1 maintenance_manager_num_threads true
Kudu Tablet Server Hard Memory Limit Maximum amount of memory that the Kudu Tablet Server will use before it starts rejecting all incoming writes. memory_limit_hard_bytes 4 GiB memory_limit_hard_bytes true
Kudu Tablet Server Core Dump Directory If Enable Core Dump is set, Kudu Tablet Servers will dump cores to this location. tserver_core_dump_directory /var/log/kudu tserver_core_dump_directory true
Kudu Tablet Server Web UI Interface The interface of the Kudu Tablet Server Web UI. If blank, binds to 0.0.0.0. webserver_interface webserver_interface false

Performance

Display Name Description Related Name Default Value API Name Required
Maximum Process File Descriptors If configured, overrides the process soft and hard rlimits (also called ulimits) for file descriptors to the configured value. rlimit_fds false

Ports and Addresses

Display Name Description Related Name Default Value API Name Required
Kudu Tablet Server Web UI Port The port of the Kudu Tablet Server Web UI. webserver_port 8050 webserver_port true

Resource Management

Display Name Description Related Name Default Value API Name Required
Cgroup CPU Shares Number of CPU shares to assign to this role. The greater the number of shares, the larger the share of the host's CPUs that will be given to this role when the host experiences CPU contention. Must be between 2 and 262144. Defaults to 1024 for processes not managed by Cloudera Manager. cpu.shares 1024 rm_cpu_shares true
Cgroup I/O Weight Weight for the read I/O requests issued by this role. The greater the weight, the higher the priority of the requests when the host experiences I/O contention. Must be between 100 and 1000. Defaults to 1000 for processes not managed by Cloudera Manager. blkio.weight 500 rm_io_weight true
Cgroup Memory Hard Limit Hard memory limit to assign to this role, enforced by the Linux kernel. When the limit is reached, the kernel will reclaim pages charged to the process. If reclaiming fails, the kernel may kill the process. Both anonymous as well as page cache pages contribute to the limit. Use a value of -1 B to specify no limit. By default processes not managed by Cloudera Manager will have no limit. memory.limit_in_bytes -1 MiB rm_memory_hard_limit true
Cgroup Memory Soft Limit Soft memory limit to assign to this role, enforced by the Linux kernel. When the limit is reached, the kernel will reclaim pages charged to the process if and only if the host is facing memory pressure. If reclaiming fails, the kernel may kill the process. Both anonymous as well as page cache pages contribute to the limit. Use a value of -1 B to specify no limit. By default processes not managed by Cloudera Manager will have no limit. memory.soft_limit_in_bytes -1 MiB rm_memory_soft_limit true

Security

Display Name Description Related Name Default Value API Name Required
Enable TLS/SSL for Tablet Server Encrypt communication between clients and Tablet Server using Transport Layer Security (TLS) (formerly known as Secure Socket Layer (SSL)). ssl_enabled false ssl_enabled false
Tablet Server TLS/SSL Server CA Certificate (PEM Format) The path to the TLS/SSL file containing the certificate of the certificate authority (CA) and any intermediate certificates used to sign the server certificate. Used when Tablet Server is acting as a TLS/SSL server. The certificate file must be in PEM format, and is usually created by concatenating all of the appropriate root and intermediate certificates. ssl_server_ca_certificate_location false
Tablet Server TLS/SSL Server Certificate File (PEM Format) The path to the TLS/SSL file containing the server certificate key used for TLS/SSL. Used when Tablet Server is acting as a TLS/SSL server. The certificate file must be in PEM format. webserver_certificate_file ssl_server_certificate_location false
Tablet Server TLS/SSL Server Private Key File (PEM Format) The path to the TLS/SSL file containing the private key used for TLS/SSL. Used when Tablet Server is acting as a TLS/SSL server. The certificate file must be in PEM format. webserver_private_key_file ssl_server_privatekey_location false
Tablet Server TLS/SSL Private Key Password The password for the private key in the Tablet Server TLS/SSL Server Certificate and Private Key file. If left blank, the private key is not protected by a password. webserver_private_key_password_cmd ssl_server_privatekey_password false

Suppressions

Display Name Description Related Name Default Value API Name Required
Suppress Parameter Validation: Kudu Tablet Server Block Cache Capacity Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Tablet Server Block Cache Capacity parameter. false role_config_suppression_block_cache_capacity_mb true
Suppress Configuration Validator: CDH Version Validator Whether to suppress configuration warnings produced by the CDH Version Validator configuration validator. false role_config_suppression_cdh_version_validator true
Suppress Parameter Validation: Kudu Tablet Server Data Directories Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Tablet Server Data Directories parameter. false role_config_suppression_fs_data_dirs true
Suppress Parameter Validation: Kudu Tablet Server WAL Directory Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Tablet Server WAL Directory parameter. false role_config_suppression_fs_wal_dir true
Suppress Parameter Validation: Tablet Server Advanced Configuration Snippet (Safety Valve) for gflagfile Whether to suppress configuration warnings produced by the built-in parameter validation for the Tablet Server Advanced Configuration Snippet (Safety Valve) for gflagfile parameter. false role_config_suppression_gflagfile_role_safety_valve true
Suppress Parameter Validation: Tablet Server Advanced Configuration Snippet (Safety Valve) for kudu-monitoring.properties Whether to suppress configuration warnings produced by the built-in parameter validation for the Tablet Server Advanced Configuration Snippet (Safety Valve) for kudu-monitoring.properties parameter. false role_config_suppression_kudu-monitoring.properties_role_safety_valve true
Suppress Parameter Validation: Tablet Server Environment Advanced Configuration Snippet (Safety Valve) Whether to suppress configuration warnings produced by the built-in parameter validation for the Tablet Server Environment Advanced Configuration Snippet (Safety Valve) parameter. false role_config_suppression_kudu_tserver_role_env_safety_valve true
Suppress Parameter Validation: Tablet Server Log Directory Whether to suppress configuration warnings produced by the built-in parameter validation for the Tablet Server Log Directory parameter. false role_config_suppression_log_dir true
Suppress Parameter Validation: Kudu Tablet Server Maintenance Threads Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Tablet Server Maintenance Threads parameter. false role_config_suppression_maintenance_manager_num_threads true
Suppress Parameter Validation: Kudu Tablet Server Hard Memory Limit Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Tablet Server Hard Memory Limit parameter. false role_config_suppression_memory_limit_hard_bytes true
Suppress Parameter Validation: Role Triggers Whether to suppress configuration warnings produced by the built-in parameter validation for the Role Triggers parameter. false role_config_suppression_role_triggers true
Suppress Parameter Validation: Tablet Server TLS/SSL Server CA Certificate (PEM Format) Whether to suppress configuration warnings produced by the built-in parameter validation for the Tablet Server TLS/SSL Server CA Certificate (PEM Format) parameter. false role_config_suppression_ssl_server_ca_certificate_location true
Suppress Parameter Validation: Tablet Server TLS/SSL Server Certificate File (PEM Format) Whether to suppress configuration warnings produced by the built-in parameter validation for the Tablet Server TLS/SSL Server Certificate File (PEM Format) parameter. false role_config_suppression_ssl_server_certificate_location true
Suppress Parameter Validation: Tablet Server TLS/SSL Server Private Key File (PEM Format) Whether to suppress configuration warnings produced by the built-in parameter validation for the Tablet Server TLS/SSL Server Private Key File (PEM Format) parameter. false role_config_suppression_ssl_server_privatekey_location true
Suppress Parameter Validation: Tablet Server TLS/SSL Private Key Password Whether to suppress configuration warnings produced by the built-in parameter validation for the Tablet Server TLS/SSL Private Key Password parameter. false role_config_suppression_ssl_server_privatekey_password true
Suppress Parameter Validation: Kudu Tablet Server Core Dump Directory Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Tablet Server Core Dump Directory parameter. false role_config_suppression_tserver_core_dump_directory true
Suppress Parameter Validation: Kudu Tablet Server Web UI Interface Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Tablet Server Web UI Interface parameter. false role_config_suppression_webserver_interface true
Suppress Parameter Validation: Kudu Tablet Server Web UI Port Whether to suppress configuration warnings produced by the built-in parameter validation for the Kudu Tablet Server Web UI Port parameter. false role_config_suppression_webserver_port true
Suppress Health Test: Failed Data Directories Whether to suppress the results of the Failed Data Directories heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu-5.16.0-failed_data_dirs true
Suppress Health Test: Full Data Directories Whether to suppress the results of the Full Data Directories heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu-5.16.0-full_data_dirs true
Suppress Health Test: Audit Pipeline Test Whether to suppress the results of the Audit Pipeline Test heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_tserver_audit_health true
Suppress Health Test: File Descriptors Whether to suppress the results of the File Descriptors heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_tserver_file_descriptor true
Suppress Health Test: Host Health Whether to suppress the results of the Host Health heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_tserver_host_health true
Suppress Health Test: Log Directory Free Space Whether to suppress the results of the Log Directory Free Space heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_tserver_log_directory_free_space true
Suppress Health Test: Process Status Whether to suppress the results of the Process Status heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_tserver_scm_health true
Suppress Health Test: Swap Memory Usage Whether to suppress the results of the Swap Memory Usage heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_tserver_swap_memory_usage true
Suppress Health Test: Unexpected Exits Whether to suppress the results of the Unexpected Exits heath test. The results of suppressed health tests are ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts. false role_health_suppression_kudu_kudu_tserver_unexpected_exits true