Configuration parameter

log_destination — PostgreSQL configuration parameter

Category Error Reporting and Logging Default to log to stderr only Change scope Sighup

PostgreSQL supports several methods for logging server messages, including stderr, csvlog, jsonlog, and syslog.

At a glance

Property Value
Parameter log_destination
Category Error Reporting and Logging
Default to
Value type string
Change scope Reload (postgresql.conf, SIGHUP)
Available in PostgreSQL 12, 13, 14, 15, 16, 17, 18, 19 (added in 12)

What it does

PostgreSQL supports several methods for logging server messages, including stderr, csvlog, jsonlog, and syslog. On Windows, eventlog is also supported. Set this parameter to a list of desired log destinations separated by commas. The default is to log to stderr only. This parameter can only be set in the postgresql.conf file or on the server command line.

If csvlog is included in log_destination, log entries are output in “comma-separated value” (CSV) format, which is convenient for loading logs into programs. See runtime_config_logging_csvlog for details. logging_collector must be enabled to generate CSV-format log output.

(Description quoted from the official PostgreSQL documentation.)

How to apply a change

Set it in postgresql.conf (or with ALTER SYSTEM) and reload with SELECT pg_reload_conf(); or pg_ctl reload — no restart needed.

Inspect the current value and source with SHOW log_destination; or SELECT name, setting, unit, context, source FROM pg_settings WHERE name = 'log_destination';.

Tuning guidance

Tune this for observability versus log volume, not for raw performance. More verbose logging helps diagnose problems but costs disk and I/O; quieter logging saves space but hides detail. Pick a level your log pipeline can store and search, and raise verbosity temporarily when investigating an incident.

Reference

PostgreSQL documentation — log_destination.

Keep going

Related & next steps

Was this helpful?

← All configuration parameters