--- title: Conviva description: Collect video streaming Quality of Experience metrics from Conviva breadcrumbs: Docs > Integrations > Conviva --- # Conviva ## 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/). ### 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/).