LibreNMS icon

LibreNMS

Interact with LibreNMS network monitoring system

Overview

This node integrates with the LibreNMS network monitoring system to retrieve VLAN information for a specified network device. It is useful in scenarios where network administrators need to programmatically access VLAN configurations of devices monitored by LibreNMS, such as for auditing, reporting, or automation tasks.

For example, you might use this node to:

  • Fetch all VLANs configured on a particular switch to verify network segmentation.
  • Automate inventory updates by extracting VLAN data from devices.
  • Integrate VLAN information into broader network management workflows.

Properties

Name Meaning
Device The target device identified by its hostname (FQDN) or numeric device ID in LibreNMS.

Output

The node outputs JSON data containing the VLAN details associated with the specified device. This typically includes VLAN IDs, names, statuses, and other relevant VLAN attributes as provided by LibreNMS.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to a LibreNMS instance.
  • Needs an API key credential for authenticating requests to the LibreNMS API.
  • The base URL of the LibreNMS API must be configured in the node credentials.
  • Optionally, SSL certificate validation can be disabled if using self-signed certificates.

Troubleshooting

  • Invalid Device Identifier: If the device hostname or ID is incorrect or does not exist in LibreNMS, the node may return an error or empty results. Verify the device identifier is accurate.
  • Authentication Errors: Ensure the API key credential is valid and has sufficient permissions to access device VLAN data.
  • Connection Issues: Network connectivity problems or incorrect LibreNMS URL configuration can cause request failures.
  • SSL Certificate Problems: If using self-signed certificates, enable the option to skip SSL certificate validation in the credentials.

Links and References

Discussion