Cynteo Alert Bridge Documentation

Connect Azure Monitor alerts to your ITSM automatically

Quick Start Guide

Deploy Cynteo Alert Bridge to your Azure environment in minutes.

Prerequisites

Before you begin, make sure you have:

  • Azure subscription (with Owner or Contributor role)
  • ITSM platform account (SolarWinds, ServiceNow, etc.)
  • API credentials for your platform
  • At least one Azure Monitor alert configured

Step 1: Deploy from Azure Marketplace

1.1 Find Cynteo Alert Bridge

  1. Go to Azure Marketplace
  2. Search for “Cynteo Alert Bridge”
  3. Click “Get It Now”
  4. Click “Continue” to go to Azure Portal

1.2 Fill in Deployment Form

Basics Tab:

  • Subscription: Select your Azure subscription
  • Resource Group: Create new (e.g., rg-alert-bridge) or select existing
  • Region: Same region as your resources (e.g., East US)
  • Application Name: Give it a friendly name (e.g., alert-bridge-prod)

Platform Configuration Tab:

  • ITSM API Token: Paste your platform API token
  • ITSM API URL: Your platform’s API endpoint
  • Requester Email: Email for created incidents (e.g., azure-monitor@yourcompany.com)
  • Platform Type: Select your ITSM platform (SolarWinds, etc.)

Alert Configuration Tab:

  • Priority Mapping: Configure severity-to-priority mapping
  • Category: Default incident category
  • Subcategory: Default incident subcategory
  • Severity Filter: (Optional) Only process specific severities

Notifications Tab:

  • Email: Your email for usage notifications

1.3 Review and Create

  1. Click “Review + create”
  2. Review settings
  3. Click “Create”
  4. Wait ~5 minutes for deployment

Step 2: Get Webhook URL

Once deployment completes, retrieve the webhook URL from the managed application:

  1. Go to Azure Portal → Resource groups
  2. Open your Cynteo Alert Bridge resource group
  3. Click the Managed Application resource
  4. Go to Overview → Outputs section
  5. Copy the “Webhook URL” value

Example URL:

https://prod-123.eastus.logic.azure.com:443/workflows/.../triggers/manual/paths/invoke?...

⚠️ Keep this URL secure - it contains authentication credentials

Step 3: Configure Azure Monitor Alert Action Group

3.1 Create Action Group

  1. In Azure Portal, search for “Monitor”
  2. Click “Alerts” → “Action groups”
  3. Click "+ Create"

Basics:

  • Subscription: Your subscription
  • Resource Group: Same as Cynteo Alert Bridge
  • Action group name: alert-bridge-itsm
  • Display name: ITSM Bridge

Actions:

  • Action type: Webhook
  • Name: Send to ITSM
  • Webhook URL: Paste URL from Step 2
  • Enable common alert schema: ✅ YES (Important!)

Click “Review + create” → “Create”

3.2 Add to Alert Rules

For each alert you want sent to your ITSM platform:

  1. Go to Monitor → Alerts → Alert rules
  2. Select an alert rule
  3. Click “Edit”
  4. Under “Actions”, click "+ Action group"
  5. Select alert-bridge-itsm
  6. Click “Save”

Step 4: Test It!

4.1 Trigger a Test Alert

Option A: Use existing alert

  • Wait for an alert to naturally fire

Option B: Create test alert

  1. Monitor → Alerts → + Create → Alert rule
  2. Select a resource (e.g., VM)
  3. Condition: CPU > 1% (will fire immediately)
  4. Actions: Select alert-bridge-itsm
  5. Save and wait 1-2 minutes

4.2 Verify in Your ITSM Platform

  1. Log into your ITSM platform
  2. Go to Incidents or Tickets
  3. You should see a new incident:
    • Title: Azure Alert: [Your Alert Name]
    • Priority: Based on severity mapping
    • Description: Rich alert details and context

If you don’t see it: Check Troubleshooting Guide

Step 5: Test Alert Resolution

5.1 Resolve the Alert

  • If you created a test alert with CPU > 1%, delete the alert rule
  • If using real alert, wait for condition to clear

5.2 Verify in Your ITSM Platform

  1. Go to the incident created in Step 4.2
  2. Wait ~2 minutes
  3. Incident should show:
    • State: Resolved
    • Resolution Note: “Resolved automatically by Azure Monitor…”
    • Updated status with resolution details

✅ You’re Done!

Your Azure Monitor alerts are now automatically creating ITSM incidents!

Next Steps

Customize Your Integration

Monitor Usage

  • View usage in Azure Portal (Resource Group → Managed Application)
  • Receive email notifications at 80% and 100% of plan limits
  • Upgrade plan if needed

Get Support

Common Questions

Q: Do I need to configure anything in my ITSM platform?
A: Just generate an API token with the required permissions. See platform-specific guides for details.

Q: Will this create duplicate tickets?
A: No, Cynteo Alert Bridge tracks alerts and updates the same ticket if an alert fires multiple times.

Q: What happens if an alert fires then resolves then fires again?
A: A new incident will be created for the second occurrence.

Q: Can I use this with multiple Azure subscriptions?
A: Yes! Deploy Cynteo Alert Bridge in each subscription, or use one deployment and add action groups in each subscription pointing to the same webhook URL.

Q: What’s included in the free trial?
A: Full functionality, up to your plan’s alert limit, for 30 days. No credit card required.

Need help? Check our troubleshooting guide or contact support.