SNMP Polling
Introduction
The SNMP Polling 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 Polling O11ySource supports SNMP versions v1, v2c, and v3.
Data Collection Method
vuSmartMaps collects SNMP metrics through a data collector deployed within the vuSmartMaps platform, which uses SNMP to retrieve performance and health metrics.
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 polling, making it easier to manage devices with common characteristics or within the same network segment.
- No. Of Retries: Number of times the system should reattempt polling if the initial attempt fails. Default: 7 retries.
- Timeout Duration: Specify how long the system should wait for a response from a device before considering the attempt unsuccessful. Default: 5 seconds.
- Devices: Add one or more devices to poll via SNMP.
- 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 the dropdown list.
- MIB Groups: Select MIB groups and polling intervals for metric collection.
- MIB Group: Select the MIB Group to poll. Default: ALL_SUPPORTED_MIB_GROUPS.
- Interval: Specify the polling interval in seconds. Default: 360 seconds.
nan
Firewall Requirement
To collect data from this O11ySource, ensure the following ports are opened:
| Source IP | Destination IP | Destination Port | Protocol | Direction |
|---|---|---|---|---|
| vuSmartMaps Collection/Ingress node IP | IP address of the target device | 443* | UDP | Outbound |
*Before providing the firewall requirements, please update the port based on the customer environment.
Configuring the Target
Configure SNMP on the target devices and allow SNMP access from the vuSmartMaps Collection/Ingress node.
Configuration Steps
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) |
| Host | IP Address for this Cisco Switch | IPv4 |
| target | IP Address for this Cisco Switch | String |
| DeviceIP | Device IP for this Cisco Switch | IPv4 |
| data_type | Data Type | LowCardinality(String) |
| type | Type | LowCardinality(String) |
| Vendor Name | Vendor Name | LowCardinality(String) |
| Device Type | Device Type. In this case, Firewall | LowCardinality(String) |
| Period | Period | Int32 |
| System Name | System Name | String |
| Index | Index | String |
| CPU Utilization | CPU Utilization | Float64 |
| CPU Name | CPU Name | LowCardinality(String) |
| Memory Utilization | Memory Utilization | Float64 |
| Description | System Description | String |
| Contact | System Contact | String |
| Location | System Location | String |
| Uptime | System Uptime | UInt64 |
| Uptime in seconds | System Uptime in Seconds | Float64 |
| Name | Interface Name | String |
| Temperature Value | Temperature Value | Int32 |
| Temperature Threshold | Temperature Threshold | Int32 |
| Temperature Percetnage | Temperature Percetnage | Float64 |
| Temperature Name | Temperature Name | String |
| FRU Power Operstatus | FRU Power Operstatus | Int32 |
| FRU Power Adminstatus | FRU Power Adminstatus | Int32 |
| FRU Power Operstatus Description | FRU Power Operstatus Description | String |
| FRU Power Adminstatus Description | FRU Power Adminstatus Description | String |
| Interface Input Abort | Interface Input Abort | UInt64 |
| Interface Input Abort Diff | Interface Input Abort Diff | UInt64 |
| Input Collisions | Input Collisions | UInt64 |
| Input Collisions Diff | Input Collisions Diff | UInt64 |
| Input CRC | Input CRC | UInt64 |
| Input CRC Diff | Input CRC Diff | UInt64 |
| Input Misaligned | Input Misaligned | UInt64 |
| Input Misaligned Diff | Input Misaligned Diff | UInt64 |
| Input Overrun | Input Overrun | UInt64 |
| Input Overrun Diff | Input Overrun Diff | UInt64 |
| Input Queue Drop | Input Queue Drop | UInt64 |
| Input Queue Drop Diff | Input Queue Drop Diff | UInt64 |
| Output Queue Drop | Output Queue Drop | UInt64 |
| Output Queue Drop Diff | Output Queue Drop Diff | UInt64 |
| BGP Local IP Address | BGP Local IP Address | String |
| BGP Peer Admin Status | BGP Peer Admin Status | Int32 |
| BGP Peer Connection State | BGP Peer Connection State | String |
| BGP Peer Remote Address | BGP Peer Remote Address | String |
| BGP Peer Up Since | BGP Peer Up Since | Int64 |
| BGP State | BGP State | LowCardinality(String) |
| BGP Peer Admin State | BGP Peer Admin State | LowCardinality(String) |
| BGP Peer Link State | BGP Peer Link State | LowCardinality(String) |
| BGP Peer Up Since Date | BGP Peer Up Since Date | String |
| upsince | upsince | DateTime64 |
| OSPF Neighbour State | OSPF Neighbour State | String |
| OSPF Neighbour Address | OSPF Neighbour Address | String |
| Is FRU | Is FRU | Int16 |
| Sensor Name | Sensor Name | String |
| Sensor Type | Sensor Type | Int32 |
| FRU Sensor State | FRU Sensor State | String |
| vublock Name | vublock Name | String |
| Topic Of | Topic Of | String |
| is_mem_type | Memory type | Int8 |
| is_cpu_type | CPU Type | Int8 |
| sensor_value | Sensor Value | Int64 |
| sensor_threshold | Sensor Threshold | Int64 |
| is_temp_type | Is Temperature Type | Int8 |
| ip_address | The IP address of the device or network interface. | IPv4 |
| if_admin_status | Administrative status of the network interface (e.g., up/down). | LowCardinality(String) |
| interface_status | Current operational status of the network interface. | LowCardinality(String) |
| if_description | Text description or label for the network interface. | String |
| if_alias | Alias or alternative name for the network interface. | String |
| if_phy_address | Physical (MAC) address of the network interface. | String |
| if_index | Unique index identifying the network interface. | UInt64 |
| in_dropped | Number of incoming packets dropped by the interface. | UInt64 |
| in_errors | Number of incoming errors encountered by the interface. | UInt64 |
| in_octet_32 | 32-bit counter for incoming bytes on the interface. | UInt64 |
| in_octets | Total number of incoming bytes on the interface. | UInt64 |
| out_dropped | Number of outgoing packets dropped by the interface. | UInt64 |
| out_errors | Number of outgoing errors encountered by the interface. | UInt64 |
| out_octet_32 | 32-bit counter for outgoing bytes on the interface. | UInt32 |
| out_octets | Total number of outgoing bytes on the interface. | UInt64 |
| speed | Speed of the network interface in bits per second. | UInt64 |
| index | Index value used for tracking the data record. | String |
| in_diff_octets | Difference in incoming bytes between intervals | UInt64 |
| in_diff_errors | Difference in incoming errors between intervals. | UInt64 |
| in_diff_dropped | Difference in incoming dropped packets between intervals. | UInt64 |
| out_diff_octets | Difference in outgoing bytes between intervals. | UInt64 |
| out_diff_errors | Difference in outgoing errors between intervals. | UInt64 |
| out_diff_dropped | Difference in outgoing dropped packets between intervals. | UInt64 |
| rx_rate_in_Bps | Incoming data rate in bytes per second. | Float64 |
| rx_rate | Incoming data rate in bits per second. | Float64 |
| tx_rate_in_Bps | Outgoing data rate in bytes per second. | Float64 |
| tx_rate | Outgoing data rate in bits per second. | Float64 |
| in_bandwidth_p | Percentage of inbound bandwidth utilization. | Float64 |
| out_bandwidth_p | Percentage of outbound bandwidth utilization. | Float64 |
| ISP | Internet Service Provider associated with the device or link. | String |
| LinkType | Type of network link (e.g., Ethernet, Fiber). | String |
| LinkUsage | Current usage status of the network link. | String |
| Bandwidth | Total available bandwidth of the link. | String |
