<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>pgAudit &#8211; SRA OSS Tech Blog</title>
	<atom:link href="https://www.sraoss.co.jp/tech-blog/tag/pgaudit/feed/index.xml" rel="self" type="application/rss+xml" />
	<link>https://www.sraoss.co.jp/tech-blog/</link>
	<description>OSS専門の技術ブログ。PostgreSQL、Zabbixを中心に10種類以上のOSSの解説、アップデート情報、運用ヒントを提供。</description>
	<lastBuildDate>Mon, 09 Nov 2026 03:40:19 +0000</lastBuildDate>
	<language>ja</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.1.3</generator>

<image>
	<url>https://www.sraoss.co.jp/tech-blog/wp-content/uploads/2018/07/blog-icon-150x150.png</url>
	<title>pgAudit &#8211; SRA OSS Tech Blog</title>
	<link>https://www.sraoss.co.jp/tech-blog/</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>pgAudit Log to File (pgAudit アドオン監査ログ専用ファイル分離ツール)</title>
		<link>https://www.sraoss.co.jp/tech-blog/pgsql/pgauditlogtofile/</link>
		
		<dc:creator><![CDATA[北山 貴広 (Takahiro Kitayama)]]></dc:creator>
		<pubDate>Thu, 10 Nov 2022 01:00:42 +0000</pubDate>
				<category><![CDATA[PostgreSQL]]></category>
		<category><![CDATA[pgAudit]]></category>
		<category><![CDATA[PostgreSQL 14]]></category>
		<category><![CDATA[サードパーティーソフトウェア]]></category>
		<guid isPermaLink="false">https://www.sraoss.co.jp/tech-blog/?p=11483</guid>

					<description><![CDATA[本記事では、PostgreSQL 監査ロギングツール「pgAudit」のアドオンとして使用する「pgAudit Log to File」のインストール方法、監査ログ取得方法について紹介します。 pgAudit Log t ...]]></description>
										<content:encoded><![CDATA[<p>本記事では、PostgreSQL 監査ロギングツール「pgAudit」のアドオンとして使用する「pgAudit Log to File」のインストール方法、監査ログ取得方法について紹介します。</p>
<p><span id="more-11483"></span></p>
<h2>pgAudit Log to File とは</h2>
<p>pgAudit Log to File とは PostgreSQL で監査ログを取得して PostgreSQL ログファイルに書き出す pgAudit のアドオンで、監査ログ専用ファイルを PostgreSQL ログファイルとは別の独立したファイルに分離して書き出してくれるソフトウェアです。</p>
<p>公式サイトは<a href="https://github.com/fmbiete/pgauditlogtofile">こちら</a>です。分かりやすいドキュメント(README.md)とともに公開されています。</p>
<p>pgAudit のブログ記事は<a href="https://www.sraoss.co.jp/tech-blog/pgsql/pgaudit/">こちら</a>になります。</p>
<h2>pgAudit Log to File サポート対象バージョン</h2>
<p>pgAudit Log to File がサポートする PostgreSQL / pgAudit のバージョンは特にドキュメントに記載はありませんので、使用する時点の最新バージョンを使用すればよいと思います。</p>
<p>現時点(2022年11月2日)の GitHub での最新バージョンは v1.5.8 で、<a href="https://github.com/fmbiete/pgauditlogtofile/releases">GitHubのリリースページ</a>からダウンロード可能です。<br />
また、PostgreSQL 公式リポジトリでは pgAudit Log to File が pgauditlogtofile_&lt;PostgreSQLメジャーバージョン&gt; というファイル名で rpm ファイルが配布されており、PostgreSQL 10,11,12,13,14,15 用バージョンが v1.5.6 となっています。</p>
<h2>pgAudit Log to File インストール方法(rpmパッケージ)</h2>
<p>pgAudit Log to File のインストール方法は、大きく分けてソースコードからのインストールと、PostgreSQL公式リポジトリの rpm からのインストールがあります。<br />
今回は rpm からのインストールをご紹介します。<br />
下記のインストールの実行例では Rocky Linux release 8.6, PostgreSQL 14.5, pgAudit v1.6.2, pgAudit Log to File v1.5.6 を使用して説明します。<br />
Rocky Linux から直接インターネット接続が可能な環境を使用しています。</p>
<h3>Rocky Linux に PostgreSQL 公式 Yum リポジトリを設定し、PostgreSQL 14をインストール</h3>
<p>Rocky Linux から PostgreSQL 公式 Yum リポジトリのパッケージを dnf でインストール可能とするために repo ファイルを導入します。<br />
<a href="https://www.postgresql.org/download/">PostgreSQL ダウンロードページ</a>の Packages and Installers で Linux と Red Hat/Rocky/CentOS を選択すると<a href="https://www.postgresql.org/download/linux/redhat/">このページ</a>が表示されます。PostgreSQL Yum Repository で使用する PostgreSQL バージョン(14)と OS のバージョン(Red Hat Enterprise, Rocky, or Oracle version 8)と CPU アーキテクチャ(x86_64)を選択すれば、repo ファイルを導入して PostgreSQL サーバを導入後有効にして起動するコマンドが表示されます。<br />
表示されたコマンドを参考にして、まず repo ファイルを導入します。</p>
<pre># dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm
：
依存関係が解決しました。
================================================================================
パッケージ Arch バージョン リポジトリー サイズ
================================================================================
インストール:
pgdg-redhat-repo noarch 42.0-28 @commandline 13 k

トランザクションの概要
================================================================================
インストール 1 パッケージ

合計サイズ: 13 k
インストール後のサイズ: 14 k
パッケージのダウンロード:
トランザクションの確認を実行中
トランザクションの確認に成功しました。
トランザクションのテストを実行中
トランザクションのテストに成功しました。
トランザクションを実行中
準備 : 1/1
インストール中 : pgdg-redhat-repo-42.0-28.noarch 1/1
検証 : pgdg-redhat-repo-42.0-28.noarch 1/1

インストール済み:
pgdg-redhat-repo-42.0-28.noarch

完了しました!
#
</pre>
<p>次に、PostgreSQL公式サイトの PostgreSQL が導入できるように OS 組み込みの PostgreSQL を無効にします。これを実行しないと PostgreSQL 公式サイトの PostgreSQL が見つからないと言われてしまいます。</p>
<pre># dnf install -y postgresql14-server
すべての検出結果は引数のモジュラーフィルタリングに一致しません (filter out): postgresql14-server
エラー: 一致するものが見つかりません: postgresql14-server
#
# dnf -qy module disable postgresql
# dnf install -y postgresql14-server
依存関係が解決しました。
================================================================================
パッケージ Arch バージョン Repo サイズ
================================================================================
インストール:
postgresql14-server x86_64 14.5-1PGDG.rhel8 pgdg14 5.7 M
依存関係のインストール:
postgresql14 x86_64 14.5-1PGDG.rhel8 pgdg14 1.5 M
postgresql14-libs x86_64 14.5-1PGDG.rhel8 pgdg14 278 k

トランザクションの概要
================================================================================
インストール 3 パッケージ

ダウンロードサイズの合計: 7.5 M
インストール後のサイズ: 31 M
パッケージのダウンロード:
(1/3): postgresql14-libs-14.5-1PGDG.rhel8.x86_6 113 kB/s | 278 kB 00:02
(2/3): postgresql14-14.5-1PGDG.rhel8.x86_64.rpm 307 kB/s | 1.5 MB 00:05
(3/3): postgresql14-server-14.5-1PGDG.rhel8.x86 196 kB/s | 5.7 MB 00:29
--------------------------------------------------------------------------------
合計 258 kB/s | 7.5 MB 00:29
トランザクションの確認を実行中
トランザクションの確認に成功しました。
トランザクションのテストを実行中
トランザクションのテストに成功しました。
トランザクションを実行中
準備 : 1/1
インストール中 : postgresql14-libs-14.5-1PGDG.rhel8.x86_64 1/3
scriptletの実行中: postgresql14-libs-14.5-1PGDG.rhel8.x86_64 1/3
インストール中 : postgresql14-14.5-1PGDG.rhel8.x86_64 2/3
scriptletの実行中: postgresql14-14.5-1PGDG.rhel8.x86_64 2/3
scriptletの実行中: postgresql14-server-14.5-1PGDG.rhel8.x86_64 3/3
インストール中 : postgresql14-server-14.5-1PGDG.rhel8.x86_64 3/3
scriptletの実行中: postgresql14-server-14.5-1PGDG.rhel8.x86_64 3/3
検証 : postgresql14-14.5-1PGDG.rhel8.x86_64 1/3
検証 : postgresql14-libs-14.5-1PGDG.rhel8.x86_64 2/3
検証 : postgresql14-server-14.5-1PGDG.rhel8.x86_64 3/3

インストール済み:
postgresql14-14.5-1PGDG.rhel8.x86_64
postgresql14-libs-14.5-1PGDG.rhel8.x86_64
postgresql14-server-14.5-1PGDG.rhel8.x86_64

完了しました!
# dnf install -y postgresql14-contrib
依存関係が解決しました。
================================================================================
パッケージ Arch バージョン Repo サイズ
================================================================================
インストール:
postgresql14-contrib x86_64 14.5-1PGDG.rhel8 pgdg14 726 k

トランザクションの概要
================================================================================
インストール 1 パッケージ

ダウンロードサイズの合計: 726 k
インストール後のサイズ: 2.5 M
パッケージのダウンロード:
postgresql14-contrib-14.5-1PGDG.rhel8.x86_64.rp 203 kB/s | 726 kB 00:03
--------------------------------------------------------------------------------
合計 203 kB/s | 726 kB 00:03
トランザクションの確認を実行中
トランザクションの確認に成功しました。
トランザクションのテストを実行中
トランザクションのテストに成功しました。
トランザクションを実行中
準備 : 1/1
インストール中 : postgresql14-contrib-14.5-1PGDG.rhel8.x86_64 1/1
scriptletの実行中: postgresql14-contrib-14.5-1PGDG.rhel8.x86_64 1/1
検証 : postgresql14-contrib-14.5-1PGDG.rhel8.x86_64 1/1

インストール済み:
postgresql14-contrib-14.5-1PGDG.rhel8.x86_64

完了しました!
#
</pre>
<p>これで PostgreSQL 公式サイトの rpm から PostgreSQL 14.5 が導入出来ました。DBの初期化も実施しておきましょう。</p>
<pre># export PGSETUP_INITDB_OPTIONS="--encoding=UTF-8 --no-locale"
# /usr/pgsql-14/bin/postgresql-14-setup initdb
Initializing database ... OK

# systemctl enable postgresql-14
Created symlink /etc/systemd/system/multi-user.target.wants/postgresql-14.service → /usr/lib/systemd/system/postgresql-14.service.
# systemctl start postgresql-14
# systemctl status postgresql-14
● postgresql-14.service - PostgreSQL 14 database server
Loaded: loaded (/usr/lib/systemd/system/postgresql-14.service; enabled; vend&gt;
Active: active (running) since Wed 2022-11-02 05:19:19 JST; 4s ago
Docs: https://www.postgresql.org/docs/14/static/
Process: 8619 ExecStartPre=/usr/pgsql-14/bin/postgresql-14-check-db-dir ${PGD&gt;
Main PID: 8624 (postmaster)
Tasks: 8 (limit: 4783)
Memory: 19.9M
CGroup: /system.slice/postgresql-14.service
tq8624 /usr/pgsql-14/bin/postmaster -D /var/lib/pgsql/14/data/
tq8626 postgres: logger
tq8628 postgres: checkpointer
tq8629 postgres: background writer
tq8630 postgres: walwriter
tq8631 postgres: autovacuum launcher
tq8632 postgres: stats collector
mq8633 postgres: logical replication launcher

11月 02 05:19:19 rockey86 systemd[1]: Starting PostgreSQL 14 database server...
11月 02 05:19:19 rockey86 postmaster[8624]: 2022-11-02 05:19:19.463 JST [8624] &gt;
11月 02 05:19:19 rockey86 postmaster[8624]: 2022-11-02 05:19:19.463 JST [8624] &gt;
11月 02 05:19:19 rockey86 systemd[1]: Started PostgreSQL 14 database server.
#
# su - postgres
$ psql
psql (14.5)
"help"でヘルプを表示します。

postgres=#
</pre>
<p>無事 PostgreSQL 14 が起動しました。</p>
<h3>pgaudit と pgauditlogtofile のインストール</h3>
<p>PostgreSQL 公式リポジトリに含まれる pgaudit と pgauditlogtofile の rpm パッケージ名を調べてみます。PostgreSQL 14 用の pgaudit のパッケージは pgaudit16_14、pgauditlogtofile のパッケージは pgauditlogtofile_14 もしくは pgauditlogtofile_14-llvmjit (JITコンパイル対応)となっています。</p>
<pre># dnf list | grep pgaudit
pgaudit16_14.x86_64 1.6.2-1.rhel8 @pgdg14
pgauditlogtofile_14.x86_64 1.5.6-1.rhel8 @pgdg14
pgaudit12_10.x86_64 1.2.4-1.rhel8 pgdg10
pgaudit13_11.x86_64 1.3.4-1.rhel8 pgdg11
pgaudit14_12.x86_64 1.4.3-1.rhel8 pgdg12
pgaudit15_13.x86_64 1.5.2-1.rhel8 pgdg13
pgaudit17_15.x86_64 1.7.0-1.rhel8 pgdg15
pgaudit_analyze.x86_64 1.0.7-1.rhel8 pgdg-common
pgaudit_analyze.noarch 1.0.8-1.rhel8 pgdg-common
pgauditlogtofile-10.x86_64 1.0-1.rhel8 pgdg10
pgauditlogtofile-11.x86_64 1.0-1.rhel8 pgdg11
pgauditlogtofile-12.x86_64 1.0-1.rhel8 pgdg12
pgauditlogtofile-13.x86_64 1.0-1.rhel8 pgdg13
pgauditlogtofile_10.x86_64 1.5.6-1.rhel8 pgdg10
pgauditlogtofile_11.x86_64 1.5.6-1.rhel8 pgdg11
pgauditlogtofile_11-llvmjit.x86_64 1.5.6-1.rhel8 pgdg11
pgauditlogtofile_12.x86_64 1.5.6-1.rhel8 pgdg12
pgauditlogtofile_12-llvmjit.x86_64 1.5.6-1.rhel8 pgdg12
pgauditlogtofile_13.x86_64 1.5.6-1.rhel8 pgdg13
pgauditlogtofile_13-llvmjit.x86_64 1.5.6-1.rhel8 pgdg13
pgauditlogtofile_14-llvmjit.x86_64 1.5.6-1.rhel8 pgdg14
pgauditlogtofile_15.x86_64 1.5.6-2.rhel8 pgdg15
pgauditlogtofile_15-llvmjit.x86_64 1.5.6-2.rhel8 pgdg15
#
</pre>
<p>今回は pgaudit と pgauditlogtofile のパッケージを導入します。</p>
<pre># dnf install -y pgaudit16_14 pgauditlogtofile_14
依存関係が解決しました。
================================================================================
パッケージ Arch バージョン リポジトリー サイズ
================================================================================
インストール:
pgaudit16_14 x86_64 1.6.2-1.rhel8 pgdg14 56 k
pgauditlogtofile_14 x86_64 1.5.6-1.rhel8 pgdg14 18 k

トランザクションの概要
================================================================================
インストール 2 パッケージ

ダウンロードサイズの合計: 74 k
インストール後のサイズ: 124 k
パッケージのダウンロード:
(1/2): pgauditlogtofile_14-1.5.6-1.rhel8.x86_64 13 kB/s | 18 kB 00:01
(2/2): pgaudit16_14-1.6.2-1.rhel8.x86_64.rpm 37 kB/s | 56 kB 00:01
--------------------------------------------------------------------------------
合計 49 kB/s | 74 kB 00:01
トランザクションの確認を実行中
トランザクションの確認に成功しました。
トランザクションのテストを実行中
トランザクションのテストに成功しました。
トランザクションを実行中
準備 : 1/1
インストール中 : pgaudit16_14-1.6.2-1.rhel8.x86_64 1/2
インストール中 : pgauditlogtofile_14-1.5.6-1.rhel8.x86_64 2/2
scriptletの実行中: pgauditlogtofile_14-1.5.6-1.rhel8.x86_64 2/2
検証 : pgaudit16_14-1.6.2-1.rhel8.x86_64 1/2
検証 : pgauditlogtofile_14-1.5.6-1.rhel8.x86_64 2/2

インストール済み:
pgaudit16_14-1.6.2-1.rhel8.x86_64 pgauditlogtofile_14-1.5.6-1.rhel8.x86_64

完了しました!
#</pre>
<p>これで pgaudit と pgauditlogtofile がインストールされました。</p>
<h3>postgresql.conf の shared_preload_libraries の設定と有効化確認</h3>
<p>shared_preload_libraries に共有ライブラリの pgaudit,pgauditlogtofile を設定して PostgreSQL を再起動し、新規に db1 データベースを作成後、pgaudit が有効になっていることを確認します。</p>
<pre>$ cd $PGDATA
$ pwd
/var/lib/pgsql/14/data
$ vi postgresql.conf
shared_preload_libraries = 'pgaudit, pgauditlogtofile'
# systemctl restart postgresql-14.service
$ createdb db1
$ psql db1
psql (14.5)
"help"でヘルプを表示します。

db1=# show shared_preload_libraries;
shared_preload_libraries
---------------------------
pgaudit, pgauditlogtofile
(1 行)

</pre>
<h3>CREATE EXTENSION を実行してエクステンションに登録</h3>
<p>使用したいデータベースに psql で接続して、pgaudit と pgauditlogtofile で CREATE EXTENSION を実行します。エクステンションが登録されていることを確認します。</p>
<pre>db1=# CREATE EXTENSION pgaudit;
CREATE EXTENSION
db1=# CREATE EXTENSION pgauditlogtofile;
CREATE EXTENSION
db1=# \dx
インストール済みの拡張一覧
名前 | バージョン | スキーマ | 説明

------------------+------------+------------+------------------------------------------------------------
pgaudit | 1.6.2 | public | provides auditing functionality
pgauditlogtofile | 1.5 | public | pgAudit addon to redirect audit log to an independent file
plpgsql | 1.0 | pg_catalog | PL/pgSQL procedural language
(3 行)

db1=#
</pre>
<p>これで pgAudit と pgAudit Log to File のインストールは完了しました。</p>
<h2>セッション監査ロギングを有効にして分離した監査ログファイルを確認</h2>
<p>監査ログをセッション単位で取得するセッション監査ロギングを試して監査ログファイルが分離されることを確認します。postgresql.conf ファイルに pgaudit.log = &#8216;ALL&#8217; を追加し、PostgreSQL に設定を読み込ませます。</p>
<pre>$ cd $PGDATA
$ vi postgresql.conf
pgaudit.log = 'ALL'
# systemctl reload postgresql-14.service
$ cd $PGDATA/log
$ ls
postgresql-Wed.log
$ tail -3 postgresql-Wed.log
2022-11-02 05:30:01.537 JST [9842] LOG: database system is ready to accept connections
2022-11-02 05:37:08.831 JST [9842] LOG: received SIGHUP, reloading configuration files
2022-11-02 05:37:08.831 JST [9842] LOG: parameter "pgaudit.log" changed to "ALL"
</pre>
<p>table1 を作成してSELECT 文を実行したところ、無事 PostgreSQL ログとは別に新規に作成された監査ログファイル(audit-YYYYMMDD_0000.log)に記録されました。</p>
<pre>$ psql db1
db1=# CREATE TABLE table1 (i1 integer, t1 text);
CREATE TABLE
db1=# INSERT INTO table1 VALUES (1, 'aaa'),(2, 'bbb');
INSERT 0 2
db1=# SELECT * FROM table1;
i1 | t1
----+-----
1 | aaa
2 | bbb
(2 行)
db1=# \q
$ cd $PGDATA/log
$ ls -tl
合計 8
-rw-------. 1 postgres postgres 651 11月 2 05:39 audit-20221102_0000.log
-rw-------. 1 postgres postgres 1972 11月 2 05:37 postgresql-Wed.log
$ cat audit-20221102_0000.log
2022-11-02 05:39:32.716 JST,postgres,db1,10095,[local],636183eb.276f,1,CREATE TABLE,2022-11-02 05:39:07 JST,3/24,737,00000,SESSION,1,1,DDL,CREATE TABLE,TABLE,public.table1,"CREATE TABLE table1 (i1 integer, t1 text);",&lt;not logged&gt;,,,,,,,,,psql
2022-11-02 05:39:43.309 JST,postgres,db1,10095,[local],636183eb.276f,2,INSERT,2022-11-02 05:39:07 JST,3/25,0,00000,SESSION,2,1,WRITE,INSERT,,,"INSERT INTO table1 VALUES (1, 'aaa'),(2, 'bbb');",&lt;not logged&gt;,,,,,,,,,psql
2022-11-02 05:39:49.228 JST,postgres,db1,10095,[local],636183eb.276f,3,SELECT,2022-11-02 05:39:07 JST,3/26,0,00000,SESSION,3,1,READ,SELECT,,,SELECT * FROM table1;,&lt;not logged&gt;,,,,,,,,,psql
$
</pre>
<h3>pgaudit.log_connections, pgaudit.log_disconnections について</h3>
<p>postgresql.conf ファイルで log_connections = on と log_disconnections = on を設定した上で pg_audit.log_connections = on と pg_audit.log_disconnections = on と設定して PostgreSQL に設定を再読み込みさせると、監査ログファイルにログイン情報とログアウト情報が記録されます。</p>
<pre>$ cd $PGDATA
$ vi postgresql.conf
log_connections = on
log_disconnections = on
pg_audit.log_connections = on
pg_audit.log_disconnections = on
# systemctl reload postgresql-14.service
$ cd $PGDATA/log
$ tail -3 postgresql-Wed.log
2022-11-02 06:12:30.368 JST [9842] LOG: received SIGHUP, reloading configuration files
2022-11-02 06:12:30.368 JST [9842] LOG: parameter "log_connections" changed to "on"
2022-11-02 06:12:30.368 JST [9842] LOG: parameter "log_disconnections" changed to "on"
2022-11-02 06:12:30.368 JST [9842] LOG: parameter "pg_audit.log_connections" changed to "on"
2022-11-02 06:12:30.368 JST [9842] LOG: parameter "pg_audit.log_disconnections" changed to "on"
</pre>
<p>現在のバージョンでは、ログインが成功すると、監査ログファイルにのみ情報が記録されますが、ログインが失敗した場合は、ログインに失敗したこと自体は監査ログに記録されずに PostgreSQL ログのみに記録される点には注意が必要です。</p>
<pre>[ログイン/ログアウト成功時]
$ psql db1
db1=# \q
$ tail -f audit-20221102_0000.log
2022-11-02 06:13:15.781 JST,,,11664,[local],63618beb.2d90,1,,2022-11-02 06:13:15 JST,,0,00000,connection received: host=[local],,,,,,,,,
2022-11-02 06:13:15.782 JST,postgres,db1,11664,[local],63618beb.2d90,2,authentication,2022-11-02 06:13:15 JST,3/140,0,00000,connection authenticated: identity="postgres" method=peer (/var/lib/pgsql/14/data/pg_hba.conf:85),,,,,,,,,
2022-11-02 06:13:15.782 JST,postgres,db1,11664,[local],63618beb.2d90,3,authentication,2022-11-02 06:13:15 JST,3/140,0,00000,connection authorized: user=postgres database=db1 application_name=psql,,,,,,,,,
2022-11-02 06:13:22.678 JST,postgres,db1,11664,[local],63618beb.2d90,4,idle,2022-11-02 06:13:15 JST,,0,00000,disconnection: session time: 0:00:06.896 user=postgres database=db1 host=[local],,,,,,,,,psql
[ログイン失敗時]
$ psql db1 -U nouser
psql: エラー: ソケット"/var/run/postgresql/.s.PGSQL.5432"上でのサーバーへの接続に失敗しました: FATAL: Peer authentication failed for user "nouser"
$ tail -f audit-20221102_0000.log
2022-11-02 06:14:29.051 JST,,,11676,[local],63618c35.2d9c,1,,2022-11-02 06:14:29 JST,,0,00000,connection received: host=[local],,,,,,,,,
2022-11-02 06:14:29.052 JST,nouser,db1,11676,[local],63618c35.2d9c,2,authentication,2022-11-02 06:14:29 JST,3/145,0,00000,connection authenticated: identity="postgres" method=peer (/var/lib/pgsql/14/data/pg_hba.conf:85),,,,,,,,,
$ tail -f postgresql-Wed.log
2022-11-02 06:14:29.052 JST [11676] LOG: provided user name (nouser) and authenticated user name (postgres) do not match
2022-11-02 06:14:29.052 JST [11676] FATAL: Peer authentication failed for user "nouser"
2022-11-02 06:14:29.052 JST [11676] DETAIL: Connection matched pg_hba.conf line 85: "local all all peer"
$
</pre>
<h2>終わりに</h2>
<p>pgAudit 単体では監査の記録が PostgreSQL ログと混在していましたが、pgAudit Log To File を追加で導入することで、監査の記録を PostgreSQL ログとは別の独立した監査ログファイルに記録することが出来るため、PostgreSQL ログに混在した監査ログの分離が不要となり PostgreSQL ログの扱いがこれまでと同様に出来るため非常に便利です。<br />
pgAudit を新規に導入する際は pgAudit Log to File もセットで導入、pgAudit が既に導入されている環境には pgAudit Log to File を追加で導入することをお勧めします。</p>
<div>
<a href="https://www.sraoss.co.jp/prod_serv/support/pgsql-mainte/?utm_source=sraoss-techblog&utm_medium=referral&utm_campaign=under-article-pgsql" rel="noopener" style="color:initial;" target="_blank" class="no-ext"></p>
<div style="background-color:#DAEFF6; padding:20px; border-radius:8px; text-align:center;">
SRA OSSでは、PostgreSQL/Pgpool-II のサポートを提供しております。<br />
詳しくは<strong style="color:#2581c4;">弊社ホームページ</strong>をご覧ください。
</div>
<p></a>
</div>

]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>pgAudit (PostgreSQL 監査ロギングツール)</title>
		<link>https://www.sraoss.co.jp/tech-blog/pgsql/pgaudit/</link>
		
		<dc:creator><![CDATA[北山 貴広 (Takahiro Kitayama)]]></dc:creator>
		<pubDate>Wed, 25 Nov 2020 02:01:06 +0000</pubDate>
				<category><![CDATA[PostgreSQL]]></category>
		<category><![CDATA[pgAudit]]></category>
		<category><![CDATA[サードパーティーソフトウェア]]></category>
		<guid isPermaLink="false">https://www.sraoss.co.jp/tech-blog/?p=6604</guid>

					<description><![CDATA[本記事では、PostgreSQL 監査ロギングツール「pgAudit」のインストール方法、監査ログ取得方法について紹介します。 pgAudit とは pgAudit は PostgreSQL で監査ログを取得するためのオ ...]]></description>
										<content:encoded><![CDATA[<p>本記事では、PostgreSQL 監査ロギングツール「pgAudit」のインストール方法、監査ログ取得方法について紹介します。</p>
<h2>pgAudit とは</h2>
<p>pgAudit は PostgreSQL で監査ログを取得するためのオープンソースソフトウェアで、PostgreSQL の拡張機能として実装されています。監査する対象として設定した内容は、PostgreSQL ログに混在して出力されます。</p>
<p><span id="more-6604"></span></p>
<p>公式サイトは<a href="https://github.com/pgaudit/pgaudit">こちら</a>です。分かりやすいドキュメント(README.md)とともに公開されています。</p>
<h2>pgAudit サポート対象バージョン</h2>
<p>pgAudit がサポートする PostgreSQL のバージョンは PostgreSQL 9.5 からで、2024年4月時点では PostgreSQL 16 に対応したバージョンがリリースされています。</p>
<p>pgAudit のバージョン体系は、対象とする PostgreSQL のメジャーバージョンで導入された新機能に対応するため、PostgreSQL のメジャーバージョンに対応したバージョンが独立して存在しています。一旦リリースされた後はバグ修正のみが実施される PostgreSQL と同様のリリースモデルを採用しています。</p>
<p>pgAudit のバージョンとサポート対象の PostgreSQL のバージョンの対応は以下の通りです。</p>
<table>
<thead>
<tr>
<th>pgAudit バージョン</th>
<th>サポート対象 PostgreSQL バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td>pgAudit v16.X</td>
<td>PostgreSQL 16</td>
</tr>
<tr>
<td>pgAudit v15.X</td>
<td>PostgreSQL 15</td>
</tr>
<tr>
<td>pgAudit v14.X</td>
<td>PostgreSQL 14</td>
</tr>
<tr>
<td>pgAudit v1.5.X</td>
<td>PostgreSQL 13</td>
</tr>
<tr>
<td>pgAudit v1.4.X</td>
<td>PostgreSQL 12</td>
</tr>
<tr>
<td>pgAudit v1.3.X</td>
<td>PostgreSQL 11</td>
</tr>
<tr>
<td>pgAudit v1.2.X</td>
<td>PostgreSQL 10</td>
</tr>
<tr>
<td>pgAudit v1.1.X</td>
<td>PostgreSQL 9.6</td>
</tr>
<tr>
<td>pgAudit v1.0.X</td>
<td>PostgreSQL 9.5</td>
</tr>
</tbody>
</table>
<h2>pgAudit インストール方法(rpmパッケージ)</h2>
<p>pgAudit のインストール方法は、大きく分けてソースコードからのインストールと、PostgreSQL公式リポジトリの rpm からのインストールがあります。</p>
<p>Windows むけには公式のバイナリ提供はありませんが、ビルドは可能です。 <a href="https://www.sraoss.co.jp/prod_serv/support/pgsql-mainte/?utm_source=sraoss-techblog&amp;utm_medium=referral&amp;utm_campaign=under-article-pgsql">SRA OSS の PostgreSQLサポートサービス</a>では pgAudit の Windowsバイナリを提供しています。</p>
<p>今回は rpm からのインストールをご紹介します。下記のインストールの実行例では CentOS Linux release 8.2.2004, PostgreSQL 13.0, pgAudit v1.5.0 を使用して説明します。CentOS から直接インターネット接続が可能な環境を使用しています。</p>
<h3>CentOS に PostgreSQL 公式 Yum リポジトリを設定し、PostgreSQL 13をインストール</h3>
<p>CentOS から PostgreSQL 公式 Yum リポジトリのパッケージを dnf でインストール可能とするために repo ファイルを導入します。<a href="https://www.postgresql.org/download/">PostgreSQL ダウンロードページ</a>の Packages and Installers で Linux と Red Hat/CentOS を選択したら<a href="https://www.postgresql.org/download/linux/redhat/">このページ</a>が表示されます。PostgreSQL Yum Repository で使用する PostgreSQL バージョン(13)と OS のバージョン(Red Hat/CentOS 8)と CPU アーキテクチャ(x86_64)を選択すれば、repo ファイルを導入して PostgreSQL サーバを導入するコマンドが表示されます。表示されたコマンドを参考にして、まず repo ファイルを導入します。</p>
<pre># dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm
:
依存関係が解決しました。
================================================================================
 パッケージ              Arch          バージョン     リポジトリー        サイズ
================================================================================
インストール中:
 pgdg-redhat-repo        noarch        42.0-14        @commandline         11 k

トランザクションの概要
================================================================================
インストール  1 パッケージ

合計サイズ: 11 k
インストール済みのサイズ: 11 k
パッケージのダウンロード:
トランザクションの確認を実行中
トランザクションの確認に成功しました。
トランザクションのテストを実行中
トランザクションのテストに成功しました。
トランザクションを実行中
  準備              :                                                       1/1
  インストール中    : pgdg-redhat-repo-42.0-14.noarch                       1/1
  検証              : pgdg-redhat-repo-42.0-14.noarch                                                                                1/1
Installed products updated.

インストール済み:
  pgdg-redhat-repo-42.0-14.noarch

完了しました!
#
</pre>
<p>次に、PostgreSQL公式サイトの PostgreSQL が導入できるように OS 組み込みの PostgreSQL を無効にします。これを実行しないと PostgreSQL 公式サイトの PostgreSQL が見つからないと言われてしまいます。</p>
<pre># dnf install -y postgresql13-server
All matches were filtered out by modular filtering for argument: postgresql13-server
エラー: 一致するものが見つかりません: postgresql13-server
# dnf -qy module disable postgresql
# dnf install -y postgresql13-server
依存関係が解決しました。
=========================================================================================================================================
 パッケージ                             アーキテクチャー          バージョン                             リポジトリー              サイズ
=========================================================================================================================================
インストール中:
 postgresql13-server                    x86_64                    13.0-1PGDG.rhel8                       pgdg13                    5.5 M
依存関係のインストール中:
 postgresql13                           x86_64                    13.0-1PGDG.rhel8                       pgdg13                    1.4 M
 postgresql13-libs                      x86_64                    13.0-1PGDG.rhel8                       pgdg13                    411 k

トランザクションの概要
=========================================================================================================================================
インストール  3 パッケージ

ダウンロードサイズの合計: 7.4 M
インストール済みのサイズ: 31 M
パッケージのダウンロード:
(1/3): postgresql13-libs-13.0-1PGDG.rhel8.x86_64.rpm                                                     163 kB/s | 411 kB     00:02
(2/3): postgresql13-13.0-1PGDG.rhel8.x86_64.rpm                                                          262 kB/s | 1.4 MB     00:05
(3/3): postgresql13-server-13.0-1PGDG.rhel8.x86_64.rpm                                                   466 kB/s | 5.5 MB     00:12
-----------------------------------------------------------------------------------------------------------------------------------------
合計                                                                                                     617 kB/s | 7.4 MB     00:12
警告: /var/cache/dnf/pgdg13-e81daebfc8b779ec/packages/postgresql13-13.0-1PGDG.rhel8.x86_64.rpm: ヘッダー V4 DSA/SHA1 Signature、鍵 ID 442df0f8: NOKEY
PostgreSQL 13 for RHEL/CentOS 8 - x86_64                                                                 1.6 MB/s | 1.7 kB     00:00
GPG 鍵 0x442DF0F8 をインポート中:
 Userid     : "PostgreSQL RPM Building Project &lt;pgsqlrpms-hackers@pgfoundry.org&gt;"
 Fingerprint: 68C9 E2B9 1A37 D136 FE74 D176 1F16 D2E1 442D F0F8
 From       : /etc/pki/rpm-gpg/RPM-GPG-KEY-PGDG
鍵のインポートに成功しました
トランザクションの確認を実行中
トランザクションの確認に成功しました。
トランザクションのテストを実行中
トランザクションのテストに成功しました。
トランザクションを実行中
  準備              :                                                                                                                1/1
  インストール中    : postgresql13-libs-13.0-1PGDG.rhel8.x86_64                                                                      1/3
  scriptlet の実行中: postgresql13-libs-13.0-1PGDG.rhel8.x86_64                                                                      1/3
  インストール中    : postgresql13-13.0-1PGDG.rhel8.x86_64                                                                           2/3
  scriptlet の実行中: postgresql13-13.0-1PGDG.rhel8.x86_64                                                                           2/3
  scriptlet の実行中: postgresql13-server-13.0-1PGDG.rhel8.x86_64                                                                    3/3
  インストール中    : postgresql13-server-13.0-1PGDG.rhel8.x86_64                                                                    3/3
  scriptlet の実行中: postgresql13-server-13.0-1PGDG.rhel8.x86_64                                                                    3/3
  検証              : postgresql13-13.0-1PGDG.rhel8.x86_64                                                                           1/3
  検証              : postgresql13-libs-13.0-1PGDG.rhel8.x86_64                                                                      2/3
  検証              : postgresql13-server-13.0-1PGDG.rhel8.x86_64                                                                    3/3
Installed products updated.

インストール済み:
  postgresql13-13.0-1PGDG.rhel8.x86_64     postgresql13-libs-13.0-1PGDG.rhel8.x86_64     postgresql13-server-13.0-1PGDG.rhel8.x86_64

完了しました!
# 
</pre>
<p>これで PostgreＳQＬ 公式サイトの rpm から PostgreSQL 13.0 が導入出来ました。DBの初期化も実施しておきましょう。</p>
<pre># export PGSETUP_INITDB_OPTIONS="--encoding=UTF-8 --no-locale"
# /usr/pgsql-13/bin/postgresql-13-setup initdb
Initializing database ... OK

# systemctl enable postgresql-13
Created symlink /etc/systemd/system/multi-user.target.wants/postgresql-13.service → /usr/lib/systemd/system/postgresql-13.service.
# systemctl start postgresql-13
# systemctl status postgresql-13
● postgresql-13.service - PostgreSQL 13 database server
   Loaded: loaded (/usr/lib/systemd/system/postgresql-13.service; enabled; vendor preset: disabled)
   Active: active (running) since Tue 2020-11-10 11:42:49 JST; 7s ago
     Docs: https://www.postgresql.org/docs/13/static/
  Process: 24991 ExecStartPre=/usr/pgsql-13/bin/postgresql-13-check-db-dir ${PGDATA} (code=exited, status=0/SUCCESS)
 Main PID: 24996 (postmaster)
    Tasks: 8 (limit: 4879)
   Memory: 23.7M
   CGroup: /system.slice/postgresql-13.service
           tq24996 /usr/pgsql-13/bin/postmaster -D /var/lib/pgsql/13/data/
           tq24998 postgres: logger
           tq25000 postgres: checkpointer
           tq25001 postgres: background writer
           tq25002 postgres: walwriter
           tq25003 postgres: autovacuum launcher
           tq25004 postgres: stats collector
           mq25005 postgres: logical replication launcher

11月 10 11:42:49 c822004 systemd[1]: Starting PostgreSQL 13 database server...
11月 10 11:42:49 c822004 postmaster[24996]: 2020-11-10 11:42:49.736 JST [24996] LOG:  redirecting log output to logging collector process
11月 10 11:42:49 c822004 postmaster[24996]: 2020-11-10 11:42:49.736 JST [24996] HINT:  Future log output will appear in directory "log".
11月 10 11:42:49 c822004 systemd[1]: Started PostgreSQL 13 database server.
# su - postgres
[postgres@c822004 ~]$ psql
psql (13.0)
"help"でヘルプを表示します。

postgres=#
</pre>
<p>無事 PostgreSQL 13 が起動しました。</p>
<h3>pgaudit のインストール</h3>
<p>PostgreSQL 公式リポジトリに含まれる pgaudit の rpm パッケージ名を調べてみます。PostgreSQL 13 用の pgaudit のパッケージは pgaudit15_13 でした。</p>
<pre># dnf list | grep pgaudit
pgaudit10_95.x86_64                                  1.0.8-1.rhel8                                     pgdg95
pgaudit11_96.x86_64                                  1.1.3-1.rhel8                                     pgdg96
pgaudit12_10.x86_64                                  1.2.2-1.rhel8                                     pgdg10
pgaudit13_11.x86_64                                  1.3.2-1.rhel8                                     pgdg11
pgaudit14_12.x86_64                                  1.4.1-1.rhel8                                     pgdg12
pgaudit15_13.x86_64                                  1.5.0-1.rhel8                                     pgdg13
pgaudit_analyze.x86_64                               1.0.7-1.rhel8                                     pgdg-common
pgauditlogtofile-10.x86_64                           1.0-1.rhel8                                       pgdg10
pgauditlogtofile-11.x86_64                           1.0-1.rhel8                                       pgdg11
pgauditlogtofile-12.x86_64                           1.0-1.rhel8                                       pgdg12
pgauditlogtofile-13.x86_64                           1.0-1.rhel8                                       pgdg13
pgauditlogtofile-96.x86_64                           1.0-1.rhel8                                       pgdg96
#
</pre>
<p>pgaudit のパッケージを導入します。</p>
<pre># dnf install -y pgaudit15_13
依存関係が解決しました。
=========================================================================================================================================
 パッケージ                         アーキテクチャー             バージョン                           リポジトリー                 サイズ
=========================================================================================================================================
インストール中:
 pgaudit15_13                       x86_64                       1.5.0-1.rhel8                        pgdg13                        52 k

トランザクションの概要
=========================================================================================================================================
インストール  1 パッケージ

ダウンロードサイズの合計: 52 k
インストール済みのサイズ: 93 k
パッケージのダウンロード:
pgaudit15_13-1.5.0-1.rhel8.x86_64.rpm                                                                     26 kB/s |  52 kB     00:02
-----------------------------------------------------------------------------------------------------------------------------------------
合計                                                                                                      25 kB/s |  52 kB     00:02
トランザクションの確認を実行中
トランザクションの確認に成功しました。
トランザクションのテストを実行中
トランザクションのテストに成功しました。
トランザクションを実行中
  準備              :                                                                                                                1/1
  インストール中    : pgaudit15_13-1.5.0-1.rhel8.x86_64                                                                              1/1
  scriptlet の実行中: pgaudit15_13-1.5.0-1.rhel8.x86_64                                                                              1/1
  検証              : pgaudit15_13-1.5.0-1.rhel8.x86_64                                                                              1/1
Installed products updated.

インストール済み:
  pgaudit15_13-1.5.0-1.rhel8.x86_64

完了しました!
#
</pre>
<p>これで pgaudit がインストールできました。</p>
<h3>postgresql.conf の shared_preload_libraries に pgaudit を追加して PostgreSQL を再起動、有効になっていることを確認</h3>
<p>shared_preload_libraries に共有ライブラリの pgaudit を設定して PostgreSQL を再起動し、pgaudit が有効になっていることを確認します。</p>
<pre>$ cd $PGDATA
$ vi postgresql.conf
shared_preload_libraries = 'pgaudit'
# systemctl restart postgresql-13
$ psql
psql (13.0)
"help"でヘルプを表示します。

postgres=# show shared_preload_libraries;
 shared_preload_libraries
--------------------------
 pgaudit
(1 行)
</pre>
<h3>CREATE EXTENSION を実行してエクステンションに登録</h3>
<p>使用したいデータベースに psql で接続して、CREATE EXTENSION を実行します。エクステンションが登録されていることを確認します。</p>
<pre>postgres=# CREATE EXTENSION pgaudit;
CREATE EXTENSION
postgres=# \dx
                     インストール済みの拡張一覧
  名前   | バージョン |  スキーマ  |              説明
---------+------------+------------+---------------------------------
 pgaudit | 1.5        | public     | provides auditing functionality
 plpgsql | 1.0        | pg_catalog | PL/pgSQL procedural language
(2 行)

postgres=#
</pre>
<p>これで pgAudit のインストールは完了しました。</p>
<h2>pgAudit 監査ログ取得方法</h2>
<p>監査ログの取得方法は大きく分けて二種類あります。セッション監査ロギングとオブジェクト監査ロギングです。</p>
<h3>セッション監査ロギング</h3>
<p>セッションで接続した際に、pgAudit のパラメータ pgaudit.log に設定した文のクラスがすべて記録されます。文のクラスとして設定できる値は、READ / WRITE / FUNCTION / ROLE / DDL / MISC / MISC_SET とそれら全てを含む ALL があり、複数の値をカンマで区切って指定できます。例えば、READ を設定すると SELECT とソースがリレーションかクエリの場合の COPY が、WRITE を設定すると INSERT、UPDATE、DELETE、TRUNCATEと宛先がリレーションの場合の COPY が記録されます。またマイナス記号を使用すると、除外対象として設定可能です。例えば、&#8217;ALL, -MISC&#8217; と設定すると、MISC 以外の内容がすべて監査ログとして記録されます。</p>
<h3>オブジェクト監査ロギング</h3>
<p>テーブル単位やカラム単位などオブジェクトに対する権限を pgAudit のパラメータ pgaudit.role に設定したロールに対して設定することで、ロールの操作がすべて記録されます。pgaudit.role に設定するロールはマスターロールと呼ばれます。セッション監査ログでは大量の監査ログが出力される可能性があるため、特定のテーブルだけを監査したい場合や特定のテーブルの特定のカラムに対する操作だけを監査したい場合など特定のリレーションに絞った詳細な監査ログを取得するのに向いています。</p>
<h2>pgAudit を使ってみる（セッション監査ロギング編）</h2>
<p>監査ログをセッション単位で取得するセッション監査ロギングを試してみます。postgresql.conf ファイルに pgaudit.log = &#8216;ALL&#8217; を追加し、PostgreSQL に設定を読み込ませます。SELECT 文を実行したところ、無事 PostgreSQL ログに記録されました。</p>
<pre>LOG:  received SIGHUP, reloading configuration files
LOG:  parameter "pgaudit.log" changed to "ALL"
LOG:  AUDIT: SESSION,1,1,READ,SELECT,,,SELECT * FROM test1;,&lt;not logged&gt;
</pre>
<p>pgAuditの監査ログは、AUDIT: で始まって、カンマ区切り形式で各情報が出力されます。監査ログのフォーマットは後で詳細を説明します。</p>
<h3>pgaudit.log_catalog について</h3>
<p>psql で \d を実行すると、psql が実行した pg_catalog.pg_class と pg_catalog.pg_namespace への SELECT 文が監査ログとして記録されます。これは、pgaudit.log_catalog のデフォルト値が &#8216;on&#8217; になっているためです。psql がどのような DML 文で内容を検索しているのかの勉強になると思いますが、psql や pgAdmin4 などを使う時にはデフォルト値のままだと必要な監査ログが埋もれてしまう可能性があるので、こういった pg_catalog への参照をするようなツールを使う時に監査ログを取得する際は、pgaudit.log_catalog を &#8216;off&#8217; にしてノイズを減らしたほうがよいと思います。</p>
<pre>postgres=# \d
         List of relations
 Schema | Name  | Type  |  Owner
--------+-------+-------+----------
 public | test1 | table | postgres
(1 row)

LOG:  AUDIT: SESSION,2,1,READ,SELECT,,,"SELECT n.nspname as ""Schema"",
          c.relname as ""Name"",
          CASE c.relkind WHEN 'r' THEN 'table' WHEN 'v' THEN 'view' WHEN 'm' THEN 'materialized view' WHEN 'i' THEN 'index' WHEN 'S' THEN 'sequence' WHEN 's' THEN 'special' WHEN 'f' THEN 'foreign table' WHEN 'p' THEN 'partitioned table' WHEN 'I' THEN 'partitioned index' END as ""Type"",
          pg_catalog.pg_get_userbyid(c.relowner) as ""Owner""
        FROM pg_catalog.pg_class c
             LEFT JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace
        WHERE c.relkind IN ('r','p','v','m','S','f','')
              AND n.nspname &lt;&gt; 'pg_catalog'
              AND n.nspname &lt;&gt; 'information_schema'
              AND n.nspname !~ '^pg_toast'
          AND pg_catalog.pg_table_is_visible(c.oid)
        ORDER BY 1,2;",&lt;not logged&gt;
</pre>
<h3>pgaudit.log_relation について</h3>
<p>セッション監査ロギングで SELECT 文または DML文で参照される各リレーション（TABLE、VIEW など）の個別のログエントリを作成するかどうかを指定します。デフォルト値は &#8216;off&#8217; でリレーションは記録されませんが、&#8217;on&#8217; に設定すると、6番目にオブジェクトの型（TABLEなど）、7番目にオブジェクトの完全修飾名（public.table1など）とリレーションの情報が記録されます。</p>
<ul>
<li>pgaudit.log_relation = &#8216;off&#8217; (デフォルト値) の時
<pre>LOG:  AUDIT: SESSION,1,1,READ,SELECT,,,SELECT * FROM table1;,&lt;not logged&gt;
</pre>
</li>
<li>pgaudit.log_relation = &#8216;on&#8217; の時
<pre>LOG:  AUDIT: SESSION,1,1,READ,SELECT,TABLE,public.table1,SELECT * FROM table1;,&lt;not logged&gt;
</pre>
</li>
</ul>
<p>pgaudit.log_relation が &#8216;on&#8217; の時は SELECT と SELECT文との間の6番目と7番目にそれぞれ TABLE と public.table1 が記録されています。異なるスキーマに属するけれども同一のテーブル名のリレーションが複数存在する時もありますので、このパラメータ pgaudit.log_relation は &#8216;on&#8217; に設定するのがよさそうに思います。</p>
<h3>pgaudit.log_parameter について</h3>
<p>pgaudit.log_parameter は渡されたパラメータを監査ログの最後のエントリに追記するかどうかを指定します。デフォルト値は &#8216;off&#8217; でパラメータは記録されずに &lt;not logged&gt; と表示されます。&#8217;on&#8217; に設定するとパラメータは記録されますが、パラメータが無い時は &lt;none&gt; と表示されます。</p>
<ul>
<li>pgaudit.log_parameter = &#8216;off&#8217; （デフォルト値）の時
<pre>LOG:  AUDIT: SESSION,4,1,MISC,SHOW,,,SHOW pgaudit.log_client;,&lt;not logged&gt;
</pre>
</li>
<li>pgaudit.log_parameter = &#8216;on&#8217; の時
<pre>LOG:  AUDIT: SESSION,7,1,MISC,SHOW,,,SHOW pgaudit.log_client;,&lt;none&gt;
</pre>
</li>
</ul>
<h3>pgaudit.log_statement_once について</h3>
<p>監査ログにおいて、文テキストとパラメータをステートメント(文)とサブステートメント(サブ文)の組み合わせを最初のエントリだけに含めるか、各エントリのすべてに含めるかを指定します。デフォルト値は &#8216;off&#8217; で、各エントリのすべてに含められます。下記の例は、 pgaudit.log_relation = &#8216;on&#8217; の時に table1 テーブルと table2 テーブルに対して SELECT 文で JOIN をした時の出力です。</p>
<ul>
<li>pgaudit.log_statement_once = &#8216;off&#8217; （デフォルト値）の時
<pre>LOG:  AUDIT: SESSION,1,1,READ,SELECT,TABLE,public.table1,"SELECT table1.id, table1.t1, table2.t1 FROM table1, table2 WHERE table1.id = table2.id;",&lt;not logged&gt;
LOG:  AUDIT: SESSION,1,1,READ,SELECT,TABLE,public.table2,"SELECT table1.id, table1.t1, table2.t1 FROM table1, table2 WHERE table1.id = table2.id;",&lt;not logged&gt;
</pre>
</li>
<li>pgaudit.log_statement_once = &#8216;on&#8217; の時
<pre>LOG:  AUDIT: SESSION,1,1,READ,SELECT,TABLE,public.table1,"SELECT table1.id, table1.t1, table2.t1 FROM table1, table2 WHERE table1.id = table2.id;",&lt;not logged&gt;
LOG:  AUDIT: SESSION,1,1,READ,SELECT,TABLE,public.table2,&lt;previously logged&gt;,&lt;previously logged&gt;
</pre>
</li>
</ul>
<p>リレーション出力がオンなので、二つのテーブルの完全修飾名である public.table1 と public.table2 が二行に出力されています。pgaudit.log_statement が &#8216;off&#8217; の時は8番目のバックエンドで実行される SELECT 文と9番目のパラメータの情報が二行とも出力されていますが、pgaudit.log_statement が &#8216;on&#8217; の時は8番目と9番目は &lt;previously logged&gt; と省略した表示がされています。</p>
<h3>pgaudit.log_client と pgaudit.log_level について</h3>
<p>pgaudit.log_client はログメッセージを psql などのクライアントプロセスに表示するかどうかを指定します。psql を使ってデバッグや動作確認をしたい時に便利な機能です。デフォルト値は &#8216;off&#8217; で通常は表示されません。また pgaudit.log_client が &#8216;on&#8217; の時だけ使用可能なパラメータ pgaudit.log_level があり、このパラメータでログエントリに使用されるログレベルが指定可能です。デフォルト値は log で、指定可能なパラメータは debug1 から debug5 / info / notice / warning / log です。error と fatal と panic は使用できません。</p>
<h2>pgAudit を使ってみる（オブジェクト監査ロギング編）</h2>
<p>オブジェクトに対する権限をロールに付与して、そのロールを監査対象とすることで監査を実施するオブジェクト監査ロギングを試してみます。</p>
<h3>auditmroleマスターロールの作成</h3>
<p>オブジェクト監査ロギングの対象ロールとして auditmrole マスターロールを作成します。</p>
<pre>postgres=# CREATE ROLE auditmrole;
CREATE ROLE
</pre>
<h3>pgaudit.role の設定</h3>
<p>postgresql.conf ファイルに pgaudit.role = &#8216;auditorole&#8217; を追加し、PostgreSQL に設定を反映します。</p>
<pre>$ cd $PGDATA
$ vi postgresql.conf
pgaudit.role = 'auditmrole'
$ pg_ctl reload

2020-11-02 07:22:08.263 JST [2107] LOG:  received SIGHUP, reloading configuration files
2020-11-02 07:22:08.264 JST [2107] LOG:  parameter "pgaudit.role" changed to "auditmrole"
</pre>
<h3>マスターロールへの権限の付与</h3>
<p>auditmrole マスターロールに table1 テーブルの t1 カラムへの SELECT の権限を与えます。</p>
<pre>postgres=# CREATE TABLE table1 (id int, t1 text);
CREATE TABLE
postgres=# INSERT INTO table1 VALUES (1, 'aaa'),(2, 'bbb');
INSERT 0 2
postgres=# SELECT * FROM table1;
 id | t1
----+-----
  1 | aaa
  2 | bbb
(2 rows)

postgres=# GRANT SELECT (t1) on table1 to auditmrole;
GRANT

</pre>
<h3>マスターロールでの種々の操作と監査ログ</h3>
<p>t1 カラムを含む SELECT と t1 カラムを含まない SELECT を実施します。</p>
<pre>postgres=# SELECT * FROM table1;
 id | t1
----+-----
  1 | aaa
  2 | bbb
(2 行)


postgres=&gt; SELECT id FROM table1;
  id
----
  1
  2
(2 行)

postgres=# SELECT id,t1 FROM table1;
 id | t1
----+-----
  1 | aaa
  2 | bbb
(2 行)
</pre>
<p>auditmroleロールに与えられた権限の通り、t1カラムを含むSELECTは記録されましたが、t1カラムを含まないidカラムのみのSELECT文は記録されませんでした。このようにオブジェクト監査ロギングではauditmroleロールに与えられた権限のみがPostgreSQLログに記録されますので詳細なレベルで取得する情報を設定できます。</p>
<pre>2020-11-02 07:38:12.106 JST [3750] LOG:  AUDIT: OBJECT,1,1,READ,SELECT,TABLE,public.table1,SELECT * FROM table1;,
2020-11-02 07:38:57.614 JST [3750] LOG:  AUDIT: OBJECT,2,1,READ,SELECT,TABLE,public.table1,"SELECT id,t1 FROM table1;",
</pre>
<h2>pgAudit のログ出力形式</h2>
<p>pgAuditの監査エントリは、標準のロギング機能に書き込まれ、カンマ区切り形式で以下の列が含まれます。各ログエントリのログ行のプレフィックス部分が削除された場合のみ、出力はCSV形式に準拠します。</p>
<table>
<thead>
<tr>
<th>順番</th>
<th>エントリ</th>
<th>説明</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>AUDIT_TYPE</td>
<td>SESSION または OBJECT</td>
</tr>
<tr>
<td>2</td>
<td>STATEMENT_ID</td>
<td>このセッションの一意の文ID。各文IDはバックエンド呼び出しを表します。一部の文がログに記録されていない場合でも、文IDは連続しています。複数のリレーションがログに記録されている場合、1つの文IDに対して複数のエントリが存在する可能性があります。</td>
</tr>
<tr>
<td>3</td>
<td>SUBSTATEMENT_ID</td>
<td>メイン文内の各サブ文のシーケンシャル ID。例えば、クエリから関数を呼び出す場合など。一部のサブ文がログに記録されていなくてもサブ文IDは連続しています。複数のリレーションがログに記録される場合、サブ文IDに対して複数のエントリが存在する可能性があります。</td>
</tr>
<tr>
<td>4</td>
<td>CLASS</td>
<td>例：READ、ROLE など(pgaudit.log を参照)。</td>
</tr>
<tr>
<td>5</td>
<td>COMMAND</td>
<td>例：ALTER TABLE、SELECT など。</td>
</tr>
<tr>
<td>6</td>
<td>OBJECT_TYPE</td>
<td>TABLE、INDEX、VIEWなど。SELECT と DML とほとんどの DDL 文で利用可能。セッション監査ロギングでは pgaudit.log_relation = &#8216;on&#8217; の時のみ出力されます。</td>
</tr>
<tr>
<td>7</td>
<td>OBJECT_NAME</td>
<td>完全修飾されたオブジェクト名（例：public.account）。SELECT と DML とほとんどの DDL 文で利用可能。セッション監査ロギングでは pgaudit.log_relation = &#8216;on&#8217; の時のみ出力されます。</td>
</tr>
<tr>
<td>8</td>
<td>STATEMENT</td>
<td>バックエンドで実行される文(ステートメント)</td>
</tr>
<tr>
<td>9</td>
<td>PARAMETER</td>
<td>pgaudit.log_parameter が設定されている場合、このフィールドには、引用符で囲まれた CSV の文パラメータ、パラメータがない場合は &lt;none&gt; が含まれます。pgaudit.log_parameter が設定されていない場合は &lt;not logged&gt; となります。</td>
</tr>
</tbody>
</table>
<p>監査ログの要件を満たすために必要な他のフィールドを追加するには log_line_prefix を使用します。典型的なログ行プレフィックスは、&#8217;%m %u %d [%p]: &#8216; で、各監査ログの日付/時刻、ユーザ名、データベース名、およびプロセス ID を提供します。</p>
<h2>終わりに</h2>
<p>pgAudit を導入して、セッション監査ロギングとオブジェクト監査ロギングの両方を実行してみました。また pgAudit の種々のパラメータの紹介と解説をしました。PostgreSQL で監査ログを取得する必要が出てきた時に、本記事が参考になれば幸いです。</p>
<div>
<a href="https://www.sraoss.co.jp/prod_serv/support/pgsql-mainte/?utm_source=sraoss-techblog&utm_medium=referral&utm_campaign=under-article-pgsql" rel="noopener" style="color:initial;" target="_blank" class="no-ext"></p>
<div style="background-color:#DAEFF6; padding:20px; border-radius:8px; text-align:center;">
SRA OSSでは、PostgreSQL/Pgpool-II のサポートを提供しております。<br />
詳しくは<strong style="color:#2581c4;">弊社ホームページ</strong>をご覧ください。
</div>
<p></a>
</div>

]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
