Kafka Properties in CDH 5.5.0
Role groups:
Gateway
Advanced
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Deploy Directory | The directory where the client configs will be deployed | /etc/kafka | client_config_root_dir | true | |
Kafka Client Advanced Configuration Snippet (Safety Valve) for kafka-conf/kafka-client.conf | For advanced use only, a string to be inserted into the client configuration for kafka-conf/kafka-client.conf. | kafka-conf/kafka-client.conf_client_config_safety_valve | false | ||
Gateway Logging Advanced Configuration Snippet (Safety Valve) | For advanced use only, a string to be inserted into log4j.properties for this role only. | log4j_safety_valve | false |
Logs
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Gateway Logging Threshold | The minimum log level for Gateway logs | INFO | log_threshold | false |
Monitoring
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Enable Configuration Change Alerts | When set, Cloudera Manager will send alerts when this entity's configuration changes. | false | enable_config_alerts | false |
Other
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Alternatives Priority | The priority level that the client configuration will have in the Alternatives system on the hosts. Higher priority levels will cause Alternatives to prefer this configuration over any others. | 50 | client_config_priority | true |
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: Deploy Directory | Whether to suppress configuration warnings produced by the built-in parameter validation for the Deploy Directory parameter. | false | role_config_suppression_client_config_root_dir | true | |
Suppress Parameter Validation: Kafka Client Advanced Configuration Snippet (Safety Valve) for kafka-conf/kafka-client.conf | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka Client Advanced Configuration Snippet (Safety Valve) for kafka-conf/kafka-client.conf parameter. | false | role_config_suppression_kafka-conf/kafka-client.conf_client_config_safety_valve | true | |
Suppress Parameter Validation: Gateway Logging Advanced Configuration Snippet (Safety Valve) | Whether to suppress configuration warnings produced by the built-in parameter validation for the Gateway Logging Advanced Configuration Snippet (Safety Valve) parameter. | false | role_config_suppression_log4j_safety_valve | true |
Kafka Broker
Advanced
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Kafka Broker Advanced Configuration Snippet (Safety Valve) for kafka-monitoring.properties | For advanced use only. A string to be inserted into kafka-monitoring.properties for this role only. | kafka-monitoring.properties_role_safety_valve | false | ||
Kafka Broker Advanced Configuration Snippet (Safety Valve) for kafka.properties | For advanced use only. A string to be inserted into kafka.properties for this role only. | kafka.properties_role_safety_valve | false | ||
Kafka Broker 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. | KAFKA_BROKER_role_env_safety_valve | false | ||
Kafka Broker Logging Advanced Configuration Snippet (Safety Valve) | For advanced use only, a string to be inserted into log4j.properties for this role only. | log4j_safety_valve | false | ||
Heap Dump Directory | Path to directory where heap dumps are generated when java.lang.OutOfMemoryError error is thrown. This directory is automatically created if it does not exist. If this directory already exists, role user must have write access to this directory. If this directory is shared among multiple roles, it should have 1777 permissions. The heap dump files are created with 600 permissions and are owned by the role user. The amount of free space in this directory should be greater than the maximum Java Process heap size configured for this role. | oom_heap_dump_dir | /tmp | oom_heap_dump_dir | false |
Dump Heap When Out of Memory | When set, generates heap dump file when java.lang.OutOfMemoryError is thrown. | true | oom_heap_dump_enabled | true | |
Kill When Out of Memory | When set, a SIGKILL signal is sent to the role process when java.lang.OutOfMemoryError is thrown. | true | oom_sigkill_enabled | true | |
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 | |
Kafka Broker Advanced Configuration Snippet (Safety Valve) for ssl.properties | For advanced use only. A string to be inserted into ssl.properties for this role only. | ssl.properties_role_safety_valve | false |
Logs
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Kafka Broker Log Directory | The log directory for log files of the role Kafka Broker. | kafka.log4j.dir | /var/log/kafka | log_dir | false |
Kafka Broker Logging Threshold | The minimum log level for Kafka Broker logs | INFO | log_threshold | false | |
Kafka Broker Maximum Log File Backups | The maximum number of rolled log files to keep for Kafka Broker logs. Typically used by log4j or logback. | 10 | max_log_backup_index | false | |
Kafka Broker Max Log Size | The maximum size, in megabytes, per log file for Kafka Broker logs. Typically used by log4j or logback. | 200 MiB | max_log_size | 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 % | kafka_broker_fd_thresholds | false | |
Kafka Broker Host Health Test | When computing the overall Kafka Broker health, consider the host's health. | true | kafka_broker_host_health_enabled | false | |
Kafka Broker Process Health Test | Enables the health test that the Kafka Broker's process state is consistent with the role configuration | true | kafka_broker_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. | Warning: Any, 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:
|
[] | 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 |
---|---|---|---|---|---|
Advertised Host | If set, this is the hostname given out to producers, consumers, and other brokers to use in establishing connections. Never set this property at the group level; it should always be overriden on instance level. | advertised.host.name | advertised.host.name | false | |
Authenticate Zookeeper Connection | Authenticate a SASL connection with zookeeper, if Kerberos authentication is enabled. It also allows a broker to set SASL ACL on zookeeper nodes which locks these nodes down so that only kafka broker can modify. | authenticate.zookeeper.connection | true | authenticate.zookeeper.connection | false |
Broker ID | ID uniquely identifying each broker. Never set this property at the group level; it should always be overridden on instance level. | broker.id | broker.id | false | |
Additional Broker Java Options | These arguments are passed as part of the Java command line. Commonly, garbage collection flags or extra debugging flags are passed here. | broker_java_opts | -server -XX:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled -XX:+CMSScavengeBeforeRemark -XX:+DisableExplicitGC -Djava.awt.headless=true | broker_java_opts | false |
Java Heap Size of Broker | Maximum size for the Java process heap memory. Passed to Java -Xmx. Measured in megabytes. Kafka does not generally require setting large heap sizes. It is better to let the file system cache utilize the available memory. | broker_max_heap_size | 1 GiB | broker_max_heap_size | false |
Graceful Shutdown Timeout | The timeout in milliseconds to wait for graceful shutdown to complete. | 30 second(s) | graceful_stop_timeout | false | |
HTTP Metric Report Host | Host the HTTP metric reporter binds to. | kafka.http.metrics.host | 0.0.0.0 | kafka.http.metrics.host | false |
Data Directories | A list of one or more directories in which Kafka data is stored.. Each new partition created is placed in the directory that currently has the fewest partitions.. Each directory should be on its own separate drive. | log.dirs | /var/local/kafka/data | log.dirs | true |
Data Retention Size | The amount of data to retain in the log for each topic-partition. This is the limit per partition: multiply by the number of partitions to get the total data retained for the topic. The special value of -1 is interpreted as unlimited. If both log.retention.ms and log.retention.bytes are set, a segment is deleted when either limit is exceeded. | log.retention.bytes | -1 B | log.retention.bytes | false |
Data Retention Check Interval | The frequency, in milliseconds, that the log cleaner checks whether any log segment is eligible for deletion, per retention policies. | log.retention.check.interval.ms | 5 minute(s) | log.retention.check.interval.ms | false |
Data Retention Hours | The maximum time before a new log segment is rolled out (in hours). Secondary to the log.retention.ms property. The special value of -1 is interpreted as unlimited. This property is deprecated in Kafka 1.4.0. Use log.retention.ms. | log.retention.hours | 7 day(s) | log.retention.hours | false |
Data Retention Time | The maximum time before a new log segment is rolled out. If both log.retention.ms and log.retention.bytes are set, a segment is deleted when either limit is exceeded. The special value of -1 is interpreted as unlimited. This property is used in Kafka 1.4.0 and later in place of log.retention.hours. | log.retention.ms | log.retention.ms | false | |
Data Log Roll Hours | The maximum time before a new log segment is rolled out (in hours). This property is deprecated in Cloudera Kafka 1.4.0; use log.roll.ms. | log.roll.hours | 7 day(s) | log.roll.hours | false |
Data Log Roll Time | The maximum time before a new log segment is rolled out. This property is used in Cloudera Kafka 1.4.0 and later in place of log.roll.hours. | log.roll.ms | log.roll.ms | false | |
Segment File Size | The log for a topic partition is stored as a directory of segment files. This setting controls the size to which a segment file can grow before a new segment is rolled over in the log. This value should be larger than message.max.bytes. | log.segment.bytes | 1 GiB | log.segment.bytes | false |
Maximum Connections per IP Address | Maximum number of connections allowed from each IP address. | max.connections.per.ip | max.connections.per.ip | false | |
Number of I/O Threads | The number of I/O threads that the server uses for executing requests. You should have at least as many threads as you have disks. | num.io.threads | 8 | num.io.threads | false |
Inter Broker Protocol | Protocol to be used for inter-broker communication. INFERRED will use the same protocol configured for external clients. | security.inter.broker.protocol | INFERRED | security.inter.broker.protocol | false |
SSL Client Authentication | Client authentication mode for SSL connections. Default is none, could be set to "required", i.e., client authentication is required or to "requested", i.e., client authentication is requested and client without certificates can still connect. | ssl.client.auth | none | ssl.client.auth | false |
Super users | Users who are allowed to perform any action on the Kafka cluster. | super.users | kafka | super.users | 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 |
---|---|---|---|---|---|
Advertised Port | The port to give out to producers, consumers, and other brokers to use in establishing connections. This only needs to be set if this port is different from the port the server should bind to. | advertised.port | advertised.port | false | |
JMX Port | Port for JMX. | jmx_port | 9393 | jmx_port | false |
HTTP Metric Report Port | Port the HTTP metric reporter listens on. | kafka.http.metrics.port | 24042 | kafka.http.metrics.port | false |
TCP Port | Kafka broker port. | port | 9092 | port | false |
TLS/SSL Port | Kafka broker secure port. | ssl_port | 9093 | ssl_port | false |
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 |
---|---|---|---|---|---|
Kafka Broker TLS/SSL Certificate Trust Store File | The location on disk of the trust store, in .jks format, used to confirm the authenticity of TLS/SSL servers that Kafka Broker might connect to. This is used when Kafka Broker is the client in a TLS/SSL connection. This trust store must contain the certificate(s) used to sign the service(s) connected to. If this parameter is not provided, the default list of well-known certificate authorities is used instead. | ssl.truststore.location | ssl_client_truststore_location | false | |
Kafka Broker TLS/SSL Certificate Trust Store Password | The password for the Kafka Broker TLS/SSL Certificate Trust Store File. This password is not required to access the trust store; this field can be left blank. This password provides optional integrity checking of the file. The contents of trust stores are certificates, and certificates are public information. | ssl.truststore.password.generator | ssl_client_truststore_password | false | |
Enable TLS/SSL for Kafka Broker | Encrypt communication between clients and Kafka Broker using Transport Layer Security (TLS) (formerly known as Secure Socket Layer (SSL)). | ssl_enabled | false | ssl_enabled | false |
Kafka Broker TLS/SSL Server JKS Keystore Key Password | The password that protects the private key contained in the JKS keystore used when Kafka Broker is acting as a TLS/SSL server. | ssl.key.password.generator | ssl_server_keystore_keypassword | false | |
Kafka Broker TLS/SSL Server JKS Keystore File Location | The path to the TLS/SSL keystore file containing the server certificate and private key used for TLS/SSL. Used when Kafka Broker is acting as a TLS/SSL server. The keystore must be in JKS format. | ssl.keystore.location | ssl_server_keystore_location | false | |
Kafka Broker TLS/SSL Server JKS Keystore File Password | The password for the Kafka Broker JKS keystore file. | ssl.keystore.password.generator | ssl_server_keystore_password | false |
Stacks Collection
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Stacks Collection Data Retention | The amount of stacks data that is retained. After the retention limit is reached, the oldest data is deleted. | stacks_collection_data_retention | 100 MiB | stacks_collection_data_retention | false |
Stacks Collection Directory | The directory in which stacks logs are placed. If not set, stacks are logged into a stacks subdirectory of the role's log directory. | stacks_collection_directory | stacks_collection_directory | false | |
Stacks Collection Enabled | Whether or not periodic stacks collection is enabled. | stacks_collection_enabled | false | stacks_collection_enabled | true |
Stacks Collection Frequency | The frequency with which stacks are collected. | stacks_collection_frequency | 5.0 second(s) | stacks_collection_frequency | false |
Stacks Collection Method | The method used to collect stacks. The jstack option involves periodically running the jstack command against the role's daemon process. The servlet method is available for those roles that have an HTTP server endpoint exposing the current stacks traces of all threads. When the servlet method is selected, that HTTP endpoint is periodically scraped. | stacks_collection_method | jstack | stacks_collection_method | false |
Suppressions
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Suppress Parameter Validation: Advertised Host | Whether to suppress configuration warnings produced by the built-in parameter validation for the Advertised Host parameter. | false | role_config_suppression_advertised.host.name | true | |
Suppress Parameter Validation: Broker ID | Whether to suppress configuration warnings produced by the built-in parameter validation for the Broker ID parameter. | false | role_config_suppression_broker.id | true | |
Suppress Parameter Validation: Additional Broker Java Options | Whether to suppress configuration warnings produced by the built-in parameter validation for the Additional Broker Java Options parameter. | false | role_config_suppression_broker_java_opts | true | |
Suppress Parameter Validation: Java Heap Size of Broker | Whether to suppress configuration warnings produced by the built-in parameter validation for the Java Heap Size of Broker parameter. | false | role_config_suppression_broker_max_heap_size | 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: Kafka Broker Advanced Configuration Snippet (Safety Valve) for kafka-monitoring.properties | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka Broker Advanced Configuration Snippet (Safety Valve) for kafka-monitoring.properties parameter. | false | role_config_suppression_kafka-monitoring.properties_role_safety_valve | true | |
Suppress Parameter Validation: HTTP Metric Report Host | Whether to suppress configuration warnings produced by the built-in parameter validation for the HTTP Metric Report Host parameter. | false | role_config_suppression_kafka.http.metrics.host | true | |
Suppress Parameter Validation: Kafka Broker Advanced Configuration Snippet (Safety Valve) for kafka.properties | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka Broker Advanced Configuration Snippet (Safety Valve) for kafka.properties parameter. | false | role_config_suppression_kafka.properties_role_safety_valve | true | |
Suppress Parameter Validation: Kafka Broker Environment Advanced Configuration Snippet (Safety Valve) | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka Broker Environment Advanced Configuration Snippet (Safety Valve) parameter. | false | role_config_suppression_kafka_broker_role_env_safety_valve | true | |
Suppress Parameter Validation: Data Directories | Whether to suppress configuration warnings produced by the built-in parameter validation for the Data Directories parameter. | false | role_config_suppression_log.dirs | true | |
Suppress Parameter Validation: Segment File Size | Whether to suppress configuration warnings produced by the built-in parameter validation for the Segment File Size parameter. | false | role_config_suppression_log.segment.bytes | true | |
Suppress Parameter Validation: Kafka Broker Logging Advanced Configuration Snippet (Safety Valve) | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka Broker Logging Advanced Configuration Snippet (Safety Valve) parameter. | false | role_config_suppression_log4j_safety_valve | true | |
Suppress Parameter Validation: Kafka Broker Log Directory | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka Broker Log Directory parameter. | false | role_config_suppression_log_dir | true | |
Suppress Parameter Validation: Number of I/O Threads | Whether to suppress configuration warnings produced by the built-in parameter validation for the Number of I/O Threads parameter. | false | role_config_suppression_num.io.threads | true | |
Suppress Parameter Validation: Heap Dump Directory | Whether to suppress configuration warnings produced by the built-in parameter validation for the Heap Dump Directory parameter. | false | role_config_suppression_oom_heap_dump_dir | 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: Kafka Broker Advanced Configuration Snippet (Safety Valve) for ssl.properties | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka Broker Advanced Configuration Snippet (Safety Valve) for ssl.properties parameter. | false | role_config_suppression_ssl.properties_role_safety_valve | true | |
Suppress Parameter Validation: Kafka Broker TLS/SSL Certificate Trust Store File | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka Broker TLS/SSL Certificate Trust Store File parameter. | false | role_config_suppression_ssl_client_truststore_location | true | |
Suppress Parameter Validation: Kafka Broker TLS/SSL Certificate Trust Store Password | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka Broker TLS/SSL Certificate Trust Store Password parameter. | false | role_config_suppression_ssl_client_truststore_password | true | |
Suppress Parameter Validation: Kafka Broker TLS/SSL Server JKS Keystore Key Password | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka Broker TLS/SSL Server JKS Keystore Key Password parameter. | false | role_config_suppression_ssl_server_keystore_keypassword | true | |
Suppress Parameter Validation: Kafka Broker TLS/SSL Server JKS Keystore File Location | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka Broker TLS/SSL Server JKS Keystore File Location parameter. | false | role_config_suppression_ssl_server_keystore_location | true | |
Suppress Parameter Validation: Kafka Broker TLS/SSL Server JKS Keystore File Password | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka Broker TLS/SSL Server JKS Keystore File Password parameter. | false | role_config_suppression_ssl_server_keystore_password | true | |
Suppress Parameter Validation: Stacks Collection Directory | Whether to suppress configuration warnings produced by the built-in parameter validation for the Stacks Collection Directory parameter. | false | role_config_suppression_stacks_collection_directory | true | |
Suppress Parameter Validation: Super users | Whether to suppress configuration warnings produced by the built-in parameter validation for the Super users parameter. | false | role_config_suppression_super.users | 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_kafka_kafka_broker_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_kafka_kafka_broker_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_kafka_kafka_broker_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_kafka_kafka_broker_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_kafka_kafka_broker_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_kafka_kafka_broker_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_kafka_kafka_broker_unexpected_exits | true |
Kafka MirrorMaker
Advanced
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Kafka MirrorMaker 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. | KAFKA_MIRROR_MAKER_role_env_safety_valve | false | ||
Kafka MirrorMaker Logging Advanced Configuration Snippet (Safety Valve) | For advanced use only, a string to be inserted into log4j.properties for this role only. | log4j_safety_valve | false | ||
Kafka MirrorMaker Advanced Configuration Snippet (Safety Valve) for mirror_maker_consumers.properties | For advanced use only. A string to be inserted into mirror_maker_consumers.properties for this role only. | mirror_maker_consumers.properties_role_safety_valve | false | ||
Kafka MirrorMaker Advanced Configuration Snippet (Safety Valve) for mirror_maker_producers.properties | For advanced use only. A string to be inserted into mirror_maker_producers.properties for this role only. | mirror_maker_producers.properties_role_safety_valve | false | ||
Heap Dump Directory | Path to directory where heap dumps are generated when java.lang.OutOfMemoryError error is thrown. This directory is automatically created if it does not exist. If this directory already exists, role user must have write access to this directory. If this directory is shared among multiple roles, it should have 1777 permissions. The heap dump files are created with 600 permissions and are owned by the role user. The amount of free space in this directory should be greater than the maximum Java Process heap size configured for this role. | oom_heap_dump_dir | /tmp | oom_heap_dump_dir | false |
Dump Heap When Out of Memory | When set, generates heap dump file when java.lang.OutOfMemoryError is thrown. | true | oom_heap_dump_enabled | true | |
Kill When Out of Memory | When set, a SIGKILL signal is sent to the role process when java.lang.OutOfMemoryError is thrown. | true | oom_sigkill_enabled | true | |
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 | |
Kafka MirrorMaker Advanced Configuration Snippet (Safety Valve) for ssl_client.properties | For advanced use only. A string to be inserted into ssl_client.properties for this role only. | ssl_client.properties_role_safety_valve | false | ||
Kafka MirrorMaker Advanced Configuration Snippet (Safety Valve) for ssl_server.properties | For advanced use only. A string to be inserted into ssl_server.properties for this role only. | ssl_server.properties_role_safety_valve | false |
Logs
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Kafka MirrorMaker Log Directory | The log directory for log files of the role Kafka MirrorMaker. | kafka_mirrormaker.log4j.dir | /var/log/kafka | log_dir | false |
Kafka MirrorMaker Logging Threshold | The minimum log level for Kafka MirrorMaker logs | INFO | log_threshold | false | |
Kafka MirrorMaker Maximum Log File Backups | The maximum number of rolled log files to keep for Kafka MirrorMaker logs. Typically used by log4j or logback. | 10 | max_log_backup_index | false | |
Kafka MirrorMaker Max Log Size | The maximum size, in megabytes, per log file for Kafka MirrorMaker logs. Typically used by log4j or logback. | 200 MiB | max_log_size | 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 % | kafka_mirror_maker_fd_thresholds | false | |
Kafka MirrorMaker Host Health Test | When computing the overall Kafka MirrorMaker health, consider the host's health. | true | kafka_mirror_maker_host_health_enabled | false | |
Kafka MirrorMaker Process Health Test | Enables the health test that the Kafka MirrorMaker's process state is consistent with the role configuration | true | kafka_mirror_maker_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. | Warning: Any, 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:
|
[] | 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 |
---|---|---|---|---|---|
Abort on Send Failure | Stop the entire mirror maker when a send failure occurs. | abort.on.send.failure | true | abort.on.send.failure | false |
Producer Batch Size | This configuration controls the batch size in bytes. The producer will attempt to batch records together into fewer requests whenever multiple records are being sent to the same partition. This helps performance on both the client and the server. Only respected by Kafka 2.0 or later. | batch.size | 16 KiB | batch.size | false |
Topic Blacklist | Regular expression that represents a set of topics to avoid mirroring. Note that whitelist and blacklist parameters are mutually exclusive. If both are defined, only the whilelist is used. WARNING: Does not work with Kafka 2.0 or later. | blacklist | blacklist | false | |
Destination Broker List | List of brokers on destination cluster. This should be more than one, for high availability, but there's no need to list all brokers. | bootstrap.servers | bootstrap.servers | true | |
Producer Buffer Memory | The total bytes of memory the producer can use to buffer records waiting to be sent to the server. Only respected by Kafka 2.0 or later. | buffer.memory | 32 MiB | buffer.memory | false |
Producer Compression Type | The compression type for all data generated by the producer. Only respected by Kafka 2.0 or later. | compression.type | none | compression.type | false |
MirrorMaker Consumer Rebalance Listener | A consumer rebalance listener of type ConsumerRebalanceListener to be invoked when MirrorMaker's consumer rebalances. | consumer.rebalance.listener | consumer.rebalance.listener | false | |
MirrorMaker Consumer Rebalance Listener Arguments | Arguments used by MirrorMaker consumer rebalance listener. | consumer.rebalance.listener.args | consumer.rebalance.listener.args | false | |
Consumer Request Timeout | The maximum amount of time the consumer will wait for the response of a request. If the response is not received before the timeout elapses the consumer will resend the request if necessary or fail the request if retries are exhausted. Only respected by Kafka 2.0 or later. | consumer.request.timeout.ms | 40 second(s) | consumer.request.timeout.ms | false |
Destination Kafka Cluster's Security Protocol | Protocol to be used for communication with destination kafka cluster. | destination.security.protocol | PLAINTEXT | destination.security.protocol | false |
Destination Kafka Cluster's Client Auth | Only required if destination Kafka cluster requires client authentication. | destination.ssl.client.auth | false | destination.ssl.client.auth | false |
Consumer Minimum Fetch Size | The minimum amount of data the server should return for a fetch request. If insufficient data is available the request will wait for that much data to accumulate before answering the request. Setting this to something greater than 1 will cause the server to wait for larger amounts of data to accumulate which can improve server throughput a bit at the cost of some additional latency. | fetch.min.bytes | 1 B | fetch.min.bytes | false |
Consumer Group ID | Name of the consumer group used by MirrorMaker. When multiple role instances are configured with the same topics and same group ID, the role instances load-balance replication for the topics. When multiple role instances are configured with the same topics but different group ID, each role instance replicates all the events for those topics - this can be used to replicate the source cluster into multiple destination clusters. | group.id | cloudera_mirrormaker | group.id | false |
Producer Linger Time | The upper bound on the delay for batching. Once the producer gets a batch.size worth of records for a partition it will be sent immediately regardless of this setting. However if fewer than this many bytes accumulated for this partition the producer will 'linger' for the specified time waiting for more records to show up. Only respected by Kafka 2.0 or later. | linger.ms | 0 second(s) | linger.ms | false |
MirrorMaker Message Handler | A MirrorMaker message handler of type MirrorMakerMessageHandler that will process every record in-between producer and consumer. | message.handler | message.handler | false | |
MirrorMaker Message Handler Arguments | Arguments used by MirrorMaker message handler. | message.handler.args | message.handler.args | false | |
Additional MirrorMaker Java Options | These arguments are passed as part of the Java command line. Commonly, garbage collection flags or extra debugging flags are passed here. | mirror_maker_java_opts | -server -XX:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:+CMSClassUnloadingEnabled -XX:+CMSScavengeBeforeRemark -XX:+DisableExplicitGC -Djava.awt.headless=true | mirror_maker_java_opts | false |
Java Heap Size of MirrorMaker | Maximum size for the Java process heap memory. Passed to Java -Xmx. Measured in megabytes. | mirror_maker_max_heap_size | 1 GiB | mirror_maker_max_heap_size | false |
Avoid Data Loss | Run with MirrorMaker settings that eliminate potential loss of data. This impacts performance, but is highly recommended. WARNING: Does not work with Kafka 2.0 or later. | no.data.loss | true | no.data.loss | false |
Number of Producers | Number of producer instances. WARNING: Does not work with Kafka 2.0 or later. | num.producers | 1 | num.producers | false |
Number of Consumer Threads | Number of consumer threads. | num.streams | 1 | num.streams | false |
Offset Commit Interval | Offset commit interval in milliseconds. | offset.commit.interval.ms | 60000 | offset.commit.interval.ms | false |
Producer Request Timeout | The maximum amount of time the producer will wait for the response of a request. If the response is not received before the timeout elapses the producer will resend the request if necessary or fail the request if retries are exhausted. Only respected by Kafka 2.0 or later. | producer.request.timeout.ms | 30 second(s) | producer.request.timeout.ms | false |
Queue Size | Maximum number of bytes that can be buffered between producer and consumer. WARNING: Does not work with Kafka 2.0 or later. | queue.byte.size | 100000000 B | queue.byte.size | false |
Message Queue Size | Number of messages that are buffered between producer and consumer. WARNING: Does not work with Kafka 2.0 or later. | queue.size | 10000 | queue.size | false |
Consumer Session Timeout | The timeout used to detect failures when using Kafka's group management facilities. When a consumer's heartbeat is not received within the session timeout, the broker will mark the consumer as failed and rebalance the group. Note that the value must be in the allowable range as configured in the broker by group.min.session.timeout.ms and group.max.session.timeout.ms. Only respected by Kafka 2.0 or later. | session.timeout.ms | 30 second(s) | session.timeout.ms | false |
Source Broker List | List of brokers on source cluster. This should be more than one, for high availability, but there's no need to list all brokers. | source.bootstrap.servers | source.bootstrap.servers | true | |
Source Kafka Cluster's Security Protocol | Protocol to be used for communication with source kafka cluster. | source.security.protocol | PLAINTEXT | source.security.protocol | false |
Source Kafka Cluster's Client Auth | Only required if source Kafka cluster requires client authentication. | source.ssl.client.auth | false | source.ssl.client.auth | false |
Topic Whitelist | Regular expression that represents a set of topics to mirror. Note that whitelist and blacklist parameters are mutually exclusive. If both are defined, only the whilelist is used. | whitelist | whitelist | 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 |
---|---|---|---|---|---|
JMX Port | Port for JMX. | jmx_port | 9394 | jmx_port | false |
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 |
---|---|---|---|---|---|
Kafka MirrorMaker TLS/SSL Certificate Trust Store File | The location on disk of the trust store, in .jks format, used to confirm the authenticity of TLS/SSL servers that Kafka MirrorMaker might connect to. This is used when Kafka MirrorMaker is the client in a TLS/SSL connection. This trust store must contain the certificate(s) used to sign the service(s) connected to. If this parameter is not provided, the default list of well-known certificate authorities is used instead. | ssl.truststore.location | ssl_client_truststore_location | false | |
Kafka MirrorMaker TLS/SSL Certificate Trust Store Password | The password for the Kafka MirrorMaker TLS/SSL Certificate Trust Store File. This password is not required to access the trust store; this field can be left blank. This password provides optional integrity checking of the file. The contents of trust stores are certificates, and certificates are public information. | ssl.truststore.password.generator | ssl_client_truststore_password | false | |
Enable TLS/SSL for Kafka MirrorMaker | Encrypt communication between clients and Kafka MirrorMaker using Transport Layer Security (TLS) (formerly known as Secure Socket Layer (SSL)). | ssl_enabled | false | ssl_enabled | false |
Kafka MirrorMaker TLS/SSL Server JKS Keystore Key Password | The password that protects the private key contained in the JKS keystore used when Kafka MirrorMaker is acting as a TLS/SSL server. | ssl.key.password.generator | ssl_server_keystore_keypassword | false | |
Kafka MirrorMaker TLS/SSL Server JKS Keystore File Location | The path to the TLS/SSL keystore file containing the server certificate and private key used for TLS/SSL. Used when Kafka MirrorMaker is acting as a TLS/SSL server. The keystore must be in JKS format. | ssl.keystore.location | ssl_server_keystore_location | false | |
Kafka MirrorMaker TLS/SSL Server JKS Keystore File Password | The password for the Kafka MirrorMaker JKS keystore file. | ssl.keystore.password.generator | ssl_server_keystore_password | false |
Stacks Collection
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Stacks Collection Data Retention | The amount of stacks data that is retained. After the retention limit is reached, the oldest data is deleted. | stacks_collection_data_retention | 100 MiB | stacks_collection_data_retention | false |
Stacks Collection Directory | The directory in which stacks logs are placed. If not set, stacks are logged into a stacks subdirectory of the role's log directory. | stacks_collection_directory | stacks_collection_directory | false | |
Stacks Collection Enabled | Whether or not periodic stacks collection is enabled. | stacks_collection_enabled | false | stacks_collection_enabled | true |
Stacks Collection Frequency | The frequency with which stacks are collected. | stacks_collection_frequency | 5.0 second(s) | stacks_collection_frequency | false |
Stacks Collection Method | The method used to collect stacks. The jstack option involves periodically running the jstack command against the role's daemon process. The servlet method is available for those roles that have an HTTP server endpoint exposing the current stacks traces of all threads. When the servlet method is selected, that HTTP endpoint is periodically scraped. | stacks_collection_method | jstack | stacks_collection_method | false |
Suppressions
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Suppress Parameter Validation: Topic Blacklist | Whether to suppress configuration warnings produced by the built-in parameter validation for the Topic Blacklist parameter. | false | role_config_suppression_blacklist | true | |
Suppress Parameter Validation: Destination Broker List | Whether to suppress configuration warnings produced by the built-in parameter validation for the Destination Broker List parameter. | false | role_config_suppression_bootstrap.servers | 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: MirrorMaker Consumer Rebalance Listener | Whether to suppress configuration warnings produced by the built-in parameter validation for the MirrorMaker Consumer Rebalance Listener parameter. | false | role_config_suppression_consumer.rebalance.listener | true | |
Suppress Parameter Validation: MirrorMaker Consumer Rebalance Listener Arguments | Whether to suppress configuration warnings produced by the built-in parameter validation for the MirrorMaker Consumer Rebalance Listener Arguments parameter. | false | role_config_suppression_consumer.rebalance.listener.args | true | |
Suppress Parameter Validation: Consumer Group ID | Whether to suppress configuration warnings produced by the built-in parameter validation for the Consumer Group ID parameter. | false | role_config_suppression_group.id | true | |
Suppress Parameter Validation: Kafka MirrorMaker Environment Advanced Configuration Snippet (Safety Valve) | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka MirrorMaker Environment Advanced Configuration Snippet (Safety Valve) parameter. | false | role_config_suppression_kafka_mirror_maker_role_env_safety_valve | true | |
Suppress Parameter Validation: Kafka MirrorMaker Logging Advanced Configuration Snippet (Safety Valve) | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka MirrorMaker Logging Advanced Configuration Snippet (Safety Valve) parameter. | false | role_config_suppression_log4j_safety_valve | true | |
Suppress Parameter Validation: Kafka MirrorMaker Log Directory | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka MirrorMaker Log Directory parameter. | false | role_config_suppression_log_dir | true | |
Suppress Parameter Validation: MirrorMaker Message Handler | Whether to suppress configuration warnings produced by the built-in parameter validation for the MirrorMaker Message Handler parameter. | false | role_config_suppression_message.handler | true | |
Suppress Parameter Validation: MirrorMaker Message Handler Arguments | Whether to suppress configuration warnings produced by the built-in parameter validation for the MirrorMaker Message Handler Arguments parameter. | false | role_config_suppression_message.handler.args | true | |
Suppress Parameter Validation: Kafka MirrorMaker Advanced Configuration Snippet (Safety Valve) for mirror_maker_consumers.properties | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka MirrorMaker Advanced Configuration Snippet (Safety Valve) for mirror_maker_consumers.properties parameter. | false | role_config_suppression_mirror_maker_consumers.properties_role_safety_valve | true | |
Suppress Parameter Validation: Additional MirrorMaker Java Options | Whether to suppress configuration warnings produced by the built-in parameter validation for the Additional MirrorMaker Java Options parameter. | false | role_config_suppression_mirror_maker_java_opts | true | |
Suppress Parameter Validation: Java Heap Size of MirrorMaker | Whether to suppress configuration warnings produced by the built-in parameter validation for the Java Heap Size of MirrorMaker parameter. | false | role_config_suppression_mirror_maker_max_heap_size | true | |
Suppress Parameter Validation: Kafka MirrorMaker Advanced Configuration Snippet (Safety Valve) for mirror_maker_producers.properties | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka MirrorMaker Advanced Configuration Snippet (Safety Valve) for mirror_maker_producers.properties parameter. | false | role_config_suppression_mirror_maker_producers.properties_role_safety_valve | true | |
Suppress Parameter Validation: Heap Dump Directory | Whether to suppress configuration warnings produced by the built-in parameter validation for the Heap Dump Directory parameter. | false | role_config_suppression_oom_heap_dump_dir | 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: Source Broker List | Whether to suppress configuration warnings produced by the built-in parameter validation for the Source Broker List parameter. | false | role_config_suppression_source.bootstrap.servers | true | |
Suppress Parameter Validation: Kafka MirrorMaker Advanced Configuration Snippet (Safety Valve) for ssl_client.properties | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka MirrorMaker Advanced Configuration Snippet (Safety Valve) for ssl_client.properties parameter. | false | role_config_suppression_ssl_client.properties_role_safety_valve | true | |
Suppress Parameter Validation: Kafka MirrorMaker TLS/SSL Certificate Trust Store File | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka MirrorMaker TLS/SSL Certificate Trust Store File parameter. | false | role_config_suppression_ssl_client_truststore_location | true | |
Suppress Parameter Validation: Kafka MirrorMaker TLS/SSL Certificate Trust Store Password | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka MirrorMaker TLS/SSL Certificate Trust Store Password parameter. | false | role_config_suppression_ssl_client_truststore_password | true | |
Suppress Parameter Validation: Kafka MirrorMaker Advanced Configuration Snippet (Safety Valve) for ssl_server.properties | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka MirrorMaker Advanced Configuration Snippet (Safety Valve) for ssl_server.properties parameter. | false | role_config_suppression_ssl_server.properties_role_safety_valve | true | |
Suppress Parameter Validation: Kafka MirrorMaker TLS/SSL Server JKS Keystore Key Password | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka MirrorMaker TLS/SSL Server JKS Keystore Key Password parameter. | false | role_config_suppression_ssl_server_keystore_keypassword | true | |
Suppress Parameter Validation: Kafka MirrorMaker TLS/SSL Server JKS Keystore File Location | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka MirrorMaker TLS/SSL Server JKS Keystore File Location parameter. | false | role_config_suppression_ssl_server_keystore_location | true | |
Suppress Parameter Validation: Kafka MirrorMaker TLS/SSL Server JKS Keystore File Password | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka MirrorMaker TLS/SSL Server JKS Keystore File Password parameter. | false | role_config_suppression_ssl_server_keystore_password | true | |
Suppress Parameter Validation: Stacks Collection Directory | Whether to suppress configuration warnings produced by the built-in parameter validation for the Stacks Collection Directory parameter. | false | role_config_suppression_stacks_collection_directory | true | |
Suppress Parameter Validation: Topic Whitelist | Whether to suppress configuration warnings produced by the built-in parameter validation for the Topic Whitelist parameter. | false | role_config_suppression_whitelist | 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_kafka_kafka_mirror_maker_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_kafka_kafka_mirror_maker_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_kafka_kafka_mirror_maker_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_kafka_kafka_mirror_maker_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_kafka_kafka_mirror_maker_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_kafka_kafka_mirror_maker_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_kafka_kafka_mirror_maker_unexpected_exits | true |
Service-Wide
Advanced
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Kafka 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. | KAFKA_service_env_safety_valve | false | ||
System Group | The group that this service's processes should run as. | kafka | process_groupname | true | |
System User | The user that this service's processes should run as. | kafka | 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 | |
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:
|
[] | 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 |
---|---|---|---|---|---|
Topic Auto Creation | Enables auto creation of topics on the server. If this is set to true, then attempts to produce, consume, or fetch metadata for a non-existent topic automatically create the topic with the default replication factor and number of partitions. | auto.create.topics.enable | true | auto.create.topics.enable | false |
Enable Automatic Leader Rebalancing | If automatic leader rebalancing is enabled, the controller tries to balance leadership for partitions among the brokers by periodically returning leadership for each partition to the preferred replica, if it is available. | auto.leader.rebalance.enable | true | auto.leader.rebalance.enable | false |
Enable Controlled Shutdown | Enables controlled shutdown of the broker. If enabled, the broker moves all leaders on it to other brokers before shutting itself down. This reduces the unavailability window during shutdown. | controlled.shutdown.enable | true | controlled.shutdown.enable | false |
Controlled Shutdown Maximum Attempts | Number of unsuccessful controlled shutdown attempts before executing an unclean shutdown. For example, the default value of 3 means that the system will attempt a controlled shutdown 3 times before executing an unclean shutdown. | controlled.shutdown.max.retries | 3 | controlled.shutdown.max.retries | false |
Default Replication Factor | The default replication factor for automatically created topics. | default.replication.factor | 1 | default.replication.factor | false |
Enable Delete Topic | Enables topic deletion using admin tools. When delete topic is disabled, deleting topics through the admin tools has no effect. | delete.topic.enable | true | delete.topic.enable | false |
List of Metric Reporters | List of metric reporter class names. HTTP reporter is included by default. | kafka.metrics.reporters | nl.techop.kafka.KafkaHttpMetricsReporter | kafka.metrics.reporters | false |
Enable Kerberos Authentication | Enable Kerberos authentication for this KAFKA service. | kerberos.auth.enable | false | kerberos.auth.enable | false |
Leader Imbalance Check Interval | The frequency with which to check for leader imbalance. | leader.imbalance.check.interval.seconds | 5 minute(s) | leader.imbalance.check.interval.seconds | false |
Leader Imbalance Allowed Per Broker | The percentage of leader imbalance allowed per broker. The controller rebalances leadership if this ratio goes above the configured value per broker. | leader.imbalance.per.broker.percentage | 10 % | leader.imbalance.per.broker.percentage | false |
Log Cleaner Deduplication Buffer Size | The total memory used for log deduplication across all cleaner threads. This memory is statically allocated and will not cause GC problems. | log.cleaner.dedupe.buffer.size | 128 MiB | log.cleaner.dedupe.buffer.size | false |
Log Compaction Delete Record Retention Time | The amount of time to retain delete messages for log compacted topics. Once a consumer has seen an original message you need to ensure it also sees the delete message. If you removed the delete message too quickly, this might not happen. As a result there is a configurable delete retention time. | log.cleaner.delete.retention.ms | 7 day(s) | log.cleaner.delete.retention.ms | false |
Enable Log Compaction | Enables the log cleaner to compact topics with cleanup.policy=compact on this cluster. | log.cleaner.enable | true | log.cleaner.enable | false |
Log Cleaner Clean Ratio | Controls how frequently the log cleaner will attempt to clean the log. This ratio bounds the maximum space wasted in the log by duplicates. For example, at 0.5 at most 50% of the log could be duplicates. A higher ratio will mean fewer, more efficient cleanings but will mean more wasted space in the log. | log.cleaner.min.cleanable.ratio | 0.5 | log.cleaner.min.cleanable.ratio | false |
Number of Log Cleaner Threads | The number of background threads to use for log cleaning. | log.cleaner.threads | 1 | log.cleaner.threads | false |
Log Flush Message Interval | The number of messages written to a log partition before triggering an fsync on the log. Setting this lower syncs data to disk more often, but has a major impact on performance. Cloudera recommends use of replication for durability rather than depending on single-server fsync; however, this setting can be used to be extra certain. If used in conjunction with log.flush.interval.ms, the log is flushed when either criteria is met. | log.flush.interval.messages | log.flush.interval.messages | false | |
Log Flush Time Interval | The maximum time between fsync calls on the log. If used in conjuction with log.flush.interval.messages, the log is flushed when either criteria is met. | log.flush.interval.ms | log.flush.interval.ms | false | |
Log Flush Scheduler Interval | The frequency, in ms, with which the log flusher checks whether any log is eligible to be flushed to disk. | log.flush.scheduler.interval.ms | log.flush.scheduler.interval.ms | false | |
Maximum Message Size | The maximum size of a message that the server can receive. It is important that this property be in sync with the maximum fetch size the consumers use, or else an unruly producer could publish messages too large for consumers to consume. | message.max.bytes | 1000000 B | message.max.bytes | false |
Minimum Number of Replicas in ISR | The minimum number of replicas in the in-sync replica needed to satisfy a produce request where required.acks=-1 (that is, all). | min.insync.replicas | 1 | min.insync.replicas | false |
Enable Kafka Monitoring (Note: Requires Kafka-1.3.0 parcel or higher) | Enables Kafka monitoring. | monitoring.enabled | true | monitoring.enabled | false |
Default Number of Partitions | The default number of partitions for automatically created topics. | num.partitions | 1 | num.partitions | false |
Number of Replica Fetchers | Number of threads used to replicate messages from leaders. Increasing this value increases the degree of I/O parallelism in the follower broker. | num.replica.fetchers | 1 | num.replica.fetchers | false |
Offset Commit Topic Number of Partitions | The number of partitions for the offset commit topic. Since changing this after deployment is currently unsupported, Cloudera recommends using a higher setting for production (for example, 100-200). | offsets.topic.num.partitions | 50 | offsets.topic.num.partitions | false |
Offset Commit Topic Replication Factor | The replication factor for the offset commit topic. A higher setting is recommended in order to ensure higher availability (for example, 3 or 4) . If the offsets topic is created when there are fewer brokers than the replication factor, then the offsets topic is created with fewer replicas. | offsets.topic.replication.factor | 3 | offsets.topic.replication.factor | false |
Default Consumer Quota | Any consumer distinguished by clientId/consumer group will get throttled if it fetches more bytes than this value per-second. Only respected by Kafka 2.0 or later. | quota.consumer.default | quota.consumer.default | false | |
Default Producer Quota | Any producer distinguished by clientId will get throttled if it produces more bytes than this value per-second. Only respected by Kafka 2.0 or later. | quota.producer.default | quota.producer.default | false | |
Replica Maximum Fetch Size | The maximum number of bytes to fetch for each partition in fetch requests replicas send to the leader. This value should be larger than message.max.bytes. | replica.fetch.max.bytes | 1 MiB | replica.fetch.max.bytes | false |
Allowed Replica Message Lag | If a replica falls more than this number of messages behind the leader, the leader removes the follower from the ISR and treats it as dead. This property is deprecated in Kafka 1.4.0; higher versions use only replica.lag.time.max.ms. | replica.lag.max.messages | 4000 | replica.lag.max.messages | false |
Allowed Replica Time Lag | If a follower has not sent any fetch requests, nor has it consumed up to the leader's log end offset during this time, the leader removes the follower from the ISR set. | replica.lag.time.max.ms | 10 second(s) | replica.lag.time.max.ms | false |
Enable Sentry Privileges Caching | Enables Sentry privileges caching. Only applicable if authorization via Sentry is enabled. | sentry.kafka.caching.enable | true | sentry.kafka.caching.enable | false |
Sentry Privileges Cache Refresh Interval | The amount of time between updates of the Sentry privileges cache. Any change in role or privilege can take up to the specified time for changes to reflect in the cache. | sentry.kafka.caching.ttl.ms | 30 second(s) | sentry.kafka.caching.ttl.ms | false |
Sentry Privileges Cache Maximum Update Failures | If Sentry privileges cache fails to update for specified number of times, all authorization requests will be denied. | sentry.kafka.caching.update.failures.count | 3 | sentry.kafka.caching.update.failures.count | false |
Sentry Service | Name of the Sentry service that this Kafka service instance depends on | sentry_service | false | ||
Enable Unclean Leader Election | Enable replicas not in the ISR set to be elected as leader as a last resort, even though doing so might result in data loss. | unclean.leader.election.enable | false | unclean.leader.election.enable | false |
ZooKeeper Root | ZNode in ZooKeeper that should be used as a root for this Kafka cluster. | zookeeper.chroot | zookeeper.chroot | false | |
ZooKeeper Session Timeout | If the server fails to send a heartbeat to ZooKeeper within this period of time, it is considered dead. If set too low, ZooKeeper might falsely consider a server dead; if set too high, ZooKeeper might take too long to recognize a dead server. | zookeeper.session.timeout.ms | 6 second(s) | zookeeper.session.timeout.ms | false |
ZooKeeper Service | Name of the ZooKeeper service that this Kafka service instance depends on | zookeeper_service | true |
Suppressions
Display Name | Description | Related Name | Default Value | API Name | Required |
---|---|---|---|---|---|
Suppress Parameter Validation: Controlled Shutdown Maximum Attempts | Whether to suppress configuration warnings produced by the built-in parameter validation for the Controlled Shutdown Maximum Attempts parameter. | false | service_config_suppression_controlled.shutdown.max.retries | true | |
Suppress Parameter Validation: Default Replication Factor | Whether to suppress configuration warnings produced by the built-in parameter validation for the Default Replication Factor parameter. | false | service_config_suppression_default.replication.factor | true | |
Suppress Configuration Validator: Gateway Count Validator | Whether to suppress configuration warnings produced by the Gateway Count Validator configuration validator. | false | service_config_suppression_gateway_count_validator | true | |
Suppress Parameter Validation: List of Metric Reporters | Whether to suppress configuration warnings produced by the built-in parameter validation for the List of Metric Reporters parameter. | false | service_config_suppression_kafka.metrics.reporters | true | |
Suppress Configuration Validator: Kafka Broker Count Validator | Whether to suppress configuration warnings produced by the Kafka Broker Count Validator configuration validator. | false | service_config_suppression_kafka_broker_count_validator | true | |
Suppress Configuration Validator: Kafka MirrorMaker Count Validator | Whether to suppress configuration warnings produced by the Kafka MirrorMaker Count Validator configuration validator. | false | service_config_suppression_kafka_mirror_maker_count_validator | true | |
Suppress Parameter Validation: Kafka Service Environment Advanced Configuration Snippet (Safety Valve) | Whether to suppress configuration warnings produced by the built-in parameter validation for the Kafka Service Environment Advanced Configuration Snippet (Safety Valve) parameter. | false | service_config_suppression_kafka_service_env_safety_valve | true | |
Suppress Parameter Validation: Leader Imbalance Check Interval | Whether to suppress configuration warnings produced by the built-in parameter validation for the Leader Imbalance Check Interval parameter. | false | service_config_suppression_leader.imbalance.check.interval.seconds | true | |
Suppress Parameter Validation: Leader Imbalance Allowed Per Broker | Whether to suppress configuration warnings produced by the built-in parameter validation for the Leader Imbalance Allowed Per Broker parameter. | false | service_config_suppression_leader.imbalance.per.broker.percentage | true | |
Suppress Parameter Validation: Maximum Message Size | Whether to suppress configuration warnings produced by the built-in parameter validation for the Maximum Message Size parameter. | false | service_config_suppression_message.max.bytes | true | |
Suppress Parameter Validation: Minimum Number of Replicas in ISR | Whether to suppress configuration warnings produced by the built-in parameter validation for the Minimum Number of Replicas in ISR parameter. | false | service_config_suppression_min.insync.replicas | true | |
Suppress Parameter Validation: Default Number of Partitions | Whether to suppress configuration warnings produced by the built-in parameter validation for the Default Number of Partitions parameter. | false | service_config_suppression_num.partitions | true | |
Suppress Parameter Validation: Number of Replica Fetchers | Whether to suppress configuration warnings produced by the built-in parameter validation for the Number of Replica Fetchers parameter. | false | service_config_suppression_num.replica.fetchers | true | |
Suppress Parameter Validation: Offset Commit Topic Number of Partitions | Whether to suppress configuration warnings produced by the built-in parameter validation for the Offset Commit Topic Number of Partitions parameter. | false | service_config_suppression_offsets.topic.num.partitions | true | |
Suppress Parameter Validation: Offset Commit Topic Replication Factor | Whether to suppress configuration warnings produced by the built-in parameter validation for the Offset Commit Topic Replication Factor parameter. | false | service_config_suppression_offsets.topic.replication.factor | 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: Replica Maximum Fetch Size | Whether to suppress configuration warnings produced by the built-in parameter validation for the Replica Maximum Fetch Size parameter. | false | service_config_suppression_replica.fetch.max.bytes | 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: ZooKeeper Root | Whether to suppress configuration warnings produced by the built-in parameter validation for the ZooKeeper Root parameter. | false | service_config_suppression_zookeeper.chroot | true | |
Suppress Parameter Validation: ZooKeeper Session Timeout | Whether to suppress configuration warnings produced by the built-in parameter validation for the ZooKeeper Session Timeout parameter. | false | service_config_suppression_zookeeper.session.timeout.ms | true |