Skip to content
🚀 Limited-time offer $130 for Lifetime Pro access. Buy once and use forever

Status List

Uptime & Status Pages


metrics dashboard

Uptime Monitoring - Heroku Setup Guide

It’s critical that you monitor your web application for issues. When issues come up, you need to be alerted right away so you can fix it before it impacts your customers. Today we’ll show you how to get your monitoring setup with Heroku.


This guide is for Heroku hosted applications only. If you’re running on a different hosting platform, we have additional guides that you may find helpful.


At the end of this tutorial, you will have the following:

  1. Downtime and performance alerting via email, sms and/or Slack.
    1. Includes detailed diagnostic messages
  2. Monitor and Debug Dashboard
  3. Incident History
  4. Hosted Status Page

Provisioning the add-on

Let’s add the Status List addon to your app.

heroku addons:create statuslist

The addon has been provisioned. It’s now available to configure from your Heroku Dashboard or through the CLI. Let’s go add some monitors.

Accessing the Status List Dashboard

You can access the dashboard via the CLI:

heroku addons:open statuslist

or by visiting the Heroku Dashboard and selecting your application, then select StatusList from the Add-ons menu.

After you have setup users (later in this guide), you can also login at

Setting up Your Account

When you first login, you’ll get a page that looks like this:

Status List setup

Setup Monitors

Here you can add your monitors. If you need to customize further, you’ll be able to do that in the Monitors tab after. If you don’t have any monitors ready, you can skip this step for now.

Setup Notifications

Next, you will see a spot to configure your notification alerts. You can configure email or sms notifications. Ensure you confirm your email address by clicking confirmation email.

The Monitors Section

You should now have a monitoring dashboard that looks like this:

statuslist dashboard, monitor expanded

Adding Monitors

You can add monitors by clicking on the Add Monitors button on the top right. This will walk you through the steps to setup your monitor and get it started.

Advanced Configuration

You can configure advanced settings for each monitor as well. Click on the monitor and choose the Configuration sub tab. Here you can do things like:

  • Change performance thresholds
  • Change check interval
  • Add authentication parameters
  • Remove a monitor

Incident Log

The incident log automatically logs every incident this monitor has had. You can view the incidents and their HTTP transcripts by opening your monitor and going to the Incident subtab.

Setup Slack

If you would like to configure Slack notifications, click on the Slack icon at the top. This will walk you through the steps on how to get things set up. You can also refer to our Slack Setup Guide for more details.

Setup Status Page

Setup your hosted status page by clicking on the Status Page header item. You should see a screen that looks like this:

hosted status page configuration

This will walk you through the steps of how to set up your hosted status page. You can see an example of a hosted status page at

Wrapping Up

You are off to the races with your Heroku uptime monitor. If you’re using Rails as your Heroku backend, you may be interested in our Rails Health Check Setup Guide. We also have guides to set up specific technologies.