Analytics - Anchora VaaS Documentation

Dashboard Analytics

The Anchora dashboard provides real-time visibility into your usage:

Records Anchored: Total and daily anchoring volume
API Calls: Request counts by endpoint
Confirmation Times: Average blockchain confirmation speed
Error Rates: Failed requests and their causes
Cost Tracking: Current usage vs. plan limits

Analytics API

Programmatically access your analytics data using the /v1/analytics endpoints.

Get Usage Summary

Get usage summary

curl -X GET "https://api.anchora.io/v1/analytics/usage?period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "period": {
    "start": "2024-01-01T00:00:00Z",
    "end": "2024-01-31T23:59:59Z"
  },
  "summary": {
    "totalRecords": 15420,
    "totalApiCalls": 18650,
    "successRate": 99.8,
    "avgConfirmationTime": "42s"
  },
  "breakdown": {
    "byEndpoint": {
      "/v1/anchor/encrypted": 12500,
      "/v1/anchor/batch": 2420,
      "/v1/records": 3730
    },
    "byStatus": {
      "CONFIRMED": 15380,
      "PENDING": 25,
      "FAILED": 15
    }
  }
}

Get Daily Metrics

Get daily time series

curl -X GET "https://api.anchora.io/v1/analytics/timeseries?metric=records&granularity=day&period=7d" \
  -H "Authorization: Bearer YOUR_API_KEY"

Available Metrics

Metric	Description	Granularity
`records`	Number of records anchored	hour, day, week, month
`api_calls`	Total API requests	hour, day, week, month
`errors`	Failed API requests	hour, day, week, month
`latency`	API response time (p50, p95, p99)	hour, day
`confirmation_time`	Blockchain confirmation duration	hour, day

Rate Limit Headers

Every API response includes headers to help you monitor rate limits:

Rate limit headers

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 985
X-RateLimit-Reset: 1706745600
X-RateLimit-Window: 3600

Alerts and Notifications

Configure alerts in your dashboard to get notified when:

Usage approaches plan limits (80%, 90%, 100%)
Error rate exceeds threshold
Confirmation times are unusually slow
API rate limits are being hit

Pro Tip: Set up Slack or email alerts for usage thresholds to avoid unexpected service interruptions.

Exporting Data

Export analytics data for external analysis:

CSV Export: Download from dashboard
API Export: Use format=csv query parameter
Webhook: Send daily/weekly summaries to your endpoint