ARP / IP Neighbor Topology
ARP / IP Neighbor Topology documentationARP / IP Neighbor Topology
Plugin: go.d.plugin Module: snmp_topology
Overview
Bind IP addresses to MAC addresses across the fabric. Netdata reads the IP neighbor / ARP table (IP-MIB ipNetToMediaTable) and cross-references it with switch FDB data to position endpoints by IP.
Netdata reads the IP-MIB neighbor / ARP tables over SNMP and joins them with FDB data in the topology:snmp view.
This integration is supported on all platforms.
This integration runs as a single instance per Netdata Agent.
Default Behavior
Auto-Detection
Discovered automatically on routers and switches that expose the ARP / IP neighbor table.
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
The snmp_topology collector runs as a single instance: it does not take user-defined jobs, and the
Netdata web interface offers no + to add one.
Adjust its settings in go.d/snmp_topology.conf.
Prerequisites
SNMP devices configured
The devices must already be collected over SNMP (go.d/snmp.conf), and SNMP access must be reachable from the Netdata Agent acting as the site’s SNMP hub.
Configuration
Options
Topology discovery needs no per-device configuration: it walks the devices already configured as SNMP collector jobs. The only settings are the two intervals below, and update_every has a minimum of 10.
| Option | Description | Default | Required |
|---|---|---|---|
| update_every | How often to check for new or stale devices, in seconds. | 60 | no |
| refresh_every | How often to refresh topology data for each device. | 30m | no |
via File
The configuration file name for this integration is go.d/snmp_topology.conf.
The file format is YAML. A single-instance collector takes exactly one job, whose name is fixed:
jobs:
- name: snmp_topology
Any other job name is rejected. Set the collector’s own options alongside name.
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_topology.conf
Examples
There are no configuration examples.
Metrics
Alerts
There are no alerts configured by default for this integration.
The observability platform companies need to succeed
Sign up for freeWant a personalised demo of Netdata for your use case?