To simplify shipping your Azure diagnostic metrics, we provide an automated deployment process. At the end of this process, you’ll have configured an event hub namespace, an event hub, and 2 storage blobs.

The resources set up by the automated deployment can collect data for a single Azure region and ship that data to Logz.io.

More information

What am I setting up in my Azure account?

The automated deployment sets up a new Event Hub namespace and all the components you’ll need to collect metrics in one Azure region.

Each automated deployment sets up these resources in your Azure environment:

  • 1 namespace
  • 1 Azure function
  • 1 event hubs
  • 2 blobs
Naming convention

Each deployed resource has a Logz.io-defined name and ends with a string unique to that deployment.

For example: We name the namespace LogzioNS—so if your namespace is LogzioNS6nvkqdcci10p, the rest of the deployed resources will end with 6nvkqdcci10p.

How many automated deployments should I... deploy?

Azure requires an event hub in the same region as your services. Also worth noting is that you can stream data from multiple services to one event hub (as long as it’s in the same region).

So what does this mean for you? It means that you’ll need to do at least one automated deployment for each region where you want to collect logs or metrics.

Setup

Configuration

If needed, configure an automated deployment

If you already set up an automated deployment in this region, you can skip to step 2.

👇 Otherwise, click this button to start the automated deployment.

Deploy to Azure

You’ll be taken to Azure, where you’ll configure the resources to be deployed. Make sure to use the settings shown below.

Customized template

In the BASICS section
Parameter Description
Resource group Click Create new. Give a meaningful Name, such as “logzioEventHubIntegration”, and then click OK.
Location Choose the same region as the Azure services that will stream data to this Event Hub.
In the SETTINGS section
Parameter Description
Metrics listener host Use the listener URL for your metrics account region. For more information on finding your account’s region, see Account region.
Metrics account token Use the token of the metrics account you want to ship to.

At the bottom of the page, select I agree to the terms and conditions stated above, and then click Purchase to deploy.

Deployment can take a few minutes.

(Optional) Add failsafes for shipping timeouts

You can configure Azure to back up your data to Azure Blob Storage. So if the connection to Logz.io times out or an error occurs, you’ll still have a backup of any dropped data.

To do this, expand your function app’s left menu, and then click Integrate.

New Blob output

In the top of the triggers panel, click Azure Blob Storage (outputBlob). The Azure Blob Storage output settings are displayed.

Leave Blob parameter name blank. Enter the Path for the Azure blob you’re sending dropped metrics to, and then click Save.

For more information on Azure Blob output binding, see Azure Blob storage bindings for Azure Functions > Output from Microsoft.

Stream data to the new event hub

So far in this process, you’ve deployed an event hub and a function app.

Now you’ll need to configure Azure to stream diagnostic metrics to the event hub you just deployed. When data comes into the event hub, the function app will forward that data to Logz.io.

In the search bar, type “Diagnostics”, and then click Diagnostics settings. This brings you to the Diagnostics settings page.

Choose a resource from the list of resources, and click Turn on diagnostics settings to open the Diagnostics settings panel for that resource.

Give your diagnostic settings a Name.

Select Stream to an event hub, and then click Configure to open the Select event hub panel.

Choose your event hub:

  • Event hub namespace: Choose the namespace that starts with LogzioNS (LogzioNS6nvkqdcci10p, for example)
  • Event hub name: Choose insights-operational-metrics
  • Event hub policy name: Choose LogzioSharedAccessKey
  • Click OK to return to Diagnostics settings.

Click OK to return to the Diagnostics settings panel.

In the Metrics section, select the data you want to stream, and then click Save. The selected data will now stream to the event hub.

Check Logz.io for your metrics

Give your data some time to get from your system to ours, and then open Logz.io.