Druva MSP icon

Druva MSP

Interact with the Druva MSP API
Join our community

Actions39

Overview

The "Get Alert History Report" operation within the "Report - Hybrid Workloads" resource fetches historical alert data related to hybrid workloads managed by Druva MSP. This node is useful for administrators and analysts who want to review past alerts, monitor alert trends, or audit alert occurrences over specific time periods. It supports filtering by date ranges, customers, workload types (which correspond to alert types in this context), and alert severity levels.

Practical examples include:

  • Retrieving all critical alerts from the last 30 days for a specific customer.
  • Generating a report of warning and info-level alerts across multiple workload types during the previous quarter.
  • Auditing alert history without any date filter to get a complete overview of all alerts.

Properties

Name Meaning
Return All Whether to return all results or only up to a given limit.
Limit Maximum number of results to return when not returning all. Value range: 1 to 100.
Date Selection Method Choose how to filter by date: no date filter (all dates), specific start and end dates, or a relative date range (e.g., current month, last 30 days).
Start Date Start date for filtering report data (inclusive). Used only if "Specific Dates" is selected as the date selection method.
End Date End date for filtering report data (inclusive). Used only if "Specific Dates" is selected as the date selection method.
Date Range Predefined relative date range for filtering report data, such as current month, previous year, last 90 days, etc. Used only if "Relative Date Range" is selected as the date selection method.
Filter by Customer(s) Whether to filter results by specific customers.
Customer IDs List of customer IDs to filter by. Only shown if filtering by customers is enabled.
Filter by Workload Types Whether to filter by workload types. For this alert history report, workload types correspond to alert types.
Workload Types List of workload/alert types to filter by. Only shown if filtering by workload types is enabled.
Filter by Alert Severity Whether to filter by alert severity levels.
Alert Severity List of alert severity levels to filter by: Critical, Warning, Info. Only shown if filtering by alert severity is enabled.

Output

The node outputs an array of JSON objects representing alert history records matching the specified filters. Each record typically contains details about individual alerts such as alert type, severity, timestamp, affected resources, and possibly customer information.

If binary data were involved (not indicated here), it would represent attachments or exported reports, but this operation focuses on JSON alert data.

Dependencies

  • Requires an active connection to the Druva MSP API with appropriate API authentication credentials configured in n8n.
  • The node relies on the Druva MSP API endpoints for fetching alert history data.
  • No additional external services are required beyond the Druva MSP API.

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 errors or empty results.
    • Filtering by customers or workload types without valid IDs or options may yield no data.
    • Exceeding the maximum allowed limit (over 100) will be rejected.

  • Error Messages:

    • Authentication errors: Verify that the API key or token is correctly set up in n8n credentials.
    • Validation errors on date fields: Ensure start and end dates are valid and logically ordered.
    • API rate limits or connectivity issues: Check network access and API usage quotas.

Links and References

Discussion