Service Check

Service Check

Overview

Services checks allow you to characterize the status of a service to monitor it within Datadog. Service checks monitor the up or down status of the specific service. You are alerted whenever the monitoring Agent fails to connect to that service in a specified number of consecutive checks. For example, you can get an alert any time the monitoring Agent on a Redis host reports three consecutive failed attempts to connect to Redis and collect metrics.

Service checks at the cluster level offer another effective way to monitor distributed or redundant systems that can withstand some failures. Use these alerts for architectures where individual hosts run multiple services, because they can surface the degradation of the service even if the hosts running that service remain available (and would pass a host-level health check).

You can set up monitoring and an alert for when a critical, non-redundant service is lost, or if a cluster is on the verge of failure due to widespread node loss. Other critical alerts could be a drop in request throughput or an increase in request latency.

You might need to set up a service check if an integration does not have one natively or for an internal service that you want to monitor for up or down status.

To use service checks, first set up the check:


Once the service check is sending data, check out your check summary and set up dashboards, monitors, and alerts:

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.

Screenboards

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.