Skip to content

Easily visualize your video analytics data in your Grafana dashboard using our new Grafana plugin so Bitmovin Analytics can be used as a Data Source in your Grafana deployment

License

Notifications You must be signed in to change notification settings

bitmovin/analytics-grafana-datasource

Repository files navigation

Bitmovin Analytics Grafana Plugin

Plugin that allows you to connect Bitmovin Analytics solution into your Grafana dashboards.

Setup

Add the datasource

Add the plugin and acquire your Bitmovin Analytics API key from the bitmovin dashboard.

Configure the datasource:

Setting Value
URL https://api.bitmovin.com/v1
API Key Your API key
Ad Analytics If checked, the datasource is switched to query ads data

Optionally add your Tenant Org Id which you can also get from the bitmovin dashboard.

Add example dashboard

See the example_dashboard.json for a demo. Configure the datasource with your Api Key and select a license key in each panel.

Time Series Graph

Add a new panel and select the bitmovin analytics datasource. Configure the metric with following settings:

Setting Description
License* Your analytics license
Metric* Aggregation method to use, e.g. count, sum
Dimension* Dimension to aggregate over
Filter Apply filters to the query
Format as time series* Check the switch to see time series data
Group By Group query by dimension and plot as individual time series
Order By Order query ascending or descending by dimension
Limit Limit the result to given number
Interval* Time granularity of queries, select AUTO to automatically adapt to selected time range
Alias By Set the name of series (only visible with multiple queries in one Graph)

Settings marked with * are required for the time series graph.

Grouped Time Series

To compare e.g. impressions per browser, we provide the Group By attribute to group the results by specific dimensions and plot them as individual time series. Multiple Group Bys are supported for time series.

Tables

Configure the metric as described in Time Series Graph but uncheck the Format as time series option and add a Group By dimension. It is recommended to add a limit (e.g. 10).

Gauges

Configure the Gauge's Value Options, depending on your query.

  • For table data (Format as time series option unchecked) for the Show option select All Values.
  • For time series data (Format as time series option checked) for the Show option select Calculate and choose a reducer function.

Support

Please refer to our Documentation and Analytics Api Reference for more information or reach out to us at bitmovin.com.


Development

This project was generated with yarn create @grafana/plugin@4.3.0.

Frontend

  1. Install dependencies

    yarn install
  2. Build plugin in development mode and run in watch mode

    yarn run dev
  3. Build plugin in production mode

    yarn run build
  4. Run the tests (using Jest)

    # Runs the tests and watches for changes, requires git init first
    yarn run test
    
    # Exits after running all the tests
    yarn run test:ci
  5. Spin up a Grafana instance and run the plugin inside it (using Docker)

    yarn run server
  6. Run the E2E tests (using Playwright)

    # Spins up a Grafana instance first that we tests against
    yarn run server
    
    # Starts the tests
    yarn run e2e
  7. Run the linter

    yarn run lint
    
    # or
    
    yarn run lint:fix

About

Easily visualize your video analytics data in your Grafana dashboard using our new Grafana plugin so Bitmovin Analytics can be used as a Data Source in your Grafana deployment

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published