PG Exporter — PostgreSQL Metrics Exporter for Prometheus on PG Exporter

pg_exporter v1.4.1

Wed, 29 Jul 2026 21:31:19 +0800

v1.4.1 is a maintenance release focused on metric accuracy and RPM upgrade compatibility.

Highlights

Fix pg_subrel_count overcounting when parallel logical replication apply workers are active: deduplicate pg_stat_subscription by subscription ID and name before aggregating subscription relation states
If a query result omits a configured LABEL column, that collector’s scrape now fails atomically instead of emitting an empty label or retaining stale results; other non-fatal collectors continue normally
Rename the official RPM package and artifact prefix from pg_exporter to pg-exporter; the new package provides and obsoletes the legacy name, allowing direct upgrades
Refresh version and standalone package metadata, add missing-label regression coverage, and validate RPM configuration, artifact names, and compatibility metadata in CI

Upgrade Notes

Custom collector SQL must return every LABEL column; the result schema must remain complete even when the query returns zero rows
If automation matches GitHub RPM file names directly, update pg_exporter-*.rpm to pg-exporter-*.rpm

Release resources

Introduction

Mon, 01 Jan 0001 00:00:00 +0000

pg_exporter turns PostgreSQL and pgBouncer runtime state into Prometheus metrics. Unlike an exporter with a fixed list of hard-coded queries, most of its metric surface is declared in YAML: a collector defines SQL, result columns, labels, metric types, eligibility rules, timeouts, and caching policy.

That design gives operators two useful properties at once:

a release ships with a broad, tested default metric set;
local teams can add, remove, or specialize metrics without rebuilding the binary.

The Data Path

A normal scrape passes through six stages:

pg_exporter v1.4.0

Sat, 18 Jul 2026 10:41:26 +0800

v1.4.0 introduces the Snapshot Histogram metric type and the new pg_xact_age transaction age collector, along with a round of systematic hardening across HTTP routing, packaging, and the build toolchain.

New Features

New HISTOGRAM column type: SQL query snapshots can be aggregated per label group into classic Prometheus histograms, deriving _bucket / _count / _sum series families; bucket bounds are strictly validated at config load time (finite, strictly increasing, +Inf appended automatically), le becomes a reserved label, and hot reload is fully supported
New pg_xact_age collector: exposes the distribution of open transaction age (pg_xact_age_seconds) and idle-in-transaction age (pg_xact_age_idle_seconds) as histograms; cluster-level collection, client backends only, 10s TTL
Default config bundle grows from 57 to 58 definition files; pg_xact_age takes slot 0450, with pg_lock / pg_lock_stat / pg_query renumbered to 0460 / 0470 / 0480 (contents unchanged)

Fixes & Improvements

HTTP route registration is isolated to a private ServeMux instead of the global DefaultServeMux, so endpoints registered by third-party libraries can no longer be exposed accidentally
--web.telemetry-path is strictly validated at startup: empty paths, paths not starting with /, paths containing ? # { }, conflicts with built-in endpoints, and non-canonical paths like //metrics that could never be matched all fail fast with a clear error
The landing page HTML-escapes the telemetry path
The primary connection pool is properly closed when --fail-fast pre-check fails
RPM / DEB packaging fixes (#105): the prometheus system user’s HOME now points to /var/lib/prometheus (where libpq looks for ~/.pgpass), and the packaged default URL gains the /postgres database name so libpq no longer falls back to a database named after the OS user
Version string unified with the v prefix: --version output, the /version endpoint, and the pg_exporter_build_info{version=...} label of official release binaries now report v1.4.0 (GoReleaser artifacts previously reported unprefixed 1.3.0); artifact file names, package versions, and Docker image tag conventions are unchanged
Histogram value casting aligned with the scalar path: timestamp and boolean columns are exempt from scale
GoReleaser embedded package metadata corrected: supported range updated to PostgreSQL 9.x - 19+ and pgBouncer 1.8 - 1.25+
make docker restores GOPROXY / GOSUMDB build-arg passthrough

Engineering & Build

Build toolchain updated to Go 1.26.5, exporter-toolkit v0.17.1, and prometheus/common v0.70.0
New regular CI verification workflow: module tidy check, generated-config drift check (make conf output must stay in sync with config/*.yml), race tests, and six-platform cross-builds
Docker build tooling consolidated: the docker/ scripts and make docker-release are removed; multi-arch release images are built by GoReleaser
Config coverage tests generalized: tests no longer assume specific collectors exist in the config directory, making trimmed custom bundles easier to maintain

Upgrade Notes

If you were running with a non-canonical telemetry path (e.g. //metrics), the process will now refuse to start — previously it started but the metrics endpoint was silently unreachable
Automation that parses the version label of pg_exporter_build_info or the --version output needs to accommodate the v prefix
When any HISTOGRAM collector is configured, le can no longer be used as a constant label

Checksums

https://github.com/pgsty/pg_exporter/releases/download/v1.4.0/checksums.txt

Getting Started

Mon, 01 Jan 0001 00:00:00 +0000

This page is the shortest path: install pg_exporter, connect it to a PostgreSQL instance, verify metrics output, and hook it into Prometheus.

You only need two things: a reachable PostgreSQL 10-19+ (or pgBouncer 1.8+) instance, and permission to create a user in it. For older PostgreSQL 9.1-9.6 instances, see Compatibility.

Step 1: Install

On Linux amd64 you can download the binary directly (for other platforms and RPM/DEB/Docker options, see the Installation guide):

pg_exporter v1.3.0

Wed, 24 Jun 2026 12:04:24 +0800

v1.3.0 adds PostgreSQL 19 support, and refreshes the default collector bundle, build toolchain, and config coverage tests.

Highlights

Default support range extended from PostgreSQL 10-18+ to 10-19+
Default config bundle includes 57 config/*.yml definition files
Build dependencies updated to Go 1.26.4, lib/pq v1.12.3, Prometheus client v1.23.2, and exporter-toolkit v0.16.0
pg_recovery_state: collect pg_stat_recovery on recovery nodes, exposing promotion trigger status, replay LSN, timeline, recovery transaction time, and pause state
pg_lock_stat: collect PG19 pg_stat_lock, exposing waits, wait time, and fast-path overflow counts by locktype
pg_vacuum_score: collect the current-database summary from pg_stat_autovacuum_scores, exposing max autovacuum score and candidate table count
pg_wal_19: expose wal_fpi_bytes on PG19 as pg_wal_fpi_bytes
pg_sub_19: adapt sequence sync and logical replication conflict stats from pg_stat_subscription_stats, while keeping sync_error_count for legacy dashboards
pg_recv: recognize the PG13+ WAL receiver connecting state on PG19
pg_slot: recognize the PG19 replication slot invalidation reason idle_timeout
pg_db_confl: switch to an explicit column list to avoid accidentally exporting future view columns
pg_backup, pg_vacuuming, and pg_clustering continue reusing stable existing branches instead of changing the metric surface for low-value PG19 fields

Checksums

https://github.com/pgsty/pg_exporter/releases/download/v1.3.0/checksums.txt

Installation

Mon, 01 Jan 0001 00:00:00 +0000

pg_exporter can be installed via Pigsty, YUM/APT repositories, GitHub release packages (RPM/DEB/Tarball), Docker images, or built from source — pick whichever fits your infrastructure.

Pigsty

The easiest way to get started with pg_exporter is to use Pigsty, which is a complete PostgreSQL distribution with built-in Observability best practices based on pg_exporter, Prometheus, and Grafana. You don’t even need to know any details about pg_exporter; it just gives you all the metrics and dashboard panels.

pg_exporter v1.2.2

Tue, 14 Apr 2026 20:09:59 +0800

v1.2.2 is a routine maintenance release that only refreshes the release toolchain to Go 1.26.2. It does not introduce new collectors, config semantics, or runtime behavior changes.

Highlights

Refresh the release toolchain: bump release builds to Go 1.26.2
No functional changes: collector behavior, default configs, metric definitions, and runtime semantics remain unchanged

Checksums

https://github.com/pgsty/pg_exporter/releases/download/v1.2.2/checksums.txt

273dfd45ac367f71044998d19171ee27d7deb094ec9410d4b31aef7caacfdcc6  pg-exporter_1.2.2-1_amd64.deb
5e83c8448ee6350bec96ab95550df439a129c6700e5c9c7d0f9411aa9c2e7f40  pg-exporter_1.2.2-1_arm64.deb
97bb804bd1018c111708df9118561421d2cc51bd47d031b6d1f12cf1c988a3b2  pg-exporter_1.2.2-1_ppc64le.deb
b2f76799b21aba02b6bf5b6e71bf7ae2cf4487ad8817d53aad92f1d710c00120  pg_exporter-1.2.2-1.aarch64.rpm
f0ab38907bc87a9634c22911d8a0501634d58ce34020c0952dd49281a06787e6  pg_exporter-1.2.2-1.ppc64le.rpm
2000593d9d6732f3e03a43e291bc4e2368d2ecea125a2744dc533a030f51c800  pg_exporter-1.2.2-1.x86_64.rpm
e8a71704eb6957beaebd8ecaf83479e44db4a09bd9dc95c32f7b617f141b0386  pg_exporter-1.2.2.darwin-amd64.tar.gz
e648d9444f9a5f3ee49b82bcbbb459eefd73307c789f24f0d5238dbe1bcfec9c  pg_exporter-1.2.2.darwin-arm64.tar.gz
f278aba93d09b2a47aeef66898e770cacfdbc046eab0ba02de29f7c0261d9ede  pg_exporter-1.2.2.linux-amd64.tar.gz
bbeef56452643b8eb6bf9bb5baf113ab2c38177c06f8e1d008e63cce82260801  pg_exporter-1.2.2.linux-arm64.tar.gz
ad2385278ec6060fef2f7db7873c025f56f5c55048b51815cb4195486ca9dbe2  pg_exporter-1.2.2.linux-ppc64le.tar.gz
2ac53298058f09c5569464f918396f13d3a9efebec00296d89497e97ea74caf4  pg_exporter-1.2.2.windows-amd64.tar.gz

Release resources

Compatibility

Mon, 01 Jan 0001 00:00:00 +0000

Compatibility has three separate layers: the exporter binary must run on the host, the selected collector branch must match the target server, and optional SQL objects or extensions must exist. “The process starts” therefore does not prove that every collector is eligible.

Database Targets

Target	Status	Configuration
PostgreSQL 10-18	Default support	`pg_exporter.yml` / `config/`
PostgreSQL 19	Collector branches included	Default config; validate against the current pre-release/final server build
PostgreSQL 9.1-9.6	Legacy support	`legacy/pg_exporter.yml` / `legacy/config/`
PostgreSQL 9.0 and older	Unsupported	—
pgBouncer 1.8-1.25+	Supported	`0910`-`0940` collector files; connect to the admin database

PostgreSQL 19-specific branches cover new recovery, lock, autovacuum-score, WAL, subscription, receiver, and slot fields. As of August 2026, PostgreSQL 19 is still in beta; the PostgreSQL project states that beta builds are for testing rather than production. Check the current PostgreSQL beta status before deploying a PG19 target.

pg_exporter v1.2.1

Sat, 21 Mar 2026 09:23:31 +0800

v1.2.1 is a lightweight maintenance release focused on release engineering, config package consistency, and documentation/metadata refresh. It does not introduce new collector semantics or runtime behavior changes.

Highlights

Refresh the build toolchain: bump both release workflows and Docker build images to Go 1.26.1
Standardize config style: switch inline description values in both current and legacy configs to double-quoted form, and regenerate merged pg_exporter.yml / legacy/pg_exporter.yml
Add config consistency tests: verify split and merged configs remain equivalent, and check inline metric description style to reduce configuration drift
Refresh packaging metadata: update RPM / DEB support descriptions to PostgreSQL 9.x - 18+ and pgBouncer 1.8 - 1.25+, and refresh Pigsty documentation links

Checksums

2cbe7a78a0dde8a6155a543232af883de6623531c9f6ea0951ddc30dc7514649  pg-exporter_1.2.1-1_amd64.deb
e70e09974ad52ba607b176b63c300610e37f44fe67d249aa9ef364bd58352585  pg-exporter_1.2.1-1_arm64.deb
4e6c7fae85e7fe2e62c3d66c388b5f3db57b5e95e85f43ce648d21b792d83d87  pg-exporter_1.2.1-1_ppc64le.deb
30103629e8c5c1ee5589addadb37fcb07b43179c8a19f80c016a0ed8d7ac2a47  pg_exporter-1.2.1-1.aarch64.rpm
01b4dd32b20bca8612f71f0edf3557dfa92fc85f669d3260f627d34ce102b517  pg_exporter-1.2.1-1.ppc64le.rpm
5afb4f14aa71b256cdfc93d6cc6da8a7052427d6f1c1b71900bf2593b196de50  pg_exporter-1.2.1-1.x86_64.rpm
45e71c6017beffabf2873841d374b5de40eb499dd768d6db1208d7cc6295bcf5  pg_exporter-1.2.1.darwin-amd64.tar.gz
d3035cc6a023fe1bad5443a7c1d5c8189b3d807d165f131f88566b5c35476259  pg_exporter-1.2.1.darwin-arm64.tar.gz
14d3f83de4377e5363611d2ae4eef9470a85d7518784c06b8a8c0f63b6e0a340  pg_exporter-1.2.1.linux-amd64.tar.gz
71082081e7aaf1cf15c941c310d03da49cf9971205274aad7dae21a126bc4fe1  pg_exporter-1.2.1.linux-arm64.tar.gz
cba30919b8d2945be199a4a346eb2891c88fd7a1d6c3482c1006442f4f6109e7  pg_exporter-1.2.1.linux-ppc64le.tar.gz
6fe528a242f0bbd3b89cd8b2697f48905b5c4b1398abfb3305193808c01738e9  pg_exporter-1.2.1.windows-amd64.tar.gz

Release resources

Production Deployment

Mon, 01 Jan 0001 00:00:00 +0000

This page covers what it takes to run pg_exporter in production: process arguments and environment variables, monitoring user and credential management, the systemd / Docker / Kubernetes deployment forms, pgBouncer and auto-discovery, plus scrape and alerting configuration on the Prometheus side.

Process-level configuration comes from two sources, in decreasing precedence:

Command-line arguments (--url, --config, …)
Environment variables (every flag has a corresponding PG_EXPORTER_* variable)

Metric collection behavior is entirely driven by YAML collector definitions (default /etc/pg_exporter.yml, or a config directory) — see the Configuration reference.

pg_exporter v1.2.0

Thu, 12 Feb 2026 19:37:24 +0800

v1.2.0 is a stability-and-compatibility focused minor release across startup flow, hot reload, health probing, config validation, and legacy support.

New Features

Add robust hot reload workflow: support platform-specific reload signals (SIGHUP / SIGUSR1) and strengthen POST /reload to refresh configs and query plans without process restart
Switch startup to non-blocking mode: HTTP endpoints come up first even when target precheck fails, making recovery and monitoring integration smoother
Add PostgreSQL 9.1-9.6 legacy config bundle: provide legacy/ configs and a make conf9 target for easier onboarding of EOL PostgreSQL versions
Rework health probing architecture: use cached health snapshots with periodic probes for more consistent role-based health endpoints and smoother reload behavior
Improve release engineering baseline: run go test and go vet in release workflows and bump build toolchain to Go 1.26.0

Bug Fixes

Fix multiple config parsing edge cases: reject malformed metrics entries, return explicit errors when config dirs fail to load valid YAML, and harden runtime fallbacks
Fix CLI bool flag parsing to correctly handle --flag=false style arguments
Fix /explain output/rendering behavior by adjusting content type handling and using safer template rendering
Fix predicate query and PG URL handling details: better BOOL/BOOLEAN predicate support, safer row lifecycle handling, and improved dbname query-parameter parsing/redaction
Fix resource cleanup when auto-discovered targets are removed by closing dropped server connections asynchronously
Fix metric/label validation details including const-label conflict checks, scaled default-value handling, and Prometheus naming/rule checks

Checksums

26e7a052e730b412bbbe5f49846f951b89650f1f95c2466d5d486923f0825f64  pg-exporter_1.2.0-1_amd64.deb
4ec219135c49708d010af7b8a7553b8008f630574e1d4cfc7642fbf951eefafe  pg-exporter_1.2.0-1_arm64.deb
5b2cc00e2c3e2ffd9eb0ab1a4f5e937dd68f3a69a14423a74d4de3d7cf29283e  pg-exporter_1.2.0-1_ppc64le.deb
d536d41a92e8aa85ae3935715d1bf0463208b1e614eae73543f1472ca8a7e0d4  pg_exporter-1.2.0-1.aarch64.rpm
b7a1daa225f8ca4de6d227e6004330589295d924accd221892ebe14f191fe35c  pg_exporter-1.2.0-1.ppc64le.rpm
28bf7d85862510675c64ff5181d216c6a068a23ffa56dc4bb9e6b82165ff99b5  pg_exporter-1.2.0-1.x86_64.rpm
51c3b3d18089d888a54a6b3e7ecb0620dc0da04c81471a0b7aaa88c1677ddb8c  pg_exporter-1.2.0.darwin-amd64.tar.gz
3ba1c7adea9c926afd3054ba18cc43e665e420a495bfcfd2248242c49a67b077  pg_exporter-1.2.0.darwin-arm64.tar.gz
9e1ec6c15e6b2aaadbe27a27053ee1ec289bdd012c19ca6371de738fa5f8843e  pg_exporter-1.2.0.linux-amd64.tar.gz
9e18849693ccda313979db0a230cb81acfe4199364feb6ce3e72d1a89fbfb809  pg_exporter-1.2.0.linux-arm64.tar.gz
6e28489685d0bd1fdabcb71474f64f559ade199b871666954323bae9dc01465f  pg_exporter-1.2.0.linux-ppc64le.tar.gz
9e9beac619fe2c614a77bc3334bc4b80df9db355bf95845eb4b11674ddad52d9  pg_exporter-1.2.0.windows-amd64.tar.gz

Release resources

Security

Mon, 01 Jan 0001 00:00:00 +0000

pg_exporter sits between two trust domains: it authenticates to PostgreSQL or pgBouncer, then exposes metrics and management endpoints over HTTP. Secure both sides independently. Database TLS does not protect the HTTP listener, and HTTP Basic Auth does not reduce database privileges.

Threat Surface

Surface	Sensitive capability	Primary control
PostgreSQL connection	Read monitoring views and execute collector SQL	Dedicated login, `pg_monitor`, `pg_hba.conf`, TLS
Target URL	Contains host, user, and often a password	`.pgpass`, secret file, file permissions, secret manager
`/metrics`	Reveals topology, object names, workload, and capacity	Private network, firewall, TLS/auth
`/explain` and `/stat`	Reveal collector definitions, eligibility, timing, and errors	Restrict or authenticate HTTP access
`/reload`	Triggers config parsing and an atomic query-plan replacement	Restrict or authenticate HTTP access
Collector SQL	Consumes database resources and may expose labels	Query review, least privilege, timeout, TTL, cardinality review

Use a Dedicated Database Role

For PostgreSQL 10+, the built-in pg_monitor role covers the read permissions needed by the default collectors:

pg_exporter v1.1.2

Thu, 15 Jan 2026 23:06:15 +0800

Minor release fixing pg_timeline configuration issue and building with latest go deps

Checksums

https://github.com/pgsty/pg_exporter/releases/download/v1.1.2/checksums.txt

8cddd57a843914a3145a80a3220bc875047b9bcac0664357c01ba86485436236  pg-exporter_1.1.2-1_amd64.deb
f5b25a8ae5c022867a54c17ba1c6493eba20dcb292340460390289336df24f04  pg-exporter_1.1.2-1_arm64.deb
4da2c287f6717681b25befda0d59a89b9d1b258281ce94f3a6bc21d02f70c83c  pg-exporter_1.1.2-1_ppc64le.deb
b26355f3c1a5b8a147291a51e2d7ada204deed6d52877c146a8b3e499defa5e8  pg_exporter-1.1.2-1.aarch64.rpm
42ef89716ba99dd918b0e9c77ef3236129d613f68bb8ae5929668a5a2596cca5  pg_exporter-1.1.2-1.ppc64le.rpm
a8f4a2d5c7b6701c7bac788a7ed7183b6c4b74a334326cd389f3a695fb77675d  pg_exporter-1.1.2-1.x86_64.rpm
775f5ea3188a6acb1327c001c4ba9a0651424c3bb37d800e6f67972c904c4750  pg_exporter-1.1.2.darwin-amd64.tar.gz
7f2bbcc2db1e16dc78c3edd8e67e20e4ec81f2972c8c37135cba6f6afbf91003  pg_exporter-1.1.2.darwin-arm64.tar.gz
33c34b1f9ef6b6e7615f241a95059a8137a2337a454930b668180a9329d12b98  pg_exporter-1.1.2.linux-amd64.tar.gz
2b91a5818d780e38692ab6446cacb496695e67388676c18012be582e8ddfbdd8  pg_exporter-1.1.2.linux-arm64.tar.gz
adcb5f229f4a5d641f6430b9a2dfb0377a2e4310efad242730867d6cdf5e27ee  pg_exporter-1.1.2.linux-ppc64le.tar.gz
90b7c7e4b2b94936b5faa3cf2d35509b62ebc0d60b3afe1abaaf03efcd415a4a  pg_exporter-1.1.2.windows-amd64.tar.gz

Release resources

Troubleshooting

Mon, 01 Jan 0001 00:00:00 +0000

Start by separating four layers: process, HTTP, database connectivity, and individual collectors. A running systemd unit only proves the process layer; pg_up 1 proves the current target connection and fatal collector path; a successful Prometheus scrape proves the end-to-end HTTP path.

Five-Minute Triage

# Process and logs
systemctl status pg_exporter --no-pager
journalctl -u pg_exporter -n 100 --no-pager

# HTTP and build identity
curl -fsS http://127.0.0.1:9630/version
curl -i http://127.0.0.1:9630/up

# Core metrics
curl -fsS http://127.0.0.1:9630/metrics \
  | grep -E '^(pg|pgbouncer)_(up|version|in_recovery) '

# Planning and runtime evidence
curl -fsS http://127.0.0.1:9630/explain
curl -fsS http://127.0.0.1:9630/stat

Observation	Layer to investigate
Unit exits immediately	Arguments, config path, telemetry path, listen address, file permissions
Port answers but `/up` is 503	Target URL, network, authentication, `pg_hba.conf`, TLS, startup probe state
`/up` is 200 but a metric family is absent	Dynamic plan, version/role/tags/predicates, auto-discovery, disabled collector
`/metrics` returns an error or Prometheus times out	Fatal collector, slow query, scrape timeout, label/schema mismatch
Exporter is healthy but Prometheus target is down	Prometheus address, scheme, auth, TLS, firewall, telemetry path

Process Will Not Start

`no valid config path`

The config search order is --config, PG_EXPORTER_CONFIG, ./pg_exporter.yml, /etc/pg_exporter.yml, then /etc/pg_exporter. Confirm the file exists and is readable by the runtime user:

pg_exporter v1.1.1

Wed, 31 Dec 2025 00:03:31 +0800

Minor release with new collectors and bug fixes.

New Features

New pg_timeline collector for timeline monitoring
New pg_sub_16 collector branch to exclude parallel operations in subscriptions (PostgreSQL 16+ compatibility)

Bug Fixes

Fix: Add coalesce for slotname in pg_recv collector to handle NULL values

Checksums

https://github.com/pgsty/pg_exporter/releases/download/v1.1.1/checksums.txt

fd5ee96511676fc11b975115a4870ed0c811056519f79ad7f24ab7ec538fa278  pg-exporter_1.1.1-1_amd64.deb
b90a08d16a6e4707d82f8f3ae282cb76acb331de607e7544532fd0b774b7aa27  pg-exporter_1.1.1-1_arm64.deb
163955f59a71da48901ffa26bb2f2db0712d31d8aeb1ab3fa463683f719a6d3a  pg-exporter_1.1.1-1_ppc64le.deb
cf4f8bc12bb8a2d1e55553f891fd31c43324e4348249727972eb44f82cd4e6c8  pg_exporter-1.1.1-1.aarch64.rpm
5a425b2f61f308b32f2d107372830c34eb685bfb312ee787f11877a20f1c4a2e  pg_exporter-1.1.1-1.ppc64le.rpm
23606ccea565368971ac2e7f39766455b507021f09457bcf61db13cb10501a16  pg_exporter-1.1.1-1.x86_64.rpm
ce74624eba92573318f50764cee4f355fa1f35697d209f70a4240f8f9d976188  pg_exporter-1.1.1.darwin-amd64.tar.gz
35fba12521dbdcc54a3792278ed4822e4ca9e951665b5e53dff7c2a0f7014ae3  pg_exporter-1.1.1.darwin-arm64.tar.gz
7699bdef15dd306289645beee8d40a123ca75dc988e46d89cdd75a1c1f650bef  pg_exporter-1.1.1.linux-amd64.tar.gz
f4baba59d27a8eb67f0c5209fed7b9f00f78db796e583cc3487701e7803671c6  pg_exporter-1.1.1.linux-arm64.tar.gz
810c3817c27358fa667714f8bfe8d52840a7ea010035e29547919ccb7c9fa781  pg_exporter-1.1.1.linux-ppc64le.tar.gz
3f6df693b3eb92fdaeaeccf99ea7e5977b2c65028a4f00bdfabbc0405b9f5f93  pg_exporter-1.1.1.windows-amd64.tar.gz

Release resources

pg_exporter v1.1.0

Mon, 15 Dec 2025 14:09:58 +0800

Build with Go 1.25.5 and latest dependencies, collector updates:

Collector Changes

pg_setting: Major refactor for PG10-18 compatibility with missing_ok support
- Add 13 new metrics: max_parallel_workers, max_parallel_workers_per_gather, max_parallel_maintenance_workers, shared_buffers, maintenance_work_mem, effective_cache_size, fsync, full_page_writes, autovacuum, autovacuum_max_workers, checkpoint_timeout, checkpoint_completion_target, hot_standby, synchronous_commit, io_method
- Rename work_memory_size to work_mem
- Change min_version from 9.6 to 10, explicit ::int type casting
pg_size: Fix log directory size detection, use logging_collector check instead of path pattern matching
pg_table: Performance optimization, replace LATERAL subqueries with JOIN for better query performance; fix tuples and frozenxid metric type from COUNTER to GAUGE; increase timeout from 1s to 2s
pg_vacuuming: Add PG17 collector branch with new metrics indexes_total, indexes_processed, dead_tuple_bytes for index vacuum progress tracking
pg_query: Increase timeout from 1s to 2s for high-load scenarios
pg_io: Fix typo in reuses description (“in reused” -> “is reused”)
pg_checkpointer: Fix description for pg_checkpointer_10 (“9.4+” -> “9.4-17”)
pg_db_confl: Fix description for pg_db_confl_15 (“9.1 - 16” -> “9.1 - 15”)
Format alignment fixes for pg_db, pg_indexing, pg_clustering, pg_backup

Other Changes

Fix release year by @anayrat

Checksums

https://github.com/pgsty/pg_exporter/releases/download/v1.1.0/checksums.txt

Collector Configuration

Mon, 01 Jan 0001 00:00:00 +0000

Every business metric in pg_exporter is driven by a YAML collector definition: one SQL query plus its execution conditions (version, role, tags, predicates) and runtime controls (caching, timeout). This page is the complete reference for collector definitions.

A configuration can be a single YAML file (like the default pg_exporter.yml) or a directory of YAML files — the official default bundle is merged from the 58 definition files under config/.

Configuration Loading

PG Exporter searches for configuration in the following order:

pg_exporter v1.0.3

Thu, 20 Nov 2025 17:19:38 +0800

Build with Go 1.25.4 and latest dependencies
Fix #80 Conflict with libpq env variables
Change default value of auto-discovery to true by @kadaffy

Checksums

https://github.com/pgsty/pg_exporter/releases/download/v1.0.3/checksums.txt

7efa1a77dfd5b94813c32c7ac015b1d479b1f04fb958f6b1ed5af333e354d015  pg-exporter_1.0.3-1_amd64.deb
41e18bf18eba2ab90ac371bfb46e9152da9fe628ebd8e26766cac08325eb3b07  pg-exporter_1.0.3-1_arm64.deb
7da8ed738d254c120d42aa51d6137f84e7f4e3188bc764d4f9a1438220363a43  pg-exporter_1.0.3-1_ppc64le.deb
a214b555981156da7b7d248b1f728f8ac88a07ac8f77a66c5d8e43b40670d6b4  pg_exporter-1.0.3-1.aarch64.rpm
d876fc66e208612ebffe3c43dabce88b088d915f92584260d710b85a3a131413  pg_exporter-1.0.3-1.ppc64le.rpm
75f62d314fec50c836c534996c884d25ecea77810ab33e7ba0e9c4b783e775b4  pg_exporter-1.0.3-1.x86_64.rpm
47829a19707284bcee1b8dc47cc7d0172398bb533e6b4043950f787486712769  pg_exporter-1.0.3.darwin-amd64.tar.gz
38b6ccb72315cadea542b1f2a7b7022d0e8d48ffd4ab177bb69a0a909b99af6b  pg_exporter-1.0.3.darwin-arm64.tar.gz
36e8dff84d61a7593ff1fcec567ca4ffeaecd0be2f9eabd227ceac71b12a919a  pg_exporter-1.0.3.linux-amd64.tar.gz
6477e8ef873773a09c4f39a29444f21b5b2c71e717e52ca425bcc8e8e5448791  pg_exporter-1.0.3.linux-arm64.tar.gz
a083b51ebed2b280e2eaa0f19558494e7fa6f122a0a86a1d117206fcd090820c  pg_exporter-1.0.3.linux-ppc64le.tar.gz
a1f9b27b7190f478726d96f270a72d9dc4d3f2bcc3b0326b7c4a2607e62ea588  pg_exporter-1.0.3.windows-amd64.tar.gz

Release resources

Bundled Collectors

Mon, 01 Jan 0001 00:00:00 +0000

PG Exporter v1.4.1 ships 58 collector definition files under config/. They are merged in filename order into the default pg_exporter.yml by make conf.

The filename prefix is an ordering convention, not a metric name. A file can define multiple version- or role-specific branches with the same public metric namespace. At startup, PG Exporter evaluates server facts and installs only the eligible branch; GET /explain shows that plan for the connected target.

Numbering Map

Range	Area	Typical scope
`0000`	Authoring reference	YAML schema and examples; not an installed collector
`0100`	Identity and settings	Server identity, metadata, configuration limits
`0200`	Replication	senders, receivers, slots, subscriptions, origins
`0300`	Instance internals	I/O, storage, checkpoints, recovery, SLRU, shared memory
`0400`	Workload	WAL, sessions, waits, transactions, locks, query statistics
`0500`	Progress	VACUUM, indexing, clustering, and backup progress
`0600`	Database and logical replication	database counters, conflicts, publication/subscription state
`0700`	Relations	tables, indexes, functions, sequences, partitions
`0800`	Expensive relation analysis	size and bloat collectors
`0900`	PgBouncer	lists, databases, statistics, pools
`1000+`	Optional integrations	wait sampling, TimescaleDB, Citus, heartbeat

Complete Inventory

File	Namespace	Scope and requirement
`0000-doc.yml`	config reference	YAML schema and collector authoring guide; not installed
`0110-pg.yml`	`pg`	Basic server information, with primary and replica branches
`0120-pg_meta.yml`	`pg_meta`	Cluster metadata; PG13+ includes `primary_conninfo`
`0130-pg_setting.yml`	`pg_setting`	Shared settings and capacity limits
`0210-pg_repl.yml`	`pg_repl`	Replication sender statistics
`0220-pg_sync_standby.yml`	`pg_sync_standby`	Synchronous standby status
`0230-pg_downstream.yml`	`pg_downstream`	Downstream replication client counts
`0240-pg_slot.yml`	`pg_slot`	Replication slots; standby-aware on PG16+, PG19 invalidation reason support
`0250-pg_recv.yml`	`pg_recv`	Replica WAL receiver; PG19 `connecting` status support
`0260-pg_sub.yml`	`pg_sub`	Subscription statistics; PG19 sync-error and conflict counters
`0270-pg_origin.yml`	`pg_origin`	Replication origins; disabled by default, may need extra privileges
`0300-pg_io.yml`	`pg_io`	`pg_stat_io` on PG16+, with a PG18+ branch
`0310-pg_size.yml`	`pg_size`	Database, WAL, and log sizes
`0320-pg_archiver.yml`	`pg_archiver`	Archiver process statistics
`0330-pg_bgwriter.yml`	`pg_bgwriter`	Background writer statistics, with a PG17+ branch
`0331-pg_checkpointer.yml`	`pg_checkpointer`	Checkpointer statistics; PG18+ completion and SLRU counters
`0340-pg_ssl.yml`	`pg_ssl`	SSL client connection counts
`0350-pg_checkpoint.yml`	`pg_checkpoint`	Checkpoint control information
`0355-pg_timeline.yml`	`pg_timeline`	Current timeline ID on primary or replica
`0360-pg_recovery.yml`	`pg_recovery`, `pg_recovery_prefetch`	Replica recovery and recovery-prefetch statistics
`0370-pg_recovery_state.yml`	`pg_recovery_state`	PG19 replica recovery state from `pg_stat_recovery`
`0380-pg_slru.yml`	`pg_slru`	SLRU cache statistics on PG13+
`0390-pg_shmem.yml`	`pg_shmem`	Shared memory allocation; disabled by default, requires `schema:monitor`
`0400-pg_wal.yml`	`pg_wal`	WAL statistics on PG14+; PG19 adds full-page-image byte counters
`0410-pg_activity.yml`	`pg_activity`	Backend counts by database and state
`0420-pg_wait.yml`	`pg_wait`	Backend waits by wait-event type
`0430-pg_backend.yml`	`pg_backend`	Backend counts grouped by `backend_type`
`0440-pg_xact.yml`	`pg_xact`	Transaction snapshot boundaries and active transaction count
`0450-pg_xact_age.yml`	`pg_xact_age`	PG10+ per-database open and idle transaction age histograms
`0460-pg_lock.yml`	`pg_lock`	Lock distribution by database and mode
`0470-pg_lock_stat.yml`	`pg_lock_stat`	PG19 cluster-wide lock wait and fast-path overflow counters
`0480-pg_query.yml`	`pg_query`	Query statistics; requires `extension:pg_stat_statements`
`0510-pg_vacuuming.yml`	`pg_vacuuming`	Primary-only VACUUM progress; PG18+ includes `delay_time`
`0520-pg_indexing.yml`	`pg_indexing`	Primary-only `CREATE INDEX` progress
`0530-pg_clustering.yml`	`pg_clustering`	Primary-only `CLUSTER` and `VACUUM FULL` progress
`0540-pg_backup.yml`	`pg_backup`	Base backup progress on PG13+
`0610-pg_db.yml`	`pg_db`	Per-database statistics; PG18+ parallel-worker counters
`0620-pg_db_confl.yml`	`pg_db_confl`	Replica database conflict counters
`0640-pg_pubrel.yml`	`pg_pubrel`	Publication and publication-relation counts
`0650-pg_subrel.yml`	`pg_subrel`	Subscription relation counts grouped by state
`0660-pg_vacuum_score.yml`	`pg_vacuum_score`	PG19 autovacuum score summary from `pg_stat_autovacuum_scores`
`0700-pg_table.yml`	`pg_table`	Per-table statistics; PG18+ maintenance-time and new-page counters
`0710-pg_index.yml`	`pg_index`	Per-index statistics
`0720-pg_func.yml`	`pg_func`	Function execution statistics
`0730-pg_seq.yml`	`pg_seq`	Sequence metrics
`0740-pg_relkind.yml`	`pg_relkind`	Relation counts by kind
`0750-pg_defpart.yml`	`pg_defpart`	Default partition tuple counts
`0810-pg_table_size.yml`	`pg_table_size`	Per-table sizes; can be slow on large schemas
`0820-pg_table_bloat.yml`	`pg_table_bloat`	Disabled by default; requires auxiliary view `pg_table_bloat`
`0830-pg_index_bloat.yml`	`pg_index_bloat`	Disabled by default; requires auxiliary view `pg_index_bloat`
`0910-pgbouncer_list.yml`	`pgbouncer_list`	PgBouncer list metrics from the admin database
`0920-pgbouncer_database.yml`	`pgbouncer_database`	PgBouncer database metrics with version-specific branches
`0930-pgbouncer_stat.yml`	`pgbouncer_stat`	PgBouncer per-database statistics with version-specific branches
`0940-pgbouncer_pool.yml`	`pgbouncer_pool`	PgBouncer pool metrics with version-specific branches
`1000-pg_wait_event.yml`	`pg_wait_event`, `pg_wait_event_1s`	Wait sampling; requires `extension:pg_wait_sampling`
`1800-pg_tsdb_hypertable.yml`	`pg_tsdb_hypertable`	Disabled by default; requires TimescaleDB and its information schema
`1900-pg_citus.yml`	`pg_citus_node`	Citus worker/coordinator inventory; requires `extension:citus`
`2000-pg_heartbeat.yml`	`pg_heartbeat`	Disabled by default; requires the `monitor` heartbeat table in `postgres`

Plan Before Enabling

Do not treat all 58 files as 58 unconditional queries. The planner selects branches using PostgreSQL or PgBouncer version, recovery role, target database, extensions, schemas, username, and predicate results. Inspect the real plan before tuning:

pg_exporter v1.0.2

Thu, 14 Aug 2025 13:12:49 +0800

Build with Go 1.25.0 and latest dependencies
Dedicate website and homepage: https://exp.pgsty.com
Release with goreleaser for more os/arch with CI/CD pipeline:
- add windows amd64 support
- add linux ppc64le support

Checksums

https://github.com/pgsty/pg_exporter/releases/download/v1.0.2/checksums.txt

683bf97f22173f2f2ec319a88e136939c2958a1f5ced4f4aa09a1357fc1c44c5  pg-exporter_1.0.2-1_amd64.deb
f62d479a92be2d03211c162b8419f968cea87ceef5b1f25f2bcd390e0b72ccb5  pg-exporter_1.0.2-1_arm64.deb
e1bbfc5a4c1b93e6f92bc7adcb4364583ab763e76e156aa5c979d6d1040f4c7a  pg-exporter_1.0.2-1_ppc64le.deb
f51d5b45448e6bbec3467d1d1dc049b1e16976f723af713c4262541ac55a039c  pg_exporter-1.0.2-1.aarch64.rpm
18380011543674e4c48b2410266b41165974d780cbc8918fc562152ba623939e  pg_exporter-1.0.2-1.ppc64le.rpm
198372d894b9598c166a0e91ca36d3c9271cb65298415f63dbffcf6da611f2bb  pg_exporter-1.0.2-1.x86_64.rpm
cbe7e07df6d180507c830cdab4cf86d40ccd62774723946307b5331d4270477d  pg_exporter-1.0.2.darwin-amd64.tar.gz
20c4a35fa244287766c1d1a19cd2e393b3fa451a96a81e5635401e69bef04b97  pg_exporter-1.0.2.darwin-arm64.tar.gz
d742111185f6a89fff34bfd304b851c8eb7a8e38444f0220786e11ed1934eff1  pg_exporter-1.0.2.linux-amd64.tar.gz
0b1f4c97c1089c4767d92eb22419b8f29c9f46fb90ddfd1e8514cc42dc41054f  pg_exporter-1.0.2.linux-arm64.tar.gz
895083fd2c7fc5409cc1a2dbaaef1e47ac7aa6a3fd5db2359012922d90bcdcc3  pg_exporter-1.0.2.linux-ppc64le.tar.gz
5f751228e7120604af9a482fb70197489fa633c38a0f2b6a3489393fbc6a10aa  pg_exporter-1.0.2.windows-amd64.tar.gz

Release resources

HTTP API

Mon, 01 Jan 0001 00:00:00 +0000

pg_exporter exposes four kinds of HTTP endpoints on its listen port (default :9630): metrics, health checks, traffic routing, and operational management. The full endpoint list:

Endpoint	Method	Description
`/metrics`	GET	Prometheus metrics endpoint (path configurable via `--web.telemetry-path`)
`/up`	GET	Aliveness check; aliases `/health`, `/liveness`, `/readiness`, `/read`
`/primary`	GET	Primary check; aliases `/leader`, `/master`, `/read-write`, `/rw`
`/replica`	GET	Replica check; aliases `/standby`, `/slave`, `/read-only`, `/ro`
`/reload`	GET/POST	Hot-reload collector configuration
`/explain`	GET	Show per-collector planning decisions
`/stat`	GET	Per-collector runtime statistics (hits / errors / duration)
`/version`	GET	Version and build information (plain text)
`/`	GET	Landing page linking to the metrics endpoint

Health and routing endpoints answer from a cached background-probe role state (primary / replica / down / starting / unknown) — they never query the database synchronously per HTTP request, so probe storms cannot reach the database.

pg_exporter v1.0.1

Thu, 17 Jul 2025 09:15:40 +0800

Add dockerhub images: pgsty/pg_exporter
Bump go dependencies to the latest version, build with go 1.24.5
Disable pg_tsdb_hypertable collector by default, since timescaledb catalog is changed.

Checksums

d5e2d6a656eef0ae1b29cd49695f9773  pg_exporter-1.0.1-1.aarch64.rpm
cb01bb78d7b216a235363e9342803cb3  pg_exporter-1.0.1-1.x86_64.rpm
67093a756b04845f69ad333b6d458e81  pg_exporter-v1.0.1.darwin-amd64.tar.gz
2d3fdc10045d1cf494b9c1ee7f94f127  pg_exporter-v1.0.1.darwin-arm64.tar.gz
e242314461becfa99c3978ae72838ab0  pg_exporter-v1.0.1.linux-amd64.tar.gz
63de91da9ef711a53718bc60b89c82a6  pg_exporter-v1.0.1.linux-arm64.tar.gz
718f6afc004089f12c1ca6553f9b9ba5  pg-exporter_1.0.1_amd64.deb
57da7a8005cdf91ba8c1fb348e0d7367  pg-exporter_1.0.1_arm64.deb

Release resources

Development

Mon, 01 Jan 0001 00:00:00 +0000

The project intentionally keeps most monitoring logic in YAML and a smaller execution engine in Go. Changes therefore fall into two paths: collector work and exporter-runtime work. Both paths should keep the merged configs, tests, documentation, and release metadata aligned.

Repository Layout

Path	Purpose
`exporter/`	CLI parsing, URL/config loading, planning, execution, metrics, health state, HTTP handlers, tests
`config/`	58 ordered collector definition files for PostgreSQL 10-19+ and pgBouncer
`pg_exporter.yml`	Generated monolithic default config (`make conf`)
`legacy/config/`	Collector definitions for PostgreSQL 9.1-9.6
`legacy/pg_exporter.yml`	Generated legacy monolithic config (`make conf9`)
`docs/design/`	Authoritative design notes such as snapshot histogram semantics
`monitor/`	Grafana dashboards and database initialization helper
`package/`	systemd environment/unit files and package scripts
`.goreleaser.yml`	Cross-platform archives, RPM/DEB packages, checksums, Docker images, and GitHub Release

Toolchain

The current go.mod declares Go 1.26.5. For a normal development build:

pg_exporter v1.0.0

Tue, 06 May 2025 23:43:42 +0800

Changes

Add PostgreSQL 18 metrics support

new collector branch pg_wal_18:
remove write, sync, write_time, sync_time metrics
move to pg_stat_io
new collector branch pg_checkpointer_18:
new metric num_done
new metric slru_written
new collector branch pg_db_18:
new metric parallel_workers_to_launch
new metric parallel_workers_launched
new collector branch pg_table_18:
table_parallel_workers_to_launch
table_parallel_workers_launched
new collector branch pg_io_18:
new series about WAL statistics
new metric read_bytes
new metric write_bytes
new metric extend_bytes
remove op_bytes due to fixed value
new collector branch pg_vacuuming_18
new metric delay_time

8637bc1a05b93eedfbfd3816cca468dd  pg_exporter-1.0.0-1.aarch64.rpm
a28c4c0dcdd3bf412268a2dbff79f5b9  pg_exporter-1.0.0-1.x86_64.rpm
229129209b8e6bc356c28043c7c22359  pg_exporter-v1.0.0.darwin-amd64.tar.gz
d941c2c28301269e62a8853c93facf12  pg_exporter-v1.0.0.darwin-arm64.tar.gz
5bbb94db46cacca4075d4c341c54db37  pg_exporter-v1.0.0.linux-amd64.tar.gz
da9ad428a50546a507a542d808f1c0fa  pg_exporter-v1.0.0.linux-arm64.tar.gz
0fa2395d9d7a43ab87e5c87e5b06ffcc  pg-exporter_1.0.0_amd64.deb
fed56f8a37e30cc59e85f03c81fce3f5  pg-exporter_1.0.0_arm64.deb

Release resources

pg_exporter v0.9.0

Sat, 26 Apr 2025 23:12:49 +0800

Default Collectors

new metrics collector for timescaledb hypertable
new metrics collector for citus dist node
new metrics collector for pg_wait_sampling wait event profile
pg_slot overhaul: Add 16/17 pg_replication_slot metrics
allow pg_slot collector run on replica since 16/17
refactor pg_wait collector to agg from all processes
restrict pg_clustering, pg_indexing, pg_vacuuming run on primary
mark all reset_time as GAUGE rather than COUNTER
fix pg_recovery_prefetch_skip_fpw type from GAUGE to COUNTER
fix pg_recv.state type from LABEL to GAUGE
Format collector in compact mode
new default metric pg_exporter_build_info / pgbouncer_exporter_build_info
add server_encoding to pg_meta collector
add 12 new setting metrics to pg_setting collector

wal_block_size
segment_size
wal_segment_size
wal_level
wal_log_hints
work_mem
hugepage_count
hugepage_status
max_wal_size
min_wal_size
max_slot_wal_keep_size

Exporter Codebase

normalize collector branch name with min pg ver suffix
Add license file to binary packages
move pgsty/pg_exporter repo to pgsty/pg_exporter
refactor server.go to reduce Compatible and PostgresPrecheck complexity
rename metrics collector with extra number prefix for better sorting
bump dependencies to the latest version
execute fatal collectors ahead of all non-fatal collectors, and fail fast

Release resources

pg_exporter v0.8.1

Sat, 29 Mar 2025 12:33:55 +0800

Changes

Bump dependencies to the latest version
Bump golang.org/x/net from 0.35.0 to 0.36.0 #67
Update docker images building tags

Release resources

pg_exporter v0.8.0

Fri, 14 Feb 2025 15:40:25 +0800

Changes

Add PgBouncer 1.24 new metrics support (stat, pool, database)
Fix: 310-pg_size.yml fails if log dir not set properly #64 by @Süleyman Vurucu
Build with the latest Go 1.24 and bump all dependencies
Refactor logging with the standard log/slog instead of go-kit
Full Changelog: https://github.com/pgsty/pg_exporter/compare/v0.7.1...v0.8.0

Release resources

pg_exporter v0.7.1

Sun, 29 Dec 2024 17:00:02 +0800

Changes

Routine update with dependabot

Feat: support specifying configuration as Reader by @ringerc in #62
Bump golang.org/x/crypto from 0.21.0 to 0.31.0 by @dependabot in #63
Fix some typos
Full Changelog: https://github.com/pgsty/pg_exporter/compare/v0.7.0...v0.7.1

Release resources

pg_exporter v0.7.0

Tue, 13 Aug 2024 19:41:28 +0800

Changes

Refactor codebase for the latest go version.

Release resources

pg_exporter v0.6.1

Fri, 26 Jan 2024 17:26:17 +0800

Changes

Update golang.org/x/net from v0.10.0 to v0.17.0 to pick up security fixes (#38)
Fix connect-timeout propagation (#37), contributed by @mouchar
Recognize both .yaml and .yml files in a configuration directory (#34), contributed by @japinli

Checksums

The original release published MD5 checksums for its archives and packages:

107a67ca74b1d6e7bbe773694a48f6ab  pg_exporter-v0.6.1.darwin-amd64.tar.gz
75b57566838c38092a9c45531c031561  pg_exporter-v0.6.1.darwin-arm64.tar.gz
9e55128671b31dd28d6bca3d0429de8f  pg_exporter-v0.6.1.linux-amd64.tar.gz
68a8b9537f6deb1773d8bea9182bd613  pg_exporter-v0.6.1.linux-arm64.tar.gz
0b0cd62c59cab6d1ab8772d820e599db  pg-exporter_0.6.1_amd64.deb
947126150b71081d0592d7f1fce0aaac  pg-exporter_0.6.1_arm64.deb
6a3608b965143441a5921d3017318146  pg_exporter-0.6.1-1.aarch64.rpm
b3c9f2edd28810cae81cd0edad9eae5d  pg_exporter-0.6.1-1.x86_64.rpm

Release resources

pg_exporter v0.6.0

Wed, 18 Oct 2023 12:54:49 +0800

Changes

Security Enhancement: Fix security dependent-bot issue
Add pg16 collectors
Add arm64 & aarch64 packages
Remove the monitor schema requirement for pg_query collectors (you have to ensure it with search_path or just install pg_stat_statements in the default public schema)
Fix pgbouncer version parsing message level from info to debug
Fix pg_table_10_12 collector missing relid issue.
Recognize the files with yml suffix in config directory by @Japin Li
Support PostgreSQL 15 and higher by @Japin Li

pg_exporter v0.5.0

Thu, 28 Apr 2022 07:27:37 +0800

Exporter Enhancement

Build rpm & deb with nfpm
Add column.default, replace when metric value is NULL
Add column.scale, multiply scale factor when metric value is float/int (e.g µs to second)
Fix /stat endpoint output
Add docker container pgsty/pg_exporter

Metrics Collector

scale bgwriter & pg_wal time unit to second
remove pg_class collector and move it to pg_table & pg_inex
add pg_class metrics to pg_table
add pg_class metrics to pg_index
enable pg_table_size by default
scale pg_query pg_db pg_bgwriter pg_ssl pgbouncer_stat time metrics to second

Release resources

pg_exporter v0.4.1

Tue, 08 Mar 2022 18:48:00 +0800

Changes

update default collectors
- omit citus & timescaledb schemas on object monitoring
- avoid duplicate pg_statio tuples
- support pgbouncer v1.16
- bug fix: pg_repl collector overlap on pg 12
new parameter: -T connect-timeout PG_EXPORTER_CONNECT_TIMEOUT this can be useful when monitoring remote Postgres instances.
now pg_exporter.yaml are renamed as pg_exporter.yml in rpm package.

Release resources

pg_exporter v0.4.0

Mon, 12 Jul 2021 16:09:02 +0800

Changes

Add PG 14 support
Default metrics configuration overhaul. (BUT you can still use the old configuration)
add auto-discovery , include-database and exclude-database option
Add multiple database monitoring implementations (with auto-discovery = on)

Release resources

pg_exporter v0.3.2

Mon, 01 Feb 2021 11:12:06 +0800

Changes

fix shadow DSN corner case
fix typo & docs

Release resources

pg_exporter v0.3.1

Fri, 04 Dec 2020 17:27:21 +0800

Changes

fix default configuration problems (especially for versions lower than 13)

setting primary_conninfo not exists until PG13
add funcid label to pg_func collector to avoid func name duplicate label
fix version string to pg_exporter

Release resources

pg_exporter v0.3.0

Thu, 29 Oct 2020 16:47:32 +0800

Changes

https://github.com/pgsty/pg_exporter/releases/tag/v0.3.0

Change default configuration, Support PostgreSQL 13 new metrics (pg_slru, pg_shmem, pg_query13,pg_backup, etc…)
Add a series of new REST APIs for health / recovery status check
Add a dummy server with fake pg_up 0 metric, which serves before PgExporter is initialized.
Add sslmode=disable to URL if sslmode is not given
fix typos and bugs

Release resources

pg_exporter v0.2.0

Sat, 21 Mar 2020 19:10:25 +0800

Changes

add yum package and linux service definition
add a ‘skip’ flag into query config
fix pgbouncer_up metrics
add conf reload support

Release resources

pg_exporter v0.1.2

Thu, 20 Feb 2020 15:12:29 +0800

Changes

fix pgbouncer_up metrics
add dynamic configuration reload
remove ‘shard’ related logic
add a ‘bulky’ mode to default settings

Release resources

pg_exporter v0.1.1

Fri, 10 Jan 2020 01:30:28 +0800

Changes

Fix the bug that pg_exporter will hang during start-up if any query is failed.

Release resources

pg_exporter v0.1.0

Wed, 08 Jan 2020 21:10:42 +0800

Changes

It works, looks good to me.

Release resources

pg_exporter v0.0.5

Wed, 08 Jan 2020 20:12:11 +0800

This is an early repository tag without a separate GitHub Release object. This archival note is based on the tag commit and historical release summary.

Changes

Add per-collector query timeouts
Replace the earlier skip_error behavior with the fatal collector policy
Revise collector priority semantics
Fix the built-in pg_up metric
Add documentation for each bundled collector

This historical version exists as a repository tag but was not published as a separate GitHub Release object.

pg_exporter v0.0.4

Fri, 20 Dec 2019 17:22:44 +0800

Changes

Tested in real world production environment with 200+ nodes for about 2 weeks. Looks good !

Release resources

pg_exporter v0.0.3

Sat, 14 Dec 2019 00:03:23 +0800

Changes

v0.0.3 Release, Tested in Production Environment

This version is already tested in a production environment.

This project is still under rapid evolution, I would say if you want use it in production , try with caution.

Release resources

pg_exporter v0.0.2

Mon, 09 Dec 2019 20:43:23 +0800

Changes

It’s ok to try now

Release resources

pg_exporter v0.0.1

Mon, 09 Dec 2019 14:12:22 +0800

This is an early repository tag without a separate GitHub Release object. This archival note is based on the tag commit and historical release summary.

Changes

Add pgbouncer mode

Release resources

Browse the v0.0.1 source tag

Page Not Found

Mon, 01 Jan 0001 00:00:00 +0000

The requested page does not exist. Continue with the documentation, release notes, or GitHub repository.