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 hardware audit information for a specified device. It allows users to fetch detailed or summarized hardware audit data, filtered by categories such as processor, memory, storage, network, or graphics components. This node is useful in scenarios where IT administrators or managed service providers want to monitor and analyze the hardware configuration and changes of devices managed within Datto RMM.

Practical examples include:

Retrieving all hardware audit records for a device to track hardware changes over time.
Filtering audits to only show CPU or memory details for performance troubleshooting.
Including archived audit data within a specific date range to investigate historical hardware configurations.

Properties

Name	Meaning
Device	Select the device to retrieve hardware audit information for. The list is dynamically loaded from available devices.
Include Archived	Whether to include archived (historical) audit data in the response.
Start Date	When including archived data, this filters the audit records starting from this ISO 8601 formatted date/time.
End Date	When including archived data, this filters the audit records up to this ISO 8601 formatted date/time.
Hardware Category	Filter hardware audit results by category. Options: All, Processor, Memory, Storage, Network, Graphics.
Retrieve All	Whether to automatically retrieve all audit records using pagination. If false, manual paging is used.
Page	When not retrieving all, specifies the page number (1-based) of results to return.
Max Results	Maximum number of results to return per page when not retrieving all.
Include Details	Whether to include detailed audit information, which may increase the size of the response.
Fields to Include	Select which fields to include in the response. Supports adding or defining specific fields to tailor the output data.

Output

The node outputs JSON data containing the hardware audit records for the selected device. The structure includes:

Audit entries representing hardware components or categories.
Each entry may contain detailed information depending on the "Include Details" property.
Pagination metadata if applicable.
If archived data is included, entries are filtered by the specified date range.

No binary data output is produced by this operation.

Dependencies

Requires an active connection to the Datto RMM API via an API key credential configured in n8n.
The node depends on the Datto RMM API endpoints for devices and audit data.
Proper permissions on the API key to access device audit information are necessary.

Troubleshooting

Common Issues:
- Invalid or missing device selection will cause the node to fail to retrieve audit data.
- Insufficient API permissions can result in authorization errors.
- Requesting archived data without specifying valid date ranges may return empty results.
- Large datasets may cause timeouts if "Retrieve All" is enabled and the API rate limits are reached.
Error Messages:
- Errors related to resource support indicate misconfiguration of the resource or operation parameters.
- API errors typically include HTTP status codes; 401/403 suggest authentication issues, while 404 may indicate the device UID does not exist.
Resolutions:
- Verify device selection and ensure the device exists in Datto RMM.
- Confirm API credentials have appropriate scopes.
- Use date filters carefully when including archived data.
- Consider disabling "Retrieve All" and using pagination for large result sets.