Druva MSP icon

Druva MSP

Interact with the Druva MSP API

Overview

This node interacts with the Druva MSP API to retrieve various reports and data related to managed service providers. Specifically, for the Report - Endpoint resource with the Get Storage Statistics Report operation, it fetches storage usage statistics over a specified date range and optionally filtered by customer IDs.

Common scenarios where this node is beneficial include:

  • Generating storage usage reports for endpoint devices across multiple customers.
  • Monitoring storage trends over specific periods (e.g., last month, current quarter).
  • Filtering reports to focus on particular customers to analyze their storage consumption.

Practical example:

  • A managed service provider wants to generate a monthly storage usage report for all customers or selected customers to optimize storage allocation and billing.

Properties

Name Meaning
Date Selection Method Choose how to filter the report by date:
• All Dates (no date filter)
• Specific Dates (select start and end dates)
• Relative Date Range (predefined ranges like current month, last 30 days, etc.)
Start Date The start date of the report period (required if "Specific Dates" is chosen).
End Date The end date of the report period (required if "Specific Dates" is chosen).
Date Range Select a predefined relative date range for the report (used if "Relative Date Range" is chosen). Options include: Current Month, Previous Month, Current Quarter, Previous Quarter, Current Year, Previous Year, Last 30/60/90 Days, Last 6/12 Months, Year To Date.
Filter by Customers Boolean flag to indicate whether to filter the report results by specific customer IDs.
Customer IDs List of customer IDs to include in the report (required if filtering by customers). These are selectable from available customers.
Return All Whether to return all results or limit the number of returned items.
Limit Maximum number of results to return if not returning all. Minimum value is 1.

Output

The node outputs JSON data representing the storage statistics report. The structure typically includes fields such as storage usage metrics aggregated over the selected date range and filtered customers. Each item corresponds to a record in the report, containing relevant statistics.

If binary data were involved (not indicated here), it would represent files or attachments related to the report, but this operation focuses on JSON data output only.

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.
  • The node depends on internal helper functions to paginate through API responses and load options dynamically (e.g., customer lists).

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication errors.
    • Selecting specific dates without providing both start and end dates will result in validation errors.
    • Filtering by customers without selecting any customer IDs will cause the request to fail or return empty results.
    • Exceeding API rate limits may cause temporary failures.
  • Error messages:

    • "The resource 'reportEndpoint' is not implemented!" — indicates a misconfiguration or unsupported resource selection.
    • Errors fetching customers or other dropdown options will be logged and shown as error entries in the UI dropdowns.
    • Network or API errors will propagate as node execution errors unless "Continue On Fail" is enabled.
  • Resolutions:

    • Ensure API credentials are correctly set up and have necessary permissions.
    • Provide valid date inputs according to the selected date method.
    • When filtering by customers, select at least one valid customer ID.
    • Use "Return All" carefully to avoid large data loads; use limits to control response size.

Links and References

Discussion