SNMP Trap

Introduction

The SNMP Trap Observability solution aims to provide detailed insights and comprehensive visibility into various network infrastructure devices such as routers, switches, firewalls, load balancers, and more, leveraging the Simple Network Management Protocol (SNMP). This solution serves as an SNMP enabler for different vendors and models.

Getting Started

Compatibility

SNMP Trap O11ySource supports SNMP versions v1, v2c and v3.

Data Collection Method

vuSmartMaps collects snmp-trap through a data collector deployed within the vuSmartMaps platform.

Infrastructure Requirement — Node Designation The SNMP Trap receiver pod must be pinned to a dedicated Kubernetes node so that all devices can send to a stable, known IP. This is a one-time setup performed by the infrastructure team.

Run once on the target node: kubectl label node <node-name> snmptrap=True kubectl taint node <node-name> snmptrap=True:NoSchedule

Once labeled, the pod is automatically scheduled to that node and all listeners start on boot. No UI configuration is required.

Prerequisites

Dependent Configuration

To configure this O11ySource, create a 'credential' of type 'snmp' under the 'Definition' tab.

Inputs for Configuring Data Source

• Group Name: This field is for grouping devices for SNMP Trap, making it easier to manage devices with common characteristics or within the same network segment.
• Devices: Group
• Device IP: Enter the IP address of the device.
• SNMP Credential: Select the SNMP credential from the dropdown list that corresponds to this device.
• Vendor: Select the vendor of the device from the dropdown list
• Model: Select the model of the device from dropdown list.

Firewall Requirement

To collect data from this O11ySource, ensure the following ports are opened:

Source IP	Destination IP	Destination Port	Protocol	Direction
IP address of the SNMP device	vuSmartMaps IP	162*	UDP	Outbound

*Before providing the firewall requirements, please update the port based on the customer environment.

Configuring the Target

Configure SNMP Trap on target devices and grant SNMP access permissions to vuSmartMaps designated IP address.

Configuration Steps

• **Enable**the SNMP Trap O11ySource.

• Select the Sources tab and press the + button to add a new SNMP device to be monitored.

• Click on Save to create the instance

Metrics Collected

Name	Description	Data Type
@timestamp	Timestamp	String
timestamp	Timestamp	DateTime64
BU ID	Business Unit Id	LowCardinality(String)
Tenant ID	Tenant id	LowCardinality(String)
target	IP Address for the SNMP Device	String
DeviceIP	Device IP	String
type	Type	LowCardinality(String)
Vendor Name	Vendor Name	LowCardinality(String)
Device Type	Device Type	LowCardinality(String)
vutrap_id	Trap Messages ID	String
oid	Object ID (specific varbind)	String
mib	MIB Source	String
version	SNMP Version	LowCardinality(String)
name	Trap Name	String
system_uptime	System Uptime	UInt64
snmp_trap_fields	SNMP Trap additional fields	JSON