Prometheus Metrics & Grafana Dashboard
Export real-time metrics to your monitoring stack
Prometheus Endpoint
Flowtriq exposes a /api/metrics endpoint in standard Prometheus exposition format. Point your Prometheus scraper at it to pull DDoS detection and traffic metrics into your existing monitoring stack.
Authentication
Authenticate with either a Bearer token or query parameter:
# Bearer token (preferred)
curl -H "Authorization: Bearer YOUR_API_KEY" https://flowtriq.com/api/metrics
# Query parameter
curl https://flowtriq.com/api/metrics?token=YOUR_API_KEY
Available Metrics
| Metric | Type | Description |
|---|---|---|
flowtriq_nodes_total | gauge | Total active nodes in workspace |
flowtriq_nodes_online | gauge | Nodes currently online |
flowtriq_nodes_under_attack | gauge | Nodes currently under attack |
flowtriq_nodes_offline | gauge | Nodes currently offline |
flowtriq_node_pps | gauge | Current PPS per node (labels: node, ip) |
flowtriq_node_bps | gauge | Current BPS per node |
flowtriq_node_tcp_pct | gauge | TCP traffic percentage per node |
flowtriq_node_udp_pct | gauge | UDP traffic percentage per node |
flowtriq_node_icmp_pct | gauge | ICMP traffic percentage per node |
flowtriq_node_connections | gauge | Active connection count per node |
flowtriq_node_baseline_avg_pps | gauge | Baseline average PPS per node |
flowtriq_node_baseline_p95_pps | gauge | Baseline 95th percentile PPS per node |
flowtriq_node_baseline_p99_pps | gauge | Baseline 99th percentile PPS per node |
flowtriq_incidents_active | gauge | Currently active incidents |
flowtriq_incidents_last_24h | gauge | Incidents in the last 24 hours |
flowtriq_mitigation_active_rules | gauge | Active BGP mitigation rules |
flowtriq_mitigation_pending_rules | gauge | Pending mitigation rules |
flowtriq_mitigation_failed_rules | gauge | Failed mitigation rules |
flowtriq_mitigation_adapter_healthy | gauge | Adapter health (1=healthy, 0=down, labels: adapter, type) |
Prometheus Scrape Config
# prometheus.yml
scrape_configs:
- job_name: 'flowtriq'
scheme: https
bearer_token: 'YOUR_API_KEY'
static_configs:
- targets: ['flowtriq.com']
metrics_path: '/api/metrics'
scrape_interval: 30s
Pre-Built Grafana Dashboard
Import our pre-built dashboard JSON for instant visualization of all Flowtriq metrics. Download it from:
https://flowtriq.com/assets/grafana-dashboard.json
Panels Included
- Node Overview: Total nodes, online, under attack, offline, active incidents, 24h incidents
- Traffic Volume: PPS and BPS over time per node with mean/max/current stats
- Protocol Distribution: TCP/UDP/ICMP percentage stacked chart
- Active Connections: Connection count over time per node
- Top Talkers: Top 10 nodes by PPS and BPS (table view)
- PPS vs Baseline: Current PPS overlaid with baseline avg, P95, and P99
- Mitigation Rules: Active, pending, failed, and withdrawn rules over time
- BGP Adapter Health: LCD bar gauge showing healthy/down status per adapter
- Attack Timeline: Active incidents, nodes under attack, and mitigation rules as a combined timeline
The dashboard uses Grafana variable templating for tenant_id and node filtering, so it works across multi-node deployments.
Import Steps
- In Grafana, go to Dashboards → Import
- Paste the JSON from the URL above or upload the file
- Select your Prometheus data source when prompted
- Click Import