NameNode Health Tests

NameNode Audit Pipeline Test

This NameNode health test checks that the Auditing for the NameNode role is getting processed correctly and is not blocked. A failure of this health test may indicate a problem with the audit pipeline of NameNode process. This test can fail either because the Cloudera Audit Server is not accepting audits, or the Cloudera Manager Agent on the NameNode host isn't able to send audits because of some network issue. Check the Cloudera Manager Agent logs and Cloudera Audit Server logs for more details. This test can be enabled or disabled using the Navigator Audit Pipeline Health Check NameNode monitoring setting.

Short Name: Audit Pipeline Test

Monitoring Period For Audit Failures

Description
The period to review when checking if audits are blocked and not getting processed.
Template Name
mgmt_navigator_failure_window
Default Value
20
Unit(s)
MINUTES

Navigator Audit Failure Thresholds

Description
The health test thresholds for failures encountered when monitoring audits within a recent period specified by the mgmt_navigator_failure_window configuration for the role. The value that can be specified for this threshold is the number of bytes of audits data that is left to be sent to audit server.
Template Name
mgmt_navigator_failure_thresholds
Default Value
critical:any, warning:never
Unit(s)
BYTES

Navigator Audit Pipeline Health Check

Description
Enable test of audit events processing pipeline. This will test if audit events are not getting processed by Audit Server for a role that generates audit.
Template Name
mgmt_navigator_status_check_enabled
Default Value
true
Unit(s)
no unit

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

Filesystem Checkpoint Age Monitoring Thresholds

Description
The health test thresholds of the age of the HDFS namespace checkpoint. Specified as a percentage of the configured checkpoint interval.
Template Name
namenode_checkpoint_age_thresholds
Default Value
critical:400.0, warning:200.0
Unit(s)
PERCENT

Filesystem Checkpoint Transactions Monitoring Thresholds

Description
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.
Template Name
namenode_checkpoint_transactions_thresholds
Default Value
critical:400.0, warning:200.0
Unit(s)
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

File Descriptor Monitoring Thresholds

Description
The health test thresholds of the number of file descriptors used. Specified as a percentage of file descriptor limit.
Template Name
namenode_fd_thresholds
Default Value
critical:70.0, warning:50.0
Unit(s)
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

Heap Dump Directory Free Space Monitoring Absolute Thresholds

Description
The health test thresholds for monitoring of free space on the filesystem that contains this role's heap dump directory.
Template Name
heap_dump_directory_free_space_absolute_thresholds
Default Value
critical:5.36870912E9, warning:1.073741824E10
Unit(s)
BYTES

Heap Dump Directory Free Space Monitoring Percentage Thresholds

Description
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.
Template Name
heap_dump_directory_free_space_percentage_thresholds
Default Value
critical:never, warning:never
Unit(s)
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

NameNode Host Health Test

Description
When computing the overall NameNode health, consider the host's health.
Template Name
namenode_host_health_enabled
Default Value
true
Unit(s)
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

NameNode Out-Of-Sync JournalNodes Thresholds

Description
The health check thresholds for the number of out-of-sync JournalNodes for this NameNode.
Template Name
namenode_out_of_sync_journal_nodes_thresholds
Default Value
critical:any, warning:never
Unit(s)
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

Log Directory Free Space Monitoring Absolute Thresholds

Description
The health test thresholds for monitoring of free space on the filesystem that contains this role's log directory.
Template Name
log_directory_free_space_absolute_thresholds
Default Value
critical:5.36870912E9, warning:1.073741824E10
Unit(s)
BYTES

Log Directory Free Space Monitoring Percentage Thresholds

Description
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.
Template Name
log_directory_free_space_percentage_thresholds
Default Value
critical:never, warning:never
Unit(s)
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

NameNode Directory Failures Thresholds

Description
The health test thresholds of failed status directories in a NameNode.
Template Name
namenode_directory_failures_thresholds
Default Value
critical:any, warning:never
Unit(s)
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

NameNode Data Directories Free Space Monitoring Absolute Thresholds

Description
The health test thresholds for monitoring of free space on the filesystem that contains this role's NameNode Data Directories.
Template Name
namenode_data_directories_free_space_absolute_thresholds
Default Value
critical:5.36870912E9, warning:1.073741824E10
Unit(s)
BYTES

NameNode Data Directories Free Space Monitoring Percentage Thresholds

Description
The health test thresholds for monitoring of free space on the filesystem that contains this role's NameNode Data Directories. Specified as a percentage of the capacity on that filesystem. This setting is not used if a NameNode Data Directories Free Space Monitoring Absolute Thresholds setting is configured.
Template Name
namenode_data_directories_free_space_percentage_thresholds
Default Value
critical:never, warning:never
Unit(s)
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

Pause Duration Monitoring Period

Description
The period to review when computing the moving average of extra time the pause monitor spent paused.
Template Name
namenode_pause_duration_window
Default Value
5
Unit(s)
MINUTES

Pause Duration Thresholds

Description
The health test thresholds for the weighted average extra time the pause monitor spent paused. Specified as a percentage of elapsed wall clock time.
Template Name
namenode_pause_duration_thresholds
Default Value
critical:60.0, warning:30.0
Unit(s)
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

NameNode Process Health Test

Description
Enables the health test that the NameNode's process state is consistent with the role configuration
Template Name
namenode_scm_health_enabled
Default Value
true
Unit(s)
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

NameNode RPC Latency Monitoring Window

Description
The period to review when computing the moving average of the NameNode's RPC latency.
Template Name
namenode_rpc_latency_window
Default Value
5
Unit(s)
MINUTES

NameNode RPC Latency Thresholds

Description
The health check thresholds of the NameNode's RPC latency.
Template Name
namenode_rpc_latency_thresholds
Default Value
critical:5000.0, warning:1000.0
Unit(s)
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 meatadata 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

HDFS Rolling Metadata Upgrade Status Health Test

Description
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.
Template Name
namenode_rolling_upgrade_status_enabled
Default Value
true
Unit(s)
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 Test Startup Tolerance NameNode monitoring setting also controls the amount of time at NameNode start up to tolerate safemode.

Short Name: Safe Mode Status

Health Test Startup Tolerance

Description
The amount of time allowed after this role is started that failures of health tests that rely on communication with this role will be tolerated.
Template Name
namenode_startup_tolerance
Default Value
5
Unit(s)
MINUTES

NameNode Safemode Health Test

Description
Enables the health test that the NameNode is not in safemode
Template Name
namenode_safe_mode_enabled
Default Value
true
Unit(s)
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

Process Swap Memory Thresholds

Description
The health test thresholds on the swap memory usage of the process. This takes precedence over the host level threshold.
Template Name
process_swap_memory_thresholds
Default Value
critical:never, warning:200.0
Unit(s)
BYTES

NameNode Swap Memory Usage Rate Beta

This NameNode health test checks the change of the amount of swap memory usage by the role during a predefined period. A failure of this health test may indicate that your machine is overloaded. This test can be configured using the Swap Memory Usage Rate Thresholds and Swap Memory Usage Rate Window monitoring settings.

Short Name: Swap Memory Usage Rate Beta

Swap Memory Usage Rate Thresholds

Description
The health test thresholds on the swap memory usage rate of the process. Specified as the change of the used swap memory during the predefined period.
Template Name
process_swap_memory_rate_thresholds
Default Value
critical:never, warning:never
Unit(s)
BYTES

Swap Memory Usage Rate Window

Description
The period to review when computing unexpected swap memory usage change of the process.
Template Name
process_swap_memory_rate_window
Default Value
5
Unit(s)
MINUTES

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 exceeds a critical threshold. For example, if this test is configured with a critical threshold of 1, this test returns "Good" health if there have been no unexpected exits recently. If 1 or more unexpected exits occured recently, this test returns "Bad" health. The test also indicates whether any of the exits were caused by an OutOfMemory error if the Cloudera Manager Kill When Out of Memory monitoring setting is enabled. This test can be configured using the Unexpected Exits Thresholds and Unexpected Exits Monitoring Period NameNode monitoring settings.

Short Name: Unexpected Exits

Unexpected Exits Monitoring Period

Description
The period to review when computing unexpected exits.
Template Name
unexpected_exits_window
Default Value
5
Unit(s)
MINUTES

Unexpected Exits Thresholds

Description
The health test thresholds for unexpected exits encountered within a recent period specified by the unexpected_exits_window configuration for the role.
Template Name
unexpected_exits_thresholds
Default Value
critical:any, warning:never
Unit(s)
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

HDFS Metadata Upgrade Status Health Test

Description
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.
Template Name
namenode_upgrade_status_enabled
Default Value
true
Unit(s)
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

Web Metric Collection

Description
Enables the health test that the Cloudera Manager Agent can successfully contact and gather metrics from the web server.
Template Name
namenode_web_metric_collection_enabled
Default Value
true
Unit(s)
no unit

Web Metric Collection Duration

Description
The health test thresholds on the duration of the metrics request to the web server.
Template Name
namenode_web_metric_collection_thresholds
Default Value
critical:never, warning:10000.0
Unit(s)
MILLISECONDS