load-testing

Run Locust-based load tests to measure Databricks App QPS limits.

2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/bcheng004/agent-langgraph-advanced-workshop --skill load-testing-bcheng004
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: load-testing
Source: https://github.com/bcheng004/agent-langgraph-advanced-workshop/tree/main/.claude/skills/load-testing
Command: npx skills add https://github.com/bcheng004/agent-langgraph-advanced-workshop --skill load-testing-bcheng004

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires locust, urllib3, requests.

What problem does it solve?

This Skill helps you determine the throughput ceiling of a Databricks App by measuring how many successful requests per second it can handle under increasing load. It prevents guesswork by producing QPS, latency, and failure-rate evidence from repeatable test runs.

Core Features & Use Cases

  • Capacity planning for agent endpoints: Measures peak QPS and saturation behavior for apps that implement streaming Responses-style invocations.
  • Realistic end-to-end or isolated infrastructure tests: Supports optional mocking to separate LLM latency from infrastructure throughput for more accurate benchmarks.
  • OAuth-ready long-running test execution: Uses M2M service-principal client_credentials flow to keep tests running reliably across long durations.
  • Actionable results with dashboards: Generates an interactive HTML dashboard (Chart.js) with percentile latency, TTFT, and QPS ramp progression.

Quick Start

Ask the Skill to load-test your deployed Databricks App by ramping concurrent users while streaming responses, using your M2M OAuth client credentials and generating a results dashboard.

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 a Databricks App?

You can find the maximum sustainable queries per second for a Databricks App by running controlled Locust-based load tests that ramp concurrent users against your invocations endpoint, tracking QPS, latency, and failure rates to identify the throughput ceiling.

Can I isolate infrastructure throughput from LLM latency during load testing?

Yes, you can isolate infrastructure throughput from LLM latency during load testing by enabling optional mocked LLM streaming, which removes variable model response times to benchmark the raw infrastructure capacity of your Databricks App accurately.

Do I need OAuth client credentials to run performance benchmarking on Databricks Apps?

Yes, you need OAuth client credentials using the M2M service-principal client_credentials flow to authenticate long-running load tests reliably, ensuring sustained benchmarking sessions against your Databricks App endpoints without token expiration interruptions.

What metrics are collected when load testing streaming SSE endpoints?

Load testing streaming SSE endpoints collects queries per second, percentile latency, time to first token (TTFT), and failure-rate evidence, which are visualized in an interactive HTML dashboard showing the QPS ramp progression and saturation behavior.

How does Locust handle capacity planning for agent-style invocations?

Locust handles capacity planning for agent-style invocations by orchestrating ramp-step load tests with concurrent users, measuring peak QPS and saturation behavior to produce repeatable performance benchmarks across different compute sizes and worker counts.

What are the limitations of using Locust for Databricks App performance troubleshooting?

Locust-based performance troubleshooting is limited to evaluating Databricks Apps implementing streaming Responses-style invocations, requiring OAuth M2M authentication and depending on urllib3 and requests libraries to execute the controlled load tests.