Analytics

Metrics & Analytics

Edge DNS provides detailed metrics on query volume, response times, and traffic patterns to help you understand how your domains are being used.

Available Metrics

Query Count

Total number of DNS queries received for your zone, broken down by time period.

Latency

Average and maximum response times in microseconds. Typical resolution is under 10ms.

Query Types

Breakdown by record type (A, AAAA, MX, TXT, etc.) to understand query patterns.

Response Codes

Distribution of response types: NOERROR, NXDOMAIN, REFUSED, etc.

Geographic Distribution

Query volume by country based on resolver location (GeoIP).

Node Distribution

Which Edge nodes handled your queries, showing traffic distribution.

Time Ranges

View metrics at different granularities based on your analysis needs:

Range	Granularity	Data Points
Last Hour	1 minute	~60 points
Last 24 Hours	1 minute	~1,440 points
Last 7 Days	1 hour	~168 points
Last 30 Days	1 day	~30 points

Data Retention

Metrics are automatically aggregated and pruned to optimize storage while maintaining useful historical data:

Minute-level data

24 hours

Hourly aggregates

7 days

Daily aggregates

90 days

Viewing Metrics

Navigate to your zone

Go to DNS → select your domain

Click the Metrics tab

View charts and statistics for your zone

Select time range

Choose 1h, 24h, 7d, or 30d to adjust the view

API Access

Fetch metrics programmatically for custom dashboards or monitoring:

# Get zone metrics

GET /api/dns/zones/:id/metrics?range=24h

# Response
{
  "metrics": {
    "zone": "example.com",
    "from": "2024-01-14T00:00:00Z",
    "to": "2024-01-15T00:00:00Z",
    "granularity": "1m",
    "data": [
      {
        "timestamp": "2024-01-14T00:00:00Z",
        "queryCount": 1234,
        "byType": { "A": 800, "AAAA": 300, "MX": 134 },
        "byResponse": { "NoError": 1200, "NXDomain": 34 },
        "byCountry": { "US": 500, "GB": 300, "DE": 200 },
        "latencyAvgUs": 2500,
        "latencyMaxUs": 15000
      }
    ]
  }
}

# Get account-wide DNS stats

GET /api/dns/stats

# Response
{
  "stats": {
    "totalQueries": 1234567,
    "avgLatencyMs": 8,
    "zoneCount": 5,
    "recordCount": 47
  }
}

Common Use Cases

Traffic Monitoring

Track query volume over time to understand traffic patterns and identify unexpected spikes that might indicate issues or attacks.

Performance Analysis

Monitor latency metrics to ensure DNS resolution stays fast. Investigate if max latency spikes occur during high traffic periods.

Error Detection

Watch response code distribution. High NXDOMAIN rates might indicate misconfigurations or broken links pointing to non-existent subdomains.

Geographic Insights

See where your users are located based on query origins. Useful for planning geo-routing or understanding your audience.