Host Configuration Properties

Advanced

P2P Parcel Distribution Port

Description
TCP port (on each cluster host) to be used for P2P Parcel Distribution. Set to 0 to disable P2P Parcel Distribution. This setting should only be modified when no parcels are being distributed.
Related Name
Default Value
7191
API Name
flood_torrent_port
Required
false

Cloudera Manager Agent Monitoring Advanced Configuration Snippet (Safety Valve)

Description
For advanced use only, key-value pairs (one on each line) used by Cloudera Manager Agent.
Related Name
Default Value
API Name
host_agent_safety_valve
Required
false

Java Home Directory

Description
Explicitly set the value of JAVA_HOME for all processes. This will override the auto-detection logic that is normally used.
Related Name
Default Value
API Name
java_home
Required
false

Host Upgrade Domain

Description
For advanced use only, the HDFS Upgrade Domain that a host belongs to. Only applies to DataNode hosts. Any DataNode hosts without an Upgrade Domain set will default to using the rack assignment of the host. This setting is not used if the Upgrade Domains block placement policy is not enabled for HDFS.
Related Name
upgrade_domain
Default Value
API Name
upgrade_domain
Required
false

Monitoring

Enable Health Alerts for This Host

Description
When set, Cloudera Manager will send alerts when the health of this host reaches the threshold specified by the EventServer setting eventserver_health_events_alert_threshold
Related Name
Default Value
false
API Name
enable_alerts
Required
false

Enable Configuration Change Alerts

Description
When set, Cloudera Manager will send alerts when this entity's configuration changes.
Related Name
Default Value
false
API Name
enable_config_alerts
Required
false

Cloudera Manager Agent TLS Certificate Expiry Thresholds

Description
The health test thresholds for monitoring the certificate of Cloudera Manager Agent.
Related Name
Default Value
Warning: 60 day(s), Critical: 7 day(s)
API Name
host_agent_certificate_expiry_thresholds
Required
false

Cloudera Manager Agent Log Directory Free Space Monitoring Absolute Thresholds

Description
The health check thresholds for monitoring of free space on the filesystem that contains the Cloudera Manager Agent's log directory.
Related Name
Default Value
Warning: 2 GiB, Critical: 1 GiB
API Name
host_agent_log_directory_free_space_absolute_thresholds
Required
false

Cloudera Manager Agent Log Directory Free Space Monitoring Percentage Thresholds

Description
The health check thresholds for monitoring of free space on the filesystem that contains the Cloudera Manager Agent's log directory. Specified as a percentage of the capacity on that filesystem. This setting is not used if a Cloudera Manager Agent Log Directory Free Space Monitoring Absolute Thresholds setting is configured.
Related Name
Default Value
Warning: Never, Critical: Never
API Name
host_agent_log_directory_free_space_percentage_thresholds
Required
false

Cloudera Manager Agent Parcel Directory Free Space Monitoring Absolute Thresholds

Description
The health check thresholds for monitoring of free space on the filesystem that contains the Cloudera Manager Agent's parcel directory.
Related Name
Default Value
Warning: 10 GiB, Critical: 5 GiB
API Name
host_agent_parcel_directory_free_space_absolute_thresholds
Required
false

Cloudera Manager Agent Parcel Directory Free Space Monitoring Percentage Thresholds

Description
The health check thresholds for monitoring of free space on the filesystem that contains the Cloudera Manager Agent's parcel directory. Specified as a percentage of the capacity on that filesystem. This setting is not used if a Cloudera Manager Agent Parcel Directory Free Space Monitoring Absolute Thresholds setting is configured.
Related Name
Default Value
Warning: Never, Critical: Never
API Name
host_agent_parcel_directory_free_space_percentage_thresholds
Required
false

Cloudera Manager Agent Process Directory Free Space Monitoring Absolute Thresholds

Description
The health check thresholds for monitoring of free space on the filesystem that contains the Cloudera Manager Agent's process directory.
Related Name
Default Value
Warning: 200 MiB, Critical: 100 MiB
API Name
host_agent_process_directory_free_space_absolute_thresholds
Required
false

Cloudera Manager Agent Process Directory Free Space Monitoring Percentage Thresholds

Description
The health check thresholds for monitoring of free space on the filesystem that contains the Cloudera Manager Agent's process directory. Specified as a percentage of the capacity on that filesystem. This setting is not used if a Cloudera Manager Agent Process Directory Free Space Monitoring Absolute Thresholds setting is configured.
Related Name
Default Value
Warning: Never, Critical: Never
API Name
host_agent_process_directory_free_space_percentage_thresholds
Required
false

Host Entropy Thresholds

Description
The health check thresholds for the available entropy on the host.
Related Name
Default Value
Warning: 100.0, Critical: 50.0
API Name
host_available_entropy_thresholds
Required
false

Host Clock Offset Thresholds

Description
The thresholds for the host clock offset health test. The test compares this threshold against the absolute value of the clock offset reported by the host's NTP service from the 'ntpdc -np' or 'chronyc sources' command. Setting both the warning and critical threshold values to never turns off collection of the clock offset by the Cloudera Manager Agent. If no time synchronization is in use, both threshold values should be set to never. Cloudera recommends using NTP for time synchronization of Hadoop clusters.
Related Name
Default Value
Warning: 3 second(s), Critical: 10 second(s)
API Name
host_clock_offset_thresholds
Required
false

Default Process Swap Memory Thresholds

Description
The default health test thresholds on the swap memory usage of the processes on the host. This value is used if process level threshold is equal to the default.
Related Name
Default Value
Warning: 200.0 page(s), Critical: Never
API Name
host_default_proc_memswap_thresholds
Required
false

Disk Device Collection Exclusion Regex

Description
The regular expression used to filter monitored disk devices and partitions. Disk device (for example, sda) and partition (for example, sda2) names that match this pattern will be excluded from metric collection.
Related Name
Default Value
^$
API Name
host_disk_collection_filter
Required
false

Host DNS Resolution Duration Thresholds

Description
The health check thresholds for the host DNS resolution duration.
Related Name
Default Value
Warning: 1 second(s), Critical: Never
API Name
host_dns_resolution_duration_thresholds
Required
false

Hostname and Canonical Name Health Check

Description
Whether the hostname and canonical names for this host are consistent when checked from a Java process.
Related Name
Default Value
true
API Name
host_dns_resolution_enabled
Required
false

Filesystem Collection Exclusion Regex

Description
The regular expression used to filter monitored filesystems. Mountpoints for filesystems (for example, /data/1) that match this pattern will be excluded from metric collection.
Related Name
Default Value
^$
API Name
host_fs_collection_filter
Required
false

Host Memory Swapping Thresholds

Description
The health test thresholds of the number of pages swapped out on the host in the last 15 minutes
Related Name
Default Value
Warning: 200.0 page(s), Critical: Never
API Name
host_memswap_thresholds
Required
false

Host Memory Swapping Check Window

Description
The amount of time over which the memory swapping test checks for pages swapped.
Related Name
Default Value
15 minute(s)
API Name
host_memswap_window
Required
false

Host Network Frame Error Test Minimum Required Packets

Description
The minimum number of received packets that must be received within the test window for this test to return "Bad" health. If less that this number of packets is received during the test window, the health check will never return "Bad" health.
Related Name
Default Value
0
API Name
host_network_frame_errors_floor
Required
false

Host Network Frame Error Percentage Thresholds

Description
The health check thresholds for the percentage of received packets that are frame errors.
Related Name
Default Value
Warning: Any, Critical: 0.5 %
API Name
host_network_frame_errors_thresholds
Required
false

Host Network Frame Error Check Window

Description
The amount of time over which the host frame error checks for frame errors.
Related Name
Default Value
15 minute(s)
API Name
host_network_frame_errors_window
Required
false

Network Interface Collection Exclusion Regex

Description
The regular expression used to filter monitored network interfaces. Network interfaces that match this pattern will be excluded from metric collection.
Related Name
Default Value
^(lo|bond[0-9]*)$
API Name
host_network_interface_collection_filter
Required
false

Host's Network Interfaces Slow Link Modes Thresholds

Description
The thresholds for the health check of the number of network interfaces that appear to be operating at less than full speed.
Related Name
Default Value
Warning: Any, Critical: Never
API Name
host_network_interfaces_slow_mode_thresholds
Required
false

Network Interface Expected Duplex Mode

Description
The expected duplex mode for network interfaces.
Related Name
Default Value
Full
API Name
host_nic_expected_duplex_mode
Required
false

Network Interface Expected Link Speed

Description
The expected network interface link speed.
Related Name
Default Value
1000
API Name
host_nic_expected_speed
Required
false

Host Process Health Test

Description
Enables the health test that the host's process state is consistent with the role configuration
Related Name
Default Value
true
API Name
host_scm_health_enabled
Required
false

Host Triggers

Description
The configured triggers for this host. 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 host.
  • 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 fires if the host wait time exceeds 500 ms:[{"triggerName": "sample-trigger", "triggerExpression": "IF (select await_time where hostname=$HOSTNAME and last(await_time) > 500ms) DO health:concerning", "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.
Related Name
Default Value
[]
API Name
host_triggers
Required
true

Parcels

Parcel Directory

Description
The directory that parcels will be installed into on the host(s). The download 'parcel-cache' directory will be placed next to this directory on the filesystem. If the 'parcel_dir' variable is set in the Agent's config.ini file, it will override this value.
Related Name
Default Value
/opt/cloudera/parcels
API Name
parcels_directory
Required
true

Resource Management

Memory Overcommit Validation Threshold

Description
Threshold used when validating the allocation of RAM on a host. 0 means all of the memory is reserved for the system. 1 means none is reserved. Values can range from 0 to 1.
Related Name
Default Value
0.8
API Name
memory_overcommit_threshold
Required
false

Enable Cgroup-based Resource Management

Description
Enables resource management using control groups (cgroups). When toggled, roles on the host must be restarted for cgroups to be enabled or disabled. Per-resource controls are found in the configuration pages of role configuration groups and individual roles. Control groups are a feature of the Linux kernel, and support varies by distribution; see the Cloudera Manager documentation for details.
Related Name
Default Value
false
API Name
rm_enabled
Required
true

Suppressions

Suppress Configuration Validator: Cloudera Manager Agent User and Group Validator

Description
Whether to suppress configuration warnings produced by the Cloudera Manager Agent User and Group Validator configuration validator.
Related Name
Default Value
false
API Name
host_config_suppression_agent_system_user_group_validator
Required
true

Suppress Configuration Validator: CGroups Disabled Validator

Description
Whether to suppress configuration warnings produced by the CGroups Disabled Validator configuration validator.
Related Name
Default Value
false
API Name
host_config_suppression_cgroups_disabled_validator
Required
true

Suppress Parameter Validation: P2P Parcel Distribution Port

Description
Whether to suppress configuration warnings produced by the built-in parameter validation for the P2P Parcel Distribution Port parameter.
Related Name
Default Value
false
API Name
host_config_suppression_flood_torrent_port
Required
true

Suppress Parameter Validation: Cloudera Manager Agent Monitoring Advanced Configuration Snippet (Safety Valve)

Description
Whether to suppress configuration warnings produced by the built-in parameter validation for the Cloudera Manager Agent Monitoring Advanced Configuration Snippet (Safety Valve) parameter.
Related Name
Default Value
false
API Name
host_config_suppression_host_agent_safety_valve
Required
true

Suppress Parameter Validation: Disk Device Collection Exclusion Regex

Description
Whether to suppress configuration warnings produced by the built-in parameter validation for the Disk Device Collection Exclusion Regex parameter.
Related Name
Default Value
false
API Name
host_config_suppression_host_disk_collection_filter
Required
true

Suppress Parameter Validation: Filesystem Collection Exclusion Regex

Description
Whether to suppress configuration warnings produced by the built-in parameter validation for the Filesystem Collection Exclusion Regex parameter.
Related Name
Default Value
false
API Name
host_config_suppression_host_fs_collection_filter
Required
true

Suppress Parameter Validation: Network Interface Collection Exclusion Regex

Description
Whether to suppress configuration warnings produced by the built-in parameter validation for the Network Interface Collection Exclusion Regex parameter.
Related Name
Default Value
false
API Name
host_config_suppression_host_network_interface_collection_filter
Required
true

Suppress Parameter Validation: Host Triggers

Description
Whether to suppress configuration warnings produced by the built-in parameter validation for the Host Triggers parameter.
Related Name
Default Value
false
API Name
host_config_suppression_host_triggers
Required
true

Suppress Parameter Validation: Java Home Directory

Description
Whether to suppress configuration warnings produced by the built-in parameter validation for the Java Home Directory parameter.
Related Name
Default Value
false
API Name
host_config_suppression_java_home
Required
true

Suppress Configuration Validator: Java Version Validator

Description
Whether to suppress configuration warnings produced by the Java Version Validator configuration validator.
Related Name
Default Value
false
API Name
host_config_suppression_java_version_required_for_cdh_validator
Required
true

Suppress Configuration Validator: Memory Overcommited Validator

Description
Whether to suppress configuration warnings produced by the Memory Overcommited Validator configuration validator.
Related Name
Default Value
false
API Name
host_config_suppression_memory_overcommitted_validator
Required
true

Suppress Parameter Validation: Parcel Directory

Description
Whether to suppress configuration warnings produced by the built-in parameter validation for the Parcel Directory parameter.
Related Name
Default Value
false
API Name
host_config_suppression_parcels_directory
Required
true

Suppress Configuration Validator: Rack Diversity Validator

Description
Whether to suppress configuration warnings produced by the Rack Diversity Validator configuration validator.
Related Name
Default Value
false
API Name
host_config_suppression_rack_diversity_validator
Required
true

Suppress Configuration Validator: Supervisord Version Validator

Description
Whether to suppress configuration warnings produced by the Supervisord Version Validator configuration validator.
Related Name
Default Value
false
API Name
host_config_suppression_supervisord_version_matched_with_cm_validator
Required
true

Suppress Parameter Validation: Host Upgrade Domain

Description
Whether to suppress configuration warnings produced by the built-in parameter validation for the Host Upgrade Domain parameter.
Related Name
Default Value
false
API Name
host_config_suppression_upgrade_domain
Required
true

Suppress Health Test: Certificate Expiration

Description
Whether to suppress the results of the Certificate Expiration 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.
Related Name
Default Value
false
API Name
host_health_suppression_host_agent_certificate_expiry
Required
true

Suppress Health Test: Agent Log Directory

Description
Whether to suppress the results of the Agent Log Directory 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.
Related Name
Default Value
false
API Name
host_health_suppression_host_agent_log_directory_free_space
Required
true

Suppress Health Test: Agent Parcel Directory

Description
Whether to suppress the results of the Agent Parcel Directory 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.
Related Name
Default Value
false
API Name
host_health_suppression_host_agent_parcel_directory_free_space
Required
true

Suppress Health Test: Agent Process Directory

Description
Whether to suppress the results of the Agent Process Directory 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.
Related Name
Default Value
false
API Name
host_health_suppression_host_agent_process_directory_free_space
Required
true

Suppress Health Test: Entropy

Description
Whether to suppress the results of the Entropy 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.
Related Name
Default Value
false
API Name
host_health_suppression_host_available_entropy
Required
true

Suppress Health Test: Clock Offset

Description
Whether to suppress the results of the Clock Offset 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.
Related Name
Default Value
false
API Name
host_health_suppression_host_clock_offset
Required
true

Suppress Health Test: DNS Resolution

Description
Whether to suppress the results of the DNS Resolution 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.
Related Name
Default Value
false
API Name
host_health_suppression_host_dns_resolution
Required
true

Suppress Health Test: Swapping

Description
Whether to suppress the results of the Swapping 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.
Related Name
Default Value
false
API Name
host_health_suppression_host_memory_swapping
Required
true

Suppress Health Test: Frame Errors

Description
Whether to suppress the results of the Frame Errors 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.
Related Name
Default Value
false
API Name
host_health_suppression_host_network_frame_errors
Required
true

Suppress Health Test: Network Interface Speed

Description
Whether to suppress the results of the Network Interface Speed 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.
Related Name
Default Value
false
API Name
host_health_suppression_host_network_interfaces_slow_mode
Required
true

Suppress Health Test: Agent Status

Description
Whether to suppress the results of the Agent 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.
Related Name
Default Value
false
API Name
host_health_suppression_host_scm_health
Required
true