Datto RMM

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

Actions59

Activity Log → Search

AI-generated

Overview

This node operation allows users to search device activity logs within the Datto RMM platform. It is useful for retrieving specific device events and alerts based on a text query and various filtering options such as date range, case sensitivity, and activity types. This operation is beneficial for IT administrators and support teams who need to monitor device activities, investigate incidents, or audit user and device events.

Use Case Examples

  1. Search for all device activities containing the keyword 'error' within the last week.
  2. Retrieve user login and logout events for a specific device within a given date range.
  3. Filter device alerts by severity and sort results by activity time.

Properties

Name Meaning
Return All Whether to return all device activities or only up to a given limit.
Limit Maximum number of device activities to return when 'Return All' is false.
Search Query Text to search for in device events and alerts, including alert messages and device names.
Search Options Additional filters for the search such as date range, case sensitivity, and activity types to limit the search scope.
Select Columns Specific columns to include in the response, allowing users to customize the data returned. Leaving empty returns all columns.
Options Additional options for sorting and including detailed information in the response.

Output

JSON

  • activityTime - Timestamp of the activity event.
  • activityType - Type of activity event, e.g., device status, user login.
  • userName - Name of the user involved in the activity.
  • deviceName - Name of the device involved in the activity.
  • siteName - Name of the site associated with the activity.
  • severity - Severity level of the activity or alert.
  • userDetails - Detailed information about the user, included if requested.
  • deviceDetails - Detailed information about the device, included if requested.
  • siteDetails - Detailed information about the site, included if requested.

Dependencies

  • Datto RMM API with appropriate API key credentials

Troubleshooting

  • Ensure the API credentials are correctly configured and have sufficient permissions to access activity logs.
  • Verify that the search query and filters are correctly formatted and valid.
  • If no results are returned, check the date range and activity type filters to ensure they match existing data.
  • Common error messages may include authentication failures, invalid parameters, or rate limiting by the API. Resolving these involves checking credentials, input parameters, and API usage limits.

Links

Discussion