Usage Limits

​

Plan Limits

​

Checking Your Usage

1. Go to Settings > Usage
2. See current period usage:
   • Traces sent
   • Percentage of limit used
   • Days remaining in period

curl https://api.anyway.sh/v1/usage \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "plan": "pro",
  "period": {
    "start": "2024-01-01",
    "end": "2024-01-31"
  },
  "traces": {
    "used": 45000,
    "limit": 100000,
    "percentage": 45
  }
}

​

What Happens When You Hit Limits

​

Trace Limits

1. Warning at 80% - Email notification
2. Warning at 100% - Dashboard notification
3. At limit - New traces are still accepted but:
   • Free: Oldest traces are dropped
   • Pro: Overage charges apply ($0.50/1,000 traces)
   • Enterprise: No overage (unlimited)

​

API Rate Limits

• Requests return 429 Too Many Requests
• Retry after the period shown in Retry-After header
• Consider implementing exponential backoff

import time
import anyway

try:
    anyway.send_trace(trace)
except anyway.RateLimitError as e:
    time.sleep(e.retry_after)
    anyway.send_trace(trace)  # Retry

​

Increasing Limits

​

Upgrade Your Plan

1. Go to Settings > Billing
2. Click Change Plan
3. Select a higher tier

​

Request Custom Limits

• Higher API rate limits
• Extended data retention
• Increased team member limits

​

Optimizing Usage

​

Reduce Trace Volume

anyway.init(sample_rate=0.1)  # 10% sampling

anyway.init(
    trace_filter=lambda span: span.latency > 1000  # Only slow requests
)

anyway.init(
    enabled=os.getenv("ENV") == "production"
)

​

Reduce Data Size

• Avoid tracing large payloads
• Use max_payload_size configuration
• Exclude sensitive/unnecessary fields

​

Usage Alerts

1. Go to Settings > Alerts
2. Create a usage alert:
   • Trigger at 50%, 80%, 90% usage
   • Notify via email or Slack

​

Usage History

1. Go to Settings > Usage
2. Select date range
3. View daily/weekly/monthly breakdown

curl "https://api.anyway.sh/v1/usage/history?start=2024-01-01&end=2024-01-31" \
  -H "Authorization: Bearer YOUR_API_KEY"

​

Next Steps