Cyberpower PDU

Plugin: go.d.plugin Module: snmp

Overview

Monitor Cyberpower PDU (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 cyberpower-pdu.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 Cyberpower PDU 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 Cyberpower PDU 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.

43 metrics in 13 groups; each row is a chart context usable in alerts.

Group	Metrics
Environment / Humidity	1
Environment / Temperature	2
Hardware / Power	6
PowerFlow / Bank	2
PowerFlow / Input	2
PowerFlow / Load	2
PowerFlow / Outlet	5
PowerFlow / Phase	1
PowerFlow / Power	3
PowerFlow / Rack	16
PowerFlow / Voltage	1
System / Rack	1
System / Uptime	1

Environment / Humidity

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cyberpower_envirHumidity	%	device	Environment relative humidity expressed in percentage

Environment / Temperature

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cyberpower_envirTemperature	degF	device	Environment temperature
snmp.device_prof_cyberpower_envirTemperatureCelsius	Cel	device	Environment temperature expressed in Celsius

Hardware / Power

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ePDU2DeviceStatusPowerSupply1Status	{status}	per e_pdu2_device_status_index, e_pdu2_device_status_name	Rack PDU Power Supply 1 alarm
snmp.device_prof_ePDU2DeviceStatusPowerSupply2Status	{status}	per e_pdu2_device_status_index, e_pdu2_device_status_name	Rack PDU Power Supply 2 alarm
snmp.device_prof_ePDU2DeviceStatusPowerSupplyAlarm	{status}	per e_pdu2_device_status_index, e_pdu2_device_status_name	Rack PDU Power Supply alarm
snmp.device_prof_ePDUPowerSupply1Status	{status}	device	Power Supply 1 Status
snmp.device_prof_ePDUPowerSupply2Status	{status}	device	Power Supply 2 Status
snmp.device_prof_ePDUPowerSupplyAlarm	{status}	device	Power Supply Alarm

PowerFlow / Bank

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ePDULoadBankConfigAlarm	{status}	per e_pdu_load_bank_config_index	Bank Alarm
snmp.device_prof_ePDUStatusBankState	{status}	per e_pdu_status_bank_index, e_pdu_status_bank_number	Bank load state

PowerFlow / Input

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cyberpower_ePDUStatusInputFrequency	dHz	device	Input frequency
snmp.device_prof_cyberpower_ePDUStatusInputVoltage	dV	device	Input voltage

PowerFlow / Load

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cyberpower_ePDULoadStatusLoad	dA	per e_pdu_load_status_index	Phase/bank load
snmp.device_prof_ePDULoadStatusLoadState	{status}	per e_pdu_load_status_index	Load state

PowerFlow / Outlet

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cyberpower_ePDUOutletStatusActivePower	W	per e_pdu_outlet_status_index, e_pdu_outlet_status_outlet_name	Measured Outlet load for an Outlet Monitored Rack PDU
snmp.device_prof_cyberpower_ePDUOutletStatusLoad	dA	per e_pdu_outlet_status_index, e_pdu_outlet_status_outlet_name	Measured Outlet load for an Outlet Monitored Rack PDU
snmp.device_prof_ePDUOutletStatusAlarm	{status}	per e_pdu_outlet_status_index, e_pdu_outlet_status_outlet_name	Outlet Alarm
snmp.device_prof_ePDUOutletStatusOutletState	{status}	per e_pdu_outlet_status_index, e_pdu_outlet_status_outlet_name	Outlet state
snmp.device_prof_ePDUStatusOutletState	{status}	per e_pdu_status_outlet_index, e_pdu_status_outlet_number	Outlet load state

PowerFlow / Phase

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ePDUStatusPhaseState	{status}	per e_pdu_status_phase_index, e_pdu_status_phase_number	Phase load state

PowerFlow / Power

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cyberpower_ePDULoadStatusActivePower	W	per e_pdu_load_status_index	Phase/bank active power
snmp.device_prof_cyberpower_ePDULoadStatusApparentPower	VA	per e_pdu_load_status_index	Phase/bank apparent power
snmp.device_prof_cyberpower_ePDULoadStatusPowerFactor	%	per e_pdu_load_status_index	Power factor of the output

PowerFlow / Rack

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cyberpower_ePDU2BankStatusLoad	dA	per e_pdu2_bank_status_index	Current draw of the load on the Rack PDU bank
snmp.device_prof_cyberpower_ePDU2BankStatusPeakLoad	dA/s	per e_pdu2_bank_status_index	Peak current of the Rack PDU bank load in tenths of Amps
snmp.device_prof_cyberpower_ePDU2DeviceStatusApparentPower	VA	per e_pdu2_device_status_index, e_pdu2_device_status_name	Apparent power consumption of the Rack PDU load
snmp.device_prof_cyberpower_ePDU2DeviceStatusCurrentLoad	dA	per e_pdu2_device_status_index, e_pdu2_device_status_name	Power consumption of the Rack PDU load
snmp.device_prof_cyberpower_ePDU2DeviceStatusCurrentPeakLoad	dA/s	per e_pdu2_device_status_index, e_pdu2_device_status_name	Peak power consumption of the Rack PDU load
snmp.device_prof_cyberpower_ePDU2DeviceStatusPowerFactor	%	per e_pdu2_device_status_index, e_pdu2_device_status_name	Power factor of the Rack PDU load
snmp.device_prof_cyberpower_ePDU2PhaseStatusApparentPower	VA	per e_pdu2_phase_status_index	Load apparent power consumed on the Rack PDU phase
snmp.device_prof_cyberpower_ePDU2PhaseStatusLoad	dA	per e_pdu2_phase_status_index	Current draw of the load on the Rack PDU phase
snmp.device_prof_cyberpower_ePDU2PhaseStatusPeakLoad	dA/s	per e_pdu2_phase_status_index	Peak current of the Rack PDU phase load in tenths of Amps
snmp.device_prof_cyberpower_ePDU2PhaseStatusPower	kW	per e_pdu2_phase_status_index	Load power consumed on the Rack PDU phase
snmp.device_prof_cyberpower_ePDU2PhaseStatusPowerFactor	%	per e_pdu2_phase_status_index	Load power factor of the Rack PDU phase
snmp.device_prof_cyberpower_ePDU2PhaseStatusVoltage	V	per e_pdu2_phase_status_index	Voltage of the Rack PDU phase
snmp.device_prof_ePDU2BankStatusLoadState	{status}	per e_pdu2_bank_status_index	Load status of the Rack PDU bank
snmp.device_prof_ePDU2DeviceStatusLoadState	{status}	per e_pdu2_device_status_index, e_pdu2_device_status_name	Rack PDU load state
snmp.device_prof_ePDU2OutletSwitchedStatusState	{status}	per e_pdu2_outlet_switched_status_index, e_pdu2_outlet_switched_status_name	Switch state of the Rack PDU switched outlet
snmp.device_prof_ePDU2PhaseStatusLoadState	{status}	per e_pdu2_phase_status_index	Phase load state

PowerFlow / Voltage

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cyberpower_ePDULoadStatusVoltage	dV	per e_pdu_load_status_index	Phase/bank voltage measured

System / Rack

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ePDU2DeviceStatusRoleType	{status}	per e_pdu2_device_status_index, e_pdu2_device_status_name	Rack PDU role on Daisy Chain group

System / Uptime

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

Troubleshooting

Other Problems

Collect Diagnostics for Netdata Support

For SNMP metrics, BGP, licensing, or topology issues, follow Collect SNMP troubleshooting data to include built-in diagnostics in a support bundle. SNMP evidence is unsanitized; share the bundle through a restricted Netdata Support ticket.