Druva MSP icon

Druva MSP

Interact with the Druva MSP API

Actions79

Event → Get Many Customer Events

AI-generated

Overview

This node operation retrieves multiple events related to a specific customer from the Druva MSP API. It supports filtering events by various criteria such as date ranges (all dates, specific dates, or relative date ranges), event categories, event types, features, severity levels, and initiators. Users can specify whether to return all results or limit the number of results, and can choose to include detailed event information and format timestamps for readability. This operation is useful for monitoring and analyzing customer-related events in managed service provider environments, such as auditing customer activities, tracking alerts, or reviewing event logs for compliance and troubleshooting.

Use Case Examples

  1. Retrieve all events for a customer within the last month to audit recent activities.
  2. Fetch up to 50 events filtered by specific categories and event types for a customer to analyze security alerts.
  3. Get detailed event logs for a customer filtered by severity and initiator to investigate a specific incident.

Properties

Name Meaning
Customer ID The unique identifier of the customer whose events to retrieve.
Return All Whether to return all results or only up to a given limit.
Limit Maximum number of results to return when 'Return All' is false.
Date Selection Method Choose whether to use specific dates, relative date ranges, or include all dates (no date filter).
Start Date Start date for filtering events (inclusive), used when 'Specific Dates' is selected.
End Date End date for filtering events (inclusive), used when 'Specific Dates' is selected.
Date Range Select a predefined relative date range for filtering events, used when 'Relative Date Range' is selected.
Filter by Category Whether to filter events by category.
Category The categories of events to return, applicable if filtering by category is enabled.
Filter by Event Type Whether to filter events by specific event types.
Event Type The specific types of events to return, applicable if filtering by event type is enabled.
Filter by Feature Whether to filter events by feature.
Feature The features or components the events are related to, applicable if filtering by feature is enabled.
Filter by Severity Whether to filter events by severity level.
Severity The severity levels of events to return, applicable if filtering by severity is enabled.
Filter by Initiator Whether to filter events by who initiated them.
Initiated By Filter events by who initiated them - applies to AUDIT category events. Searches in the initiatorName and initiatorId fields in event details.
Options Additional options for the operation.
Wrap Output Items When enabled, wraps all output items into a single item containing an array to prevent the next node from executing multiple times.
Wrapper Property Name The property name to use for the wrapped array of items in the output. Default is 'items'.

Output

JSON

  • eventId - The unique identifier of the event.
  • customerId - The unique identifier of the customer associated with the event.
  • eventCategory - The category of the event (e.g., EVENT, AUDIT, ALERT).
  • eventType - The specific type of the event.
  • feature - The feature or component related to the event.
  • severity - The severity level of the event.
  • initiatedBy - The user or system that initiated the event.
  • timestamp - The timestamp when the event occurred.
  • details - Detailed information about the event, included if 'Include Details' option is enabled.

Dependencies

  • Druva MSP API
  • API key credential for authentication

Troubleshooting

  • Ensure the Customer ID is valid and exists in the Druva MSP system to avoid errors retrieving events.
  • If no events are returned, check the date filters and other filter criteria to ensure they match existing events.
  • If the node throws an error about the resource not being implemented, verify that the 'Event' resource and 'Get Many Customer Events' operation are correctly selected.
  • Network or authentication issues with the Druva MSP API can cause request failures; verify API credentials and network connectivity.

Discussion