Skip to main content
The Gcore WAAP datasource plugin for Grafana lets security and DevOps teams visualize traffic statistics for WAAP-protected domains directly in Grafana dashboards. It connects to the Gcore WAAP Statistics API and renders time-series panels without requiring any manual API calls. The plugin supports the following metrics:
  • Total Requests — the number of HTTP requests processed by WAAP across protected domains within the selected time range.
  • Total Bytes — the total volume of traffic, displayed in kilobytes (KB).
Metrics can be queried at two granularity levels:
  • 1h — one data point per hour.
  • 1d — one data point per day.
The plugin requires Grafana 10.4.0 or higher.

​
Download and install the plugin

  1. Get the plugin from the GitHub repository using either method:
    • Clone the repository: run git clone https://github.com/G-Core/waap-stats-datasource-plugin.git in a terminal.
    • Download as ZIP: on the GitHub page, click Code > Download ZIP, then extract the archive.
  2. Copy the gcorelabs-waap-stats-datasource folder into the Grafana plugins directory. The default location is:
    • Linux/macOS: /var/lib/grafana/plugins
    • Windows: C:\Program Files\GrafanaLabs\grafana\data\plugins
  3. Restart Grafana to load the new plugin.

​
Configure the data source

After installing the plugin, add it as a data source in Grafana and authenticate it with a Gcore API token.
  1. Log in to Grafana, then open the main menu and navigate to Connections > Data sources.
  2. Click Add new data source.
  3. Search for Waap and select the Waap plugin from Gcore.
  4. In the WAAP API section, fill in the configuration fields:
    • API URL (host only) — enter api.gcore.com. Change this only if connecting to a dedicated or on-premises Gcore API endpoint.
    • Authorization header value — enter the permanent API token generated in the Gcore Customer Portal. The value must include the APIKey prefix: 
      APIKey 7711$eyJ0eXAiOiJKV1Q...
    To generate a token, log in to the Gcore Customer Portal and navigate to Profile > API tokens > Create.
  5. Click Save & Test.

A successful connection displays a confirmation message with the authenticated account name. If the test fails, verify that the API token is valid and includes the APIKey prefix.

​
Configure a dashboard

With the data source connected, create a dashboard panel to visualize WAAP metrics.
  1. In the Grafana main menu, click + > New dashboard, then click Add visualization.
  2. In the Data source dropdown at the top of the query editor, select Waap.
  3. In the query editor, configure the query:
    • Metric — select the metric to display:
      • total_requests — renders the request count over time.
      • total_bytes — renders traffic volume in KB over time.
    • Granularity — select the time resolution:
      • 1h — one data point per hour.
      • 1d — one data point per day.
  4. Click Apply to add the panel to the dashboard.
  5. To save the dashboard, click Save dashboard in the upper-right corner, enter a name, and click Save.