Skip to main content

Install the Grafana plugin

Grafana lets you bring metrics from different services into dashboards to monitor performance and analyze trends. To include statistics from Orange's CDN, DNS, CDB EdgeCompute, and WAAP, install the CDB Platform-EN plugin.

The plugin requires Grafana 12.0.0 or later and a CDB API token.

The CDN-only plugin (cdn-stats) and the WAAP-only plugin (Waap) are deprecated. Migrate existing dashboards to CDB Platform-EN.

Download and install the plugin

Install the plugin from the GitHub repository, then restart Grafana so it can load the data source.

  1. Download the latest plugin archive from the repository release folder.

  2. Extract the archive into the Grafana plugins directory. Default locations:

    • Linux and macOS: /var/lib/grafana/plugins
    • Windows: C:\Program Files\GrafanaLabs\grafana\data\plugins

    The plugin folder name must be gcore-stats-datasource-plugin.

  3. If Grafana blocks unsigned plugins, allow this plugin ID in the Grafana configuration file (custom.ini or grafana.ini):

    [plugins]
allow_loading_unsigned_plugins = gcore-stats-datasource-plugin

  4. Restart Grafana and sign in.

Configure the data source

After installation, add CDB Platform-EN as a data source and authenticate it with a CDB API token.

  1. In the Grafana main menu, navigate to Connections > Data sources.

  2. Click Add new data source.

  3. Search for CDB and select CDB Platform-EN.

  4. Configure the connection fields:

    • URL: leave the field empty to call https://api.cdb-staging.cdn.orange.com. A custom value is a hostname only, with no scheme or path, and api.cdb-staging.cdn.orange.com is the production host written that way.
    • API key: paste an API token from the CDB Customer Portal (Profile > API tokens > Create). The raw token is enough; the plugin adds the APIKey prefix when needed. A value that already includes APIKey or Bearer is also accepted.

  5. Click Save & Test.

A successful test confirms authentication with the account name. If the test fails, verify the token and that the URL is a hostname only.

The data source charts CDN statistics, DNS statistics, CDB EdgeCompute statistics, and WAAP statistics. An alert rule on one of those queries changes state when a value crosses a threshold.