pg_crash

pg_crash : Send random signals to random processes

Overview

Packages

Source

pig build pkg pg_crash;		# build rpm/deb

Install

Make sure PGDG and PIGSTY repo available:

pig repo add pgsql -u   # add both repo and update cache

Install this extension with pig:

pig install pg_crash;		# install via package name, for the active PG version

pig install pg_crash -v 18;   # install for PG 18
pig install pg_crash -v 17;   # install for PG 17
pig install pg_crash -v 16;   # install for PG 16
pig install pg_crash -v 15;   # install for PG 15
pig install pg_crash -v 14;   # install for PG 14

Config this extension to shared_preload_libraries:

shared_preload_libraries = 'pg_crash';

This extension does not need CREATE EXTENSION DDL command

Usage

pg_crash: Send random signals to random processes

pg_crash is a chaos engineering extension that periodically sends kill signals to PostgreSQL backend processes, useful for HA and failover testing. It must be added to shared_preload_libraries.

Configuration

Add to postgresql.conf:

shared_preload_libraries = 'pg_crash'

# POSIX signals to send (space-separated)
crash.signals = '1 2 3'

# Delay in seconds between sending signals
crash.delay = 30

Signal Reference

Common POSIX signals: 1 (SIGHUP), 2 (SIGINT), 3 (SIGQUIT), 9 (SIGKILL), 15 (SIGTERM).

After configuring, restart the server. The background worker will periodically send the configured signals to random backend processes at the specified interval.