--- title: Conviva description: Collect video streaming Quality of Experience metrics from Conviva breadcrumbs: Docs > Integrations > Conviva --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # Conviva {% callout %} # Important note for users on the following Datadog sites: us2.ddog-gov.com {% alert level="info" %} To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator. To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com). {% /alert %} {% /callout %} ## Overview{% #overview %} Connect Datadog with your Conviva account to see your quality of experience (QoE) MetricLens metrics. ## Setup{% #setup %} ### Installation{% #installation %} Install the integration with the Datadog [Conviva integration tile](https://app.datadoghq.com/integrations/conviva). ### Configuration{% #configuration %} 1. Go to the configuration tab inside the Datadog [Conviva integration tile](https://app.datadoghq.com/integrations/conviva). 1. Click **Add New Credentials** and input your Conviva API Key and API Secret. Datadog searches for accounts associated with those credentials. 1. After Datadog finds the accounts associated with your credentials, add a *MetricLens* to determine which metrics are be ingested into Datadog. Click **Add New** under the MetricLens list, and specify a name for the MetricLens, along with a **Filter** and **Dimension**. The name is automatically tagged for that specific MetricLens. 1. 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. 1. Add more MetricLenses by clicking **Add New** and following the instructions. 1. Repeat these steps with any additional Conviva credentials using the **Add New Credentials** button. ### Dashboard{% #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. 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{% #data-collected %} ### Metrics{% #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{% #events %} The Conviva integration sends alerts to your [Datadog event stream](https://docs.datadoghq.com/events.md). ### Service Checks{% #service-checks %} The Conviva integration does not include any service checks. ## Troubleshooting{% #troubleshooting %} Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).