Druva MSP icon

Druva MSP

Interact with the Druva MSP API
Join our community

Actions39

Overview

The "Get Global Usage Summary" operation of the "Report - Usage" resource in this node retrieves aggregated usage data from the Druva MSP API. This summary provides insights into overall consumption or activity metrics over a specified time period, which can be filtered by date ranges.

This operation is beneficial for MSP administrators and analysts who want to monitor global usage trends, track billing periods, or analyze service consumption patterns. For example, it can be used to generate monthly reports on total storage used, number of backups performed, or other key usage indicators across all customers or tenants managed by the MSP.

Practical examples include:

  • Generating a report of total data backed up during the last quarter.
  • Comparing usage between the current month and previous months.
  • Auditing historical usage without date filtering to understand long-term trends.

Properties

Name Meaning
Date Selection Method Choose how to filter the usage data by date:
• All Dates — no date filtering, includes all available data.
• Specific Dates — specify exact start and end dates.
• Relative Date Range — select from predefined relative periods.
Start Date (Optional) The start date for the usage report period when using "Specific Dates". Defaults to 30 days ago if not specified.
End Date (Optional) The end date for the usage report period when using "Specific Dates". Defaults to the current date if not specified.
Date Range (Required if using "Relative Date Range") Select a predefined relative date range for the billing period analysis. Options include:
• Current Month
• Previous Month
• Current Quarter
• Previous Quarter
• Current Year
• Previous Year
• Last 30 Days
• Last 60 Days
• Last 90 Days
• Last 6 Months
• Last 12 Months
• Year To Date

Output

The output JSON contains the global usage summary data retrieved from the Druva MSP API. This typically includes aggregated metrics such as total usage counts, consumption volumes, or other summarized statistics relevant to the MSP environment.

The structure generally consists of key-value pairs representing different usage categories and their corresponding values for the selected date range.

If binary data were involved (not indicated here), it would represent downloadable reports or files, but this operation focuses on JSON-formatted summary data.

Dependencies

  • Requires an active connection to the Druva MSP API via an API key credential configured in n8n.
  • The node uses the base URL https://apis.druva.com for API requests.
  • No additional external services are required beyond the Druva MSP API.
  • Proper permissions on the API key are necessary to access usage reporting endpoints.

Troubleshooting

  • Common Issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Selecting "Specific Dates" without providing valid start or end dates may default unexpectedly or cause errors.
    • Using an unsupported combination of resource and operation parameters will throw an error indicating the resource is not implemented.
    • Network connectivity issues can prevent successful API calls.

  • Error Messages:

    • "The resource '...' is not implemented!" — Occurs if an invalid resource name is provided; ensure the resource parameter is set correctly.
    • Authentication errors usually indicate invalid or expired API keys; verify and update credentials.
    • Date validation errors may occur if start date is after end date; ensure correct chronological order.

  • Resolution Tips:

    • Double-check API credentials and permissions.
    • Validate date inputs before execution.
    • Use the "All Dates" option to test if date filters cause issues.
    • Enable detailed logging to capture API response errors.

Links and References

Discussion