The Service Map for APM is here!

Nomad

StatsD Check StatsD Check

Overview

Gather metrics from your Nomad clusters to:

  • Visualize and monitor cluster performance
  • Alert on cluster health and availability

Setup

Installation

Nomad emits metrics to Datadog via DogStatsD. To enable the Nomad integration, install the Datadog Agent on each client and server host.

Configuration

Once the Datadog Agent is installed, add a Telemetry stanza to the Nomad configuration for your clients and servers:

telemetry {
  publish_allocation_metrics = true
  publish_node_metrics       = true
  datadog_address = "localhost:8125"
  disable_hostname = true
}

Next, reload or restart the Nomad agent on each host. You should now begin to see Nomad metrics flowing to your Datadog account.

Data Collected

Metrics

nomad.client.host.memory.total
(gauge)
Total amount of memory for a client
shown as mebibyte
nomad.client.host.memory.available
(gauge)
Amount of memory available for a client
shown as mebibyte
nomad.client.host.memory.used
(gauge)
Amount of memory used for a client
shown as mebibyte
nomad.client.host.memory.free
(gauge)
Amount of memory free for a client
shown as mebibyte
nomad.client.host.cpu.total
(gauge)
Amount of CPU total for a client
shown as megahertz
nomad.client.host.cpu.user
(gauge)
Amount of CPU total for a client
shown as megahertz
nomad.client.host.cpu.idle
(gauge)
Amount of CPU idle for a client
shown as megahertz
nomad.client.host.cpu.system
(gauge)
Amount of CPU consumed by the system for a client
shown as megahertz
nomad.client.host.disk.size
(gauge)
Disk size for a particular client
shown as mebibyte
nomad.client.host.disk.used
(gauge)
Disk used for a particular client
shown as mebibyte
nomad.client.host.disk.available
(gauge)
Disk available for a particular client
shown as mebibyte
nomad.client.host.disk.used_percent
(gauge)
Disk used as a percentage for a particular client
shown as mebibyte
nomad.client.host.disk.inodes_percent
(gauge)
Disk nodes used as a percentage for a particular client
shown as mebibyte
nomad.client.allocated.memory
(gauge)
Amount of memory allocated for a client
shown as mebibyte
nomad.client.allocated.disk
(gauge)
Amount of disk allocated for a client
shown as mebibyte
nomad.client.allocated.cpu
(gauge)
Amount of CPU allocated for a client
shown as megahertz
nomad.client.allocated.iops
(gauge)
Number of iops allocated for a client
shown as operation
nomad.client.unallocated.memory
(gauge)
Amount of unallocated memory for a client
shown as mebibyte
nomad.client.unallocated.disk
(gauge)
Amount of unallocated disk for a client
shown as mebibyte
nomad.client.unallocated.cpu
(gauge)
Amount of unallocated CPU for a client
shown as megahertz
nomad.client.unallocated.iops
(gauge)
Number of unallocated iops for a client
shown as operation
nomad.client.allocations.migrating
(gauge)
Number of allocations migrating for a client
shown as job
nomad.client.allocations.blocked
(gauge)
Number of allocations blocked for a client
shown as job
nomad.client.allocations.pending
(gauge)
Number of allocations pending for a client
shown as job
nomad.client.allocations.running
(gauge)
Number of allocations running for a client
shown as job
nomad.client.allocations.terminal
(gauge)
Number of allocations terminated for a client
shown as job
nomad.client.allocated.network
(gauge)
Bandwidth allocatoin for a client
shown as mebibyte
nomad.client.unallocated.network
(gauge)
Unallocated bandwidth for a client
shown as mebibyte

Events

The Nomad check does not include any events at this time.

Service Checks

The Nomad check does not include any service checks at this time.

Troubleshooting

Need help? Contact Datadog Support.


Mistake in the docs? Feel free to contribute!