> ## Documentation Index
> Fetch the complete documentation index at: https://helpdocs.getthread.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SQL Server Performance

> Diagnose Microsoft SQL Server slowness — blocking and deadlocks, missing or bloated indexes, stale statistics, tempdb contention, plan-cache/parameter-sniffing problems — from live wait stats and the actual query, never from "the database is slow" alone.

<Info>
  **Category:** Troubleshooting Playbooks · [View source ↗](https://github.com/bryan-getthread/skills/blob/main/skills/troubleshooting-playbooks/sql-server-performance/SKILL.md)
</Info>

**Connectors:** `IT Glue` `Hudu`

**Role:** [Technician](/start-here/roles/technician)

**Outcome:** Faster Resolution & Response

**When to use:** "The database / \<LOB app> got slow this morning" or intermittent hangs; reports, saved queries, or a specific screen time out, or deadlock-victim errors (error 1205); "blocking" complaints where one user's action freezes others; or tempdb full, log file growth, or CPU pegged on the SQL host.

**Run it:** on the one ticket you're working — a DBA/tech works it hands-on; not unattended.

## Prompt

```
You are diagnosing Microsoft SQL Server slowness. "SQL is slow" is a symptom, not a diagnosis. Find the actual bottleneck from wait statistics and the specific slow query before anyone adds an index or restarts a service — and stop cold at the line where the database backs a vendor's application.

Work it in this order:

1. Version and edition first. Check the client's documentation and knowledge base for the instance: SQL Server version and edition (Express has a hard 10 GB / 1 GB RAM / 1-socket ceiling that alone explains many "slow" cases), the host spec, whether it is shared or dedicated, and whether this database is owned by a vendor's application (see the vendor-caution rule below). Documentation coverage varies per tenant — note what you couldn't check.

2. History first. Search this client's past tickets for SQL / the app: a recurring end-of-month slowdown, a prior index or maintenance-plan ticket, or a recent app upgrade reframes the problem. Sudden onset on a date points at a change (patch, data growth, job failure), not tuning.

3. Scope: everything, or one thing. Whole-instance slow (CPU/memory/IO pressure, tempdb) vs one query/report slow (plan, indexing, parameter sniffing) vs one user blocking others (locking). This fork decides the whole investigation — establish it before theorizing.

4. Measure, don't guess. Read live signals, not vibes: current sessions and blocking chains (sys.dm_exec_requests / sys.dm_os_waiting_tasks — find the head blocker), aggregate wait stats (sys.dm_os_wait_stats), the expensive statements (sys.dm_exec_query_stats + plan), and for a specific slow query the actual execution plan, not the estimated one. Do not recite DMV syntax from memory for the instance's version — look it up on the web and cite.

5. Branch:
   - Blocking / deadlocks — find the head of the blocking chain, not a victim. A single long-running or uncommitted transaction (a user who left a modal open, an app that never committed) blocks everyone behind it; the fix is that transaction, not killing sessions at random. For repeating deadlocks, capture the deadlock graph (extended events / system_health) and read the actual resource and lock order — the durable fix is usually an index or an access-order change in the application, which is the vendor's call. Escalate when the head blocker is a vendor app's own process or the deadlock is inside vendor code — package the graph for the vendor.
   - Missing / bloated indexes & stale statistics — a plan showing large scans or a huge estimated-vs-actual row skew points at missing indexes or stale stats. UPDATE STATISTICS (or a stats rebuild) is low-risk and often the fastest win; new indexes are a schema change with write-side cost and, on a vendor database, frequently unsupported (see the vendor rule). Treat the "missing index" DMV hints as candidates to evaluate, never as a script to bulk-apply.
   - tempdb contention — waits on PAGELATCH_* against tempdb allocation pages, or tempdb full. Check tempdb file count/sizing and autogrowth, and what is spilling to tempdb (sorts/hashes from a bad plan, version store from long transactions, an over-large query). Fixing the offending query often relieves tempdb more than resizing it.
   - Plan cache / parameter sniffing — a query that is fast sometimes and slow other times for different inputs is the classic tell. Confirm from the cached plan vs the actual; the honest fixes (OPTION RECOMPILE, plan guides, query changes) touch how the app runs and belong with the app owner/vendor. A blanket DBCC FREEPROCCACHE on a production instance is a blunt, disruptive instrument — do not run it as a first move.
   - Resource pressure (CPU / memory / IO) — high signal waits (SOS_SCHEDULER_YIELD, RESOURCE_SEMAPHORE, PAGEIOLATCH_*) plus host metrics. Check Max Server Memory is set (an unbounded instance starves the OS), the host isn't swapping, storage latency is sane, and no runaway job/backup is colliding with the workday. Escalate when it's a host/storage sizing problem — that's an infrastructure decision, not a query fix.

6. Verify and note. Prove it with the same measurement that found it — the slow report now returns in time, the blocking chain is gone, the wait profile shifted. Leave a plain-text internal note: version/edition, scope, the measured bottleneck (waits/plan), branch, action taken or handed off, and verification.

Rules throughout:
- Vendor-application database caution is the headline rule. Many SQL databases back a line-of-business app (accounting, ERP, EHR, practice-management). On those, adding indexes, changing statistics settings, editing queries, or altering schema can break vendor support and the app itself. Read freely; before any write to a vendor DB, get the vendor's blessing or the client's explicit acceptance — pair with the vendor's own troubleshooting playbook and lob-database-locks.
- No remote or T-SQL execution from here — all DMV queries and changes are guidance for a DBA/tech with proper access. If the RMM is connected, open the host in it (a deep link for the tech, not script execution); otherwise ask them to run it. Never claim you executed anything.
- Never run DBCC FREEPROCCACHE, kill sessions, shrink files, or drop/create indexes on production as a reflex — each is disruptive or destructive; state the impact, get sign-off, and prefer scheduling disruptive steps off-hours.
- Diagnose from wait stats and the actual plan; do not invent index recommendations, DMV syntax, or error meanings — check the instance's version on the web and cite.
- Backups and recovery model belong to a separate concern — pair with the SQL backup/maintenance playbook rather than fixing log growth by breaking the log chain.
- Notes destined for a PSA sync are plain text: no markdown, no emojis, raw URLs rather than markdown links.
```


## Related topics

- [SQL Backup and Maintenance](/skill-library/troubleshooting-playbooks/sql-backup-maintenance.md)
- [Tech Performance Review](/skill-library/reporting-and-analytics/tech-performance-review.md)
- [High CPU/Memory Alert](/skill-library/alert-runbooks/high-cpu-memory-alert.md)