Skip to content
Open
Show file tree
Hide file tree
Changes from 12 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 8 additions & 3 deletions DATA.md
Original file line number Diff line number Diff line change
Expand Up @@ -222,7 +222,7 @@ Instance-level PostgreSQL collectors. Files stored in `postgresql/`.
| File | Source | Description |
|------|--------|-------------|
| `postgresql/archiver.tsv` | `pg_stat_archiver` | WAL archiver statistics |
| `postgresql/available_extensions.tsv` | `pg_available_extensions` | Available extensions |
| `postgresql/available_extensions.tsv` | `pg_available_extension_versions` | Available extension versions with installed flag, trust and requires metadata |
| `postgresql/bgwriter.tsv` | `pg_stat_bgwriter` | Background writer statistics |
| `postgresql/blocking_locks.tsv` | Complex query | Blocking/blocked lock pairs |
| `postgresql/checkpointer.tsv` | `pg_stat_checkpointer` | Checkpointer statistics |
Expand Down Expand Up @@ -260,7 +260,9 @@ Instance-level PostgreSQL collectors. Files stored in `postgresql/`.
| `postgresql/stat_progress_copy.tsv` | `pg_stat_progress_copy` | COPY progress (PG14+) |
| `postgresql/stat_progress_create_index.tsv` | `pg_stat_progress_create_index` | CREATE INDEX progress (PG12+) |
| `postgresql/stat_progress_vacuum.tsv` | `pg_stat_progress_vacuum` | VACUUM progress (PG9.6+) |
| `postgresql/stat_replication_slots.tsv` | `pg_stat_replication_slots` | Replication slot stats incl. spill counters (PG14+) |
| `postgresql/stat_slru.tsv` | `pg_stat_slru` | SLRU cache statistics |
| `postgresql/stat_ssl.tsv` | `pg_stat_ssl` | Per-backend SSL/TLS state |
| `postgresql/stat_statements_calls.tsv` | `pg_stat_statements` | Top 100 queries by call count |
| `postgresql/stat_statements_max_time.tsv` | `pg_stat_statements` | Top 100 queries by max execution time |
| `postgresql/stat_statements_total_time.tsv` | `pg_stat_statements` | Top 100 queries by total execution time |
Expand All @@ -281,21 +283,24 @@ Collected for each accessible database. Files stored in `databases/{dbname}/`.

| File | Source | Description |
|------|--------|-------------|
| `bloat.tsv` | `pg_stats` heuristic | Table bloat estimate (heuristic) |
| `extensions.tsv` | `pg_extension` | Installed extensions |
| `funcs.tsv` | `pg_proc WHERE prokind='f'` | Functions |
| `indexes.tsv` | `pg_indexes` | Indexes |
| `indexes.tsv` | `pg_index` + `pg_stat_all_indexes` | Top 1000 indexes by size with semantic key, validity, scan counters and size |
| `languages.tsv` | `pg_language` | Procedural languages |
| `operators.tsv` | `pg_operator` | Operators |
| `partitioned_tables.tsv` | `pg_partitioned_table` | Partitioned tables (PG10+) |
| `partitions.tsv` | `pg_inherits` | Partition relationships |
| `pgstattuple.tsv` | `pgstattuple_approx()` | Authoritative bloat (when `pgstattuple` extension is installed) |
| `procs.tsv` | `pg_proc WHERE prokind='p'` | Procedures (PG11+) |
| `publication_tables.tsv` | `pg_publication_tables` | Tables in publications |
| `publications.tsv` | `pg_publication` | Logical replication publications |
| `schemas.tsv` | `pg_namespace` | Schemas |
| `sequences.tsv` | `pg_sequences` | Sequences with last/min/max values (PG10+) |
| `stat_database.tsv` | `pg_stat_database` | Per-database statistics |
| `statistics.tsv` | `pg_statistic_ext` | Extended statistics (PG10+) |
| `subscription_tables.tsv` | `pg_subscription_rel` | Subscription relation states |
| `tables.tsv` | `pg_tables` | Tables |
| `tables.tsv` | `pg_class` + `pg_stat_all_tables` | Top 1000 tables by size with persistence, options, heap and table sizes, toast mapping, dead-tup counters and vacuum/analyze timestamps |
| `triggers.tsv` | `pg_trigger` | Triggers |
| `types.tsv` | `pg_type` | Data types |

Expand Down
11 changes: 6 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -187,19 +187,20 @@ For a complete reference of all collected data, see [docs/data.md](docs/data.md)

- **Configuration & files**: `pg_db_role_setting`, `pg_file_settings`, `pg_hba.conf`, `pg_hba_file_rules`, `pg_ident.conf`, `pg_settings`, `pg_tablespace`, `postgresql.auto.conf`, `postgresql.conf`, `recovery.conf`, `recovery.done`
- **Activity & monitoring**: `pg_locks`, `pg_postmaster_start_time()`, `pg_prepared_xacts`, `pg_shmem_allocations`, `pg_stat_activity`
- **Statistics views**: `pg_stat_archiver`, `pg_stat_bgwriter`, `pg_stat_checkpointer` (PG17+), `pg_stat_database_conflicts`, `pg_stat_io` (PG16+), `pg_stat_slru`, `pg_stat_statements` (if installed), `pg_stat_wal` (PG14+), `pg_stat_wal_receiver`
- **Replication & WAL**: `pg_current_wal_lsn()`, `pg_replication_origin_status`, `pg_replication_slots`, `pg_stat_replication`, `pg_subscription`
- **Statistics views**: `pg_stat_archiver`, `pg_stat_bgwriter`, `pg_stat_checkpointer` (PG17+), `pg_stat_database_conflicts`, `pg_stat_io` (PG16+), `pg_stat_slru`, `pg_stat_ssl`, `pg_stat_statements` (if installed), `pg_stat_wal` (PG14+), `pg_stat_wal_receiver`
- **Replication & WAL**: `pg_current_wal_lsn()`, `pg_replication_origin_status`, `pg_replication_slots`, `pg_stat_replication`, `pg_stat_replication_slots` (PG14+, spill counters), `pg_subscription`
- **Progress tracking**: `pg_stat_progress_analyze`, `pg_stat_progress_basebackup`, `pg_stat_progress_cluster`, `pg_stat_progress_copy`, `pg_stat_progress_create_index`, `pg_stat_progress_vacuum`
- **Catalog**: `pg_available_extensions`, `pg_database`, `pg_database_size()`, `pg_roles`, `pg_tablespace_size()`, `version()`
- **Catalog**: `pg_available_extension_versions`, `pg_database` (incl. `datfrozenxid`/`datminmxid` wraparound headroom and `datconnlimit`), `pg_database_size()`, `pg_roles`, `pg_tablespace_size()`, `version()`

**Per-Database**

- **Schema objects**: `pg_indexes`, `pg_namespace`, `pg_operator`, `pg_tables`, `pg_type`
- **Schema objects**: `pg_class` + `pg_stat_all_tables` (tables incl. dead-tup counters, vacuum/analyze timestamps, `reloptions`, `reltoastrelid`, `relpersistence`), `pg_index` + `pg_stat_all_indexes` (indexes incl. validity, scan counters, size), `pg_namespace`, `pg_operator`, `pg_sequences`, `pg_type`
- **Functions & procedures**: `pg_proc`
- **Triggers & partitioning**: `pg_inherits`, `pg_partitioned_table`, `pg_trigger`
- **Logical replication**: `pg_publication`, `pg_publication_tables`, `pg_subscription_rel`
- **Extensions**: `pg_extension`, `pg_language`, `pg_statistic_ext`
- **Extensions**: `pg_extension`, `pg_language`, `pg_statistic_ext`, `pgstattuple` (if installed — authoritative bloat estimate via `pgstattuple_approx()`)
- **Statistics**: `pg_stat_database` (conflicts, deadlocks, temp files, stats reset)
- **Bloat estimate**: heuristic from `pg_stats` (always emitted)

**[pg_statviz](https://github.com/vyruss/pg_statviz) Extension** (if present)

Expand Down
11 changes: 8 additions & 3 deletions docs/data.md
Original file line number Diff line number Diff line change
Expand Up @@ -222,7 +222,7 @@ Instance-level PostgreSQL collectors. Files stored in `postgresql/`.
| File | Source | Description |
|------|--------|-------------|
| `postgresql/archiver.tsv` | `pg_stat_archiver` | WAL archiver statistics |
| `postgresql/available_extensions.tsv` | `pg_available_extensions` | Available extensions |
| `postgresql/available_extensions.tsv` | `pg_available_extension_versions` | Available extension versions with installed flag, trust and requires metadata |
| `postgresql/bgwriter.tsv` | `pg_stat_bgwriter` | Background writer statistics |
| `postgresql/blocking_locks.tsv` | Complex query | Blocking/blocked lock pairs |
| `postgresql/checkpointer.tsv` | `pg_stat_checkpointer` | Checkpointer statistics |
Expand Down Expand Up @@ -260,7 +260,9 @@ Instance-level PostgreSQL collectors. Files stored in `postgresql/`.
| `postgresql/stat_progress_copy.tsv` | `pg_stat_progress_copy` | COPY progress (PG14+) |
| `postgresql/stat_progress_create_index.tsv` | `pg_stat_progress_create_index` | CREATE INDEX progress (PG12+) |
| `postgresql/stat_progress_vacuum.tsv` | `pg_stat_progress_vacuum` | VACUUM progress (PG9.6+) |
| `postgresql/stat_replication_slots.tsv` | `pg_stat_replication_slots` | Replication slot stats incl. spill counters (PG14+) |
| `postgresql/stat_slru.tsv` | `pg_stat_slru` | SLRU cache statistics |
| `postgresql/stat_ssl.tsv` | `pg_stat_ssl` | Per-backend SSL/TLS state |
| `postgresql/stat_statements_calls.tsv` | `pg_stat_statements` | Top 100 queries by call count |
| `postgresql/stat_statements_max_time.tsv` | `pg_stat_statements` | Top 100 queries by max execution time |
| `postgresql/stat_statements_total_time.tsv` | `pg_stat_statements` | Top 100 queries by total execution time |
Expand All @@ -281,21 +283,24 @@ Collected for each accessible database. Files stored in `databases/{dbname}/`.

| File | Source | Description |
|------|--------|-------------|
| `bloat.tsv` | `pg_stats` heuristic | Table bloat estimate (heuristic) |
| `extensions.tsv` | `pg_extension` | Installed extensions |
| `funcs.tsv` | `pg_proc WHERE prokind='f'` | Functions |
| `indexes.tsv` | `pg_indexes` | Indexes |
| `indexes.tsv` | `pg_index` + `pg_stat_all_indexes` | Top 1000 indexes by size with semantic key, validity, scan counters and size |
| `languages.tsv` | `pg_language` | Procedural languages |
| `operators.tsv` | `pg_operator` | Operators |
| `partitioned_tables.tsv` | `pg_partitioned_table` | Partitioned tables (PG10+) |
| `partitions.tsv` | `pg_inherits` | Partition relationships |
| `pgstattuple.tsv` | `pgstattuple_approx()` | Authoritative bloat (when `pgstattuple` extension is installed) |
| `procs.tsv` | `pg_proc WHERE prokind='p'` | Procedures (PG11+) |
| `publication_tables.tsv` | `pg_publication_tables` | Tables in publications |
| `publications.tsv` | `pg_publication` | Logical replication publications |
| `schemas.tsv` | `pg_namespace` | Schemas |
| `sequences.tsv` | `pg_sequences` | Sequences with last/min/max values (PG10+) |
| `stat_database.tsv` | `pg_stat_database` | Per-database statistics |
| `statistics.tsv` | `pg_statistic_ext` | Extended statistics (PG10+) |
| `subscription_tables.tsv` | `pg_subscription_rel` | Subscription relation states |
| `tables.tsv` | `pg_tables` | Tables |
| `tables.tsv` | `pg_class` + `pg_stat_all_tables` | Top 1000 tables by size with persistence, options, heap and table sizes, toast mapping, dead-tup counters and vacuum/analyze timestamps |
| `triggers.tsv` | `pg_trigger` | Triggers |
| `types.tsv` | `pg_type` | Data types |

Expand Down
11 changes: 6 additions & 5 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -164,19 +164,20 @@ For a complete reference of all collected data, see [data.md](data.md).

- **Configuration & files**: `pg_db_role_setting`, `pg_file_settings`, `pg_hba.conf`, `pg_hba_file_rules`, `pg_ident.conf`, `pg_settings`, `pg_tablespace`, `postgresql.auto.conf`, `postgresql.conf`, `recovery.conf`, `recovery.done`
- **Activity & monitoring**: `pg_locks`, `pg_postmaster_start_time()`, `pg_prepared_xacts`, `pg_shmem_allocations`, `pg_stat_activity`
- **Statistics views**: `pg_stat_archiver`, `pg_stat_bgwriter`, `pg_stat_checkpointer` (PG17+), `pg_stat_database_conflicts`, `pg_stat_io` (PG16+), `pg_stat_slru`, `pg_stat_statements` (if installed), `pg_stat_wal` (PG14+), `pg_stat_wal_receiver`
- **Replication & WAL**: `pg_current_wal_lsn()`, `pg_replication_origin_status`, `pg_replication_slots`, `pg_stat_replication`, `pg_subscription`
- **Statistics views**: `pg_stat_archiver`, `pg_stat_bgwriter`, `pg_stat_checkpointer` (PG17+), `pg_stat_database_conflicts`, `pg_stat_io` (PG16+), `pg_stat_slru`, `pg_stat_ssl`, `pg_stat_statements` (if installed), `pg_stat_wal` (PG14+), `pg_stat_wal_receiver`
- **Replication & WAL**: `pg_current_wal_lsn()`, `pg_replication_origin_status`, `pg_replication_slots`, `pg_stat_replication`, `pg_stat_replication_slots` (PG14+, spill counters), `pg_subscription`
- **Progress tracking**: `pg_stat_progress_analyze`, `pg_stat_progress_basebackup`, `pg_stat_progress_cluster`, `pg_stat_progress_copy`, `pg_stat_progress_create_index`, `pg_stat_progress_vacuum`
- **Catalog**: `pg_available_extensions`, `pg_database`, `pg_database_size()`, `pg_roles`, `pg_tablespace_size()`, `version()`
- **Catalog**: `pg_available_extension_versions`, `pg_database` (incl. `datfrozenxid`/`datminmxid` wraparound headroom and `datconnlimit`), `pg_database_size()`, `pg_roles`, `pg_tablespace_size()`, `version()`

**Per-Database**

- **Schema objects**: `pg_indexes`, `pg_namespace`, `pg_operator`, `pg_tables`, `pg_type`
- **Schema objects**: `pg_class` + `pg_stat_all_tables` (tables incl. dead-tup counters, vacuum/analyze timestamps, `reloptions`, `reltoastrelid`, `relpersistence`), `pg_index` + `pg_stat_all_indexes` (indexes incl. validity, scan counters, size), `pg_namespace`, `pg_operator`, `pg_sequences`, `pg_type`
- **Functions & procedures**: `pg_proc`
- **Triggers & partitioning**: `pg_inherits`, `pg_partitioned_table`, `pg_trigger`
- **Logical replication**: `pg_publication`, `pg_publication_tables`, `pg_subscription_rel`
- **Extensions**: `pg_extension`, `pg_language`, `pg_statistic_ext`
- **Extensions**: `pg_extension`, `pg_language`, `pg_statistic_ext`, `pgstattuple` (if installed — authoritative bloat estimate via `pgstattuple_approx()`)
- **Statistics**: `pg_stat_database` (conflicts, deadlocks, temp files, stats reset)
- **Bloat estimate**: heuristic from `pg_stats` (always emitted)

**[pg_statviz](https://github.com/vyruss/pg_statviz) Extension** (if present)

Expand Down
Loading
Loading