LibreNMS icon

LibreNMS

Interact with LibreNMS network monitoring system

Overview

This node integrates with the LibreNMS network monitoring system, allowing users to manage various network-related resources programmatically. Specifically, the Services - Delete operation enables users to delete a monitored service by its unique service ID. This is useful for cleaning up obsolete or decommissioned services from the monitoring system to keep data accurate and relevant.

Practical examples include:

  • Automatically removing services that are no longer active or have been retired.
  • Integrating with automation workflows that sync service inventories and remove entries in LibreNMS accordingly.

Properties

Name Meaning
Service ID The unique identifier of the service to delete

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will include confirmation of deletion or any error messages returned by the LibreNMS API. There is no binary output associated with 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:
    • Invalid or missing Service ID will cause the API call to fail.
    • Authentication errors if the API key or URL is incorrect.
    • Network connectivity issues to the LibreNMS server.
  • Error messages:
    • "Service not found" indicates the provided Service ID does not exist.
    • "Unauthorized" or "Forbidden" suggests invalid API credentials.
    • Timeout or connection errors indicate network problems or incorrect URL.

To resolve these:

  • Verify the Service ID exists in LibreNMS.
  • Check API credentials and URL configuration.
  • Ensure network access to the LibreNMS server.

Links and References

Discussion