Docs » Integrations Guide » Integrations Reference » Conviva

../../_images/integration_conviva.png Conviva 🔗

DESCRIPTION 🔗

Conviva is a service for monitoring video playing experience on the Internet. The SignalFx Smart Agent monitor called Conviva was developed for Conviva integration. The conviva monitor can be configured to pull Real-Time/Live Conviva metrics using the Conviva Experience Insights REST APIs. Conviva Developer Community credentials are required to access this Conviva API documentation link. The Live Conviva metrics are converted to SignalFx metrics with dimensions for the name of the Conviva account and the name(s) of the applied filter(s). For MetricLens metrics, the MetricLens dimensions are mapped one-to-one to SignalFx dimensions with the values of these dimensions derived from the values of the associated MetricLens dimension entities.

REQUIREMENTS AND DEPENDENCIES 🔗

Only Live Conviva metrics are supported. Conviva MetricLens metrics require MetricLens-enabled filters. MetricLens-enabled filters are listed in the table of filters with a checkmark in the ML column. Conviva Pulse credentials are required to access the link to the table of filters.

This monitor requires:

Software Version
Conviva Experience Insights API 2.4+

INSTALLATION 🔗

Install the latest version of the SignalFx Smart Agent as described in SignalFx Smart Agent.

CONFIGURATION 🔗

  1. Open the SignalFX Smart Agent agent.yamlconfiguration file.
  2. Edit the monitors section.
  3. Add the metric parameters as values for metricParameter.

USAGE 🔗

The Conviva monitor emits Live Conviva metrics which can then be used to create dashboards such as the one below showing an overview of real-time video quality metrics.

../../_images/conviva_overview_dashboard.pngReal-Time Dashboard

Special considerations 🔗

The Conviva API response may return with filters listed in fields filters_not_exist, filters_warmup and filters_incomplete_data. This means data for these filters may be wholly or partially unavailable. When this happens it is logged in the SignalFx Smart Agent log file.

Configuration validation will fail when a non-MetricLens enabled filter is listed in a MetricLens metric configuration.

The select all filters in combination with select all dimensions options should be used with care because of the potential to generate a large amount of datapoints (in other words, metric time series (MTS)).