OpenTV ENTera & OpenTV Platform Documentation

Bitmovin Alert configuration

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

  1. Log in to the Bitmovin Dashboard and navigate to Analytics → Alerts.

  2. 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

  1. In Microsoft Teams, open your desired channel and click Manage Channel → Connectors.

  2. Search for and select Incoming Webhook.

  3. Provide a name (e.g., Bitmovin Playback Alerts) and optional image.

  4. Click Create. Copy the generated Webhook URL.

  5. In Bitmovin Dashboard, go to Analytics → Alerts → Notification Channels → Add Webhook.

  6. 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

JSON
{
  "@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
  }]
}

References