View Edge Network statistics in Grafana

The CDB Platform-EN data source connects Grafana to Edge Network statistics through a single plugin and query editor. Select a service — CDN, DNS, CDB EdgeCompute, or WAAP — then build time-series panels from the matching CDB APIs. Grafana 12.0.0 or higher and an API token are required.

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

Supported services:

CDN — delivery traffic, bandwidth, cache efficiency, and request statistics
DNS — authoritative DNS traffic per zone and record type
CDB EdgeCompute — application latency and performance metrics
WAAP — web application and API protection traffic and request analytics

Download and install the plugin

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

Download the latest gcore-stats-datasource-plugin.zip from the repository release folder.
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.
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
```
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.

In the Grafana main menu, navigate to Connections > Data sources.
Click Add new data source.
Search for CDB and select CDB Platform-EN.
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.
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 pick the Edge Network service to query.

In the Grafana main menu, click + > Dashboard, then Add visualization.
In the data source dropdown, select CDB Platform-EN.
In the query editor, under Edge Network, select the Service: CDN, DNS, CDB EdgeCompute, or WAAP. The fields below update for that service.
Configure the service-specific query fields, then click Apply to add the panel.
Click Save dashboard, enter a name, and click Save.

The following sections describe the query fields for each service.

CDN

CDN queries cover delivery traffic, cache efficiency, and request or response trends. Metrics, granularity, and grouping match the CDN statistics API.

Metrics

Metric in the plugin	Description
`total_bytes`	Total traffic volume: origin to CDN or Shielding, Shielding to CDN, and CDN to users
`cache_hit_traffic_ratio`	Share of cached traffic: `1 - (origin or Shielding traffic / CDN-to-user traffic)`
`sent_bytes`	Edges traffic: Shielding to CDN plus CDN to users
`shield_bytes`	Traffic from Shielding to CDN
`upstream_bytes`	Origin traffic: origin to CDN or origin to Shielding
`requests`	Number of requests to the CDN
`responses_2xx`, `responses_3xx`, `responses_4xx`, `responses_5xx`	Response counts by status class
`bandwidth`	Bandwidth derived from total traffic
`cache_hit_requests_ratio`	Share of responses served from cache
`shield_traffic_ratio`	Shielding efficiency: `(Shielding-to-CDN traffic - origin-to-Shielding traffic) / Shielding-to-CDN traffic`
`image_processed`	Number of processed images

Granularity: 5m, 15m, 1h, or 1d.

Group by: resource, client, region, country, dc (data center), or vhost (custom domain). Multiple groupings can be selected.

Filters (comma-separated): optional Vhosts, Resources, Clients, Regions, and Countries fields narrow the series.

Legend Format: by default the legend uses the group-by values and metric name. Customize it with placeholders in double curly braces that match the selected grouping — Traffic — {{resource}}.

DNS

DNS queries show authoritative traffic across zones and record types so query volume and load can be monitored per zone.

Zone — a specific zone, or All Zones
Granularity — 5m, 10m, 15m, 30m, 1h, 1.5h, 2h45m, or 24h
Record type — ALL, A, AAAA, NS, CNAME, MX, TXT, SVCB, or HTTPS
Legend Format — optional series label template

CDB EdgeCompute

CDB EdgeCompute queries expose application duration metrics so latency can be compared across apps and networks.

App — a specific application, or All
Metric — avg, min, max, median, perc75, or perc90
Step — sampling interval in seconds
Network — optional network name filter
Legend Format — optional series label template

WAAP

WAAP queries surface protection traffic and request volume for protected domains over time.

Metric — total_requests or total_bytes
Granularity — 1h or 1d
Legend Format — optional series label template

Dashboard variables

Dashboard variables can drive CDN filters so the same panel switches between resources, clients, or other dimensions without editing the query.

Open dashboard settings (gear icon), go to Variables, and click Add variable.
Configure the variable. For CDN resource filtering:
- Name — variable name used in the query
- Query type / Values for — select the CDN dimension exposed by the plugin (resource, client, vhost, region, country, or datacenter)
- Optional Sort and Selection options (Multi-value, Include All option)
Return to the dashboard and enter the variable in the matching CDN filter field with a $ prefix — $resource in Resources.
Save the dashboard.

Grafana Alerting

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