Eaton Epdu

Plugin: go.d.plugin Module: snmp

Overview

Monitor Eaton Epdu (pdu) with Netdata over SNMP. Netdata recognizes the device automatically by its sysObjectID (recognized across 1 device identifiers) and collects the metrics this profile declares — on top of the generic SNMP baseline — with no manual OID configuration.

Netdata's SNMP collector matches the device to the eaton-epdu.yaml profile via sysObjectID/sysDescr, then polls the OIDs it declares.

This integration is supported on all platforms.

This integration supports multiple instances configured side-by-side.

Default Behavior

Auto-Detection

Auto-detected as Eaton Epdu via sysObjectID/sysDescr.

Limits

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

Performance Impact

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

Setup

You can configure the snmp collector in two ways:

Method	Best for	How to
UI	Fast setup without editing files	Go to Nodes → Configure this node → Collectors → Jobs, search for snmp, then click + to add a job.
File	If you prefer configuring via file, or need to automate deployments (e.g., with Ansible)	Edit go.d/snmp.conf and add a job.

important

UI configuration requires paid Netdata Cloud plan.

Prerequisites

SNMP access

SNMP must be enabled on the device and reachable from the Netdata Agent acting as the site's SNMP hub.

Configuration

Options

Configure the SNMP collector with the device hostname and SNMP credentials. See the SNMP collector reference for all options.

via UI

Configure the snmp collector from the Netdata web interface:

1. Go to Nodes.
2. Select the node where you want the snmp data-collection job to run and click the ⚙ (Configure this node). That node will run the data collection.
3. The Collectors → Jobs view opens by default.
4. In the Search box, type snmp (or scroll the list) to locate the snmp collector.
5. Click the + next to the snmp collector to add a new job.
6. Fill in the job fields, then click Test to verify the configuration and Submit to save.
   • Test runs the job with the provided settings and shows whether data can be collected.
   • If it fails, an error message appears with details (for example, connection refused, timeout, or command execution errors), so you can adjust and retest.

via File

The configuration file name for this integration is go.d/snmp.conf.

The file format is YAML. Generally, the structure is:

update_every: 1
autodetection_retry: 0
jobs:
  - name: some_name1
  - name: some_name2

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 go.d/snmp.conf

Examples

There are no configuration examples.

Alerts

There are no alerts configured by default for this integration.

Metrics

On top of the generic SNMP baseline (the Generic SNMP Device integration — interfaces, system, IP/TCP/UDP, host resources), this Eaton Epdu profile adds the metrics below. Each is collected only where the device exposes the matching OID — inclusion means the profile requests it; availability depends on the device model and software.

37 metrics in 8 groups; each row is a chart context usable in alerts.

Group	Metrics
Hardware / Breaker	1
Hardware / Group	1
Hardware / PDU	3
Hardware / Sensor	8
PowerFlow / Group	7
PowerFlow / Input	9
PowerFlow / Outlet	7
System / Uptime	1

Hardware / Breaker

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_eaton_epdu_groupBreakerStatus	{status}	per eaton_epdu_group_index, eaton_epdu_group_name, eaton_epdu_group_type	Indicates whether a breaker is turned off or on

Hardware / Group

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_eaton_epdu_groupControlStatus	{status}	per eaton_epdu_group_index, eaton_epdu_group_name, eaton_epdu_group_type	Current state of a controlled group

Hardware / PDU

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_eaton_epdu_communicationStatus	{status}	device	Status of the internal communication with the PDU
snmp.device_prof_eaton_epdu_internalStatus	{status}	device	Status of the internal failure inside the PDU
snmp.device_prof_eaton_epdu_strappingStatus	{status}	device	Status of the external communication with a strapping unit

Hardware / Sensor

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_eaton_epdu_contactProbeStatus	{status}	per eaton_epdu_contact_index, eaton_epdu_contact_name	Indicates whether a probe is connected or not
snmp.device_prof_eaton_epdu_contactState	{status}	per eaton_epdu_contact_index, eaton_epdu_contact_name	The state of the contact sensor
snmp.device_prof_eaton_epdu_humidityProbeStatus	{status}	per eaton_epdu_humidity_index, eaton_epdu_humidity_name	Indicates whether a probe is connected or not
snmp.device_prof_eaton_epdu_humidityThStatus	{status}	per eaton_epdu_humidity_index, eaton_epdu_humidity_name	Status of the measured humidity relative to the configured thresholds
snmp.device_prof_eaton_epdu_humidityValue	%	per eaton_epdu_humidity_index, eaton_epdu_humidity_name	Units are tenths of a percent relative humidity Divide the value by 10 to get %RH
snmp.device_prof_eaton_epdu_temperatureProbeStatus	{status}	per eaton_epdu_temperature_index, eaton_epdu_temperature_name	Indicates whether a probe is connected or not
snmp.device_prof_eaton_epdu_temperatureThStatus	{status}	per eaton_epdu_temperature_index, eaton_epdu_temperature_name	Status of the measured temperature relative to the configured thresholds
snmp.device_prof_eaton_epdu_temperatureValue	Cel	per eaton_epdu_temperature_index, eaton_epdu_temperature_name	Temperature value

PowerFlow / Group

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_eaton_epdu_groupCurrent	mA	per eaton_epdu_group_index, eaton_epdu_group_name, eaton_epdu_group_type	A group current measurement value
snmp.device_prof_eaton_epdu_groupCurrentPercentLoad	%	per eaton_epdu_group_index, eaton_epdu_group_name, eaton_epdu_group_type	Current percent load based on the rated current capacity
snmp.device_prof_eaton_epdu_groupCurrentThStatus	{status}	per eaton_epdu_group_index, eaton_epdu_group_name, eaton_epdu_group_type	Status of the measured group current relative to the configured thresholds
snmp.device_prof_eaton_epdu_groupVA	VA	per eaton_epdu_group_index, eaton_epdu_group_name, eaton_epdu_group_type	A group VA value
snmp.device_prof_eaton_epdu_groupVoltage	mV	per eaton_epdu_group_index, eaton_epdu_group_name, eaton_epdu_group_type	Units are millivolts
snmp.device_prof_eaton_epdu_groupVoltageThStatus	{status}	per eaton_epdu_group_index, eaton_epdu_group_name, eaton_epdu_group_type	Status of the measured group voltage relative to the configured thresholds
snmp.device_prof_eaton_epdu_groupWatts	W	per eaton_epdu_group_index, eaton_epdu_group_name, eaton_epdu_group_type	A group Watts value

PowerFlow / Input

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_eaton_epdu_inputCurrent	mA	per eaton_epdu_input_index, eaton_epdu_input_description	An input current measurement value
snmp.device_prof_eaton_epdu_inputCurrentPercentLoad	%	per eaton_epdu_input_index, eaton_epdu_input_description	Current percent load based on the rated current capacity
snmp.device_prof_eaton_epdu_inputCurrentThStatus	{status}	per eaton_epdu_input_index, eaton_epdu_input_description	Status of the measured input current relative to the configured thresholds
snmp.device_prof_eaton_epdu_inputFrequency	Hz	per eaton_epdu_input_index, eaton_epdu_input_feed_name	Units are 0.1 Hz; divide by ten to get Hz
snmp.device_prof_eaton_epdu_inputFrequencyStatus	{status}	per eaton_epdu_input_index, eaton_epdu_input_feed_name	Status of the measured input frequency relative to the nominal frequency and the admitted tolerance
snmp.device_prof_eaton_epdu_inputVA	VA	per eaton_epdu_input_index, eaton_epdu_input_description	An input VA value
snmp.device_prof_eaton_epdu_inputVoltage	mV	per eaton_epdu_input_index, eaton_epdu_input_description	An input voltage measurement value
snmp.device_prof_eaton_epdu_inputVoltageThStatus	{status}	per eaton_epdu_input_index, eaton_epdu_input_description	Status of the measured input voltage relative to the configured thresholds
snmp.device_prof_eaton_epdu_inputWatts	W	per eaton_epdu_input_index, eaton_epdu_input_description	An input Watts value

PowerFlow / Outlet

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_eaton_epdu_outletCurrent	mA	per eaton_epdu_outlet_index, eaton_epdu_outlet_name	An outlet current measurement value
snmp.device_prof_eaton_epdu_outletCurrentPercentLoad	%	per eaton_epdu_outlet_index, eaton_epdu_outlet_name	Current percent load based on the rated current capacity
snmp.device_prof_eaton_epdu_outletCurrentThStatus	{status}	per eaton_epdu_outlet_index, eaton_epdu_outlet_name	Status of the measured outlet current relative to the configured thresholds
snmp.device_prof_eaton_epdu_outletVA	VA	per eaton_epdu_outlet_index, eaton_epdu_outlet_name	An outlet VA value
snmp.device_prof_eaton_epdu_outletVoltage	mV	per eaton_epdu_outlet_index, eaton_epdu_outlet_name	Units are millivolts
snmp.device_prof_eaton_epdu_outletVoltageThStatus	{status}	per eaton_epdu_outlet_index, eaton_epdu_outlet_name	Status of the measured outlet voltage relative to the configured thresholds
snmp.device_prof_eaton_epdu_outletWatts	W	per eaton_epdu_outlet_index, eaton_epdu_outlet_name	An outlet Watts value

System / Uptime

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_systemUptime	s	device	Time since the system was last rebooted or powered on.