Cloudera Docs

Host Configuration Properties

Categories:

Advanced

Display Name Description Property Name Default Value API Name Required
P2P Parcel Distribution Port 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. 7191 flood_torrent_port false
Cloudera Manager Agent Monitoring Advanced Configuration Snippet (Safety Valve) For advanced use only, key-value pairs (one on each line) used by Cloudera Manager Agent. host_agent_safety_valve false
Java Home Directory Explicitly set the value of JAVA_HOME for all processes. This will override the auto-detection logic that is normally used. java_home false
Host Upgrade Domain 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. upgrade_domain upgrade_domain false

Monitoring

Display Name Description Property Name Default Value API Name Required
Enable Health Alerts for This Host 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 false 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
Cloudera Manager Agent TLS Certificate Expiry Thresholds The health test thresholds for monitoring the certificate of Cloudera Manager Agent. Warning: 60 day(s), Critical: 7 day(s) host_agent_certificate_expiry_thresholds false
Cloudera Manager Agent Log Directory Free Space Monitoring Absolute Thresholds The health check thresholds for monitoring of free space on the filesystem that contains the Cloudera Manager Agent's log directory. Warning: 2 GiB, Critical: 1 GiB host_agent_log_directory_free_space_absolute_thresholds false
Cloudera Manager Agent Log Directory Free Space Monitoring Percentage Thresholds 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. Warning: Never, Critical: Never host_agent_log_directory_free_space_percentage_thresholds false
Cloudera Manager Agent Parcel Directory Free Space Monitoring Absolute Thresholds The health check thresholds for monitoring of free space on the filesystem that contains the Cloudera Manager Agent's parcel directory. Warning: 10 GiB, Critical: 5 GiB host_agent_parcel_directory_free_space_absolute_thresholds false
Cloudera Manager Agent Parcel Directory Free Space Monitoring Percentage Thresholds 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. Warning: Never, Critical: Never host_agent_parcel_directory_free_space_percentage_thresholds false
Cloudera Manager Agent Process Directory Free Space Monitoring Absolute Thresholds The health check thresholds for monitoring of free space on the filesystem that contains the Cloudera Manager Agent's process directory. Warning: 200 MiB, Critical: 100 MiB host_agent_process_directory_free_space_absolute_thresholds false
Cloudera Manager Agent Process Directory Free Space Monitoring Percentage Thresholds 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. Warning: Never, Critical: Never host_agent_process_directory_free_space_percentage_thresholds false
Host Entropy Thresholds The health check thresholds for the available entropy on the host. Warning: 100.0, Critical: 50.0 host_available_entropy_thresholds false
Host Clock Offset Thresholds 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. Warning: 3 second(s), Critical: 10 second(s) host_clock_offset_thresholds false
Default Process Swap Memory Thresholds 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. Warning: 200.0 page(s), Critical: Never host_default_proc_memswap_thresholds false
Disk Device Collection Exclusion Regex 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. ^$ host_disk_collection_filter false
Host DNS Resolution Duration Thresholds The health check thresholds for the host DNS resolution duration. Warning: 1 second(s), Critical: Never host_dns_resolution_duration_thresholds false
Hostname and Canonical Name Health Check Whether the hostname and canonical names for this host are consistent when checked from a Java process. true host_dns_resolution_enabled false
Filesystem Collection Exclusion Regex 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. ^$ host_fs_collection_filter false
Host Memory Swapping Thresholds The health test thresholds of the number of pages swapped out on the host in the last 15 minutes Warning: 200.0 page(s), Critical: Never host_memswap_thresholds false
Host Memory Swapping Check Window The amount of time over which the memory swapping test checks for pages swapped. 15 minute(s) host_memswap_window false
Host Network Frame Error Test Minimum Required Packets 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. 0 host_network_frame_errors_floor false
Host Network Frame Error Percentage Thresholds The health check thresholds for the percentage of received packets that are frame errors. Warning: Any, Critical: 0.5 % host_network_frame_errors_thresholds false
Host Network Frame Error Check Window The amount of time over which the host frame error checks for frame errors. 15 minute(s) host_network_frame_errors_window false
Network Interface Collection Exclusion Regex The regular expression used to filter monitored network interfaces. Network interfaces that match this pattern will be excluded from metric collection. ^lo$ host_network_interface_collection_filter false
Host's Network Interfaces Slow Link Modes Thresholds The thresholds for the health check of the number of network interfaces that appear to be operating at less than full speed. Warning: Any, Critical: Never host_network_interfaces_slow_mode_thresholds false
Network Interface Expected Duplex Mode The expected duplex mode for network interfaces. Full host_nic_expected_duplex_mode false
Network Interface Expected Link Speed The expected network interface link speed. 1000 host_nic_expected_speed false
Host Process Health Test Enables the health test that the host's process state is consistent with the role configuration true host_scm_health_enabled false
Host Triggers 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.		 [] host_triggers true

Parcels

Display Name Description Property Name Default Value API Name Required
Parcel Directory 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. /opt/cloudera/parcels parcels_directory true

Resource Management

Display Name Description Property Name Default Value API Name Required
Memory Overcommit Validation Threshold 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. 0.8 memory_overcommit_threshold false
Enable Cgroup-based Resource Management 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. false rm_enabled true

Suppressions

Display Name Description Property Name Default Value API Name Required
Suppress Configuration Validator: Cloudera Manager Agent User and Group Validator Whether to suppress configuration warnings produced by the Cloudera Manager Agent User and Group Validator configuration validator. false host_config_suppression_agent_system_user_group_validator true
Suppress Configuration Validator: CGroups Disabled Validator Whether to suppress configuration warnings produced by the CGroups Disabled Validator configuration validator. false host_config_suppression_cgroups_disabled_validator true
Suppress Parameter Validation: P2P Parcel Distribution Port Whether to suppress configuration warnings produced by the built-in parameter validation for the P2P Parcel Distribution Port parameter. false host_config_suppression_flood_torrent_port true
Suppress Parameter Validation: Cloudera Manager Agent Monitoring Advanced Configuration Snippet (Safety Valve) Whether to suppress configuration warnings produced by the built-in parameter validation for the Cloudera Manager Agent Monitoring Advanced Configuration Snippet (Safety Valve) parameter. false host_config_suppression_host_agent_safety_valve true
Suppress Parameter Validation: Disk Device Collection Exclusion Regex Whether to suppress configuration warnings produced by the built-in parameter validation for the Disk Device Collection Exclusion Regex parameter. false host_config_suppression_host_disk_collection_filter true
Suppress Parameter Validation: Filesystem Collection Exclusion Regex Whether to suppress configuration warnings produced by the built-in parameter validation for the Filesystem Collection Exclusion Regex parameter. false host_config_suppression_host_fs_collection_filter true
Suppress Parameter Validation: Network Interface Collection Exclusion Regex Whether to suppress configuration warnings produced by the built-in parameter validation for the Network Interface Collection Exclusion Regex parameter. false host_config_suppression_host_network_interface_collection_filter true
Suppress Parameter Validation: Host Triggers Whether to suppress configuration warnings produced by the built-in parameter validation for the Host Triggers parameter. false host_config_suppression_host_triggers true
Suppress Parameter Validation: Java Home Directory Whether to suppress configuration warnings produced by the built-in parameter validation for the Java Home Directory parameter. false host_config_suppression_java_home true
Suppress Configuration Validator: Java Version Validator Whether to suppress configuration warnings produced by the Java Version Validator configuration validator. false host_config_suppression_java_version_required_for_cdh_validator true
Suppress Configuration Validator: Memory Overcommited Validator Whether to suppress configuration warnings produced by the Memory Overcommited Validator configuration validator. false host_config_suppression_memory_overcommitted_validator true
Suppress Parameter Validation: Parcel Directory Whether to suppress configuration warnings produced by the built-in parameter validation for the Parcel Directory parameter. false host_config_suppression_parcels_directory true
Suppress Configuration Validator: Rack Diversity Validator Whether to suppress configuration warnings produced by the Rack Diversity Validator configuration validator. false host_config_suppression_rack_diversity_validator true
Suppress Configuration Validator: Supervisord Version Validator Whether to suppress configuration warnings produced by the Supervisord Version Validator configuration validator. false host_config_suppression_supervisord_version_matched_with_cm_validator true
Suppress Parameter Validation: Host Upgrade Domain Whether to suppress configuration warnings produced by the built-in parameter validation for the Host Upgrade Domain parameter. false host_config_suppression_upgrade_domain true
Suppress Health Test: Certificate Expiration 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. false host_health_suppression_host_agent_certificate_expiry true
Suppress Health Test: Agent Log Directory 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. false host_health_suppression_host_agent_log_directory_free_space true
Suppress Health Test: Agent Parcel Directory 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. false host_health_suppression_host_agent_parcel_directory_free_space true
Suppress Health Test: Agent Process Directory 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. false host_health_suppression_host_agent_process_directory_free_space true
Suppress Health Test: Entropy 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. false host_health_suppression_host_available_entropy true
Suppress Health Test: Clock Offset 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. false host_health_suppression_host_clock_offset true
Suppress Health Test: DNS Resolution 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. false host_health_suppression_host_dns_resolution true
Suppress Health Test: Swapping 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. false host_health_suppression_host_memory_swapping true
Suppress Health Test: Frame Errors 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. false host_health_suppression_host_network_frame_errors true
Suppress Health Test: Network Interface Speed 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. false host_health_suppression_host_network_interfaces_slow_mode true
Suppress Health Test: Agent Status 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. false host_health_suppression_host_scm_health true