Analytics & Usage

The Analytics Dashboard allows you to monitor your consumption, analyze your integration performance, and optimize your API usage.

Overview

Main Metrics

Available Periods

• Last 24 hours
• Last 7 days
• Last 30 days
• This month
• Custom period

Charts

Requests Over Time

Visualization of request count by interval:

Requests / hour (24h)
│
│    ╭──╮
│   ╭╯  ╰╮    ╭─╮
│ ╭─╯    ╰──╮╭╯ ╰╮
│─╯         ╰╯   ╰─────
└─────────────────────────
  00  04  08  12  16  20  24h

Automatic granularity:

• 24h: per hour
• 7d: per hour or per day
• 30d: per day

Distribution by Endpoint

/v1/geocoding/forward       ████████████████████ 75%
/v1/geocoding/autocomplete  ████ 15%
/v1/geocoding/reverse       ██ 8%
/v1/geocoding/batch         ▌ 2%

Distribution by Response Code

200 OK           ████████████████████ 92%
400 Bad Request  ██ 5%
429 Rate Limit   █ 2%
5xx Errors       ▌ 1%

Response Time

Latency (ms)
│
│ P99: 250ms  ─────────────────────────
│ P95: 150ms  ───────────────
│ P50: 45ms   ─────
│ Avg: 52ms   ──────
└─────────────────────────────────────

Filters

By API Key

Filter statistics by specific API key:

All keys ▼
├── production (gck_****)
├── staging (gck_****)
└── dev-local (gck_****)

By Endpoint

All endpoints ▼
├── /v1/geocoding/forward
├── /v1/geocoding/reverse
├── /v1/geocoding/autocomplete
└── /v1/geocoding/batch

By Response Code

All codes ▼
├── 2xx Success
├── 4xx Client Errors
└── 5xx Server Errors

By Origin Country

Filter by request geolocation:

All countries ▼
├── France
├── United States
├── Germany
└── ...

Detailed Logs

Request History

Access the detailed history of each request:

Request Details

Click on a request to see complete details:

Log Retention

Data Export

Available Formats

Export Logs

1. Go to Analytics > Logs
2. Apply desired filters
3. Click "Export"
4. Select the format
5. The file is generated and downloaded

Alerts

Configure an Alert

1. Go to Analytics > Alerts
2. Click "New alert"
3. Configure:
   • Condition: Metric and threshold
   • Frequency: Immediate, hourly, daily
   • Channel: Email, webhook, Slack

Recommended Alert Types

Alert Webhooks

Receive alerts via webhook:

{
  "alert_type": "quota_threshold",
  "threshold": 80,
  "current_value": 82.5,
  "message": "Monthly quota at 82.5% (8,250 / 10,000 requests)",
  "timestamp": "2026-02-23T18:30:00Z",
  "account_id": "acc_xxxxx"
}

Reports

Automatic Reports

Receive periodic reports by email:

Configure Reports

1. Go to Settings > Notifications
2. Enable "Usage reports"
3. Select frequency
4. Choose recipients

Quota Monitoring

Quota Indicator

The dashboard displays in real-time:

Monthly quota
██████████████████░░░░░░░░░░░░ 65%
6,500 / 10,000 requests

Remaining requests: 3,500
Reset: March 1, 2026

Consumption Forecast

Based on your current usage:

End of month projection: 9,800 requests (98%)
Trend: +15% vs previous month

Best Practices

Proactive Monitoring

1. Configure alerts before reaching limits
2. Regularly check usage trends
3. Analyze errors to improve your integration
4. Plan upgrades based on growth

Optimization

• Identify slow or error requests
• Detect recurring error patterns
• Compare performance between API keys
• Monitor unusual traffic spikes

Error Reduction

If you observe a high error rate:

Next Steps