Joshen Lim
5b301e1ffa
Add docs for diagnosing stuck and blocked queries ( #48920 )
...
## Context
Related to the dashboard work for [Database
Connections](https://github.com/orgs/supabase/discussions/48639 ) -
updates the "Connection Management" docs page to include a section about
"Diagnosing stuck and blocked queries". Content is intentionally
agnostic to the UI, but more focused on Postgres.
Preview:
https://docs-cdukolvgy-supabase.vercel.app/docs/guides/database/connection-management
Covers the following sub-topics:
- Reading a session's state
- Finding out what's blocking a query
- How to stop the session responsible
- Small footer to link to the dashboard's Database Connections page
Also adding a cross-reference in 2 areas
- Troubleshooting: How to check if my queries are being blocked by other
queries
- Monitoring and Debugging MDX -> Related to observability skills
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **Documentation**
* Expanded connection-management guidance with clearer explanations of
session states.
* Added instructions for diagnosing stuck or blocked queries,
identifying blocking sessions and chains, and choosing when to cancel or
terminate them.
* Documented required permissions and available dashboard tools for
managing sessions.
* Added cross-references and telemetry updates to make troubleshooting
guidance easier to discover.
* Clarified how to use PostgreSQL activity information when
investigating blocked queries.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2026-08-11 07:09:43 -06:00
..
2024-10-02 17:10:12 +00:00
2025-09-09 12:54:33 +00:00
2026-07-29 14:47:17 -07:00
2026-07-31 10:47:14 -07:00
2026-02-17 10:29:19 +01:00
2026-07-31 10:47:14 -07:00
2026-04-20 08:23:26 +00:00
2026-07-06 06:22:11 +00:00
2026-05-07 17:06:57 +02:00
2026-02-17 10:29:19 +01:00
2026-02-17 10:29:19 +01:00
2026-07-31 10:47:14 -07:00
2026-08-05 18:12:20 +01:00
2026-07-29 14:47:17 -07:00
2026-07-07 11:51:13 +02:00
2026-04-21 11:54:27 +10:00
2025-11-27 10:57:41 +01:00
2026-04-29 11:59:09 +02:00
2026-04-30 16:48:51 +10:00
2026-02-17 10:29:19 +01:00
2026-01-19 03:35:39 +00:00
2026-02-19 23:10:41 +08:00
2026-05-22 12:55:58 +07:00
2026-07-31 10:47:14 -07:00
2026-07-29 14:47:17 -07:00
2026-06-11 08:59:44 +02:00
2026-02-17 10:29:19 +01:00
2026-07-31 10:47:14 -07:00
2026-07-31 10:47:14 -07:00
2026-04-22 10:52:01 +01:00
2026-02-17 10:29:19 +01:00
2026-02-24 17:38:27 +08:00
2026-07-07 11:51:13 +02:00
2026-08-05 17:11:00 +01:00
2026-06-29 09:40:25 -07:00
2026-04-01 12:50:26 +02:00
2026-07-31 10:47:14 -07:00
2026-07-07 11:51:13 +02:00
2026-07-15 06:54:19 -06:00
2026-02-17 10:29:19 +01:00
2026-06-29 09:40:25 -07:00
2026-05-13 14:30:37 +03:00
2026-01-19 03:35:39 +00:00
2026-02-17 10:29:19 +01:00
2026-06-29 09:40:25 -07:00
2026-02-17 10:29:19 +01:00
2026-06-17 09:28:09 -07:00
2026-05-29 13:59:09 +00:00
2026-02-17 10:29:19 +01:00
2026-01-17 03:33:29 +00:00
2026-02-18 13:47:19 +00:00
2026-03-06 12:10:41 +01:00
2026-06-29 09:40:25 -07:00
2026-02-17 10:29:19 +01:00
2025-02-21 14:13:00 -05:00
2025-09-09 12:54:33 +00:00
2025-01-17 00:28:57 +00:00
2026-07-06 06:22:11 +00:00
2026-02-17 10:29:19 +01:00
2026-07-30 15:19:00 +02:00
2026-07-30 15:19:00 +02:00
2026-07-30 15:19:00 +02:00
2025-01-18 01:04:38 +00:00
2025-01-18 01:54:43 +00:00
2026-07-30 15:19:00 +02:00
2026-07-30 15:19:00 +02:00
2025-01-18 00:42:54 +00:00
2025-09-09 12:54:33 +00:00
2025-09-09 12:54:33 +00:00
2026-06-10 17:09:59 +02:00
2026-04-22 10:52:01 +01:00
2026-06-08 15:09:08 +00:00
2026-07-29 14:47:17 -07:00
2026-07-31 10:47:14 -07:00
2026-07-30 15:19:00 +02:00
2026-06-29 09:40:25 -07:00
2026-03-17 21:36:53 -04:00
2026-04-20 08:23:26 +00:00
2025-01-17 22:07:11 +00:00
2026-05-13 13:22:26 -05:00
2025-09-09 12:54:33 +00:00
2025-12-01 16:53:12 +01:00
2025-01-18 01:54:43 +00:00
2026-07-31 10:47:14 -07:00
2026-04-01 12:19:53 +03:00
2026-07-31 10:47:14 -07:00
2026-08-11 07:09:43 -06:00
2025-09-09 12:54:33 +00:00
2026-03-17 11:17:42 +01:00
2026-07-31 10:47:14 -07:00
2026-07-31 10:47:14 -07:00
2026-07-30 15:19:00 +02:00
2026-07-31 10:47:14 -07:00
2026-07-29 14:47:17 -07:00
2025-02-21 14:13:00 -05:00
2026-07-07 11:51:13 +02:00
2025-01-16 19:17:17 -05:00
2026-07-31 10:47:14 -07:00
2026-06-29 09:40:25 -07:00
2026-06-29 09:40:25 -07:00
2025-09-16 13:58:55 +02:00
2026-07-31 10:47:14 -07:00
2026-07-31 10:47:14 -07:00
2026-07-29 14:47:17 -07:00
2025-01-18 01:04:38 +00:00
2026-06-29 09:40:25 -07:00
2026-07-29 14:47:17 -07:00
2025-09-09 12:54:33 +00:00
2026-05-21 10:12:17 +02:00
2026-06-17 11:24:59 -07:00
2025-02-04 15:40:54 -05:00
2025-09-09 12:54:33 +00:00
2026-07-30 15:19:00 +02:00
2026-07-31 10:47:14 -07:00
2026-03-17 21:36:53 -04:00
2025-02-21 14:13:00 -05:00
2025-01-18 01:04:38 +00:00
2026-07-31 10:47:14 -07:00
2026-06-17 09:28:09 -07:00
2026-04-22 10:52:01 +01:00
2025-02-04 15:40:54 -05:00
2026-07-29 14:47:17 -07:00
2026-06-17 09:28:09 -07:00
2026-02-17 10:29:19 +01:00
2026-07-29 14:47:17 -07:00
2026-01-19 03:23:48 +00:00
2026-06-16 21:45:55 +00:00
2026-06-29 09:40:25 -07:00
2026-05-21 10:12:17 +02:00
2026-03-17 21:36:53 -04:00
2026-04-23 10:22:57 +05:30
2026-04-22 15:16:18 +00:00
2026-06-18 20:42:45 -07:00
2026-07-29 23:22:45 +08:00
2026-02-17 10:29:19 +01:00
2026-07-31 22:09:03 +12:00
2026-02-11 17:06:54 -03:30
2026-01-19 03:23:48 +00:00
2026-01-17 04:22:10 +00:00
2026-07-28 14:02:02 +02:00
2026-02-17 10:29:19 +01:00
2026-06-16 21:45:55 +00:00
2026-06-18 12:54:08 +02:00
2026-01-17 04:22:10 +00:00
2026-07-27 15:03:43 -04:00
2025-10-16 17:15:34 +00:00
2026-06-11 11:09:19 +00:00
2026-06-29 09:40:25 -07:00
2026-07-31 10:47:14 -07:00
2026-07-31 10:47:14 -07:00
2026-07-31 10:47:14 -07:00
2026-07-24 19:45:34 +07:00
2026-07-07 07:02:14 +00:00
2026-07-31 10:47:14 -07:00
2026-07-29 09:26:50 -07:00
2026-06-29 09:40:25 -07:00
2026-02-19 07:23:18 -07:00
2026-08-03 12:21:02 -05:00
2026-07-31 10:47:14 -07:00
2025-02-04 15:40:54 -05:00
2025-11-03 12:46:32 +01:00
2025-09-09 12:54:33 +00:00
2026-06-29 09:40:25 -07:00
2026-01-19 03:23:48 +00:00
2026-07-30 15:19:00 +02:00
2026-06-23 13:51:00 +00:00
2026-07-02 11:11:08 +00:00
2026-07-31 10:47:14 -07:00
2026-05-11 16:43:00 +02:00
2026-08-05 09:09:13 -04:00
2025-02-21 14:13:00 -05:00
2026-07-31 10:47:14 -07:00
2026-04-22 10:52:01 +01:00
2026-04-22 10:52:01 +01:00
2026-06-29 09:40:25 -07:00
2026-05-07 17:06:57 +02:00
2026-07-31 10:47:14 -07:00
2026-05-05 09:09:11 +00:00
2026-07-31 10:47:14 -07:00
2026-03-11 17:40:32 +01:00
2026-07-31 10:47:14 -07:00
2026-06-17 09:28:09 -07:00
2026-07-29 09:26:50 -07:00
2026-03-11 17:39:50 +01:00
2026-07-31 10:47:14 -07:00
2026-07-31 10:47:14 -07:00
2026-06-29 09:40:25 -07:00
2026-04-17 17:33:41 +02:00
2026-03-11 17:42:54 +01:00
2025-09-09 12:54:33 +00:00
2026-04-28 15:16:00 +02:00
2026-03-17 21:36:53 -04:00
2026-07-31 10:47:14 -07:00
2026-06-29 09:40:25 -07:00
2025-10-29 17:07:02 +00:00
2026-07-31 10:47:14 -07:00
2025-01-15 00:04:06 +00:00
2026-03-17 21:36:53 -04:00
2025-01-17 23:17:25 +00:00
2026-06-29 09:40:25 -07:00
2026-04-28 15:16:00 +02:00
2025-02-04 15:40:54 -05:00
2026-04-22 10:52:01 +01:00
2025-02-21 14:13:00 -05:00