System Check

Supported OS Linux Mac OS Windows

Overview

Get metrics from your base system about the CPU, IO, load, memory, swap, and uptime. The following checks are also system-related:

Setup

Installation

The System check is included in the Datadog Agent package. No additional installation is needed on your server.

Data Collected

Metrics

Events

The System check does not include any events.

Service checks

The System check does not include any service checks.

Tags

All system metrics are automatically tagged with host:<HOST_NAME>. Additionally, the following namespaces are tagged with device:<DEVICE_NAME>.

  • system.disk.*
  • system.fs.inodes.*
  • system.io.*
  • system.net.*

System Core

This check collects the number of CPU cores on a host and CPU times, such as system, user, idle, etc.

Setup

Installation

The system core check is included in the Datadog Agent package. No additional installation is needed on your server.

Configuration

  1. Edit the system_core.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory. See the sample system_core.d/conf.yaml for all available configuration options. Note: At least one entry is required under instances to enable the check, for example:

    init_config:
    instances:
        - foo: bar
        tags:
            - key:value
    
  2. Restart the Agent.

Validation

Run the Agent’s status subcommand and look for system_core under the Checks section.

Data Collected

Metrics

Depending on the platform, the check may collect other CPU time metrics, such as system.core.interrupt on Windows, system.core.iowait on Linux, etc.

Events

The System Core check does not include any events.

Service checks

System Swap

This check monitors the number of bytes a host has swapped in and out.

Setup

Installation

The system swap check is included in the Datadog Agent package. No additional installation is needed on your server.

Configuration

  1. Edit the system_swap.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory. See the sample system_swap.d/conf.yaml for all available configuration options. Note: This check takes no initial configuration.

  2. Restart the Agent.

Validation

Run the Agent’s status subcommand and look for system_swap under the Checks section.

Data Collected

Metrics

Events

The System Swap check does not include any events.

Service checks

The System Swap check does not include any service checks.