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 allowing users to retrieve information about device ports by their MAC address. This operation is useful in scenarios where you need to identify or gather details about a network port based on its hardware MAC address, such as troubleshooting network connectivity issues, auditing devices connected to the network, or automating inventory management.
For example, a network administrator can input a MAC address to quickly find which port on a switch corresponds to that device, enabling faster diagnostics and network mapping.
Properties
| Name | Meaning |
|---|---|
| MAC Address | The MAC address of the device/port to search for (e.g., "00:11:22:33:44:55"). |
| MAC Search Options | Options to filter the search results: |
| - All Results: Return all matching ports. | |
| - First Result Only: Return only the first matching port found. |
Output
The node outputs JSON data representing the port(s) associated with the specified MAC address. The structure typically includes details about the port such as its identifier, status, device association, and other metadata provided by LibreNMS.
If multiple results are returned (when "All Results" is selected), the output will be an array of port objects. If "First Result Only" is selected, the output will be a single port object.
No binary data output is indicated for this operation.
Dependencies
- Requires connection to a LibreNMS instance via its API.
- An API key credential must be configured in n8n to authenticate requests.
- The base URL of the LibreNMS API and SSL certificate validation settings must be set in the node credentials.
Troubleshooting
Common Issues:
- Invalid or missing MAC address input will cause the request to fail or return no results.
- Incorrect API credentials or URL configuration will result in authentication errors.
- Network connectivity issues between n8n and LibreNMS server may cause timeouts or connection failures.
Error Messages:
- Authentication errors usually indicate invalid API keys or misconfigured credentials.
- "No results found" indicates that the MAC address does not match any known ports.
- SSL certificate errors may occur if the LibreNMS server uses self-signed certificates and the node is not configured to allow unauthorized certs.
Links and References
This summary is based on static analysis of the node's bundled source code and provided property definitions.