IO: LogicalSubxactRead
Waiting for a read from a logical subxact file.
PostgreSQL wait event dossier
ClassIO
Event
LogicalSubxactRead
VersionsPG 14
Evidence1 source location(s)
Official description
Waiting for a read from a logical subxact file.
| PG 13 | PG 14 | PG 15 | PG 16 | PG 17 | PG 18 |
|---|---|---|---|---|---|
| — | ✓ | — | — | — | — |
Trigger mechanism
The catalog identity is present, but source audit found no live reporter in 14. Known active ranges: none. The definition location below is retained as negative evidence; this exact release cannot emit the event from a core code path. Evidence: pgsql-hackers confirmation.
Normal or trouble?
- Normal: No live core occurrence is expected on the audited release.
- Investigate: If telemetry shows it, verify the exact patch version, extension origin, and whether the sample is stale or came from a different server.
Diagnostic SQL
Sessions waiting on IO/LogicalSubxactRead
Current IO cohort
Lock and relation context for these sessions
Response
- Confirm the workload phase should touch this file class.
- Correlate with pg_stat_io where available and per-device latency.
- Fix the access path, burst shape, or affected storage tier before tuning unrelated memory settings.
Source evidence
- PostgreSQL 14.24 · src/backend/utils/activity/wait_event.c:733 —
LogicalSubxactRead
Related controls and signals
- GUCs: [guc:autovacuum_freeze_max_age] · [guc:vacuum_freeze_table_age]
- Metrics: [metric:waiting_sessions] · [metric:wait_event_share] · [metric:oldest_transaction_age] · [metric:io_read_time] · [metric:io_write_time]