llm-serving-performance-tuning

Diagnose and resolve LLM serving bottlenecks across vLLM, FastAPI, and database.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/saintgo7/claude-skills --skill llm-serving-performance-tuning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: llm-serving-performance-tuning
Source: https://github.com/saintgo7/claude-skills/tree/main/llm-serving-performance-tuning
Command: npx skills add https://github.com/saintgo7/claude-skills --skill llm-serving-performance-tuning

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill fixes LLM serving bottlenecks by ensuring you measure the real constraint across vLLM, the FastAPI gateway, and the database instead of guessing based only on GPU utilization.

Core Features & Use Cases

  • 6-step, evidence-driven tuning workflow: baseline load testing, bottleneck classification, vLLM parameter tuning, gateway tuning, DB tuning, then re-measuring to confirm impact.
  • Production-focused diagnostics: maps symptoms like queue backlog, 429/5xx distributions, sustained GPU underutilization, and DB pool exhaustion to the correct tuning step.
  • Concurrency validation for GEM-LLM-style workloads: guides performance decisions using multi-user scenarios (e.g., 50/100/200 concurrent users) with tok/s, RPS, and p99 latency targets.

Quick Start

Run the skill install entrypoint to apply the 6-step tuning workflow for your vLLM + FastAPI + DB deployment: ./install.sh llm-serving-performance-tuning

Frequently Asked Questions about llm-serving-performance-tuning

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

FAQPage Schema
How do I reduce p99 latency in my vLLM serving stack under multi-user load?

Reducing p99 latency in a vLLM serving stack requires baseline load testing metrics to identify bottlenecks across vLLM, the FastAPI gateway, and the database, followed by tiered parameter tuning and re-measurement under multi-user concurrency.

Why does my LLM serving throughput drop when scaling from 100 to 200 concurrent users?

Throughput drops during concurrency scaling often happen because of bottlenecks like FastAPI gateway queue backlogs, 429 rate limiting, or database pool exhaustion, which you can diagnose by mapping 5xx distributions and GPU utilization during load testing.

How to tune vLLM and FastAPI gateway for maximum throughput?

Tuning vLLM and FastAPI for maximum throughput involves a 6-step workflow: gathering baseline metrics like RPS and tokens/sec, classifying bottlenecks, adjusting vLLM parameters, tuning gateway connection limits, optimizing database writes, and re-measuring.

What load testing metrics do I need before tuning LLM serving performance?

Before tuning LLM serving performance, you need baseline load testing metrics including RPS, latency percentiles, tokens/sec, 5xx and 429 error rates, GPU utilization, and database pool status to avoid guessing bottlenecks based on GPU usage alone.

Can I use this performance tuning workflow for my FastAPI and database LLM gateway?

Yes, this workflow specifically applies to an LLM serving stack composed of vLLM, a FastAPI gateway, and a database, guiding tuning decisions for gateway connection limits, rate limiting, and DB write behavior under multi-user concurrency.

What to do when vLLM GPU utilization is low but p99 latency remains high?

When GPU utilization is low but p99 latency is high, the bottleneck likely sits in the FastAPI gateway or database pool, requiring you to map symptoms like queue backlog and DB pool exhaustion to gateway and DB tuning steps.