devstat

Plugin: freebsd.plugin Module: devstat

Overview

Collect information per hard disk available on host.

The plugin calls sysctl function to collect necessary data.

This collector is supported on all platforms.

This collector supports collecting metrics from multiple instances of this integration, including remote instances.

Default Behavior

Auto-Detection

This integration doesn't support auto-detection.

Limits

The default configuration for this integration does not impose any limits on data collection.

Performance Impact

The default configuration for this integration is not expected to impose a significant performance impact on the system.

Metrics

Metrics grouped by scope.

The scope defines the instance that the metric belongs to. An instance is uniquely identified by a set of labels.

Per devstat instance

These metrics give a general vision about I/O events on disks.

This scope has no labels.

Metrics:

Metric	Dimensions	Unit
system.io	io, out	KiB/s

Per disk

This scope has no labels.

Metrics:

Metric	Dimensions	Unit
disk.io	reads, writes, frees	KiB/s
disk.ops	reads, writes, other, frees	operations/s
disk.qops	operations	operations
disk.util	utilization	% of time working
disk.iotime	reads, writes, other, frees	milliseconds/s
disk.await	reads, writes, other, frees	milliseconds/operation
disk.avgsz	reads, writes, frees	KiB/operation
disk.svctm	svctm	milliseconds/operation

Alerts

The following alerts are available:

Alert name	On metric	Description
10min_disk_utilization	disk.util	average percentage of time ${label:device} disk was busy over the last 10 minutes

Setup

Prerequisites

No action required.

Configuration

File

The configuration file name for this integration is netdata.conf. Configuration for this specific integration is located in the [plugin:freebsd:kern.devstat] section within that file.

The file format is a modified INI syntax. The general structure is:

[section1]
    option1 = some value
    option2 = some other value

[section2]
    option3 = some third value

You can edit the configuration file using the edit-config script from the Netdata config directory.

cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata
sudo ./edit-config netdata.conf

Options

Config options

Name	Description	Default	Required
enable new disks detected at runtime	Enable or disable possibility to detect new disks.	auto	no
performance metrics for pass devices	Enable or disable metrics for disks with type PASS.	auto	no
total bandwidth for all disks	Enable or disable total bandwidth metric for all disks.	yes	no
bandwidth for all disks	Enable or disable bandwidth for all disks metric.	auto	no
operations for all disks	Enable or disable operations for all disks metric.	auto	no
queued operations for all disks	Enable or disable queued operations for all disks metric.	auto	no
utilization percentage for all disks	Enable or disable utilization percentage for all disks metric.	auto	no
i/o time for all disks	Enable or disable I/O time for all disks metric.	auto	no
average completed i/o time for all disks	Enable or disable average completed I/O time for all disks metric.	auto	no
average completed i/o bandwidth for all disks	Enable or disable average completed I/O bandwidth for all disks metric.	auto	no
average service time for all disks	Enable or disable average service time for all disks metric.	auto	no
disable by default disks matching	Do not create charts for disks listed.		no

Examples

There are no configuration examples.