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 Data Directories Free Space
This is a NameNode health test that checks whether the filesystems containing the data directories have sufficient free space. This test can be configured using the Data Directories Free Space Monitoring Absolute Thresholds and Data Directories Free Space Monitoring Percentage Thresholds NameNode monitoring settings.
Short Name: Data Directories Free Space
Property Name | Description | Template Name | Default Value | Unit |
---|---|---|---|---|
Data Directories Free Space Monitoring Absolute Thresholds | The health test thresholds for monitoring of free space on the filesystems that contain this role's data directories. | namenode_data_directories_free_space_absolute_thresholds | critical:5.36870912E9, warning:1.073741824E10 | BYTES |
Data Directories Free Space Monitoring Percentage Thresholds | The health test thresholds for monitoring of free space on the filesystems that contain this role's data directories. Specified as a percentage of the capacity on the filesystem. This setting is not used if a Data Directories Free Space Monitoring Absolute Thresholds setting is configured. | namenode_data_directories_free_space_percentage_thresholds | critical:never, warning:never | 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 GC Duration
This NameNode health test checks that the NameNode is not spending too much time performing Java garbage collection. It checks that no more than some percentage of recent time is spent performing Java garbage collection. A failure of this health test may indicate a capacity planning problem or misconfiguration of the NameNode. This test can be configured using the Garbage Collection Duration Thresholds and Garbage Collection Duration Monitoring Period NameNode monitoring settings.
Short Name: GC Duration
Property Name | Description | Template Name | Default Value | Unit |
---|---|---|---|---|
Garbage Collection Duration Monitoring Period | The period to review when computing the moving average of garbage collection time. | namenode_gc_duration_window | 5 | MINUTES |
Garbage Collection Duration Thresholds | The health test thresholds for the weighted average time spent in Java garbage collection. Specified as a percentage of elapsed wall clock time. | namenode_gc_duration_thresholds | critical:60.0, warning:30.0 | no unit |
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 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 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 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 Upgrade Status Health Test NameNode monitoring setting.
Short Name: Upgrade Status
Property Name | Description | Template Name | Default Value | Unit |
---|---|---|---|---|
HDFS Upgrade Status Health Test | Enables the health test of the upgrade status of the NameNode. | namenode_upgrade_status_enabled | true | no unit |
NameNode Web Server Status
This NameNode health test checks that the web server of the NameNode is responding quickly to requests by the Cloudera Manager Agent, and that the Cloudera Manager Agent can collect metrics from the web server. A 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's failure message indicates a communication problem, this means that the Cloudera Manager Agent's HTTP requests to the NameNode's web server are failing or timing out. These requests are completely local to the NameNode's host, and so should never fail under normal conditions. If the test's failure message indicates an unexpected response, then the NameNode's web server responded to the Cloudera Manager Agent's request, but the Cloudera Manager Agent could not interpret the response 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 |
<< NFS Gateway Health Tests | Navigator Audit Server Health Tests >> | |