Service Check

Service Check


Services Checks allow you to characterize the status of a service in order to monitor it within Datadog. All status checks must have one of the following status codes:

Status CodeDescription

Visualize your service check in Datadog

Service checks can be visualized and used in 3 Datadog sections:

Check summary

Click on the Monitors tab, and then on Check Summary to see the Check Summary page.

This is a list of all your checks and their statuses, reporting across your infrastructure in the past day. Select a check to get insights on the number of distinct checks for each of its associated tags.


You can visualize service checks with a Check status widget in a screenboard:

After clicking on the Check status widget icon, the following pop-up appears:

In this form, you can:

  • Check Name: Select your service check name.
  • Reporting Timeframe: Select the time frame on which you want to aggregate your status.
  • Scoping: Select a single check or a cluster of check statuses reported by a single tag value or a tag key.
  • Widget Title: Set your widget title.

Custom check monitor

Even if you can’t graph a custom check over time as you would for metrics, you can still monitor it. Go to monitor tab > new monitor, then select the custom check section:

Configure your custom check monitor:

In this form, you can:

  • Pick a custom check: Select your check status name to monitor.
  • Pick monitor scope: Select the context for your monitor (including/excluding tags).
  • Set alert conditions: Choose between a simple check alert or a cluster alert.
  • Say what’s happening: Edit the notifications sent (find more about Datadog notifications).
  • Notify your team: Choose who this monitor should notify.

Service check monitors for out-of-the-box Datadog integrations can be set in the monitor tab > Integration > Integration status tab on the left. For instance, with the HAProxy integration:

Learn how to write an integration with the integration developer documentation.