IBM Datapower Gateway

Plugin: go.d.plugin Module: snmp

Overview

Monitor IBM Datapower Gateway (network device) 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 ibm-datapower-gateway.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 IBM Datapower Gateway 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 IBM Datapower Gateway 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.

50 metrics in 14 groups; each row is a chart context usable in alerts.

Group	Metrics
Hardware / CPU	2
Hardware / Chassis	1
Hardware / Fan	5
Hardware / Power	1
Hardware / Sensor	1
Network / Connection	5
Network / Interface	10
Network / TCP	11
System / CPU	1
System / FileSystem	6
System / Load	1
System / Log	4
System / Memory	1
System / Uptime	1

Hardware / CPU

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ibm_dpStatusEnvironmentalSensorscpu1Temp	Cel	device	CPU 1 temperature sensor reading
snmp.device_prof_ibm_dpStatusEnvironmentalSensorscpu2Temp	Cel	device	CPU 2 temperature sensor reading

Hardware / Chassis

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ibm_dpStatusEnvironmentalSensorsCaseOpen	{status}	device	Indicates whether the sensor case is open

Hardware / Fan

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ibm_dpStatusEnvironmentalSensorschassis1rpm	{revolution}/min	device	Chassis 1 fan speed in revolutions per minute
snmp.device_prof_ibm_dpStatusEnvironmentalSensorschassis2rpm	{revolution}/min	device	Chassis 2 fan speed in revolutions per minute
snmp.device_prof_ibm_dpStatusEnvironmentalSensorschassis3rpm	{revolution}/min	device	Chassis 3 fan speed in revolutions per minute
snmp.device_prof_ibm_dpStatusEnvironmentalSensorscpu1rpm	{revolution}/min	device	CPU 1 fan speed in revolutions per minute
snmp.device_prof_ibm_dpStatusEnvironmentalSensorscpu2rpm	{revolution}/min	device	CPU 2 fan speed in revolutions per minute

Hardware / Power

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ibm_dpStatusEnvironmentalSensorsPowerSupply	{status}	device	The status of the components and systems that provide the necessary electrical power to the environmental sensors and the overall …

Hardware / Sensor

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ibm_dpStatusEnvironmentalSensorssystemTemp	Cel	device	System temperature sensor reading

Network / Connection

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ibm_dpStatusConnectionsAcceptedoneDay	{connection}	device	Number of connections accepted in last one day
snmp.device_prof_ibm_dpStatusConnectionsAcceptedoneHour	{connection}	device	Number of connections accepted in last one hour
snmp.device_prof_ibm_dpStatusConnectionsAcceptedoneMinute	{connection}	device	Number of connections accepted in last one minute
snmp.device_prof_ibm_dpStatusConnectionsAcceptedtenMinutes	{connection}	device	Number of connections accepted in last ten minutes
snmp.device_prof_ibm_dpStatusConnectionsAcceptedtenSeconds	{connection}	device	Number of connections accepted in last ten seconds

Network / Interface

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ibm_dpStatusNetworkInterfaceStatusAdminStatus	{status}	per ibm_dp_status_network_interface_status_interface_type, ibm_dp_status_network_interface_status_name, ibm_dp_status_network_interface_status_ip_type	The configured administrative state of the interface
snmp.device_prof_ibm_dpStatusNetworkInterfaceStatusOperStatus	{status}	per ibm_dp_status_network_interface_status_interface_type, ibm_dp_status_network_interface_status_name, ibm_dp_status_network_interface_status_ip_type	The current operational state of the interface
snmp.device_prof_ibm_dpStatusNetworkInterfaceStatusRxDrops2	{packet}/s	per ibm_dp_status_network_interface_status_interface_type, ibm_dp_status_network_interface_status_name, ibm_dp_status_network_interface_status_ip_type	Number of received packets dropped
snmp.device_prof_ibm_dpStatusNetworkInterfaceStatusRxErrors2	{error}/s	per ibm_dp_status_network_interface_status_interface_type, ibm_dp_status_network_interface_status_name, ibm_dp_status_network_interface_status_ip_type	Number of receive errors
snmp.device_prof_ibm_dpStatusNetworkInterfaceStatusRxHCBytes	bit/s	per ibm_dp_status_network_interface_status_interface_type, ibm_dp_status_network_interface_status_name, ibm_dp_status_network_interface_status_ip_type	Number of received high capacity bytes
snmp.device_prof_ibm_dpStatusNetworkInterfaceStatusRxHCPackets	{packet}/s	per ibm_dp_status_network_interface_status_interface_type, ibm_dp_status_network_interface_status_name, ibm_dp_status_network_interface_status_ip_type	Number of received high capacity packets
snmp.device_prof_ibm_dpStatusNetworkInterfaceStatusTxDrops2	{packet}/s	per ibm_dp_status_network_interface_status_interface_type, ibm_dp_status_network_interface_status_name, ibm_dp_status_network_interface_status_ip_type	Number of transmitted packets dropped
snmp.device_prof_ibm_dpStatusNetworkInterfaceStatusTxErrors2	{error}/s	per ibm_dp_status_network_interface_status_interface_type, ibm_dp_status_network_interface_status_name, ibm_dp_status_network_interface_status_ip_type	Number of transmit errors
snmp.device_prof_ibm_dpStatusNetworkInterfaceStatusTxHCBytes	bit/s	per ibm_dp_status_network_interface_status_interface_type, ibm_dp_status_network_interface_status_name, ibm_dp_status_network_interface_status_ip_type	Number of transmitted high capacity bytes
snmp.device_prof_ibm_dpStatusNetworkInterfaceStatusTxHCPackets	{packet}/s	per ibm_dp_status_network_interface_status_interface_type, ibm_dp_status_network_interface_status_name, ibm_dp_status_network_interface_status_ip_type	Number of transmitted high capacity packets

Network / TCP

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ibm_dpStatusTCPSummaryclosed	{connection}	device	Number of TCP connections in closed state
snmp.device_prof_ibm_dpStatusTCPSummaryclosewait	{connection}	device	Number of TCP connections in close wait state
snmp.device_prof_ibm_dpStatusTCPSummaryclosing	{connection}	device	Number of TCP connections in closing state
snmp.device_prof_ibm_dpStatusTCPSummaryestablished	{connection}	device	Number of established TCP connections
snmp.device_prof_ibm_dpStatusTCPSummaryfinwait1	{connection}	device	Number of TCP connections in FIN wait 1 state
snmp.device_prof_ibm_dpStatusTCPSummaryfinwait2	{connection}	device	Number of TCP connections in FIN wait 2 state
snmp.device_prof_ibm_dpStatusTCPSummarylastack	{connection}	device	Number of TCP connections in last ACK state
snmp.device_prof_ibm_dpStatusTCPSummarylisten	{connection}	device	Number of TCP connections in listen state
snmp.device_prof_ibm_dpStatusTCPSummarysynreceived	{connection}	device	Number of TCP connections in SYN received state
snmp.device_prof_ibm_dpStatusTCPSummarysynsent	{connection}	device	Number of TCP connections in SYN sent state
snmp.device_prof_ibm_dpStatusTCPSummarytimewait	{connection}	device	Number of TCP connections in TIME wait state

System / CPU

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_cpu_usage	%	device	The current CPU utilization

System / FileSystem

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ibm_dpStatusFilesystemStatusFreeEncrypted	By	device	Free encrypted filesystem space
snmp.device_prof_ibm_dpStatusFilesystemStatusFreeInternal	By	device	Free internal filesystem space
snmp.device_prof_ibm_dpStatusFilesystemStatusFreeTemporary	By	device	Free temporary filesystem space
snmp.device_prof_ibm_dpStatusFilesystemStatusTotalEncrypted	By	device	Total encrypted filesystem space
snmp.device_prof_ibm_dpStatusFilesystemStatusTotalInternal	By	device	Total internal filesystem space
snmp.device_prof_ibm_dpStatusFilesystemStatusTotalTemporary	By	device	Total temporary filesystem space

System / Load

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ibm_dpStatusSystemUsageLoad	{load}	device	System load average

System / Log

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_ibm_dpStatusLogTargetStatusEventsDropped	{event}/s	per ibm_dp_status_log_target_status_log_target	Number of log target events dropped
snmp.device_prof_ibm_dpStatusLogTargetStatusEventsPending	{event}/s	per ibm_dp_status_log_target_status_log_target	Number of log target events pending
snmp.device_prof_ibm_dpStatusLogTargetStatusEventsProcessed	{event}/s	per ibm_dp_status_log_target_status_log_target	Number of log target events processed
snmp.device_prof_ibm_dpStatusLogTargetStatusStatus	{status}	per ibm_dp_status_log_target_status_log_target	The status of the log target

System / Memory

Metric (chart context)	Unit	Scope	Description
snmp.device_prof_memory_usage	%	device	Memory usage percentage

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.