Druva MSP icon

Druva MSP

Interact with the Druva MSP API
Join our community

Actions39

Overview

The "Get Backup Activity Report" operation under the "Report - Hybrid Workloads" resource retrieves backup activity data related to hybrid workloads managed by Druva MSP. This report provides insights into backup statuses, workload types, and customer-specific backup activities over specified date ranges.

This node is beneficial for IT administrators and MSPs who want to monitor backup performance, identify failed or successful backups, and analyze backup trends across different customers and workload types. For example, an administrator can generate a report showing all failed backups in the last 30 days for specific customers to proactively address issues.

Properties

Name Meaning
Return All Whether to return all results or limit the output to a specified number of entries.
Limit Maximum number of results to return when "Return All" is false (range: 1-100).
Date Selection Method Choose how to filter the report data by date:
• No Date Filter — include all dates
• Specific Dates — specify exact start and end dates
• Relative Date Range — select from predefined relative periods like current month, last 30 days, etc.
Start Date Start date (inclusive) for filtering report data; used only if "Specific Dates" is selected.
End Date End date (inclusive) for filtering report data; used only if "Specific Dates" is selected.
Date Range Predefined relative date range for filtering report data; used only if "Relative Date Range" is selected. Options include current/previous month, quarter, year, last 30/60/90 days, last 6/12 months, and year to date.
Filter by Customer(s) Whether to filter the report results by specific customers.
Customer IDs List of customer IDs to filter by; shown only if filtering by customers is enabled.
Filter by Workload Types Whether to filter the report by workload types.
Workload Types List of workload types to filter by; shown only if filtering by workload types is enabled. For alert history reports, this filters by alert type.
Filter by Backup Status Whether to filter the report by backup status.
Backup Status List of backup status values to filter by; shown only if filtering by backup status is enabled.

Output

The node outputs JSON data representing the backup activity report entries matching the specified filters. Each entry typically includes details such as:

  • Backup timestamps
  • Workload type
  • Customer information
  • Backup status (e.g., success, failure)
  • Other relevant metadata about the backup activity

If multiple items are returned, they are provided as an array of JSON objects. The node does not output binary data.

Dependencies

  • Requires an active connection to the Druva MSP API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The node uses internal helper functions to paginate through API results and load options dynamically (e.g., customers, workload types, backup statuses).

Troubleshooting

  • Common Issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Specifying invalid date ranges (e.g., start date after end date) may result in empty or error responses.
    • Filtering by customers or workload types without selecting any options might lead to no results.

  • Error Messages:

    • Errors from the API (e.g., rate limits, invalid parameters) will be surfaced with their messages.
    • If the resource or operation is not implemented, the node throws an explicit error indicating so.

  • Resolution Tips:

    • Verify API credentials and permissions.
    • Double-check date filters and ensure logical consistency.
    • When filtering, ensure at least one valid option is selected.
    • Use the "Return All" option carefully to avoid large data loads that could impact performance.

Links and References

Discussion