Grafana Data Source Plugin

Grafana allows you to visualize data through graphs. Use our Grafana data source plugin, which is called Verizon Media Platform Analytics, to create queries through which you may gain insight into historical and near real-time CDN performance.

Our Grafana data source plugin uses Report Builder as a data source. Please contact your CDN account manager to activate Report Builder.

Quick Start

Get started by performing the following steps:

  1. Verify that your Grafana installation is version 6.7.x or higher.
  2. Register an IDS client application to authorize the Grafana plugin access to Report Builder data.
  3. Install our Grafana data source plugin on your Grafana installation by uncompressing it within your Grafana plugins directory.
  4. Add Report Builder (Downsampled) or Report Builder as a data source.
  5. Create your dashboard with one or more panel(s) that use the data source defined in the previous step.

Client Application Registration

Access to your Report Builder data is restricted to authorized client applications (e.g., Verizon Media Platform Analytics plugin). Authorize this plugin to access your data by creating an API client that has been granted the scope.

To create an API client for use with the Verizon Media Platform Analytics plugin

  1. Navigate to the Identity dashboard.
  2. Click Clients from the side navigation pane.
  3. Verify that the Assigned to Tenant option is set to your customer account.
  4. Click Create New Client.
  5. In the Name option, assign a name that describes this API client.
  6. In the Permissions section, mark the scope.
  7. Click Create.
  8. Make a note of your new API client's credentials. You will need these credentials when setting up your data source.

    • Client ID: Click the Settings tab and then find the Client ID option.
    • Secret Key: Click the Client Secrets tab and then click to copy that secret key.

Plugin Installation

Perform the following steps to install our Grafana data source plugin:

  1. From the computer hosting Grafana, download the plugin from:

  2. Extract the contents of the above file into your Grafana plugins directory.
  3. Restart the Grafana server.

Data Source

The Verizon Media Platform Analytics plugin acts as a data source for the following types of data:

Both of the above data sources require Report Builder. If you have not already purchased Report Builder, please contact your CDN account manager to activate it.

Both Report Builder and Report Builder (Downsampled) leverage the same type of data. However, Report Builder (Downsampled) offers superior performance due to a data set that has been downsampled to 0.1%.

Key information:


Set up a panel for Report Builder data by performing the following steps:

  1. Add a panel to the desired dashboard.
  2. Set the panel's data source to one that points to either Report Builder or Report Builder (Downsampled).
  3. Define the query that determines the set of data that will be reported.
  4. Save your changes.

Please refer to Grafana's documentation for more information on how to add a panel.

Query Settings

Use the following settings to define your query:

Setting Description


Determines the time interval for each data point in the graph.

If you plan on viewing statistics instead of a graph, you should set this option to Entire Time Span.

Use Auto to use a default time interval that varies according to the panel's time span.

Learn more.


Add one or more metric(s) to the graph.

Learn more.

Metrics Filter (Advanced)

Filter data by one or more metric(s) using a JavaScript expression. Specify each metric using its code name (e.g., bytes_out, file_size, and request_count).


Filter data by requests whose size is smaller than 50 bytes via the following syntax:

(file_size < 50)


Adds one or more dimension filter(s) to the graph. Upon selecting a dimension, you must specify a value for filtering the graph's data points.

Set a dimension filter's value to * to include all available values.

Learn more.

Dimensions Filter (Adv.)

Filter data by one or more dimension(s) using a JavaScript expression. Specify each dimension using its code name (e.g., host, status, and root_directory).

Only data that meets all of the conditions defined within the Dimensions and Dimensions (Advanced) options will be included within the report.


Filter data by cache hits via the following syntax:

(cache_status == 'TCP_EXPIRED_HIT' ) || (cache_status == 'TCP_HIT' ) || (cache_status == 'TCP_PARTIAL_HIT')


Determines how metrics will be sorted.

Combine sorting with the Limit option to view a subset of data.


If you only want to view data for requests from your top 10 edge CNAMEs, then you would define the following configuration:

  • Limit: 10
  • Metrics: Requests
  • Dimensions: Edge CNAME
  • Sort: Edge CNAME (Descending Order)

Metric Percentage Mode

Determines whether the graph will map metric data points by value or by percentage. Percentage is calculated by comparing the filtered metric's value against its total value.

Plot Data At

Determines whether data points will be plotted at the start or the end of their corresponding time intervals.

Set this option to End of Time Interval if you have set up alerts within Grafana. This mode will sync your graphed data with the time identified within your alerts.


Let's assume that your report uses 1 hour time intervals (i.e., granularity). This option determines whether all of the data that corresponds to the 10 AM to 11 AM time interval will be plotted as a single point on the graph at 10 AM or 11 AM.