Druva MSP icon

Druva MSP

Interact with the Druva MSP API
Join our community

Actions39

Overview

The "Get Alerts Report" operation of the "Report - Endpoint" resource in this node fetches alert reports from the Druva MSP API. It allows users to retrieve detailed alert data filtered by various criteria such as date ranges, customers, alert types, severity levels, and active status. This operation is useful for monitoring endpoint security and operational alerts within an organization’s managed service environment.

Typical use cases include:

  • Generating reports on endpoint alerts over a specific period to analyze security incidents or system issues.
  • Filtering alerts by customer accounts to focus on particular clients.
  • Narrowing down alerts by type or severity to prioritize response efforts.
  • Exporting alert data for compliance audits or operational reviews.

For example, a managed service provider could use this node to pull all critical security alerts for a set of customers during the last quarter to assess risk exposure and plan remediation actions.

Properties

Name Meaning
Date Selection Method Choose how to filter alerts by date:
• All Dates (no date filtering)
• Specific Dates (select start and end dates)
• Relative Date Range (predefined periods like current month, last 30 days, etc.)
Start Date The start date of the report period (required if using Specific Dates).
End Date The end date of the report period (required if using Specific Dates).
Date Range Select a predefined relative date range for the report when using Relative Date Range method. Options include Current Month, Previous Month, Current Quarter, Last 30 Days, Year To Date, etc.
Filter by Customers Boolean flag to enable filtering results by specific customer IDs.
Customer IDs List of customer IDs to include in the report (required if filtering by customers).
Filter by Alert Types Boolean flag to enable filtering results by alert types.
Alert Types List of alert types to filter by. Available options: Backup Failure, Connection Issue, Storage Warning, Security Alert, System Error.
Filter by Alert Severity Boolean flag to enable filtering results by alert severity.
Alert Severity List of alert severity levels to filter by. Options: Critical, High, Medium, Low.
Filter by Active Status Boolean flag to enable filtering results by whether alerts are active or resolved.
Active Status Filter alerts by active status. Options: Active Alerts Only (alerts requiring attention), Resolved Alerts Only (resolved or deleted alerts).
Return All Whether to return all matching results or limit the number of results returned.
Limit Maximum number of results to return if not returning all. Minimum value is 1.

Output

The output JSON contains the alert report data retrieved from the Druva MSP API according to the specified filters. Each item in the output array represents an alert record with fields describing the alert details such as alert type, severity, status, timestamps, affected customer, and other relevant metadata.

If binary data were involved (e.g., attachments or logs), it would be included in the binary output field, but this operation focuses on JSON alert data only.

Dependencies

  • Requires an API key credential for authenticating with the Druva MSP API.
  • The node depends on the Druva MSP API being accessible at https://apis.druva.com.
  • Proper permissions must be granted to the API key to access alert reporting endpoints.
  • The node uses internal helper functions to paginate through API results if needed.

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 customer IDs or alert types that do not exist will yield no data.
    • Exceeding API rate limits can cause request failures.

  • Error Messages:

    • Authentication errors typically indicate invalid or expired API keys; verify and update credentials.
    • Validation errors on input parameters suggest checking date formats and required fields.
    • Network or timeout errors may require retrying or checking network connectivity.

Links and References

Discussion