LibreNMS icon

LibreNMS

Interact with LibreNMS network monitoring system

Overview

The node interacts with the LibreNMS network monitoring system, specifically managing port groups. The "Remove Ports" operation under the "Port Groups" resource allows users to remove one or more ports from a specified port group by providing the port group ID and a list of port IDs to be removed.

This operation is useful in scenarios where network administrators need to update port group memberships dynamically, for example, when decommissioning ports, reorganizing network topology, or correcting configuration errors.

Practical examples:

  • Removing inactive or faulty ports from a port group to prevent monitoring or management actions on them.
  • Adjusting port group membership after physical changes in network hardware.

Properties

Name Meaning
Port Group ID The unique identifier of the port group from which ports will be removed.
Port IDs A comma-separated list of port IDs that should be removed from the specified port group.

Output

The node outputs JSON data representing the result of the removal operation. This typically includes confirmation of the ports removed or an updated state of the port group. The exact structure depends on the LibreNMS API response but generally confirms success or failure of the operation.

No binary data output is involved in this operation.

Dependencies

  • Requires connection to a LibreNMS instance with appropriate API access.
  • An API key credential must be configured in n8n to authenticate requests to LibreNMS.
  • The base URL of the LibreNMS API and SSL certificate validation settings are configurable via credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing Port Group ID or Port IDs can cause the operation to fail.
    • Network connectivity problems or incorrect API credentials will prevent successful communication with LibreNMS.
    • Providing port IDs that do not exist or are not part of the port group may result in partial failures or errors.
  • Error messages:

    • Authentication errors indicate invalid or missing API credentials; verify and update the API key.
    • Validation errors about port group or port IDs suggest checking the correctness and existence of these identifiers.
    • Network errors may require checking firewall rules, LibreNMS server availability, and correct API endpoint configuration.

Links and References

Discussion