LibreNMS icon

LibreNMS

Interact with LibreNMS network monitoring system

Overview

The node integrates with the LibreNMS network monitoring system, allowing users to manage various resources within LibreNMS. Specifically, for the Locations - Delete operation, it enables the deletion of a specified location by its name or ID. This is useful in scenarios where network locations are decommissioned or need to be cleaned up from the monitoring system.

Practical examples include:

  • Removing outdated or incorrect location entries from LibreNMS.
  • Automating cleanup tasks in network management workflows.
  • Integrating with other systems to synchronize location data by deleting locations no longer present elsewhere.

Properties

Name Meaning
Location The name or ID of the location to delete. This identifies which location entry in LibreNMS should be removed.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will include confirmation of successful deletion or details about any error encountered. The exact structure depends on the LibreNMS API response but generally includes status information.

No binary data output is expected for this operation.

Dependencies

  • Requires an API key credential to authenticate with the LibreNMS API.
  • Needs the base URL of the LibreNMS instance configured in credentials.
  • The node uses the LibreNMS REST API v0 endpoints.
  • SSL certificate validation can be optionally skipped based on credential settings.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent location name/ID will cause the delete operation to fail.
    • Network connectivity problems or incorrect API URL configuration can prevent communication with LibreNMS.
    • Insufficient permissions associated with the API key may block deletion.
  • Error messages and resolutions:

    • "Location not found": Verify that the location name or ID is correct and exists in LibreNMS.
    • "Unauthorized" or "Authentication failed": Check that the API key credential is valid and has appropriate permissions.
    • "Network error" or timeout: Confirm the LibreNMS URL is reachable and there are no firewall restrictions.

Links and References

Discussion