Skip to main content

Arq Signals documentation

Installation, configuration, and snapshot management for the open-source PostgreSQL telemetry collector.

Open source

Quick start

Arq Signals is a standalone binary that connects to PostgreSQL, collects performance telemetry, and produces snapshot files. Install it, point it at your database, and run. No dependencies beyond a PostgreSQL connection.

Installation

  • Download and install the Signals binary
  • Create a pg_monitor role for Signals
  • Configure connection parameters
  • Run your first snapshot collection

Configuration

  • Scheduling collection with cron or systemd
  • Configuring which statistics to collect
  • Setting snapshot output format and location
  • Running in air-gapped environments

Data collected

  • pg_stat_statements query statistics
  • Table and index usage metrics
  • Connection and session information
  • Database-level and background writer stats

Integration

  • Feeding snapshots to Arq for analysis
  • Snapshot format specification
  • Troubleshooting common issues
  • Upgrading between versions