Azure One-Click Integrations

SigNoz One-Click Azure Integration monitors your Azure services without manual setup. Connect your Azure subscription from the SigNoz UI, and SigNoz deploys an agent that provisions Event Hubs, diagnostic settings, and an OpenTelemetry Collector via Azure Deployment Stacks. Each supported service ships with a pre-built dashboard, visible as soon as data starts flowing.

Supported integrations

Key capabilities

• Automated setup: SigNoz deploys all monitoring resources into your Azure subscription. No manual resource creation needed.
• Auto-discovery: The agent detects and monitors new resources of an enabled service type. No reconfiguration as your infrastructure grows.
• Multi-subscription support: Monitor resources across multiple Azure subscriptions and resource groups from a single SigNoz workspace.
• Pre-built dashboards: Each supported service ships with a ready-made dashboard, available as soon as data starts flowing.

Prerequisites

• A SigNoz Cloud or Self-Hosted Enterprise account
• An active Azure subscription
• One of the following Azure built-in roles on the subscription:
  • Owner (covers all required permissions)
  • Contributor + User Access Administrator (use this if you prefer not to grant Owner access)

Installation

Step 1: Connect your Azure subscription

1. In SigNoz, navigate to Integrations and click Microsoft Azure.
2. Click Integrate Now to open the setup panel.
3. Select the Azure region to deploy SigNoz agent resources.
4. Add one or more resource group names that you want to monitor.
5. Click Generate Azure Setup Commands.

Step 2: Deploy the agent

SigNoz generates a deployment command pre-filled with your configuration. Copy it from the SigNoz UI and run it:

az stack sub create \
  --name signoz-integration \
  --location <azure-region> \
  --template-uri <template-url> \
  --parameters <params key value pairs> \
  --action-on-unmanage deleteAll \
  --deny-settings-mode denyDelete

New-AzSubscriptionDeploymentStack `
  -Name "signoz-integration" `
  -Location "<azure-region>" `
  -TemplateUri "<template-url>" `
  -TemplateParameterObject @{
    <params key value pairs>
  } `
  -ActionOnUnmanage "deleteAll" `
  -DenySettingsMode "denyDelete"

Step 3: Verify connection

Return to the SigNoz UI after running the command. The page shows your subscription ID in the account bar once the agent is up, confirming the connection succeeded.

Verify on the Azure Portal

1. Go to Subscriptions and select your subscription.
2. In the left menu, navigate to Deployment stacks.
3. Confirm both stacks show a Succeeded status:
   • signoz-integration: deploys the agent and its supporting infrastructure
   • signoz-integration-telemetry: deploys telemetry resources (OTel collector, Event Hubs and diagnostic settings)

If either stack shows a failed status, check the stack details for error messages and confirm your account has the required permissions listed in Prerequisites.

Managing integrations

Enabling or disabling services

Once connected, enable or disable monitoring for each service individually:

1. In the Azure integration page, select a service from the left panel (e.g., CDN Profile or Storage Accounts Blob Storage).
2. Toggle Log Collection or Metric Collection on or off.

The agent updates the telemetry pipeline in the background, deploying or removing resources to match your selection.

Updating resource groups

1. Click Edit Account in the top right of the Azure integration page.
2. Update the resource groups list in the Account Settings panel.
3. Click Update Changes.

Adding multiple accounts

To monitor multiple Azure subscriptions, click Add New Account and follow the same installation steps for each subscription.

Uninstalling

1. Click Edit Account, then click Disconnect at the bottom of the Account Settings panel.
2. Confirm by clicking Remove Account.

SigNoz deletes the signoz-integration-telemetry stack within ~15 minutes. After that, manually delete the signoz-integration stack (~20 minutes to complete):

az stack sub delete \
  --name signoz-integration \
  --action-on-unmanage deleteAll \
  --yes

Remove-AzSubscriptionDeploymentStack `
  -Name "signoz-integration" `
  -ActionOnUnmanage "deleteAll" `
  -Force

Limitations

• Two Azure services are currently supported: Azure CDN FrontDoor and Azure Blob Storage. More services will be added in future releases.
• Large deployments may hit ARM template size limits: If you have a large number of resources across many regions and resource groups, the deployment may fail. Add only the resource groups you actively want to monitor. Support for larger deployments will be addressed in a future release.
• Deployment region is set at connection time and cannot be changed: To change the region, disconnect and reconnect the account.

Architecture

When you connect an Azure subscription, SigNoz deploys two deployment stacks:

signoz-integration (core agent infrastructure):

• A Container App running the SigNoz agent, which periodically checks in with SigNoz to fetch your integration configuration
• A Managed Identity (SigNozAutomationAgent) with a custom role scoped to your subscription
• A Container App Environment that hosts both the agent and the OTel Collector

signoz-integration-telemetry (telemetry pipeline, deployed and updated by the agent whenever you enable or disable a service):

• Event Hub Namespaces (one per Azure region where your resources live) with an event hub for receiving logs
• Diagnostic Settings on each monitored resource, forwarding logs to the appropriate Event Hub
• An OpenTelemetry Collector (Container App) that reads logs from Event Hubs via the azureeventhub receiver and scrapes metrics from Azure Monitor via the azuremonitor receiver, then exports everything to SigNoz over OTLP HTTP

The agent continuously discovers new resources in your monitored resource groups using the Azure Resource Graph API. When you enable or disable a service or update resource groups in the SigNoz UI, the agent reconciles the desired state and updates the telemetry stack.

Get Help

If you need help with the steps in this topic, please reach out to us on SigNoz Community Slack.

If you are a SigNoz Cloud user, please use in product chat support located at the bottom right corner of your SigNoz instance or contact us at cloud-support@signoz.io.