load-testing

Run Locust-based streaming load tests on Databricks Apps to measure QPS, TTFT, and latency.

Updated May 10, 2026
One-click install
npx skills add https://github.com/keqingli1129/agent-langgraph-one --skill load-testing-keqingli1129
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: load-testing
Source: https://github.com/keqingli1129/agent-langgraph-one/tree/main/.claude/skills/load-testing
Command: npx skills add https://github.com/keqingli1129/agent-langgraph-one --skill load-testing-keqingli1129

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Load testing your Databricks App to discover its maximum sustainable throughput (QPS) and the point where latency and failures start to climb.

Core Features & Use Cases

  • Guided capacity-planning setup: collects deployment, compute sizes, worker counts, OAuth credentials, and whether to mock LLM calls.
  • Framework-agnostic load test harness: provides Locust-based streaming tests with TTFT (time to first token) tracking and a ramp shape to saturation.
  • Reproducible results with dashboards: saves per-run artifacts and generates an interactive HTML dashboard (Chart.js) to compare configs by compute size, latency percentiles, TTFT, peak QPS, and failure rate.
  • Use case: if you need to benchmark several deployed app variants (e.g., medium vs large compute, different worker counts), run a matrix to determine the highest QPS before saturation.

Quick Start

Ask the skill to help you generate load-test-scripts for your Databricks App, then run the provided CLI to ramp users until you find the peak QPS and review the generated dashboard in load-test-runs.

Frequently Asked Questions about load-testing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the maximum QPS for my Databricks App?

You can find the maximum QPS for your Databricks App by running controlled Locust-based streaming load tests that ramp users to saturation, measuring TTFT and latency until performance degrades. The skill automates this orchestration and saves results to a run-specific dashboard.

How do I benchmark Databricks App performance across different compute sizes?

To benchmark Databricks App performance across compute sizes, you provide the deployment URLs, compute sizes, and worker counts. The skill runs a test matrix, measuring peak QPS, latency percentiles, and failure rates, then generates an interactive HTML dashboard to compare the configurations.

Can I load test SSE streaming endpoints and measure time to first token?

Yes, you can load test SSE streaming endpoints and measure time to first token. The skill's Locust-based harness includes SSE stream parsing and tracks TTFT alongside standard latency metrics during the ramp-to-saturation performance benchmarking process.

Do I need M2M OAuth tokens to run load tests on my Databricks App?

Yes, you need M2M OAuth tokens to authenticate load tests on your Databricks App. The skill includes M2M OAuth token handling within the Locust test scripts to ensure your streaming requests are properly authorized during the performance benchmarking.

Can I benchmark app throughput without using real LLM calls?

Yes, you can benchmark app throughput without real LLM calls by enabling the optional mocked LLM throughput mode. This allows you to measure the infrastructure's maximum sustainable QPS and streaming capacity independently of downstream model latency.