load test cache miss

test/loadtest.go

@@ -1,9 +1,10 @@
 package main
 
 import (
+	"context"
 	"flag"
 	"fmt"
-	"io/ioutil"
+	"io"
 	"log"
 	"math"
 	"math/rand"
@@ -14,16 +15,30 @@ import (
 	"strconv"
 	"strings"
 	"sync"
+	"sync/atomic"
 	"time"
 )
 
-// Response struct to track which server handled the request
+// CacheStatus tracks edge/CDN cache outcome
+type CacheStatus string
+
+const (
+	CacheHit     CacheStatus = "HIT"
+	CacheMiss    CacheStatus = "MISS"
+	CacheUnknown CacheStatus = "UNKNOWN"
+)
+
+// Response tracks the result of an individual HTTP request
 type Response struct {
-	StatusCode int
+	StatusCode  int
-	Body       string
+	BodyLength  int
-	Duration   time.Duration
+	Duration    time.Duration
-	Error      error
+	Error       error
-	Page       int
+	Page        int
+	Endpoint    string
+	CacheStatus CacheStatus
+	URL         string
+	Attempt     int
 }
 
 type pageBucket struct {
@@ -31,6 +46,60 @@ type pageBucket struct {
 	weight float64
 }
 
+type endpointBucket struct {
+	endpoint string
+	weight   float64
+}
+
+// PercentileStats holds distribution percentiles
+type PercentileStats struct {
+	Count   int
+	Min     time.Duration
+	P50     time.Duration
+	P75     time.Duration
+	P90     time.Duration
+	P95     time.Duration
+	P99     time.Duration
+	Max     time.Duration
+	Average time.Duration
+}
+
+// Static dataset pools for query permutations
+var (
+	teamAbbrs = []string{
+		"ATL", "BOS", "BKN", "CHA", "CHI", "CLE", "DAL", "DEN", "DET", "GSW",
+		"HOU", "IND", "LAC", "LAL", "MEM", "MIA", "MIL", "MIN", "NOP", "NYK",
+		"OKC", "ORL", "PHI", "PHX", "POR", "SAC", "SAS", "TOR", "UTA", "WAS",
+	}
+
+	seasons = []int{2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025}
+
+	advancedSortFields = []string{
+		"winShares", "vorp", "per", "tsPercent", "threePAR", "ftr",
+		"offensiveRBPercent", "defensiveRBPercent", "totalRBPercent",
+		"assistPercent", "stealPercent", "blockPercent", "turnoverPercent",
+		"usagePercent", "offensiveWS", "defensiveWS", "winSharesPer",
+		"offensiveBox", "defensiveBox", "box", "games", "minutesPlayed", "age",
+	}
+
+	totalsSortFields = []string{
+		"points", "assists", "rebounds", "steals", "blocks", "games",
+		"minutesPlayed", "turnovers", "fieldGoals", "threePoints", "freeThrows",
+	}
+
+	gameAssociations = []string{
+		"lineScores", "playerGameBasicStats", "playerGameAdvStats",
+		"teamGameBasicStats", "teamGameAdvStats",
+	}
+
+	pageSizes = []int{10, 20, 25, 30, 40, 50}
+
+	playerIDs = []string{
+		"curryst01", "jamesle01", "antetgi01", "jokicni01", "doncilu01",
+		"tatumja01", "embiijo01", "duranke01", "butleji01", "moranja01",
+	}
+)
+
 func parsePageMix(spec string) ([]pageBucket, error) {
 	if strings.TrimSpace(spec) == "" {
 		return nil, nil
@@ -82,6 +151,32 @@ func parsePageMix(spec string) ([]pageBucket, error) {
 	return buckets, nil
 }
 
+func parseEndpointMix(spec string) ([]endpointBucket, error) {
+	if strings.TrimSpace(spec) == "" {
+		return nil, nil
+	}
+
+	var buckets []endpointBucket
+	for _, rawEntry := range strings.Split(spec, ",") {
+		entry := strings.TrimSpace(rawEntry)
+		parts := strings.Split(entry, ":")
+		if len(parts) != 2 {
+			return nil, fmt.Errorf("invalid endpoint mix entry %q: expected endpoint:weight", entry)
+		}
+		endpoint := strings.TrimSpace(parts[0])
+		if !strings.HasPrefix(endpoint, "/") {
+			endpoint = "/api/" + endpoint
+		}
+
+		weight, err := strconv.ParseFloat(strings.TrimSpace(parts[1]), 64)
+		if err != nil || weight <= 0 || math.IsNaN(weight) || math.IsInf(weight, 0) {
+			return nil, fmt.Errorf("invalid weight %q for endpoint %q", parts[1], endpoint)
+		}
+		buckets = append(buckets, endpointBucket{endpoint: endpoint, weight: weight})
+	}
+	return buckets, nil
+}
+
 func selectPages(buckets []pageBucket, count int, seed int64) []int {
 	pages := make([]int, count)
 	if len(buckets) == 0 || count == 0 {
@@ -108,6 +203,26 @@ func selectPages(buckets []pageBucket, count int, seed int64) []int {
 	return pages
 }
 
+func selectEndpoint(buckets []endpointBucket, rng *rand.Rand) string {
+	if len(buckets) == 0 {
+		return ""
+	}
+	totalWeight := 0.0
+	for _, bucket := range buckets {
+		totalWeight += bucket.weight
+	}
+
+	target := rng.Float64() * totalWeight
+	cumulativeWeight := 0.0
+	for _, bucket := range buckets {
+		cumulativeWeight += bucket.weight
+		if target < cumulativeWeight {
+			return bucket.endpoint
+		}
+	}
+	return buckets[0].endpoint
+}
+
 func urlForPage(base url.URL, page int) string {
 	query := base.Query()
 	query.Set("page", strconv.Itoa(page))
@@ -115,15 +230,201 @@ func urlForPage(base url.URL, page int) string {
 	return base.String()
 }
 
+// RequestOptions configures dynamic URL and request generation
+type RequestOptions struct {
+	BaseURL     url.URL
+	Page        int
+	VaryParams  bool
+	Complexity  string
+	CacheBust   bool
+	EndpointMix []endpointBucket
+	RequestID   int
+	WorkerID    int
+	RNG         *rand.Rand
+}
+
+// GenerateRequestURL builds a customized URL based on options and randomness
+func GenerateRequestURL(opts RequestOptions) string {
+	targetURL := opts.BaseURL
+
+	// If endpoint mix is configured, choose target endpoint
+	if len(opts.EndpointMix) > 0 {
+		ep := selectEndpoint(opts.EndpointMix, opts.RNG)
+		targetURL.Path = ep
+	}
+
+	query := targetURL.Query()
+
+	if opts.Page > 0 {
+		query.Set("page", strconv.Itoa(opts.Page))
+	} else if opts.VaryParams {
+		// Random page 1-20
+		query.Set("page", strconv.Itoa(opts.RNG.Intn(20)+1))
+	}
+
+	path := strings.ToLower(targetURL.Path)
+
+	if opts.VaryParams {
+		// Randomize pageSize
+		query.Set("pageSize", strconv.Itoa(pageSizes[opts.RNG.Intn(len(pageSizes))]))
+
+		// Randomize ascending
+		query.Set("ascending", strconv.FormatBool(opts.RNG.Intn(2) == 1))
+
+		// Randomize season (70% chance to filter by season)
+		if opts.RNG.Float64() < 0.70 {
+			query.Set("season", strconv.Itoa(seasons[opts.RNG.Intn(len(seasons))]))
+		}
+
+		// Randomize team filter (50% chance)
+		if opts.RNG.Float64() < 0.50 {
+			query.Set("team", teamAbbrs[opts.RNG.Intn(len(teamAbbrs))])
+		}
+
+		// Randomize isPlayoff (30% chance)
+		if opts.RNG.Float64() < 0.30 {
+			query.Set("isPlayoff", strconv.FormatBool(opts.RNG.Intn(2) == 1))
+		}
+
+		// Endpoint specific parameters
+		if strings.Contains(path, "playeradvanced") {
+			query.Set("sortBy", advancedSortFields[opts.RNG.Intn(len(advancedSortFields))])
+			if opts.Complexity == "high" && opts.RNG.Float64() < 0.30 {
+				query.Set("playerId", playerIDs[opts.RNG.Intn(len(playerIDs))])
+			}
+		} else if strings.Contains(path, "playertotal") {
+			query.Set("sortBy", totalsSortFields[opts.RNG.Intn(len(totalsSortFields))])
+			if opts.Complexity == "high" && opts.RNG.Float64() < 0.30 {
+				query.Set("playerId", playerIDs[opts.RNG.Intn(len(playerIDs))])
+			}
+		} else if strings.Contains(path, "game") {
+			query.Set("sortBy", "date")
+			if opts.Complexity == "high" {
+				// Random subset of 1 to 4 preloaded associations to stress joins
+				numAssoc := opts.RNG.Intn(3) + 1
+				perm := opts.RNG.Perm(len(gameAssociations))
+				var chosen []string
+				for i := 0; i < numAssoc; i++ {
+					chosen = append(chosen, gameAssociations[perm[i]])
+				}
+				query.Set("include", strings.Join(chosen, ","))
+			}
+		} else if strings.Contains(path, "shotchart") {
+			if opts.RNG.Float64() < 0.60 {
+				query.Set("playerId", playerIDs[opts.RNG.Intn(len(playerIDs))])
+			}
+		}
+	}
+
+	if opts.CacheBust {
+		// Unique high-resolution nonce guaranteed to miss CDN / reverse-proxy cache
+		nonce := fmt.Sprintf("%d_%d_%d", time.Now().UnixNano(), opts.WorkerID, opts.RequestID)
+		query.Set("_cb", nonce)
+	}
+
+	targetURL.RawQuery = query.Encode()
+	return targetURL.String()
+}
+
+// ExtractCacheStatus parses response headers to identify cache state
+func ExtractCacheStatus(headers http.Header) CacheStatus {
+	// 1. Cloudflare CF-Cache-Status
+	if cf := strings.ToUpper(headers.Get("CF-Cache-Status")); cf != "" {
+		switch cf {
+		case "HIT":
+			return CacheHit
+		case "MISS", "EXPIRED", "DYNAMIC", "BYPASS", "REVALIDATED":
+			return CacheMiss
+		}
+	}
+
+	// 2. Fastly / Varnish / Nginx X-Cache or X-Cache-Status
+	if xc := strings.ToUpper(headers.Get("X-Cache-Status")); xc != "" {
+		if strings.Contains(xc, "HIT") {
+			return CacheHit
+		}
+		if strings.Contains(xc, "MISS") {
+			return CacheMiss
+		}
+	}
+	if xc := strings.ToUpper(headers.Get("X-Cache")); xc != "" {
+		if strings.Contains(xc, "HIT") {
+			return CacheHit
+		}
+		if strings.Contains(xc, "MISS") {
+			return CacheMiss
+		}
+	}
+
+	// 3. Age header (standard HTTP caching: Age > 0 implies served from cache)
+	if ageStr := headers.Get("Age"); ageStr != "" {
+		if ageVal, err := strconv.Atoi(ageStr); err == nil && ageVal > 0 {
+			return CacheHit
+		}
+	}
+
+	return CacheUnknown
+}
+
+// CalculatePercentiles computes key percentile distributions from durations
+func CalculatePercentiles(durations []time.Duration) PercentileStats {
+	n := len(durations)
+	if n == 0 {
+		return PercentileStats{}
+	}
+
+	sorted := make([]time.Duration, n)
+	copy(sorted, durations)
+	sort.Slice(sorted, func(i, j int) bool { return sorted[i] < sorted[j] })
+
+	var sum time.Duration
+	for _, d := range sorted {
+		sum += d
+	}
+
+	getPercentile := func(p float64) time.Duration {
+		if n == 1 {
+			return sorted[0]
+		}
+		rank := p * float64(n-1)
+		idx := int(math.Floor(rank))
+		if idx >= n-1 {
+			return sorted[n-1]
+		}
+		frac := rank - float64(idx)
+		return sorted[idx] + time.Duration(float64(sorted[idx+1]-sorted[idx])*frac)
+	}
+
+	return PercentileStats{
+		Count:   n,
+		Min:     sorted[0],
+		P50:     getPercentile(0.50),
+		P75:     getPercentile(0.75),
+		P90:     getPercentile(0.90),
+		P95:     getPercentile(0.95),
+		P99:     getPercentile(0.99),
+		Max:     sorted[n-1],
+		Average: sum / time.Duration(n),
+	}
+}
+
 func main() {
-	// Define command line flags
+	// Command line flags
 	numRequests := flag.Int("n", 100, "Number of requests to send")
 	concurrency := flag.Int("c", 10, "Number of concurrent requests")
-	endpoint := flag.String("url", "http://localhost:8080/api/player/advanced", "API endpoint to test")
+	endpoint := flag.String("url", "http://localhost:5000/api/playeradvancedstats", "API endpoint to test")
 	logFile := flag.String("log", "loadtest.log", "Log file path")
 	apiKey := flag.String("key", "", "API key for x-api-key header")
+	benchmarkKey := flag.String("benchmarkKey", "", "Benchmark key for X-Benchmark-Key header (bypasses rate limiting)")
 	pageMix := flag.String("pageMix", "", "Weighted page mix, for example 1-3:60,4-10:30,11-20:10")
-	seed := flag.Int64("seed", -1, "Random seed for page selection (-1 uses the current time)")
+	varyParams := flag.Bool("varyParams", false, "Randomize query parameters (season, team, sortBy, pageSize, etc.)")
+	complexity := flag.String("complexity", "standard", "Query complexity level: standard, high")
+	cacheBust := flag.Bool("cacheBust", false, "Append unique query nonce to guarantee 100% cold-cache misses")
+	rotateIPs := flag.Bool("rotateIPs", false, "Rotate synthetic client IPs (X-Real-IP / X-Forwarded-For) to simulate distributed traffic")
+	retryOnRateLimit := flag.Bool("retryOnRateLimit", false, "Retry requests that receive 429 Too Many Requests with backoff")
+	endpointMix := flag.String("endpointMix", "", "Weighted multi-endpoint mix, for example playeradvancedstats:40,playertotals:30,games:30")
+	timeout := flag.Duration("timeout", 30*time.Second, "HTTP request timeout per request")
+	seed := flag.Int64("seed", -1, "Random seed (-1 uses current timestamp)")
 	flag.Parse()
 
 	if *numRequests <= 0 {
@@ -133,18 +434,25 @@ func main() {
 		log.Fatal("Concurrency must be greater than zero")
 	}
 
+	// Read BENCHMARK_KEY from env fallback if flag not provided
+	effectiveBenchmarkKey := *benchmarkKey
+	if effectiveBenchmarkKey == "" {
+		effectiveBenchmarkKey = os.Getenv("BENCHMARK_KEY")
+	}
+
+	parsedBaseURL, parseErr := url.Parse(*endpoint)
+	if parseErr != nil {
+		log.Fatalf("Invalid endpoint URL %q: %v", *endpoint, parseErr)
+	}
+
 	pageBuckets, err := parsePageMix(*pageMix)
 	if err != nil {
 		log.Fatalf("Invalid page mix: %v", err)
 	}
 
-	var baseURL url.URL
+	endpointBuckets, err := parseEndpointMix(*endpointMix)
-	if len(pageBuckets) > 0 {
+	if err != nil {
-		parsedURL, parseErr := url.Parse(*endpoint)
+		log.Fatalf("Invalid endpoint mix: %v", err)
-		if parseErr != nil {
-			log.Fatalf("Invalid endpoint URL: %v", parseErr)
-		}
-		baseURL = *parsedURL
 	}
 
 	selectionSeed := *seed
@@ -161,140 +469,289 @@ func main() {
 	defer f.Close()
 	log.SetOutput(f)
 
-	fmt.Printf("Starting load test with %d requests, %d concurrent\n", *numRequests, *concurrency)
+	fmt.Printf("=========================================================\n")
-	fmt.Printf("Testing endpoint: %s\n", *endpoint)
+	fmt.Printf("🏀 NBA_Go Enhanced Load Tester\n")
+	fmt.Printf("=========================================================\n")
+	fmt.Printf("Requests: %d | Concurrency: %d | Timeout: %v\n", *numRequests, *concurrency, *timeout)
+	fmt.Printf("Base Target: %s\n", *endpoint)
+	if *varyParams {
+		fmt.Printf("Query Variance: ENABLED (Complexity: %s)\n", *complexity)
+	} else {
+		fmt.Printf("Query Variance: DISABLED (Legacy Mode)\n")
+	}
+	if *cacheBust {
+		fmt.Printf("Cache Busting: ENABLED (100%% cold-cache origin benchmark)\n")
+	}
+	if effectiveBenchmarkKey != "" {
+		fmt.Printf("Benchmark Auth: ENABLED (X-Benchmark-Key header attached)\n")
+	}
+	if *rotateIPs {
+		fmt.Printf("Distributed IP Rotation: ENABLED (X-Real-IP / X-Forwarded-For)\n")
+	}
+	if len(endpointBuckets) > 0 {
+		fmt.Printf("Endpoint Mix: %s\n", *endpointMix)
+	}
+	fmt.Printf("Logging to: %s\n\n", *logFile)
 
 	// Channel to collect results
 	results := make(chan Response, *numRequests)
 
-	// Use a WaitGroup to manage concurrency
+	// Custom HTTP client with connection pooling and timeouts
+	transport := &http.Transport{
+		MaxIdleConns:        *concurrency * 2,
+		MaxIdleConnsPerHost: *concurrency * 2,
+		IdleConnTimeout:     90 * time.Second,
+		DisableKeepAlives:   false,
+	}
+	client := &http.Client{
+		Transport: transport,
+		Timeout:   *timeout,
+	}
+
 	var wg sync.WaitGroup
+	sem := make(chan struct{}, *concurrency)
+	var activeReqSeq int64
 
-	// Semaphore to limit concurrency
-	sem := make(chan bool, *concurrency)
-
-	// Start the timer
 	startTime := time.Now()
 
-	// Launch goroutines for requests
 	for i := 0; i < *numRequests; i++ {
 		wg.Add(1)
-		go func(id int) {
+		go func(reqID int) {
 			defer wg.Done()
-
+			sem <- struct{}{}
-			// Acquire semaphore
-			sem <- true
 			defer func() { <-sem }()
 
-			start := time.Now()
+			workerSeq := atomic.AddInt64(&activeReqSeq, 1)
-			result := Response{
+			threadRNG := rand.New(rand.NewSource(selectionSeed + int64(reqID)*31 + workerSeq))
-				Duration: 0,
+
-				Error:    nil,
+			targetPage := 0
-			}
+			if len(selectedPages) > reqID {
-			requestEndpoint := *endpoint
+				targetPage = selectedPages[reqID]
-			if len(selectedPages) > 0 {
-				result.Page = selectedPages[id]
-				requestEndpoint = urlForPage(baseURL, result.Page)
 			}
 
-			req, err := http.NewRequest("GET", requestEndpoint, nil)
+			reqURL := GenerateRequestURL(RequestOptions{
-			if err != nil {
+				BaseURL:     *parsedBaseURL,
-				result.Duration = time.Since(start)
+				Page:        targetPage,
-				result.Error = err
+				VaryParams:  *varyParams,
-				log.Printf("Request %d (page %d) failed to create request: %v", id, result.Page, err)
+				Complexity:  *complexity,
-				results <- result
+				CacheBust:   *cacheBust,
-				return
+				EndpointMix: endpointBuckets,
+				RequestID:   reqID,
+				WorkerID:    int(workerSeq),
+				RNG:         threadRNG,
+			})
+
+			// If no param variation and pageMix was specified, preserve legacy URL logic exactly
+			if !*varyParams && len(selectedPages) > 0 && !*cacheBust && len(endpointBuckets) == 0 {
+				reqURL = urlForPage(*parsedBaseURL, targetPage)
 			}
 
-			if *apiKey != "" {
+			maxAttempts := 1
-				req.Header.Add("x-api-key", *apiKey)
+			if *retryOnRateLimit {
+				maxAttempts = 3
 			}
 
-			client := &http.Client{}
+			var finalResp Response
-			resp, err := client.Do(req)
+			for attempt := 1; attempt <= maxAttempts; attempt++ {
-			duration := time.Since(start)
+				start := time.Now()
+				req, err := http.NewRequestWithContext(context.Background(), "GET", reqURL, nil)
+				if err != nil {
+					finalResp = Response{
+						Duration: time.Since(start),
+						Error:    err,
+						Page:     targetPage,
+						URL:      reqURL,
+						Attempt:  attempt,
+					}
+					log.Printf("Req %d: failed creating request: %v", reqID, err)
+					break
+				}
 
-			result.Duration = duration
+				if *apiKey != "" {
-			result.Error = err
+					req.Header.Set("x-api-key", *apiKey)
+				}
+				if effectiveBenchmarkKey != "" {
+					req.Header.Set("X-Benchmark-Key", effectiveBenchmarkKey)
+				}
+				if *rotateIPs {
+					simIP := fmt.Sprintf("198.51.100.%d", (reqID%250)+1)
+					req.Header.Set("X-Real-IP", simIP)
+					req.Header.Set("X-Forwarded-For", simIP)
+				}
 
-			if err != nil {
+				httpResp, err := client.Do(req)
-				log.Printf("Request %d (page %d) failed: %v", id, result.Page, err)
+				duration := time.Since(start)
-				results <- result
+
-				return
+				if err != nil {
+					finalResp = Response{
+						Duration: duration,
+						Error:    err,
+						Page:     targetPage,
+						URL:      reqURL,
+						Attempt:  attempt,
+					}
+					log.Printf("Req %d (page %d) failed: %v", reqID, targetPage, err)
+					break
+				}
+
+				bodyBytes, readErr := io.ReadAll(httpResp.Body)
+				httpResp.Body.Close()
+
+				cacheState := ExtractCacheStatus(httpResp.Header)
+
+				finalResp = Response{
+					StatusCode:  httpResp.StatusCode,
+					BodyLength:  len(bodyBytes),
+					Duration:    duration,
+					Error:       readErr,
+					Page:        targetPage,
+					CacheStatus: cacheState,
+					URL:         reqURL,
+					Attempt:     attempt,
+				}
+
+				if httpResp.StatusCode == http.StatusTooManyRequests && *retryOnRateLimit && attempt < maxAttempts {
+					backoff := time.Duration(300*attempt)*time.Millisecond + time.Duration(threadRNG.Intn(200))*time.Millisecond
+					time.Sleep(backoff)
+					continue
+				}
+
+				log.Printf("Req %d: Status=%d Cache=%s Duration=%v URL=%s", reqID, httpResp.StatusCode, cacheState, duration, reqURL)
+				break
 			}
 
-			defer resp.Body.Close()
+			results <- finalResp
-			body, err := ioutil.ReadAll(resp.Body)
-			if err != nil {
-				log.Printf("Request %d (page %d) failed to read response body: %v", id, result.Page, err)
-				result.Error = err
-				results <- result
-				return
-			}
-
-			result.StatusCode = resp.StatusCode
-			result.Body = string(body)
-			results <- result
-
-			// Log request details
-			log.Printf("Request %d: Page=%d, Status=%d, Time=%v", id, result.Page, resp.StatusCode, duration)
 		}(i)
 	}
 
-	// Close the results channel when all requests are done
 	go func() {
 		wg.Wait()
 		close(results)
 	}()
 
-	// Process results
+	// Aggregation variables
-	var successCount, errorCount int
+	var (
-	var totalDuration time.Duration
+		totalResponses int
-	pageResults := make(map[int]*pageResult)
+		successCount   int
+		errorCount     int
+		statusCounts   = make(map[int]int)
 
-	for result := range results {
+		allDurations   []time.Duration
-		if result.Page > 0 {
+		hitDurations   []time.Duration
-			stats, ok := pageResults[result.Page]
+		missDurations  []time.Duration
+		otherDurations []time.Duration
+
+		pageResults = make(map[int]*pageResult)
+	)
+
+	for res := range results {
+		totalResponses++
+		statusCounts[res.StatusCode]++
+
+		if res.Error != nil || res.StatusCode < 200 || res.StatusCode >= 400 {
+			errorCount++
+		} else {
+			successCount++
+		}
+
+		allDurations = append(allDurations, res.Duration)
+
+		switch res.CacheStatus {
+		case CacheHit:
+			hitDurations = append(hitDurations, res.Duration)
+		case CacheMiss:
+			missDurations = append(missDurations, res.Duration)
+		default:
+			otherDurations = append(otherDurations, res.Duration)
+		}
+
+		if res.Page > 0 {
+			stats, ok := pageResults[res.Page]
 			if !ok {
 				stats = &pageResult{}
-				pageResults[result.Page] = stats
+				pageResults[res.Page] = stats
 			}
 			stats.requests++
-			if result.Error != nil || result.StatusCode != http.StatusOK {
+			if res.Error != nil || res.StatusCode != http.StatusOK {
 				stats.failures++
 			} else {
 				stats.successes++
-				stats.totalDuration += result.Duration
+				stats.totalDuration += res.Duration
 			}
 		}
+	}
 
-		if result.Error != nil {
+	totalTestDuration := time.Since(startTime)
-			errorCount++
+	reqsPerSec := float64(totalResponses) / totalTestDuration.Seconds()
-		} else if result.StatusCode == http.StatusOK {
+
-			successCount++
+	overallStats := CalculatePercentiles(allDurations)
-			totalDuration += result.Duration
+	hitStats := CalculatePercentiles(hitDurations)
-		} else {
+	missStats := CalculatePercentiles(missDurations)
-			errorCount++
+
+	// Summary output
+	fmt.Printf("\n=========================================================\n")
+	fmt.Printf("📊 LOAD TEST EXECUTION SUMMARY\n")
+	fmt.Printf("=========================================================\n")
+	fmt.Printf("Total Requests:       %d\n", totalResponses)
+	fmt.Printf("Successful (2xx/3xx): %d (%.1f%%)\n", successCount, float64(successCount)*100.0/float64(totalResponses))
+	fmt.Printf("Failed (4xx/5xx/Err): %d (%.1f%%)\n", errorCount, float64(errorCount)*100.0/float64(totalResponses))
+	fmt.Printf("Total Duration:       %v\n", totalTestDuration)
+	fmt.Printf("Throughput:           %.2f req/s\n\n", reqsPerSec)
+
+	// Status code distribution
+	fmt.Printf("--- HTTP Status Code Distribution ---\n")
+	var sortedStatuses []int
+	for code := range statusCounts {
+		sortedStatuses = append(sortedStatuses, code)
+	}
+	sort.Ints(sortedStatuses)
+	for _, code := range sortedStatuses {
+		desc := http.StatusText(code)
+		if desc == "" {
+			desc = "Network / Connection Error"
+		}
+		fmt.Printf("  [%d %s]: %d\n", code, desc, statusCounts[code])
+	}
+	fmt.Println()
+
+	// Latency percentiles breakdown
+	fmt.Printf("--- Latency Percentile Distribution (All Responses) ---\n")
+	fmt.Printf("  Min:    %v\n", overallStats.Min)
+	fmt.Printf("  p50:    %v (Median)\n", overallStats.P50)
+	fmt.Printf("  p75:    %v\n", overallStats.P75)
+	fmt.Printf("  p90:    %v\n", overallStats.P90)
+	fmt.Printf("  p95:    %v\n", overallStats.P95)
+	fmt.Printf("  p99:    %v\n", overallStats.P99)
+	fmt.Printf("  Max:    %v\n", overallStats.Max)
+	fmt.Printf("  Avg:    %v\n\n", overallStats.Average)
+
+	// Cache telemetry comparison
+	fmt.Printf("--- Edge Cache vs Origin Latency Split ---\n")
+	totalCacheTracked := len(hitDurations) + len(missDurations) + len(otherDurations)
+	if totalCacheTracked > 0 {
+		hitPct := float64(len(hitDurations)) * 100.0 / float64(totalCacheTracked)
+		missPct := float64(len(missDurations)) * 100.0 / float64(totalCacheTracked)
+		otherPct := float64(len(otherDurations)) * 100.0 / float64(totalCacheTracked)
+
+		fmt.Printf("  ⚡ Cache HITS (Edge/CDN): %d (%.1f%%)\n", len(hitDurations), hitPct)
+		if len(hitDurations) > 0 {
+			fmt.Printf("     Avg: %v | p50: %v | p95: %v | p99: %v\n",
+				hitStats.Average, hitStats.P50, hitStats.P95, hitStats.P99)
+		}
+
+		fmt.Printf("  🔥 Cache MISSES (Origin / DB): %d (%.1f%%)\n", len(missDurations), missPct)
+		if len(missDurations) > 0 {
+			fmt.Printf("     Avg: %v | p50: %v | p95: %v | p99: %v\n",
+				missStats.Average, missStats.P50, missStats.P95, missStats.P99)
+		}
+
+		if len(otherDurations) > 0 {
+			fmt.Printf("  ❓ Unclassified / Direct: %d (%.1f%%)\n", len(otherDurations), otherPct)
 		}
 	}
+	fmt.Println()
 
-	// Calculate statistics
+	// Per-page results (if pageMix used)
-	totalTime := time.Since(startTime)
-	var avgDuration time.Duration
-	if successCount > 0 {
-		avgDuration = totalDuration / time.Duration(successCount)
-	}
-	requestsPerSecond := float64(*numRequests) / totalTime.Seconds()
-
-	// Print summary
-	fmt.Printf("\nLoad Test Summary:\n")
-	fmt.Printf("Total Requests: %d\n", *numRequests)
-	fmt.Printf("Successful Requests: %d\n", successCount)
-	fmt.Printf("Failed Requests: %d\n", errorCount)
-	fmt.Printf("Total Time: %v\n", totalTime)
-	fmt.Printf("Average Response Time: %v\n", avgDuration)
-	fmt.Printf("Requests Per Second: %.2f\n", requestsPerSecond)
-
 	if len(pageResults) > 0 {
 		pages := make([]int, 0, len(pageResults))
 		for page := range pageResults {
@@ -302,16 +759,17 @@ func main() {
 		}
 		sort.Ints(pages)
 
-		fmt.Printf("\nPer-page Results:\n")
+		fmt.Printf("--- Per-page Breakdown ---\n")
 		for _, page := range pages {
 			stats := pageResults[page]
 			pageAverage := time.Duration(0)
 			if stats.successes > 0 {
 				pageAverage = stats.totalDuration / time.Duration(stats.successes)
 			}
-			fmt.Printf("Page %d: Requests=%d, Successful=%d, Failed=%d, Average Response Time=%v\n",
+			fmt.Printf("  Page %2d: Requests=%4d, Success=%4d, Failed=%d, Avg Latency=%v\n",
 				page, stats.requests, stats.successes, stats.failures, pageAverage)
 		}
+		fmt.Println()
 	}
 }
 

test/loadtest_test.go

@@ -1,9 +1,12 @@
 package main
 
 import (
+	"math/rand"
+	"net/http"
 	"net/url"
 	"reflect"
 	"testing"
+	"time"
 )
 
 func TestParsePageMixDistributesRangeWeights(t *testing.T) {
@@ -110,6 +113,172 @@ func TestURLForPageReplacesOnlyPageParameter(t *testing.T) {
 	}
 }
 
+func TestParseEndpointMix(t *testing.T) {
+	buckets, err := parseEndpointMix("playeradvancedstats:40,playertotals:30,games:30")
+	if err != nil {
+		t.Fatalf("parseEndpointMix error: %v", err)
+	}
+	if len(buckets) != 3 {
+		t.Fatalf("expected 3 buckets, got %d", len(buckets))
+	}
+	if buckets[0].endpoint != "/api/playeradvancedstats" || buckets[0].weight != 40 {
+		t.Errorf("bucket 0 = %+v", buckets[0])
+	}
+	if buckets[1].endpoint != "/api/playertotals" || buckets[1].weight != 30 {
+		t.Errorf("bucket 1 = %+v", buckets[1])
+	}
+	if buckets[2].endpoint != "/api/games" || buckets[2].weight != 30 {
+		t.Errorf("bucket 2 = %+v", buckets[2])
+	}
+}
+
+func TestGenerateRequestURLVariesParams(t *testing.T) {
+	baseURL, _ := url.Parse("https://nba.turbo-data.com/api/playeradvancedstats")
+	generatedURLs := make(map[string]bool)
+
+	for i := 0; i < 50; i++ {
+		rng := rand.New(rand.NewSource(int64(i + 100)))
+		u := GenerateRequestURL(RequestOptions{
+			BaseURL:    *baseURL,
+			Page:       0,
+			VaryParams: true,
+			Complexity: "high",
+			CacheBust:  false,
+			RequestID:  i,
+			WorkerID:   1,
+			RNG:        rng,
+		})
+		generatedURLs[u] = true
+		parsed, err := url.Parse(u)
+		if err != nil {
+			t.Fatalf("invalid url generated: %s", u)
+		}
+		q := parsed.Query()
+		if q.Get("sortBy") == "" {
+			t.Errorf("expected sortBy to be populated, got URL: %s", u)
+		}
+		if q.Get("pageSize") == "" {
+			t.Errorf("expected pageSize to be populated, got URL: %s", u)
+		}
+	}
+
+	if len(generatedURLs) < 40 {
+		t.Errorf("expected high URL diversity (>40 distinct URLs for 50 requests), got %d", len(generatedURLs))
+	}
+}
+
+func TestGenerateRequestURLCacheBust(t *testing.T) {
+	baseURL, _ := url.Parse("https://nba.turbo-data.com/api/playeradvancedstats?page=1&pageSize=40")
+	rng := rand.New(rand.NewSource(42))
+
+	u1 := GenerateRequestURL(RequestOptions{
+		BaseURL:   *baseURL,
+		Page:      1,
+		CacheBust: true,
+		RequestID: 1,
+		WorkerID:  1,
+		RNG:       rng,
+	})
+
+	u2 := GenerateRequestURL(RequestOptions{
+		BaseURL:   *baseURL,
+		Page:      1,
+		CacheBust: true,
+		RequestID: 2,
+		WorkerID:  1,
+		RNG:       rng,
+	})
+
+	if u1 == u2 {
+		t.Errorf("expected distinct URLs with cacheBust=true, got identical: %s", u1)
+	}
+
+	p1, _ := url.Parse(u1)
+	if p1.Query().Get("_cb") == "" {
+		t.Errorf("expected _cb parameter in URL %s", u1)
+	}
+}
+
+func TestExtractCacheStatus(t *testing.T) {
+	tests := []struct {
+		name     string
+		headers  http.Header
+		expected CacheStatus
+	}{
+		{
+			name:     "Cloudflare HIT",
+			headers:  http.Header{"Cf-Cache-Status": []string{"HIT"}},
+			expected: CacheHit,
+		},
+		{
+			name:     "Cloudflare MISS",
+			headers:  http.Header{"Cf-Cache-Status": []string{"MISS"}},
+			expected: CacheMiss,
+		},
+		{
+			name:     "Cloudflare DYNAMIC",
+			headers:  http.Header{"Cf-Cache-Status": []string{"DYNAMIC"}},
+			expected: CacheMiss,
+		},
+		{
+			name:     "X-Cache HIT",
+			headers:  http.Header{"X-Cache": []string{"HIT from proxy"}},
+			expected: CacheHit,
+		},
+		{
+			name:     "Age header > 0",
+			headers:  http.Header{"Age": []string{"120"}},
+			expected: CacheHit,
+		},
+		{
+			name:     "Age header 0 with no cache headers",
+			headers:  http.Header{"Age": []string{"0"}},
+			expected: CacheUnknown,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			actual := ExtractCacheStatus(tt.headers)
+			if actual != tt.expected {
+				t.Errorf("ExtractCacheStatus() = %v, want %v", actual, tt.expected)
+			}
+		})
+	}
+}
+
+func TestCalculatePercentiles(t *testing.T) {
+	durations := []time.Duration{
+		10 * time.Millisecond,
+		20 * time.Millisecond,
+		30 * time.Millisecond,
+		40 * time.Millisecond,
+		50 * time.Millisecond,
+		60 * time.Millisecond,
+		70 * time.Millisecond,
+		80 * time.Millisecond,
+		90 * time.Millisecond,
+		100 * time.Millisecond,
+	}
+
+	stats := CalculatePercentiles(durations)
+	if stats.Count != 10 {
+		t.Errorf("Count = %d, want 10", stats.Count)
+	}
+	if stats.Min != 10*time.Millisecond {
+		t.Errorf("Min = %v, want 10ms", stats.Min)
+	}
+	if stats.Max != 100*time.Millisecond {
+		t.Errorf("Max = %v, want 100ms", stats.Max)
+	}
+	if stats.Average != 55*time.Millisecond {
+		t.Errorf("Average = %v, want 55ms", stats.Average)
+	}
+	if stats.P50 != 55*time.Millisecond {
+		t.Errorf("P50 = %v, want 55ms", stats.P50)
+	}
+}
+
 func assertCountNear(t *testing.T, label string, actual, expected, tolerance int) {
 	t.Helper()
 	if actual < expected-tolerance || actual > expected+tolerance {

test/run_scraper.go

@@ -1,104 +0,0 @@
-package main
-
-import (
-	"fmt"
-	"io"
-	"log"
-	"net/http"
-	"strconv"
-	"strings"
-
-	"github.com/PuerkitoBio/goquery"
-)
-
-// LineScore struct and mustAtoi helper function remain the same
-type LineScore struct {
-	GameID string
-	Team   string
-	Q1, Q2, Q3, Q4 int
-	OT1, OT2, OT3  int
-	Total          int
-}
-func mustAtoi(s string) int { i, _ := strconv.Atoi(s); return i }
-
-
-func scrapeAndPrintLineScore(gameURL, gameID string) {
-	// 1. Fetch the page
-	resp, err := http.Get(gameURL)
-	if err != nil {
-		log.Fatalf("Failed to fetch page: %v", err)
-	}
-	defer resp.Body.Close()
-
-	bodyBytes, err := io.ReadAll(resp.Body)
-	if err != nil {
-		log.Fatalf("Failed to read response body: %v", err)
-	}
-
-	doc, err := goquery.NewDocumentFromReader(strings.NewReader(string(bodyBytes)))
-	if err != nil {
-		log.Fatalf("Failed to parse HTML: %v", err)
-	}
-
-	var table *goquery.Selection
-	
-	// Try to find a visible table first
-	table = doc.Find("table#line_score")
-
-	if table.Length() == 0 {
-		log.Println("Visible table not found. Finding and parsing commented table...")
-		
-		commentNode := doc.Find("#all_line_score").Contents().FilterFunction(func(i int, s *goquery.Selection) bool {
-			return goquery.NodeName(s) == "#comment"
-		})
-
-		if commentNode.Length() > 0 {
-			// ✅ THE FIX: Access the .Data field directly from the comment node.
-			commentedHTML := commentNode.Nodes[0].Data
-			
-			innerDoc, err := goquery.NewDocumentFromReader(strings.NewReader(commentedHTML))
-			if err != nil {
-				log.Fatalf("❌ Failed to parse the HTML from the comment: %v", err)
-			}
-			table = innerDoc.Find("table#line_score")
-		}
-	}
-
-	if table == nil || table.Length() == 0 {
-		log.Println("❌ No line score table found by any method.")
-		return
-	}
-
-	// 3. Parse the data from the found table
-	var lineScores []LineScore
-	table.Find("tbody tr").Each(func(i int, row *goquery.Selection) {
-		teamName := row.Find(`th[data-stat="team"] a`).Text()
-		if teamName != "" {
-			ls := LineScore{GameID: gameID, Team: teamName}
-			ls.Q1 = mustAtoi(row.Find(`td[data-stat="1"]`).Text())
-			ls.Q2 = mustAtoi(row.Find(`td[data-stat="2"]`).Text())
-			ls.Q3 = mustAtoi(row.Find(`td[data-stat="3"]`).Text())
-			ls.Q4 = mustAtoi(row.Find(`td[data-stat="4"]`).Text())
-			ls.Total = mustAtoi(row.Find(`td[data-stat="T"]`).Text())
-			lineScores = append(lineScores, ls)
-		}
-	})
-
-	// 4. Print the results
-	if len(lineScores) > 0 {
-		log.Printf("✅ Success! Found %d line scores for game %s:", len(lineScores), gameID)
-		for _, ls := range lineScores {
-			log.Printf("%+v\n", ls)
-		}
-	} else {
-		log.Println("❌ Table was found, but failed to parse any rows.")
-	}
-}
-
-func main() {
-	gameID := "202406170BOS"
-	gameURL := fmt.Sprintf("https://www.basketball-reference.com/boxscores/%s.html", gameID)
-	log.Printf("--- Scraping Line Score for Game: %s ---", gameID)
-	log.Printf("--- URL: %s ---", gameURL)
-	scrapeAndPrintLineScore(gameURL, gameID)
-}

utils/middleware/rate_limiter.go

@@ -1,6 +1,9 @@
 package middleware
 
 import (
+	"crypto/subtle"
+	"os"
+	"strconv"
 	"strings"
 	"time"
 
@@ -9,10 +12,34 @@ import (
 )
 
 func RateLimiter() fiber.Handler {
+	benchmarkKey := strings.TrimSpace(os.Getenv("BENCHMARK_KEY"))
+
+	maxRequests := 20
+	if envMax := os.Getenv("RATE_LIMIT_MAX"); envMax != "" {
+		if val, err := strconv.Atoi(envMax); err == nil && val > 0 {
+			maxRequests = val
+		}
+	}
+
+	expiration := 1 * time.Minute
+	if envExp := os.Getenv("RATE_LIMIT_EXPIRATION_SECONDS"); envExp != "" {
+		if val, err := strconv.Atoi(envExp); err == nil && val > 0 {
+			expiration = time.Duration(val) * time.Second
+		}
+	}
+
 	return limiter.New(limiter.Config{
-		Max:        20,
+		Max:        maxRequests,
-		Expiration: 1 * time.Minute,
+		Expiration: expiration,
 		Next: func(c *fiber.Ctx) bool {
+			// Bypass rate limiting when a valid internal benchmark key is supplied
+			if benchmarkKey != "" {
+				clientKey := c.Get("X-Benchmark-Key")
+				if clientKey != "" && subtle.ConstantTimeCompare([]byte(clientKey), []byte(benchmarkKey)) == 1 {
+					return true
+				}
+			}
+
 			// Skip rate limiting for internal services and infra endpoints
 			ip := c.IP()
 			if strings.HasPrefix(ip, "10.") || strings.HasPrefix(ip, "172.") || ip == "127.0.0.1" {