---
title: "DNS Metrics & Analytics"
description: "Monitor DNS query volume, latency, and response patterns across your zones."
url: https://edge.network/docs/dns/metrics/
---

# DNS Metrics & Analytics

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:

1m
Minute-level data
24 hours
1h
Hourly aggregates
7 days
1d
Daily aggregates
90 days

## Viewing Metrics

1 Navigate to your zone

Go to DNS → select your domain

2 Click the Metrics tab

View charts and statistics for your zone

3 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.

## Related Topics

[Zone Management Create and configure zones](https://edge.network/docs/dns/zones) [Geographic Routing Route traffic by location](https://edge.network/docs/dns/geo-routing)
[Back to Docs](https://edge.network/docs) [Need help?](https://edge.network/support)