Built-in Metrics

Device metrics contain information about the host device on which the Deviceplane agent runs. These metrics come out-of-the box, and only need to be configured in the UI.

An Example

Two useful metrics to expose might be "Filesystem Free Bytes" and "Filesystem Size Bytes". These metrics give you information on disk capacity and disk usage on your devices, on a per-disk basis.

To expose these two metrics:

  1. Open Device Metrics (Monitoring > Device Metrics)
  2. Click "add device metrics"
  3. Select "Filesystem Free Bytes" and "Filesystem Size Bytes" from Metrics, and "device" from Properties

Now, you can make an alert in Datadog that notifies you when you have low amounts of disk space left!

To do so, go to the create monitor page in Datadog, scroll to the second section, "Define the metric", select the "Source" tab, and paste the following formula in:

avg:deviceplane.device.filesystem_free_bytes{*} by {deviceplane.device} / avg:deviceplane.device.filesystem_size_bytes{*} by {deviceplane.device}

Now, you can define your alert conditions. Here we've set an alert when 10% storage is left, and a warning when 30% is left. This is what it looks like:

Now you can receive Datadog alerts when your devices are low on disk space!

Full List

The full list of Device metrics we provide:

Metric NameDescriptionMetric TypeAdded Tags
cpu_guest_seconds_totalSeconds the cpus spent in guests (VMs) for each mode.countercpu, mode
cpu_seconds_totalSeconds the cpus spent in each mode.countercpu, mode
disk_discard_time_seconds_totalThis is the total number of seconds spent by all discards.counterdevice
disk_discarded_sectors_totalThe total number of sectors discarded successfully.counterdevice
disk_discards_completed_totalThe total number of discards completed successfully.counterdevice
disk_discards_merged_totalThe total number of discards merged.counterdevice
disk_io_nowThe number of I/Os currently in progress.gaugedevice
disk_io_time_seconds_totalTotal seconds spent doing I/Os.counterdevice
disk_io_time_weighted_seconds_totalThe weighted # of seconds spent doing I/Os.counterdevice
disk_read_bytes_totalThe total number of bytes read successfully.counterdevice
disk_read_time_seconds_totalThe total number of seconds spent by all reads.counterdevice
disk_reads_completed_totalThe total number of reads completed successfully.counterdevice
disk_reads_merged_totalThe total number of reads merged.counterdevice
disk_write_time_seconds_totalThis is the total number of seconds spent by all writes.counterdevice
disk_writes_completed_totalThe total number of writes completed successfully.counterdevice
disk_writes_merged_totalThe number of writes merged.counterdevice
disk_written_bytes_totalThe total number of bytes written successfully.counterdevice
filesystem_avail_bytesFilesystem space available to non-root users in bytes.gaugedevice, fstype, mountpoint
filesystem_device_errorWhether an error occurred while getting statistics for the given device.gaugedevice, fstype, mountpoint
filesystem_filesFilesystem total file nodes.gaugedevice, fstype, mountpoint
filesystem_files_freeFilesystem total free file nodes.gaugedevice, fstype, mountpoint
filesystem_free_bytesFilesystem free space in bytes.gaugedevice, fstype, mountpoint
filesystem_readonlyFilesystem read-only status.gaugedevice, fstype, mountpoint
filesystem_size_bytesFilesystem size in bytes.gaugedevice, fstype, mountpoint
load11m load average.gauge
load1515m load average.gauge
load55m load average.gauge
memory_Active_anon_bytesMemory information field Active_anon_bytes.gauge
memory_Active_bytesMemory information field Active_bytes.gauge
memory_Active_file_bytesMemory information field Active_file_bytes.gauge
memory_AnonPages_bytesMemory information field AnonPages_bytes.gauge
memory_Bounce_bytesMemory information field Bounce_bytes.gauge
memory_Buffers_bytesMemory information field Buffers_bytes.gauge
memory_Cached_bytesMemory information field Cached_bytes.gauge
memory_CmaFree_bytesMemory information field CmaFree_bytes.gauge
memory_CmaTotal_bytesMemory information field CmaTotal_bytes.gauge
memory_CommitLimit_bytesMemory information field CommitLimit_bytes.gauge
memory_Committed_AS_bytesMemory information field Committed_AS_bytes.gauge
memory_Dirty_bytesMemory information field Dirty_bytes.gauge
memory_Inactive_anon_bytesMemory information field Inactive_anon_bytes.gauge
memory_Inactive_bytesMemory information field Inactive_bytes.gauge
memory_Inactive_file_bytesMemory information field Inactive_file_bytes.gauge
memory_KernelStack_bytesMemory information field KernelStack_bytes.gauge
memory_Mapped_bytesMemory information field Mapped_bytes.gauge
memory_MemAvailable_bytesMemory information field MemAvailable_bytes.gauge
memory_MemFree_bytesMemory information field MemFree_bytes.gauge
memory_MemTotal_bytesMemory information field MemTotal_bytes.gauge
memory_Mlocked_bytesMemory information field Mlocked_bytes.gauge
memory_NFS_Unstable_bytesMemory information field NFS_Unstable_bytes.gauge
memory_PageTables_bytesMemory information field PageTables_bytes.gauge
memory_Percpu_bytesMemory information field Percpu_bytes.gauge
memory_SReclaimable_bytesMemory information field SReclaimable_bytes.gauge
memory_SUnreclaim_bytesMemory information field SUnreclaim_bytes.gauge
memory_Shmem_bytesMemory information field Shmem_bytes.gauge
memory_Slab_bytesMemory information field Slab_bytes.gauge
memory_SwapCached_bytesMemory information field SwapCached_bytes.gauge
memory_SwapFree_bytesMemory information field SwapFree_bytes.gauge
memory_SwapTotal_bytesMemory information field SwapTotal_bytes.gauge
memory_Unevictable_bytesMemory information field Unevictable_bytes.gauge
memory_VmallocChunk_bytesMemory information field VmallocChunk_bytes.gauge
memory_VmallocTotal_bytesMemory information field VmallocTotal_bytes.gauge
memory_VmallocUsed_bytesMemory information field VmallocUsed_bytes.gauge
memory_WritebackTmp_bytesMemory information field WritebackTmp_bytes.gauge
memory_Writeback_bytesMemory information field Writeback_bytes.gauge
network_receive_bytes_totalNetwork device statistic receive_bytes.counterdevice
network_receive_compressed_totalNetwork device statistic receive_compressed.counterdevice
network_receive_drop_totalNetwork device statistic receive_drop.counterdevice
network_receive_errs_totalNetwork device statistic receive_errs.counterdevice
network_receive_fifo_totalNetwork device statistic receive_fifo.counterdevice
network_receive_frame_totalNetwork device statistic receive_frame.counterdevice
network_receive_multicast_totalNetwork device statistic receive_multicast.counterdevice
network_receive_packets_totalNetwork device statistic receive_packets.counterdevice
network_transmit_bytes_totalNetwork device statistic transmit_bytes.counterdevice
network_transmit_carrier_totalNetwork device statistic transmit_carrier.counterdevice
network_transmit_colls_totalNetwork device statistic transmit_colls.counterdevice
network_transmit_compressed_totalNetwork device statistic transmit_compressed.counterdevice
network_transmit_drop_totalNetwork device statistic transmit_drop.counterdevice
network_transmit_errs_totalNetwork device statistic transmit_errs.counterdevice
network_transmit_fifo_totalNetwork device statistic transmit_fifo.counterdevice
network_transmit_packets_totalNetwork device statistic transmit_packets.counterdevice
scrape_collector_duration_secondsDuration of a collector scrape.gaugecollector
scrape_collector_successWhether a collector succeeded.gaugecollector
textfile_scrape_error1 if there was an error opening or reading a file, 0 otherwisegauge
time_secondsSystem time in seconds since epoch (1970).gauge
promhttp_metric_handler_errors_totalTotal number of internal errors encountered by the promhttp metric handler.countercause
promhttp_metric_handler_requests_in_flightCurrent number of scrapes being served.gauge
promhttp_metric_handler_requests_totalTotal number of scrapes by HTTP status code.countercode