Actions83
- Bills Actions
- Alerts Actions
- Alert Rules Actions
- ARP Actions
- Devices Actions
- Device Groups Actions
- Inventory Actions
- Locations Actions
- Logs Actions
- Poller Groups Actions
- Ports Actions
- Port Groups Actions
- Routing Actions
- Services Actions
- Switching Actions
Overview
The node integrates with the LibreNMS network monitoring system, specifically providing access to switching-related data such as VLANs, links, and forwarding database (FDB) entries. The "Get FDB Details" operation retrieves detailed information about a specific MAC address entry in the FDB, which is useful for network administrators who want to trace where a device is connected within the network.
Common scenarios include:
- Identifying the switch port and VLAN associated with a particular device's MAC address.
- Troubleshooting network connectivity or security issues by verifying device locations.
- Auditing network topology and device connections.
Example: Given a MAC address, the node fetches details like the switch port, VLAN, and other metadata related to that MAC in the network.
Properties
| Name | Meaning |
|---|---|
| MAC Address | The MAC address to filter by when retrieving FDB details. Example format: 00:11:22:33:44:55 |
Output
The node outputs JSON data containing detailed information about the specified MAC address in the forwarding database. This typically includes fields such as:
- Switch port identifier where the MAC was seen.
- VLAN ID associated with the MAC.
- Device or interface details.
- Timestamp or age of the FDB entry.
- Additional metadata relevant to the network topology.
No binary data output is expected from this operation.
Dependencies
- Requires an active connection to a LibreNMS instance via its API.
- Needs an API authentication token configured in n8n credentials to authorize requests.
- The base URL of the LibreNMS API must be set correctly in the node credentials.
- SSL certificate validation can be optionally disabled if using self-signed certificates.
Troubleshooting
- Invalid MAC address format: Ensure the MAC address is provided in a standard format (e.g.,
00:11:22:33:44:55). Incorrect formats may cause errors or empty results. - Authentication errors: Verify that the API key/token is valid and has sufficient permissions.
- Connection issues: Check the LibreNMS API URL and network connectivity.
- Empty or no results: The MAC address might not exist in the current FDB; verify the device is active and the MAC is correct.
- SSL errors: If using self-signed certificates, enable the option to skip SSL certificate validation in credentials.