sentry-load-scale

name	sentry-load-scale
description	Scale Sentry for high-traffic applications handling millions of events per day. Use when optimizing SDK performance at high volume, implementing adaptive sampling, managing quotas and costs at scale, or deploying Sentry across multi-region infrastructure. Trigger with phrases like "sentry high traffic", "scale sentry", "sentry millions events", "sentry high volume", "sentry quota management", "sentry load test".
allowed-tools	Read, Write, Edit, Grep, Bash(node:*), Bash(npx:*), Bash(k6:*)
version	1.51.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","sentry","performance","scaling","high-traffic","enterprise"]
compatibility	Designed for Claude Code

Sentry Load & Scale

Overview

Configure Sentry for applications processing 1M+ requests/day without sacrificing error visibility, burning through quota, or adding measurable SDK overhead. Covers adaptive sampling, connection pooling, multi-region tagging, quota management, SDK benchmarking, batch submission, load testing, and self-hosted deployment considerations.

Prerequisites

• Application handling sustained high traffic (>10K requests/min or >1M events/day)
• Sentry organization with quota and billing access (Settings > Subscription)
• @sentry/node v8+ installed (npm ls @sentry/node)
• Performance baseline established (p50/p95/p99 latency without Sentry)
• Event volume estimates calculated per category (errors, transactions, replays, attachments)

Instructions

Step 1 — Implement Adaptive Sampling

Static tracesSampleRate wastes quota at scale because it treats a health check the same as a checkout. Replace it with a traffic-aware tracesSampler that adjusts rates based on endpoint criticality and current load.

Traffic-aware tracesSampler:

import * as Sentry from '@sentry/node';

// Track request volume per endpoint for adaptive rate adjustment
const endpointVolume = new Map<string, { count: number; resetAt: number }>();
const WINDOW_MS = 60_000;

function getAdaptiveRate(name: string, baseRate: number): number {
  const now = Date.now();
   entry = endpointVolume.(name);

   (!entry || now > entry.) {
    entry = { : , : now +  };
    endpointVolume.(name, entry);
  }
  entry.++;

  
  
  
  
   (entry. > )  baseRate * ;
   (entry. > )  baseRate * ;
   baseRate;
}

.({
  : process..,

  :  {
     { name, parentSampled } = samplingContext;

    
     (parentSampled !== )  parentSampled ?  : ;

    
     (name?.())  ;
     (name?.())  ;

    
     (name?.() || name?.())  ;
     (name?.())  (, );

    
     (name?.())  (name, );
     (name?.())   (name, );
     (name?.())  (name, );

    
     (name?.())  (name, );

    
     (name?.() || name?.()) {
       (name, );
    }

    
     (name || , );
  },
});