LibreNMS icon

LibreNMS

Interact with LibreNMS network monitoring system

Overview

This node integrates with the LibreNMS network monitoring system to retrieve ARP (Address Resolution Protocol) table entries. It allows users to query the ARP table by specifying an IP address, MAC address, or CIDR network range. This is useful for network administrators who want to quickly find device mappings between IP addresses and MAC addresses on their network.

Practical examples include:

  • Looking up the MAC address associated with a specific IP address.
  • Finding all ARP entries within a subnet.
  • Verifying if a particular MAC address is present in the ARP table.

Properties

Name Meaning
Query The search term for the ARP entry. Can be an IP address (e.g., 192.168.1.1), a MAC address (e.g., 00:11:22:33:44:55), or a CIDR network (e.g., 192.168.1.0/24).

Output

The node outputs JSON data representing the ARP entries that match the query. Each entry typically includes details such as IP address, MAC address, interface information, and possibly other metadata related to the ARP record.

If binary data were involved (e.g., device images or logs), it would be summarized here, but this node focuses on JSON output of ARP table entries only.

Dependencies

  • Requires connection to a LibreNMS instance via its API.
  • Needs an API authentication token configured in the node credentials.
  • The base URL of the LibreNMS API must be provided.
  • Optionally supports skipping SSL certificate validation based on credential settings.

Troubleshooting

  • Common issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Invalid query formats (e.g., malformed IP or MAC addresses) may result in no results or errors.
    • Network connectivity problems to the LibreNMS server can cause request timeouts or failures.
  • Error messages:

    • Authentication errors usually indicate invalid or expired API tokens; verify and update credentials.
    • "No ARP entries found" means the query did not match any records; check the query format and values.
    • SSL errors might occur if the LibreNMS server uses self-signed certificates and the option to skip SSL validation is not enabled.

Links and References

Discussion