Sensors

Sensors documentation

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.

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.

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

Alerts

There are no alerts configured by default for this integration.

The observability platform companies need to succeed

Want a personalised demo of Netdata for your use case?

Contact Sales