Plugin: go.d.plugin Module: snmp
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.
Auto-detected as Eaton Epdu via sysObjectID/sysDescr.
The default configuration for this integration does not impose any limits.
The default configuration for this integration is not expected to impose a significant performance impact on the system.
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.
SNMP must be enabled on the device and reachable from the Netdata Agent acting as the site’s SNMP hub.
Configure the SNMP collector with the device hostname and SNMP credentials. See the SNMP collector reference for all options.
Configure the snmp collector from the Netdata web interface:
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
There are no configuration examples.
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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| Metric (chart context) | Unit | Scope | Description |
|---|---|---|---|
snmp.device_prof_systemUptime | s | device | Time since the system was last rebooted or powered on. |
There are no alerts configured by default for this integration.
Want a personalised demo of Netdata for your use case?