Skip to main content

View WAAP statistics in Grafana

The CDB Platform-EN data source connects Grafana to Edge Network statistics, including WAAP traffic and request analytics, through a single plugin and query editor. Select WAAP as the service, then build time-series panels for protected domains. Grafana 12.0.0 or higher and an API token are required.

The same data source also covers CDN, DNS, and CDB EdgeCompute. For the full Edge Network setup and those services, see View Edge Network statistics in Grafana.

The previous WAAP-only plugin (Waap / waap-stats-datasource-plugin) is deprecated as of July 25, 2026. Migrate dashboards to CDB Platform-EN before that date.

Download and install the plugin

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

  1. Download the latest gcore-stats-datasource-plugin.zip from the repository release folder.

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

    • Linux/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 empty to use the default host, or enter a hostname only with no scheme or path — api.cdb-staging.cdn.orange.com.
    • API key — paste an API token from the CDB Technical Web 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.

Configure a dashboard

With the data source connected, create a panel and select WAAP to query protection traffic metrics.

  1. In the Grafana main menu, click + > Dashboard, then Add visualization.

  2. In the data source dropdown, select CDB Platform-EN.

  3. In the query editor, under Edge Network, set Service to WAAP. The query fields update for WAAP.

  4. Configure the WAAP query:

    • Metric — total_requests (HTTP requests processed by WAAP across protected domains) or total_bytes (traffic volume in kilobytes)
    • Granularity — 1h (one data point per hour) or 1d (one data point per day)
    • Legend Format — optional series label template

  5. Click Apply to add the panel.

  6. Click Save dashboard, enter a name, and click Save.

Grafana Alerting

Because CDB Platform-EN is a backend data source with alerting enabled, WAAP panel queries can back Grafana Alerting rules. Create an alert rule from the query and use Grafana expressions (Reduce, Math, Threshold) to turn the time series into a condition.