Datto RMM

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

Actions53

Overview

The node interacts with the Datto RMM API to retrieve open alerts associated with an account. It allows users to fetch either all open alerts or a paginated subset, optionally including muted alerts. This is useful for monitoring active issues across managed devices and sites, enabling timely responses to critical events.

Practical examples:

  • Automatically fetching all current open alerts to feed into a dashboard or ticketing system.
  • Retrieving a specific page of alerts when dealing with large volumes, to process them in batches.
  • Including muted alerts to audit suppressed notifications or verify alert management policies.

Properties

Name Meaning
Retrieve All Whether to automatically retrieve all open alerts using pagination (true), or manually specify page and max results (false).
Page The page number to retrieve when not retrieving all alerts automatically (1-based index).
Max Results Maximum number of alerts to return per page when manual pagination is used.
Include Muted Alerts Whether to include muted alerts in the results (true to include, false to exclude).
Fields to Include Select which fields of the alert objects to include in the response. Can add all fields or define specific ones.

Output

The node outputs JSON data representing the retrieved open alerts. Each alert object includes various fields describing the alert details such as alert type, device name, priority, and other metadata depending on the selected fields.

If binary data were involved (not indicated here), it would typically represent attachments or files related to alerts, but this node focuses on JSON alert data only.

Dependencies

  • Requires an API key credential for authenticating with the Datto RMM API.
  • Needs the base URL of the Datto RMM API configured in the node credentials.
  • Relies on the Datto RMM API endpoints for fetching alerts (/api/v2/account/alerts/open).

Troubleshooting

  • Common Issues:

    • Authentication failures due to invalid or missing API credentials.
    • Pagination parameters out of range causing empty or partial results.
    • Network connectivity issues preventing API calls.

  • Error Messages:

    • Errors indicating unsupported resource or operation if misconfigured.
    • API errors returned from Datto RMM, e.g., rate limiting or permission denied.

  • Resolutions:

    • Verify API credentials and permissions.
    • Adjust pagination settings to valid ranges.
    • Ensure network access to the Datto RMM API endpoint.

Links and References

Discussion