F.37. pgAudit Log to File#

F.37. pgAudit Log to File

F.37. pgAudit Log to File

F.37.1. About pgauditlogtofile

Version: 1.5.12

GitHub

F.37.2. Description

pgAudit Log to File is an addon to pgAudit than will redirect audit log lines to an independent file, instead of using the PostgreSQL server logger.

This will allow us to have an audit file that we can easily rotate without polluting server logs with those messages.

Audit logs in heavily used systems can grow very fast. This extension allows to automatically rotate the files based in a number of minutes.

F.37.3. Installation

  1. Add pgauditlogtofile to "shared_preload_libraries" in postgresql.conf

  2. Restart PostgreSQL to reload new shared library

  3. Create extension in postgres database (like pgaudit we don't need to create it in all the databases)

postgres=# CREATE EXTENSION pgauditlogtofile;

F.37.4. Configuration

F.37.4.1. pgaudit.log_directory

Name of the directory where the audit file will be created.

Scope

System

Default

'log'

Empty or NULL will disable the extension and the audit logging will be done to the PostgreSQL server logger.

F.37.4.2. pgaudit.log_filename

Name of the file where the audit will be written. Writing to an existing file will append the new entries. This variable can contain time patterns up to minute to allow automatic rotation.

Scope

System

Default

'audit-%Y%m%d_%H%M.log'

Empty or NULL will disable the extension and the audit logging will be done to PostgreSQL server logger.

F.37.4.3. pgaudit.log_rotation_age

Number of minutes after which the audit file will be rotated.

Scope

System

Default

1440 minutes (1 day)

0 will disable the rotation.

F.37.4.4. pgaudit.log_connections

Intercepts server log messages emited when log_connections is on.

Scope

System

Default

off

Requires

log_connections = on

F.37.4.5. pgaudit.log_disconnections

Intercepts server log messages emited when log_disconnections is on.

Scope

System

Default

off

Requires

log_disconnections = on

F.37.4.6. Test

cd test
vagrant plugin install vagrant-vbguest
vagrant up