DocumentationGrafana CloudMonitor infrastructureCloud Provider ObservabilityAzureConfigure Azure Event Hubs

Configure Azure Event Hubs for logs

Complete the following steps to configure Azure Event Hubs as shown in the following diagram.

Select your platform

Select the platform from the drop-down menu.

Install Grafana Alloy

Click Run Grafana Alloy to open steps to set up Grafana Alloy and create a configuration file.

1. If you have not already installed Alloy where you intend to run Azure Event Hubs, click Run Grafana Alloy.
2. At the Alloy configuration screen, enter a token name. The token displays on the screen and is added to the command for running Alloy.
3. Copy the command and paste it into the terminal.
4. Click Proceed to install integration.

Set up Azure Event Hubs

Grafana Alloy consumes events from Azure Event Hub using Apache Kafka endpoint. Use the next steps in the Azure portal to start Event Hubs and route logs from the Function App.

Create a namespace

Complete the following steps in the Azure portal, and use the example command for each step.

Configure your resources to route logs to Event Hub

Configure your resources to route logs to the event hub. This allows you to set up a diagnostic settings configuration for one or more resources. These resources then route logs to your newly created event hub. Complete the following steps in the Azure portal.

1. Navigate to Azure Monitor.
2. Under Settings, click Diagnostic settings.
3. Click the resource you want to route logs from.
4. Click + Add diagnostic setting to add a new diagnostic setting.
5. Under Logs -> Categories, select options for the logs you want.
6. Under Destination details:
   1. Select Stream to an event hub as the destination.
   2. Choose the event hub namespace and the event hub name you previously created.
7. Click Save to save your diagnostic setting. Your resource begins sending logs to the specified event hub.

Configure Alloy

Set up Grafana Alloy to get events from Azure Event Hub.

1. Navigate to the configuration file for your Alloy instance.
2. Copy and append the following to your Alloy configuration file so that Grafana Alloy can scrape your Azure Event Hub instances.

Copy

discovery.relabel "logs_integrations_integrations_azure_event_hubs" {
  targets = []

  rule {
    source_labels = ["__meta_kafka_topic"]
    target_label  = "topic"
  }
}

loki.source.azure_event_hubs "logs_integrations_integrations_azure_event_hubs" {
  fully_qualified_namespace = "<fully_qualified_namespace>"
  event_hubs                = ["<event_hub_name>"]

  authentication {
    mechanism         = "connection_string"
    connection_string = "<connection_string>"
  }
  use_incoming_timestamp = true
  relabel_rules          = discovery.relabel.logs_integrations_integrations_azure_event_hubs.rules
  labels                 = {
    job = "integrations/azure_event_hubs",
  }
  forward_to = [loki.write.grafana_cloud_loki.receiver]
}

Find or create connection string

Find or create a connection-string for authentication on Azure.

1. In the Azure portal, navigate to Event Hubs.
2. To find an existing string related to an existing access policy, click Shared access policies under Settings.
3. To create a new shared access policy:
   1. Click +.
   2. Give your policy a name.
   3. Select, at a minimum, the Listen permission. If you want to create another policy, click Create.
4. View the primary and secondary connection strings for your policy under Shared access keys.
5. Copy the connection string you want to use.

Add connection string to configuration file

Add the connection string to your Alloy configuration file along with the name of the Event Hub. You can specify multiple Event Hubs.

1. Paste the connection string you previously copied into the configuration file.
2. Specify the Event Hub to consume by replacing event_hub_name with your value.
   This argument must refer to a full HOST:PORT that points to your event hub. For example: <namespace>.servicebus.windows.net:9093. The namespace is the name of your Event Hubs namespace, specified when you create the namespace. Later, it can be found in the Azure portal on the Event Hubs Namespace dashboard.

Restart Grafana Alloy

Run the command appropriate for your platform to restart Grafana Alloy so your changes can take effect.

Test connection

Click Test connection to test that Grafana Alloy is collecting data and sending it to Grafana Cloud.

View your logs

Click the Logs tab to view your logs.