""" Locust load test file for InferRoute gateway. Scenarios: - NormalUser: Mixed blocking + streaming at realistic rates - BurstUser: High-concurrency burst to stress routing/CB - CostUser: Cost-optimized requests (forces local backends) - ChaosUser: Invalid keys, oversized payloads, bad JSON Run: locust -f tests/locustfile.py --headless -u 50 -r 5 -t 60s --host http://localhost:8080 locust -f tests/locustfile.py # interactive UI at http://localhost:8089 """ import json import random import time from locust import HttpUser, task, between, events, constant_throughput # Test credentials VALID_KEY = "sk-inferroute-demo" INVALID_KEY = "sk-invalid-key-chaos" # Sample prompts of varying complexity PROMPTS = [ "What is machine learning?", "Explain the difference between REST and GraphQL APIs.", "Write a Python function to calculate the nth Fibonacci number recursively.", "What are the SOLID principles in software engineering? Give brief examples.", "How does Redis handle cache eviction? Describe the LRU algorithm in detail with a concrete example.", "Summarize the key differences between SQL and NoSQL databases for a technical audience.", "Explain CAP theorem and how it applies to distributed system design.", ] SYSTEM_PROMPT = "You are a helpful AI assistant. Keep answers concise and accurate." def _chat_body(prompt: str, model: str = "edge/auto", stream: bool = False, **routing_opts) -> dict: body = { "model": model, "messages": [ {"role": "system", "content": SYSTEM_PROMPT}, {"role": "user", "content": prompt}, ], "stream": stream, "max_output_tokens": 150, } if routing_opts: body["routing"] = routing_opts return body class NormalUser(HttpUser): """ Simulates a typical application user: mostly blocking requests, occasional streaming, realistic think time. """ wait_time = between(1, 3) weight = 60 # 60% of users @task(7) def blocking_completion(self): prompt = random.choice(PROMPTS) with self.client.post( "/v1/chat/completions", json=_chat_body(prompt), headers={"Authorization": f"Bearer {VALID_KEY}"}, catch_response=True, name="/v1/chat/completions [blocking]", ) as resp: if resp.status_code == 200: data = resp.json() if "choices" not in data: resp.failure(f"Missing choices in response: {data}") elif resp.status_code in (429, 503): resp.success() # expected under load else: resp.failure(f"Unexpected status {resp.status_code}: {resp.text[:200]}") @task(2) def streaming_completion(self): prompt = random.choice(PROMPTS) start_time = time.time() ttft_ms = None chunk_count = 0 with self.client.post( "/v1/chat/completions", json=_chat_body(prompt, stream=True), headers={ "Authorization": f"Bearer {VALID_KEY}", "Accept": "text/event-stream", }, stream=True, catch_response=True, name="/v1/chat/completions [streaming]", ) as resp: if resp.status_code == 200: for line in resp.iter_lines(): if line.startswith(b"data: "): payload = line[6:].strip() if payload == b"[DONE]": break try: chunk = json.loads(payload) chunk_count += 1 if ttft_ms is None: choices = chunk.get("choices", []) if choices and choices[0].get("delta", {}).get("content"): ttft_ms = (time.time() - start_time) * 1000.0 except json.JSONDecodeError: pass resp.success() elif resp.status_code in (429, 503): resp.success() else: resp.failure(f"Stream error {resp.status_code}") @task(1) def check_health(self): self.client.get("/healthz", name="/healthz") @task(1) def check_routing_status(self): self.client.get( "/v1/routing/status", name="/v1/routing/status", ) class BurstUser(HttpUser): """ High-frequency burst user to stress circuit breakers and fallback logic. """ wait_time = between(0.1, 0.5) weight = 20 # 20% of users @task(10) def rapid_blocking(self): prompt = random.choice(PROMPTS[:3]) # short prompts for speed with self.client.post( "/v1/chat/completions", json=_chat_body(prompt, max_output_tokens=50), headers={"Authorization": f"Bearer {VALID_KEY}"}, catch_response=True, name="/v1/chat/completions [burst]", ) as resp: if resp.status_code in (200, 429, 503): resp.success() else: resp.failure(f"Burst error {resp.status_code}") class CostUser(HttpUser): """ Cost-optimized user: forces local-only routing to minimize API costs. """ wait_time = between(2, 5) weight = 15 # 15% of users @task(5) def cost_optimized_request(self): with self.client.post( "/v1/chat/completions", json=_chat_body( random.choice(PROMPTS), policy="cost", allow_local=True, allow_cloud=False, ), headers={"Authorization": f"Bearer {VALID_KEY}"}, catch_response=True, name="/v1/chat/completions [cost-policy]", ) as resp: if resp.status_code in (200, 429, 502, 503): resp.success() else: resp.failure(f"Cost request error {resp.status_code}") @task(2) def cloud_only_request(self): with self.client.post( "/v1/chat/completions", json=_chat_body( random.choice(PROMPTS), policy="latency", allow_local=False, allow_cloud=True, ), headers={"Authorization": f"Bearer {VALID_KEY}"}, catch_response=True, name="/v1/chat/completions [cloud-only]", ) as resp: if resp.status_code in (200, 429, 502, 503): resp.success() else: resp.failure(f"Cloud request error {resp.status_code}") class ChaosUser(HttpUser): """ Chaos user: invalid auth keys, malformed payloads, oversized prompts. Verifies that the gateway correctly rejects and rate-limits bad requests. """ wait_time = between(3, 8) weight = 5 # 5% of users @task(3) def invalid_api_key(self): with self.client.post( "/v1/chat/completions", json=_chat_body("hello"), headers={"Authorization": f"Bearer {INVALID_KEY}"}, catch_response=True, name="/v1/chat/completions [invalid-auth]", ) as resp: if resp.status_code == 401: resp.success() # expected else: resp.failure(f"Expected 401, got {resp.status_code}") @task(2) def malformed_json(self): with self.client.post( "/v1/chat/completions", data="not valid json at all {{{", headers={ "Authorization": f"Bearer {VALID_KEY}", "Content-Type": "application/json", }, catch_response=True, name="/v1/chat/completions [bad-json]", ) as resp: if resp.status_code in (400, 422): resp.success() # expected else: resp.failure(f"Expected 400/422, got {resp.status_code}") @task(1) def oversized_prompt(self): huge_prompt = "Explain this concept in extreme detail. " * 500 with self.client.post( "/v1/chat/completions", json=_chat_body(huge_prompt), headers={"Authorization": f"Bearer {VALID_KEY}"}, catch_response=True, name="/v1/chat/completions [oversized]", ) as resp: if resp.status_code in (200, 400, 413, 422, 429, 502): resp.success() # any handled response is acceptable else: resp.failure(f"Oversized request unexpected {resp.status_code}")