BSD Ports

databases/pgbot 0.8.1_2 FreeBSD

Read-only observability and health reports for PostgreSQL

System
FreeBSD
Repository
FreeBSD ports
Maintainer
[email protected]
Port added
Last update
Commit
d81b7ba3c3
License
APACHE20
Categories
databases
Package size
5370.3 KiB, 17692.1 KiB installed

Description

pgbot is a single static binary that connects to a PostgreSQL server with a read-only role, reads the server's own statistics views and prints a findings-first health report, including what changed since the previous run. It needs no agent, no external service and no write privilege anywhere in the path.

Features:

  • Checks connections, cache hit ratio, locks, slow and regressed queries, unused and missing indexes, table bloat, vacuum and replication lag
  • Findings are ranked by severity, with a per-database health score
  • Snapshots are stored locally so consecutive runs can be diffed
  • Versioned --json output with a published JSON Schema, plus SARIF output for CI integration
  • Works as an MCP server so AI agents and applications can query it
  • Supports PostgreSQL 14 through 18

pgbot is the diagnostic engine behind pgterm (databases/pgterm).

Install

Binary package:

pkg install pgbot

From the ports tree:

cd /usr/ports/databases/pgbot/ && make install clean

To depend on this port in another port's Makefile:

RUN_DEPENDS=	pgbot>0:databases/pgbot

Packages

The version each package repository carries. “-” means the repository builds no package of it, “n/a” that there is no such repository.

Repositoryaarch64amd64armv6armv7i386
FreeBSD:14:latest0.8.1_10.8.1_1--0.8.1_1
FreeBSD:14:quarterly0.8.1_10.8.1_1n/a-0.8.1_1
FreeBSD:15:latest0.8.1_10.8.1_1n/a--
FreeBSD:15:quarterly0.8.1_10.8.1_1n/an/an/a
FreeBSD:16:latest0.8.10.8.1_1n/an/an/a
FreeBSD:16:quarterlyn/an/an/an/an/a

Dependencies

The Makefile names none itself; they come from USES and USE_*.

The full lists below include those, and their dependencies in turn.

Build dependencies 1
Required by 1

Configuration

No options to configure.

USES
go:modules
Service scripts
none

Files

distinfo 2
FileSizeSHA256
go/databases_pgbot/pgbot-v0.8.1/v0.8.1.mod2004634784d1e8f02b00d6a942c6a3e53d555864bca9a730916cdead612709b7f061
go/databases_pgbot/pgbot-v0.8.1/v0.8.1.zip4.08449e+06cdf43092f19a4cb97ab2f2f72b3ce21fc9392873950ba4d2d3df7b7325b9f3a8

Commit history 8

DateCommitCreditsLog message
d81b7ba3c3 Dag-Erling Smørgrav various: Bump Go ports for Go 1.26.10 / 1.27.3
031fc6bfbf Dag-Erling Smørgrav various: Bump Go ports
c33c04ca4f Jimmy Olgeni databases/pgbot: Drop Go version pin
e5ca6d763a Jimmy Olgeni databases/pgbot: Update to 0.8.1
Upstream now requires Go 1.27, so pin USES=go:1.27,modules.
8cce926501 Jimmy Olgeni databases/pgbot: Update to 0.7.2

The latest 5 of 8 in the history this site was built from.