USM Anywhere™

Collect Logs from Azure Event Hubs

Microsoft Azure Event Hubs is a data and event processing service for Microsoft Azure. The integration between USM Anywhere and Azure Event Hubs enables the Azure Sensor to receive and process information from an event hub so that you can manage them in your USM Anywhere environment.

Important: Be sure to check the Azure requirements page for any environmental requirements specific to Azure Event Hubs before implementing streaming your logs to Event Hubs.

The Azure Sensor can process different types of logs sent through Azure Event Hubs, including but not limited to the following:

  • Azure Active Directory (AD) logs, including audit logs and sign-in logs
  • Azure Application Gateway logs
  • Azure Monitor logs
  • Azure SQL Database logs
  • Microsoft Defender Advanced Threat Protection (ATP) logs

Stream Logs to Azure Event Hubs

Before configuring the Azure Event Hubs integration in USM Anywhere, you must stream the logs you want to be analyzed to an event hub. Make sure to stream your logs to the same Event Hubs, because each Azure Sensor can only collect from a single event hub.

To stream logs to Azure Event Hubs

  1. Log in to the Azure portal.
  2. Create an Event Hub.
    See Microsoft Azure Quickstart: Create an event hub using Azure portal for instructions.
  3. Go to the Event Hub you just created and click Shared access policies in the sidebar.
  4. Create or edit a policy, and then select Manage, Send, and Listen.
    Streaming to Event Hubs requires these permissions.
  5. Copy the connection string listed in the policy under Connection string-primary key.

    You need to enter this string when configuring the Event Hubs connection in USM Anywhere.

  6. Configure streaming for the logs you want to collect. For example:

    Note: Make sure to enable Stream to an event hub and select the Event Hub you just created as the destination.

Set Up Azure Event Hubs Connection in USM Anywhere

After completing the initial setup of your Azure Event Hubs, return to your USM Anywhere Sensors page to enable the Azure Event Hubs connection in USM Anywhere.

To enable Azure Event Hubs in USM Anywhere

  1. Go to the Sensors page and open the Azure Sensor.
  2. Click the Configurations tab.

  3. Complete the three fields:

    • Event Hub Name: The name of the event hub created during initial setup.
    • Event Hub Connection String: A string containing unique configuration data about your Azure Event Hubs implementation. This string was discovered during the previous procedure.
    • Event Hub Consumer Group: The name of your Azure Event Hubs consumer group. You can locate this name by opening your Event Hubs overview in the Azure portal and scrolling to the bottom of the page.
  4. (Optional.) Select Process generic events to collect events for which USM Anywhere currently does not have a parser. These events will display as "GENERIC event" under Activity > Events.

  5. Click Save.
  6. Click the Event Hub tab to see the connectivity status.

Viewing Azure Event Hubs Connectivity in USM Anywhere

The Event Hub tab on the Azure Sensor page provides a glimpse into the health of your sensor's connection to Azure Event Hubs. This page contains the name of your event hub, its connectivity status, and the number of events being processed by USM Anywhere.

To view your Azure Event Hubs connection

  1. Go to the Sensors page and open your Azure Sensor.
  2. Click the Event Hub tab.

These are the connectivity statuses you may see:

  • Connecting: Azure Event Hubs is currently connecting to the sensor.
  • Processing: Azure Event Hubs is successfully connected.
  • Shutting Down: Azure Event Hubs has begun the shutdown process to allow a different event hub to connect to the sensor.
  • Shutdown: The sensor is not currently connected to an event hub.
  • Error: The connection has experienced an error.