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 NameNode Data Directories. | 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 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. | 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 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
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 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
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 |
<< NFS Gateway Health Tests | ©2016 Cloudera, Inc. All rights reserved | Navigator Audit Server Health Tests >> |
Terms and Conditions Privacy Policy |