API Traffic Surge and Latency Degradation Forecast
Project endpoint latency curves and error rate spikes under anticipated API traffic growth.
Use this template when evaluating system resiliency before promotional events or API partner integrations. It helps a backend systems architect predict latency degradation and rate-limiting needs.
Role: Senior Distributed Systems Reliability Architect specializing in high-throughput API modeling.
Context
- Critical API endpoints under evaluation: {{api_endpoints}}
- Baseline requests per second (RPS) and p99 latency: {{baseline_traffic_latency}}
- Anticipated peak RPS and traffic multiplier: {{peak_surge_multiplier}}
- Downstream database and cache dependencies: {{downstream_dependencies}}
- Maximum acceptable p99 latency SLA: {{p99_latency_sla}}
Task
Deliver an API performance degradation forecast analysis that models p95/p99 latency trajectories, identifies throughput breaking points, and evaluates SLA compliance across {{api_endpoints}} under {{peak_surge_multiplier}}.
Method
- Analyze current performance characteristics in {{baseline_traffic_latency}} to establish the baseline concurrency profile.
- Apply {{peak_surge_multiplier}} to calculate projected concurrent connection pools and thread utilization.
- Evaluate the throughput limits of {{downstream_dependencies}} to determine backpressure risks.
- Model p50, p95, and p99 latency curves as request rates scale toward peak load.
- Identify the exact RPS threshold where response times breach {{p99_latency_sla}}.
- Assess cascading failure risks such as thread pool exhaustion or connection timeouts.
- Define targeted rate-limiting thresholds and cache warming interventions.
Constraints
- MUST identify the single weakest downstream component within {{downstream_dependencies}}.
- MUST NOT assume infinite horizontal scaling without evaluating database connection limits.
- MUST provide latency predictions in exact millisecond units.
- Analysis must highlight the specific failure mode (e.g., HTTP 504 Gateway Timeout vs 500 Internal Error).
Output format
- Performance Exposure Summary (max 100 words)
- Latency & Throughput Projection Table (Load Tier [% of Peak], Projected RPS, p50 Latency, p99 Latency, Error Rate %)
- Dependency Bottleneck Analysis (Ranked list of downstream failure points)
- Resiliency & Throttling Rules (Explicit RPS thresholds for rate-limiting)
Self-review
- Ensure p99 projections explicitly benchmark against {{p99_latency_sla}}.
- Verify all endpoints in {{api_endpoints}} are represented in the analysis.
- Confirm that the throughput limits respect constraints from {{downstream_dependencies}}.
Explicit role, a named task, and discrete steps the model can follow.
Background, inputs and variables the model needs before it starts.
Hard boundaries — what the model must and must not do.
A named, field-level shape for the response.
Ordered work items that force analysis before an answer.
Length and structure that travel across frontier models.
Signal density — instruction weight without padding.
Documented variables so the scaffold adapts to new inputs.
Quality bar, assumptions and behaviour when inputs are thin.
How much real usage the template has behind it.