NameNode Health Tests

NameNode Checkpoint Status

This is a NameNode health test that checks the NameNode's filesystem checkpoint is no older than some percentage of the Filesystem Checkpoint Period and that the number of transactions that have occurred since the last filesystem checkpoint does not exceed some percentage of the Filesystem Checkpoint Transaction Limit. A failure of this health test may indicate a problem with the active NameNode or its configured checkpointing role, i.e. either a standby NameNode or a SecondaryNameNode. Check the NameNode logs or the logs of the checkpointing role for more details. This test can be configured using the Filesystem Checkpoint Age Monitoring Thresholds and Filesystem Checkpoint Transactions Monitoring Thresholds NameNode monitoring setting.

Short Name: Checkpoint Status

Property Name Description Template Name Default Value Unit
Filesystem Checkpoint Age Monitoring Thresholds The health test thresholds of the age of the HDFS namespace checkpoint. Specified as a percentage of the configured checkpoint interval. namenode_checkpoint_age_thresholds critical:400.0, warning:200.0 PERCENT
Filesystem Checkpoint Transactions Monitoring Thresholds The health test thresholds of the number of transactions since the last HDFS namespace checkpoint. Specified as a percentage of the configured checkpointing transaction limit. namenode_checkpoint_transactions_thresholds critical:400.0, warning:200.0 PERCENT

NameNode File Descriptors

This NameNode health test checks that the number of file descriptors used does not rise above some percentage of the NameNode file descriptor limit. A failure of this health test may indicate a bug in either Hadoop or Cloudera Manager. Contact Cloudera support. This test can be configured using the File Descriptor Monitoring Thresholds NameNode monitoring setting.

Short Name: File Descriptors

Property Name Description Template Name Default Value Unit
File Descriptor Monitoring Thresholds The health test thresholds of the number of file descriptors used. Specified as a percentage of file descriptor limit. namenode_fd_thresholds critical:70.0, warning:50.0 PERCENT

NameNode Heap Dump Directory Free Space

This NameNode health test checks that the filesystem containing the heap dump directory of this NameNode has sufficient free space. This test can be configured using the Heap Dump Directory Free Space Monitoring Absolute Thresholds and Heap Dump Directory Free Space Monitoring Percentage Thresholds NameNode monitoring settings.

Short Name: Heap Dump Directory Free Space

Property Name Description Template Name Default Value Unit
Heap Dump Directory Free Space Monitoring Absolute Thresholds The health test thresholds for monitoring of free space on the filesystem that contains this role's heap dump directory. heap_dump_directory_free_space_absolute_thresholds critical:5.36870912E9, warning:1.073741824E10 BYTES
Heap Dump Directory Free Space Monitoring Percentage Thresholds The health test thresholds for monitoring of free space on the filesystem that contains this role's heap dump directory. Specified as a percentage of the capacity on that filesystem. This setting is not used if a Heap Dump Directory Free Space Monitoring Absolute Thresholds setting is configured. heap_dump_directory_free_space_percentage_thresholds critical:never, warning:never PERCENT

NameNode Host Health

This NameNode health test factors in the health of the host upon which the NameNode is running. A failure of this test means that the host running the NameNode is experiencing some problem. See that host's status page for more details.This test can be enabled or disabled using the NameNode Host Health Test NameNode monitoring setting.

Short Name: Host Health

Property Name Description Template Name Default Value Unit
NameNode Host Health Test When computing the overall NameNode health, consider the host's health. namenode_host_health_enabled true no unit

NameNode JournalNode Sync Status

This is a NameNode health test that checks that the NameNode is not out-of-sync with too many JournalNodes. This test is disabled if Quorum-based storage is not in use.A failure of this health test may indicate a problem with the JournalNodes or a communication problem between the NameNode and the JournalNodes. Check the NameNode and the JournalNode logs for more details.This test can be configured using the NameNode Out-Of-Sync JournalNodes Thresholds NameNode monitoring setting.

Short Name: JournalNode Sync Status

Property Name Description Template Name Default Value Unit
NameNode Out-Of-Sync JournalNodes Thresholds The health check thresholds for the number of out-of-sync JournalNodes for this NameNode. namenode_out_of_sync_journal_nodes_thresholds critical:any, warning:never no unit

NameNode Log Directory Free Space

This NameNode health test checks that the filesystem containing the log directory of this NameNode has sufficient free space. This test can be configured using the Log Directory Free Space Monitoring Absolute Thresholds and Log Directory Free Space Monitoring Percentage Thresholds NameNode monitoring settings.

Short Name: Log Directory Free Space

Property Name Description Template Name Default Value Unit
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. log_directory_free_space_absolute_thresholds critical:5.36870912E9, warning:1.073741824E10 BYTES
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. log_directory_free_space_percentage_thresholds critical:never, warning:never PERCENT

NameNode Name Directory Status

This is a NameNode health test that checks for whether the NameNode has reported any failed data directories. A failure of this health test indicates that there is a problem with one or more data directories on the NameNode. See the NameNode system web UI for more information. Note that unless the configuration dfs.namenode.name.dir.restore is configured to true, the NameNode will require a restart to recognize data directories that have been restored (e.g., after an NFS outage). This test can be configured using the NameNode Directory Failures Thresholds NameNode monitoring setting.

Short Name: Name Directory Status

Property Name Description Template Name Default Value Unit
NameNode Directory Failures Thresholds The health test thresholds of failed status directories in a NameNode. namenode_directory_failures_thresholds critical:any, warning:never no unit

NameNode NameNode Data Directories Free Space

This is a NameNode health test that checks that the filesystem containing the NameNode Data Directories of this NameNode has sufficient free space. See the NameNode Data Directories description on the NameNode configuration page for more information on this directory type. This test can be configured using the NameNode Data Directories Free Space Monitoring Absolute Thresholds and NameNode Data Directories Free Space Monitoring Percentage Thresholds NameNode monitoring settings.

Short Name: NameNode Data Directories Free Space

Property Name Description Template Name Default Value Unit
NameNode Data Directories Free Space Monitoring Absolute Thresholds The health test thresholds for monitoring of free space on the filesystem that contains this role's Determines where on the local file system the NameNode should store the name table (fsimage). For redundancy, enter a comma-delimited list of directories to replicate the name table in all of the directories. Typical values are /data/N/dfs/nn where N=1..3.. namenode_data_directories_free_space_absolute_thresholds critical:5.36870912E9, warning:1.073741824E10 BYTES
NameNode Data Directories Free Space Monitoring Percentage Thresholds The health test thresholds for monitoring of free space on the filesystem that contains this role's Determines where on the local file system the NameNode should store the name table (fsimage). For redundancy, enter a comma-delimited list of directories to replicate the name table in all of the directories. Typical values are /data/N/dfs/nn where N=1..3.. Specified as a percentage of the capacity on that filesystem. This setting is not used if a Determines where on the local file system the NameNode should store the name table (fsimage). For redundancy, enter a comma-delimited list of directories to replicate the name table in all of the directories. Typical values are /data/N/dfs/nn where N=1..3. Free Space Monitoring Absolute Thresholds setting is configured. namenode_data_directories_free_space_percentage_thresholds critical:never, warning:never PERCENT

NameNode Pause Duration

This NameNode health test checks that the NameNode threads are not experiencing long scheduling pauses. The test uses a pause monitoring thread in the NameNode that tracks scheduling delay by noting if it is run on its requested schedule. If the thread is not run on its requested schedule, the delay is noted and considered pause time. The health test checks that no more than some percentage of recent time is spent paused. A failure of this health test may indicate that the NameNode is not getting enough CPU resources, or that it is spending too much time doing garbage collection. Inspect the NameNode logs for any pause monitor output and check garbage collection metrics exposed by the NameNode. This test can be configured using the Pause Duration Thresholds and Pause Duration Monitoring Period NameNode monitoring settings.

Short Name: Pause Duration

Property Name Description Template Name Default Value Unit
Pause Duration Monitoring Period The period to review when computing the moving average of extra time the pause monitor spent paused. namenode_pause_duration_window 5 MINUTES
Pause Duration Thresholds The health test thresholds for the weighted average extra time the pause monitor spent paused. Specified as a percentage of elapsed wall clock time. namenode_pause_duration_thresholds critical:60.0, warning:30.0 no unit

NameNode Process Status

This NameNode health test checks that the Cloudera Manager Agent on the NameNode host is heart beating correctly and that the process associated with the NameNode role is in the state expected by Cloudera Manager. A failure of this health test may indicate a problem with the NameNode process, a lack of connectivity to the Cloudera Manager Agent on the NameNode host, or a problem with the Cloudera Manager Agent. This test can fail either because the NameNode has crashed or because the NameNode will not start or stop in a timely fashion. Check the NameNode logs for more details. If the test fails because of problems communicating with the Cloudera Manager Agent on the NameNode host, check the status of the Cloudera Manager Agent by running /etc/init.d/cloudera-scm-agent status on the NameNode host, or look in the Cloudera Manager Agent logs on the NameNode host for more details. This test can be enabled or disabled using the NameNode Process Health Test NameNode monitoring setting.

Short Name: Process Status

Property Name Description Template Name Default Value Unit
NameNode Process Health Test Enables the health test that the NameNode's process state is consistent with the role configuration namenode_scm_health_enabled true no unit

NameNode RPC Latency

This is a NameNode health test that checks that a moving average of the average time it takes for the NameNode to respond to requests does not exceed some value. A failure of this health test could indicate misconfiguration of the NameNode, that the NameNode is having a problem writing to one of its data directories, or may indicate a capacity planning problem. Check the NameNode's RpcQueueTime_avg_time and if this indicates that the bulk of the RPC latency is spent with requests queued, try increasing the NameNode Handler Count. If the NameNode's RpcProcessingTime_avg_time indicates the bulk of the RPC latency is due to request processing, check to see that each of the directories in which the HDFS metadata is being stored is performing adequately. This test can be configured using the NameNode RPC Latency Thresholds and NameNode RPC Latency Monitoring Window NameNode monitoring settings.

Short Name: RPC Latency

Property Name Description Template Name Default Value Unit
NameNode RPC Latency Monitoring Window The period to review when computing the moving average of the NameNode's RPC latency. namenode_rpc_latency_window 5 MINUTES
NameNode RPC Latency Thresholds The health check thresholds of the NameNode's RPC latency. namenode_rpc_latency_thresholds critical:5000.0, warning:1000.0 MILLISECONDS

NameNode Rolling Upgrade Status

This is a NameNode health test that checks for the presence of an unfinalized HDFS rolling metadata upgrade. If an unfinalized HDFS rolling metadata upgrade is detected, this test returns "Concerning" health. A failure of this health test indicates that a previously performed rolling metadata upgrade needs to be finalized. This can be done via HDFS Finalize Rolling Metadata Upgrade command. This test can be enabled or disabled using the HDFS Rolling Metadata Upgrade Status Health Test NameNode monitoring setting.

Short Name: Rolling Upgrade Status

Property Name Description Template Name Default Value Unit
HDFS Rolling Metadata Upgrade Status Health Test Enables the health test of the rolling metadata upgrade status of the NameNode. This covers rolling metadata upgrades. Nonrolling metadata upgrades are covered in a separate health test. namenode_rolling_upgrade_status_enabled true no unit

NameNode Safe Mode Status

This is a NameNode health test that checks that the NameNode is not in safemode. A failure of this health test indicates that the NameNode is in safemode. Look in the NameNode logs for more details. This test can be enabled or disabled using the NameNode Safemode Health Test NameNode monitoring setting. The Health Check Startup Tolerance NameNode monitoring setting also controls the amount of time at NameNode start up to tolerate safemode.

Short Name: Safe Mode Status

Property Name Description Template Name Default Value Unit
Health Check Startup Tolerance The amount of time allowed after this role is started that failures of health checks that rely on communication with this role will be tolerated. namenode_startup_tolerance 5 MINUTES
NameNode Safemode Health Test Enables the health test that the NameNode is not in safemode namenode_safe_mode_enabled true no unit

NameNode Swap Memory Usage

This NameNode health test checks the amount of swap memory in use by the role. A failure of this health test may indicate that your machine is overloaded. This test can be configured using the Process Swap Memory Thresholds monitoring settings.

Short Name: Swap Memory Usage

Property Name Description Template Name Default Value Unit
Process Swap Memory Thresholds The health test thresholds on the swap memory usage of the process. process_swap_memory_thresholds critical:never, warning:any BYTES

NameNode Unexpected Exits

This NameNode health test checks that the NameNode has not recently exited unexpectedly. The test returns "Bad" health if the number of unexpected exits goes above a critical threshold. For example, if this test is configured with a critical threshold of 1, this test would return "Good" health if there have been no unexpected exits recently. If there has been 1 or more unexpected exits recently, this test would return "Bad" health. This test can be configured using the Unexpected Exits Thresholds and Unexpected Exits Monitoring Period NameNode monitoring settings.

Short Name: Unexpected Exits

Property Name Description Template Name Default Value Unit
Unexpected Exits Monitoring Period The period to review when computing unexpected exits. unexpected_exits_window 5 MINUTES
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. unexpected_exits_thresholds critical:any, warning:never no unit

NameNode Upgrade Status

This is a NameNode health test that checks for the presence of an unfinalized HDFS metadata upgrade. If an unfinalized HDFS metadata upgrade is detected, this test returns "Concerning" health. A failure of this health test indicates that a previously performed HDFS upgrade needs to be finalized. This can be done via the Finalize Metadata Upgrade NameNode command linked above. This test can be enabled or disabled using the HDFS Metadata Upgrade Status Health Test NameNode monitoring setting.

Short Name: Upgrade Status

Property Name Description Template Name Default Value Unit
HDFS Metadata Upgrade Status Health Test Enables the health test of the metadata upgrade status of the NameNode. This covers nonrolling metadata upgrades. Rolling metadata upgrades are covered in a separate health test. namenode_upgrade_status_enabled true no unit

NameNode Web Server Status

This health test checks that the role's web server is responding quickly to requests by the Cloudera Manager Agent, and that the Cloudera Manager Agent can collect metrics from the web server. Failure of this health test may indicate a problem with the web server of the NameNode, a misconfiguration of the NameNode, or a problem with the Cloudera Manager Agent. Consult the Cloudera Manager Agent logs and the logs of the NameNode for more detail. If the test failure message indicates a communication problem, the Cloudera Manager Agent's HTTP requests to the NameNode's web server are failing or timing out. If the test's failure message indicates an unexpected response, the NameNode's web server responded to the Cloudera Manager Agent's request, but the response could not be interpreted for some reason. This test can be configured using the Web Metric Collection NameNode monitoring setting.

Short Name: Web Server Status

Property Name Description Template Name Default Value Unit
Web Metric Collection Enables the health test that the Cloudera Manager Agent can successfully contact and gather metrics from the web server. namenode_web_metric_collection_enabled true no unit
Web Metric Collection Duration The health test thresholds on the duration of the metrics request to the web server. namenode_web_metric_collection_thresholds critical:never, warning:10000.0 MILLISECONDS