Sensors

Plugin: windows.plugin Module: GetSensors

Overview

This collector monitors sensors on Windows systems.

It uses Sensors API to retrieve available data.

This collector is only supported on the following platforms:

• windows

This collector only supports collecting metrics from a single instance of this integration.

Default Behavior

Auto-Detection

The collector automatically detects all of the metrics, no further configuration is required.

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.

Setup

Prerequisites

No action required.

Configuration

Options

Option	Description	Default	Required
update every	Data collection frequency.	1	no

via File

The configuration file name for this integration is netdata.conf. Configuration for this specific integration is located in the [plugin:windows:GetSensors] 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

Examples

Specific Sensors

You can add custom sensor information by creating a dedicated sensor section.

[plugin:windows:GetSensors:Your Sensor Name]
  units = Speed
  multiplier = 100
  title = Current speed.

Alerts

There are no alerts configured by default for this integration.

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 Sensor

These metrics refer to Sensors.

Labels:

Label	Description
label	Sensor friendly name.
manufacturer	The sensor manufacturer.
model	The sensor model.

Metrics:

Metric	Description	Dimensions	Unit
system.hw.sensor.temperature.input	Sensor Temperature	input	Cel
system.hw.sensor.temperature.histogram	Distribution of all temperature sensors in fixed bands	40, 50, 60, 70, 80, 85, 90, 95, 100, +Inf	sensors
system.hw.sensor.power.input	Sensor Power	input	W
system.hw.sensor.current.input	Sensor Current	input	A
system.hw.sensor.humidity.input	Sensor Humidity	input	%
system.hw.sensor.lux.input	Ambient light level	input	lx
system.hw.sensor.color.input	Color temperature of light	input	Cel
system.hw.sensor.voltage.input	Electrical potential	input	V
system.hw.sensor.resistance.input	Electrical resistance	input	Ohms
system.hw.sensor.capacitance.input	Electrical capacitance	input	F
system.hw.sensor.inductance.input	Electrical indutance	input	H
system.hw.sensor.pressure.input	Ambient atmospheric pressure	input	Pa
system.hw.sensor.latitude.input	Geographic latitude	input	Degrees
system.hw.sensor.longitude.input	Geographic longitude	input	Degrees
system.hw.sensor.force.input	Force	input	N
system.hw.sensor.gauge_pressure.input	Gauge Pressure	input	Pa
system.hw.sensor.human_presence.input	Human presence	input	presence
system.hw.sensor.human_proximity.input	Human proximity	input	m
system.hw.sensor.distance.input	Distance	inputX, inputY, inputZ	m
system.hw.sensor.acceleration.input	Acceleration	inputX, inputY, inputZ	g
system.hw.sensor.state.input	Current sensor state.	ready, not_available, no_data, initializing, access_denied, error	status
system.hw.sensor.custom	Custom Chart	inputN	nd