Datto RMM

Interact with Datto RMM API to manage devices, sites, alerts, and monitoring

Overview

The node interacts with the Datto RMM API to retrieve open alerts for a specified device. It is useful in scenarios where users want to monitor active issues or warnings related to their managed devices within Datto RMM. For example, an IT administrator can use this node to automatically fetch all current open alerts on a particular device to trigger notifications, generate reports, or initiate remediation workflows.

Properties

Name Meaning
Device Select the specific device from the list of available devices to retrieve open alerts for.
Retrieve All Whether to automatically retrieve all results using pagination (true) or manually specify page and max results (false).
Page The page number to retrieve when not retrieving all results automatically (used if Retrieve All is false).
Max Results Maximum number of alert results to return per page (used if Retrieve All is false).
Include Muted Alerts Whether to include muted alerts in the returned results (true to include, false to exclude).

Output

The node outputs JSON data containing the list of open alerts for the selected device. Each alert typically includes details such as alert type, device name, priority, and other relevant metadata describing the alert condition. This structured output allows downstream nodes or workflows to process alert information programmatically.

If the node supports binary data output (not indicated here), it would represent any associated files or attachments related to alerts, but this node primarily returns JSON alert data.

Dependencies

  • Requires an API key credential configured in n8n to authenticate requests against the Datto RMM API.
  • The node depends on the Datto RMM service being accessible via the provided API URL.
  • Pagination support relies on the API's ability to return paged results for alerts.

Troubleshooting

  • Common Issues:

    • Incorrect or missing device selection will result in no alerts being returned.
    • Network connectivity problems or invalid API credentials will cause authentication or request failures.
    • If "Retrieve All" is set to false but page or max results are incorrectly configured, partial or empty results may be returned.
  • Error Messages:

    • Errors related to authentication usually indicate invalid or expired API keys; reconfigure credentials accordingly.
    • API rate limits or server errors from Datto RMM may cause request failures; retry after some time or check API usage policies.
    • If the node throws an error about unsupported resources or operations, verify that the Resource is set to "Device" and Operation to "Get Open Alerts".

Links and References

Discussion