Instance Health

What is Instance health?

Instance health checks your application for known issues. These health checks can return one of the following status:

Icon	Meaning
	The health check has passed successfully. No action is required.
	The health check has encountered an issue that may cause problems in the future. We recommend reviewing these messages, although remedial action may not be required.
	The health check has encountered an error, or the health check has failed to perform. You should review these messages and take any appropriate remedial action.

When are health checks performed?

Checks are performed in real time, each time you visit the Instance Health tab in the Troubleshooting and support tools screen. 

In addition, scheduled checks are performed every hour since the instance's last start time. This means if you start Confluence at 3:15 PM, Confluence will perform a scheduled health check at 15 minutes past the hour, every hour, until the next restart. This interval can be adjusted by setting the atlassian.healthcheck.scheduler.interval-ms system property to the desired interval in milliseconds.

What happens when a health check fails?

Failed health checks are listed in the Instance Health tab.  Click each health check to find out why the check has failed and what do to to resolve the problem. Here's some examples of failing health checks. 

How do I know when a health check fails?

When you visit the Instance Health tab, the health checks run automatically and you'll see any problems detected listed. 

When a health check fails in the background, we notify Administrators the next time they visit any page in the application's administration console. 

The administrator can then take the following actions:

• Find out more takes the administrator to the Instance Health screen to review the failed Health Check.
• Don't remind me again will dismiss notifications of this type, until the problem occurs again.
• The X icon will close the notification.

If you dismiss a notification three times, we won't notify you again for that particular check (this is the same as clicking the Don't remind me again link).

How can I select what types of failures that I'm notified about?

As well as dismissing particular notifications, each administrator can also select the level of notifications they would like to receive. The levels are:

• Show all notifications
• Only show notifications for major problems
• Don't show any notifications

How do I disable a particular health check? 

There may be some instances where you don't want to run a health check at all. 

To disable a health check:

1. Go to the Instance Health tab in Troubleshooting and Support Tools
2. Expand the health check you want to disable.
3. Deselect the Enable this check toggle. 

Disabled checks are listed at the bottom of the Instance Health tab, and won't be run until enabled. 

What health checks are available?

Not all checks are available in all applications, the table below provides some examples. We're adding new health checks all the time, so head to Instance health to find out which checks are running in your application.