Purpose
This page outlines the configuration, usage, and monitoring of Bitmovin Analytics Alerts, enabling customers to track playback performance metrics and receive automated notifications via Microsoft Teams or email.
Objective
The goal of this configuration is to:
-
Detect playback and performance issues in real-time.
-
Enable proactive monitoring using alert thresholds.
-
Streamline communication using Microsoft Teams integration.
Supported Alert Channels
-
Webhook integrations (e.g., Microsoft Teams, Slack)
Key Metrics for Alert Configuration
|
Metric Name |
Description |
Recommended Threshold |
Purpose |
|---|---|---|---|
|
Median Video Startup Time |
Startup delay before playback begins |
> 1s |
Detects slow video start |
|
Error Percentage |
Percentage of sessions that failed |
> 2% |
Tracks overall reliability |
|
Rebuffer Percentage |
Time spent buffering during playback |
> 3% |
Identifies playback issues |
|
Playback Success Rate |
Ratio of successful playback sessions |
< 95% |
Measures availability |
Creating Alerts in Bitmovin Dashboard
-
Log in to the Bitmovin Dashboard and navigate to Analytics → Alerts.
-
Click Create Alert and define the alert criteria.
Example:
-
Metric = Median Video Startup Time
-
Threshold = 1 second
-
Duration = 1 minute
-
Minimum viewers = 1
Configuring Microsoft Teams Webhook
-
In Microsoft Teams, open your desired channel and click Manage Channel → Connectors.
-
Search for and select Incoming Webhook.
-
Provide a name (e.g., Bitmovin Playback Alerts) and optional image.
-
Click Create. Copy the generated Webhook URL.
-
In Bitmovin Dashboard, go to Analytics → Alerts → Notification Channels → Add Webhook.
-
Paste the Microsoft Teams Webhook URL and save the configuration.
Validating the Webhook
To verify the setup, temporarily reduce the alert threshold (e.g., 0.1s) to trigger a test alert. Check Microsoft Teams for a message confirming successful alert delivery.
Troubleshooting
-
Webhook not working: verify the Teams connector is enabled and URL is valid.
-
Emails not received: confirm notification channel association with alert.
-
No alerts: reduce thresholds to simulate and validate trigger conditions.
Example Microsoft Teams Alert Payload
{
"@type": "MessageCard",
"@context": "https://schema.org/extensions",
"summary": "Bitmovin Alert",
"themeColor": "E81123",
"title": "🚨 Bitmovin Alert Triggered",
"sections": [{
"facts": [
{"name": "Metric", "value": "Median Video Startup Time"},
{"name": "Threshold", "value": "1s"},
{"name": "Duration", "value": "1 minute"},
{"name": "Viewers", "value": "2"},
{"name": "Status", "value": "Active"}
],
"markdown": true
}]
}