Installation
To install the Bitmovin Grafana plugin, so you can use the Bitmovin Analytics service as a data source in your Grafana dashboard, you can easily install it using the grafana-cli
with the following command on your grafana server:
1grafana-cli --pluginUrl https://github.com/bitmovin/analytics-grafana-datasource/archive/master.zip plugins install bitmovin-analytics
Then, restart your grafana deployment, using service grafana-server restart
, or if you are using docker, restart the container using docker restart YOUR_GRAFANA_CONTAINER_NAME
.
If you don't yet have a Grafana setup, please visit https://grafana.com/get for further instructions.
Configuration
Once the plugin got installed successfully, you can add Bitmovin Analytics as a new Data Source
to your deployment. Go to your Data Source Configuration overview at https://your-grafana-domain.com:3000
/datasources/new (Configuration => Data Sources => Add new Data Source)
- Select "Bitmovin Analytics" as Data Source
Type
- Enter your Bitmovin API Key in "Api Key" (required)
All the other fields will be filled automatically.
Usage Examples
Graph View
Add a new graph to your dashboard and select Bitmovin Analytics
as a Data Source. Then you will be presented with an editor to build your analytics query for your Bitmovin Analytics account, which result will be used for the view. The editor works the same way as our Bitmovin Analytics API Explorer which is available in our ydashboard at https://bitmovin.com/dashboard/analytics/data.
Other Graph types
As Grafana is capable to render multiple data sets in one graph, you can easily combine the results of two analtyics queries as well,
or simply list view them as a table, e.g. to get a quick overview about the top browser usages.