Conviva

Overview

Connect Datadog with your Conviva account to see your quality of experience (QoE) MetricLens metrics.

Setup

Installation

Install the integration with the Datadog Conviva integration tile.

Configuration

  1. Go to the configuration tab inside the Datadog Conviva integration tile.
  2. Click Add New Credentials and input your Conviva API Key and API Secret. Datadog searches for accounts associated with those credentials.
  3. After Datadog finds the accounts associated with your credentials, add a MetricLens to determine which metrics are be ingested into Datadog. Specify a name for the MetricLens along with a Filter and Dimension. The name is automatically tagged for that specific MetricLens.
  4. Optionally, add tags to specific MetricLenses or to accounts. When you add a tag to an account, the tag is applied to all MetricLenses associated with that account.
  5. Add more MetricLenses by clicking Add New and following the instructions.
  6. Repeat these steps with any additional Conviva credentials using the Add New Credentials button.

Dashboard

After configuring the integration, use the out-of-the box Conviva dashboard to obtain an overview of MetricLens metrics. By default, all metrics collected across all MetricLenses are displayed.

The out-of-the-box dashboard for the Conviva integration

Filter by metriclens to view the breakdown of the metrics by each corresponding MetricLens configured on the tile. Drill down further by filtering by dimension to view metrics by a single dimension entity.

Data Collected

Metrics

conviva.quality.total_attempts
(count)
The total number of play attempts in the interval.
Shown as attempt
conviva.quality.video_start_failures_percentage
(gauge)
The percentage of video start failures in the interval.
Shown as percent
conviva.quality.exit_before_video_start_percentage
(gauge)
The percentage of exits before video starts in the interval.
Shown as percent
conviva.quality.plays
(count)
The number of plays in the interval.
Shown as occurrence
conviva.quality.video_startup_time_s
(gauge)
The video startup time in seconds.
Shown as second
conviva.quality.rebuffering_ratio_percentage
(gauge)
The percentage of rebuffering video ratios.
Shown as percent
conviva.quality.average_bitrate_kbps
(gauge)
The average bitrate in kilobits per second.
conviva.quality.video_playback_failures_percentage
(gauge)
The percentage of videos with playback failures.
Shown as percent
conviva.quality.ended_plays
(count)
The number of ended plays.
Shown as occurrence
conviva.quality.connection_induced_rebuffering_ratio_percentage
(gauge)
The percentage of connection induced rebuffering ratios.
Shown as percent
conviva.quality.video_restart_time
(gauge)
The number of seconds to restart the video.
Shown as second
conviva.quality.video_start_failures_technical_percentage
(gauge)
The percentage of start failures from a technical perspective.
Shown as percent
conviva.quality.video_start_failures_business_percentage
(gauge)
The percentage of start failures from a business perspective.
Shown as percent
conviva.quality.video_playback_failures_technical_percentage
(gauge)
The percentage of playback failures from a technical perspective.
Shown as percent
conviva.quality.video_playback_failures_business_percentage
(gauge)
The percentage of playback failures from a business perspective.
Shown as percent
conviva.quality.concurrent_plays
(count)
The number of concurrent plays in this interval.
Shown as occurrence
conviva.quality.abandonment_count
(count)
The total number of play attempts abandoned by users due to delays or errors.
Shown as occurrence
conviva.quality.abandonment_percentage
(gauge)
The percentage of play attempts abandoned relative to total attempts.
Shown as percent
conviva.quality.abandonment_without_pre_roll_percentage
(gauge)
The percentage of abandonment in sessions without pre-roll ads.
Shown as percent
conviva.quality.abandonment_with_pre_roll_percentage
(gauge)
The percentage of abandonment occurring in sessions with pre-roll ads.
Shown as percent
conviva.quality.ad_actual_duration
(gauge)
The total duration of ad creatives played, divided by the number of ads.
Shown as second
conviva.quality.ad_attempts_count
(count)
The total number of attempts made to fetch ad creatives.
Shown as attempt
conviva.quality.ad_bitrate_bps
(gauge)
The average bitrate of ad playback, measured in bits per second.
Shown as bit
conviva.quality.ad_completed_creative_plays
(count)
The number of ad creatives played to completion.
Shown as occurrence
conviva.quality.ad_concurrent_plays_count
(count)
The count of simultaneous ad playbacks at any given time.
Shown as occurrence
conviva.quality.ad_connection_induced_rebuffering_ratio
(gauge)
The ratio of ad rebuffering caused by connection issues.
Shown as percent
conviva.quality.ad_ended_plays_count
(count)
The number of ad creatives that fully played in the current interval.
Shown as occurrence
conviva.quality.ad_ended_plays_per_unique_device
(gauge)
The count of ended ad plays divided by the number of unique devices.
Shown as occurrence
conviva.quality.ad_framerate_fps
(gauge)
The average frame rate of ad creatives, in frames per second.
conviva.quality.ad_impressions_count
(count)
The total number of ad creatives that started successfully.
conviva.quality.ad_impressions_percentage
(gauge)
The percentage of ad attempts resulting in successful ad starts.
Shown as percent
conviva.quality.ad_minutes_played_count
(count)
The total minutes of ad content played across all sessions.
Shown as minute
conviva.quality.ad_minutes_played_per_ended_play
(gauge)
Average minutes of ads played per ended ad session.
Shown as minute
conviva.quality.ad_minutes_played_per_unique_device
(gauge)
Average ad minutes played per unique device with ad plays.
Shown as minute
conviva.quality.ad_percentage_complete_percentage
(gauge)
The percentage of ad content viewed relative to its total length.
Shown as percent
conviva.quality.ad_rebuffering_ratio
(gauge)
The percentage of ad viewing time during which viewers experienced rebuffering.
Shown as percent
conviva.quality.ad_unique_devices_count
(count)
The count of unique devices that played at least one ad.
Shown as device
conviva.quality.ad_video_playback_failures_count
(count)
The total count of ad playback failures.
Shown as occurrence
conviva.quality.ad_video_playback_failures_percentage
(gauge)
The percentage of ad sessions ending in playback failure.
Shown as percent
conviva.quality.ad_video_restart_time
(gauge)
The time taken to restart ad playback after interruption, in seconds.
Shown as second
conviva.quality.ad_video_start_failures_count
(count)
The total number of failed attempts to start ad playback.
Shown as occurrence
conviva.quality.ad_video_start_failures_percentage
(gauge)
The percentage of ad start attempts that failed.
Shown as percent
conviva.quality.ad_video_start_time
(gauge)
The time from ad request to the start of ad playback, in seconds.
Shown as second
conviva.quality.attempts_without_pre_roll_count
(count)
The count of video play attempts without pre-roll ads.
Shown as attempt
conviva.quality.attempts_without_pre_roll_percentage
(gauge)
The percentage of video play attempts without pre-roll ads.
Shown as percent
conviva.quality.attempts_with_pre_roll_count
(count)
The count of video play attempts that included pre-roll ads.
Shown as attempt
conviva.quality.attempts_with_pre_roll_percentage
(gauge)
The percentage of video play attempts with pre-roll ads.
Shown as percent
conviva.quality.bad_session_count
(count)
The count of sessions experiencing poor video playback quality.
Shown as session
conviva.quality.bad_session_percentage
(gauge)
The percentage of sessions with poor video playback quality.
Shown as percent
conviva.quality.bad_session_average_life_playing_time_mins
(gauge)
Average playing time of sessions with poor video playback quality, in minutes.
Shown as minute
conviva.quality.bad_unique_devices_count
(count)
The count of unique devices experiencing poor video playback quality.
Shown as device
conviva.quality.bad_unique_devices_percentage
(gauge)
The percentage of devices experiencing poor video playback quality.
Shown as percent
conviva.quality.bad_unique_viewers_count
(count)
The count of unique viewers experiencing poor video playback quality.
conviva.quality.bad_unique_viewers_percentage
(gauge)
The percentage of viewers experiencing poor video playback quality.
Shown as percent
conviva.quality.ended_plays_per_unique_device
(gauge)
The ratio of ended video plays to unique devices that played videos.
Shown as occurrence
conviva.quality.ended_plays_with_ads_count
(count)
The count of video plays that ended and included ads.
Shown as occurrence
conviva.quality.ended_plays_with_ads_percentage
(gauge)
The percentage of video plays that ended and included ads.
Shown as percent
conviva.quality.ended_plays_without_ads_count
(count)
The count of video plays that ended without including ads.
Shown as occurrence
conviva.quality.ended_plays_without_ads_percentage
(gauge)
The percentage of video plays that ended without including ads.
Shown as percent
conviva.quality.exit_before_video_starts_count
(count)
The total number of exits before video playback begins.
Shown as occurrence
conviva.quality.exits_before_ad_start_count
(count)
The count of exits occurring before ad playback starts.
Shown as occurrence
conviva.quality.exits_before_ad_start_percentage
(gauge)
The percentage of exits occurring before ad playback starts.
Shown as percent
conviva.quality.exits_during_pre_roll_count
(count)
The count of exits occurring during the pre-roll ad phase.
Shown as occurrence
conviva.quality.exits_during_pre_roll_percentage
(gauge)
The percentage of exits occurring during the pre-roll ad phase.
Shown as percent
conviva.quality.framerate_fps
(gauge)
The average frame rate of video playback, in frames per second.
conviva.quality.good_session_count
(count)
The count of sessions experiencing good video playback quality.
Shown as session
conviva.quality.good_session_average_life_playing_time_mins
(gauge)
Average playing time of sessions with good video playback quality, in minutes.
Shown as minute
conviva.quality.good_unique_devices_count
(count)
The count of unique devices experiencing good video playback quality.
Shown as device
conviva.quality.good_unique_viewers_count
(count)
The count of unique viewers experiencing good video playback quality.
conviva.quality.high_rebuffering_count
(count)
The count of video playback sessions with high rebuffering.
Shown as occurrence
conviva.quality.high_rebuffering_percentage
(gauge)
The percentage of video playback sessions with high rebuffering.
Shown as percent
conviva.quality.high_rebuffering_with_ads_percentage
(gauge)
The percentage of ad-included playback sessions with high rebuffering.
Shown as percent
conviva.quality.high_rebuffering_without_ads_percentage
(gauge)
The percentage of ad-excluded playback sessions with high rebuffering.
Shown as percent
conviva.quality.high_startup_time_count
(count)
The count of video playback sessions with high startup time.
Shown as occurrence
conviva.quality.high_startup_time_percentage
(gauge)
The percentage of video playback sessions with high startup time.
Shown as percent
conviva.quality.high_startup_time_without_pre_roll_percentage
(gauge)
The percentage of sessions with high startup time excluding pre-roll ads.
Shown as percent
conviva.quality.high_startup_time_with_pre_roll_percentage
(gauge)
The percentage of sessions with high startup time including pre-roll ads.
Shown as percent
conviva.quality.interval_minutes_played_count
(count)
The total minutes of video playback in a specified interval.
Shown as minute
conviva.quality.low_bitrate_count
(count)
The count of video playback sessions with low bitrate.
Shown as occurrence
conviva.quality.low_bitrate_percentage
(gauge)
The percentage of video playback sessions with low bitrate.
Shown as percent
conviva.quality.low_bitrate_with_ads_percentage
(gauge)
The percentage of ad-included playback sessions with low bitrate.
Shown as percent
conviva.quality.low_bitrate_without_ads_percentage
(gauge)
The percentage of ad-excluded playback sessions with low bitrate.
Shown as percent
conviva.quality.minutes_played_count
(count)
The total count of minutes played in video sessions.
Shown as minute
conviva.quality.minutes_played_per_ended_play
(gauge)
Average minutes played per ended video session.
Shown as minute
conviva.quality.minutes_played_per_unique_device
(gauge)
Average minutes of video played per unique device.
Shown as minute
conviva.quality.non_zero_cirr_ended_plays_count
(count)
Count of ended plays with non-zero Client Initiated Rebuffering Ratio (CIRR).
Shown as occurrence
conviva.quality.non_zero_cirr_ended_plays_percentage
(gauge)
Percentage of ended plays with non-zero Client Initiated Rebuffering Ratio (CIRR).
Shown as percent
conviva.quality.percentage_complete_percentage
(gauge)
Percentage of video plays completed in total plays.
Shown as percent
conviva.quality.plays_percentage
(gauge)
Percentage of total plays in comparison to the total possible plays.
Shown as percent
conviva.quality.spi_streams_count
(count)
Count of streams contributing to the Streaming Performance Index (SPI).
conviva.quality.spi_unique_devices_count
(count)
Count of unique devices contributing to the Streaming Performance Index (SPI).
Shown as device
conviva.quality.spi_unique_viewers_count
(count)
Count of unique viewers contributing to the Streaming Performance Index (SPI).
conviva.quality.streaming_performance_index
(gauge)
A composite index representing the overall streaming performance.
conviva.quality.unique_devices_count
(count)
Count of unique devices used for video playback.
Shown as device
conviva.quality.video_playback_failures_count
(count)
Total count of video playback failures.
Shown as occurrence
conviva.quality.video_playback_failures_business_count
(count)
Count of business-related video playback failures.
Shown as occurrence
conviva.quality.video_playback_failures_tech_count
(count)
Count of technical-related video playback failures.
Shown as occurrence
conviva.quality.video_playback_failures_tech_with_ads_percentage
(gauge)
Percentage of technical-related playback failures in sessions with ads.
Shown as percent
conviva.quality.video_playback_failures_tech_without_ads_percentage
(gauge)
Percentage of technical-related playback failures in sessions without ads.
Shown as percent
conviva.quality.video_start_failures_count
(count)
Total count of failures to start video playback.
Shown as occurrence
conviva.quality.video_start_failures_business_count
(count)
Count of business-related failures to start video playback.
Shown as occurrence
conviva.quality.video_start_failures_tech_count
(count)
Count of technical-related failures to start video playback.
Shown as occurrence
conviva.quality.video_start_failures_tech_without_pre_roll_percentage
(gauge)
Percentage of technical-related start failures without pre-roll ads.
Shown as percent
conviva.quality.video_start_failures_tech_with_pre_roll_percentage
(gauge)
Percentage of technical-related start failures with pre-roll ads.
Shown as percent
conviva.quality.zero_cirr_ended_plays_count
(count)
Count of ended plays with zero Client Initiated Rebuffering Ratio (CIRR).
Shown as occurrence
conviva.quality.zero_cirr_ended_plays_percentage
(gauge)
Percentage of ended plays with zero Client Initiated Rebuffering Ratio (CIRR).
Shown as percent

Events

The Conviva integration sends alerts to your Datadog event stream.

Monitor alerts in the Datadog Conviva Event Stream

Service Checks

The Conviva integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.

Further Reading

Additional helpful documentation, links, and articles:

PREVIEWING: mervebolat/span-id-preprocessing