Logging
CloudNativePGは、セキュリティ上の理由からストレージに永続化せずに、PostgreSQLログを含む標準出力にJSON形式でログを出力します。このデザインにより、 stern のようなコマンドラインのものを含む、ほとんどのKubernetes互換ログ管理ツールとのシームレスな統合が促進されます。
注釈
ログの長期保存と管理はオペレーターの範囲外であり、Kubernetesインフラストラクチャレベルで処理する必要があります。詳細については、
Kubernetes Logging Architecture を参照してください。
ドキュメント。
各ログエントリには、次のフィールドが含まれます。
level– ログレベルたとえばinfo、notice。ts– タイムスタンプ。logger– ログのタイプpostgres、pg_controldataなど。msg– ログメッセージ、またはメッセージがJSON形式の場合はキーワードrecordrecord– 実際のレコード。loggerタイプに応じて異なる構造。logging_pod– ログが生成されたポッドの名前。
注釈
ログ取り込みシステムでカスタムフィールド名が必要な場合、オペレーターコントローラの`log-field-level` および`log-field-timestamp` フラグを使用して、level および`ts` フィールドの名前を変更できます。これは、 cloudnative-pg オペレーターの`Deployment` 定義を編集することにより構成できます。
クラスターログ
logLevel
オプションを使用して、クラスター仕様でインスタンスポッドのログレベルを構成できます。使用可能なログレベルはerror
、warning 、info デフォルト、debug 、およびtrace
です。
注釈
現在、ログレベルはインスタンスの起動時にのみ設定できます。クラスターが起動した後のクラスター仕様のログレベルの変更は、新しいポッドにのみ適用され、既存のポッドには適用されません。
オペレーターログ
オペレーターポッドによって生成されるログは、インスタンスポッドと同じログレベルで構成できます。error
、warning 、info デフォルト、debug 、およびtrace
。
オペレーターのログレベルは、オペレーターのDeployment
定義を編集し、--log-level
コマンドライン引数を目的の値に設定することにより、構成できます。
PostgreSQLログ
各PostgreSQLログエントリは、 logger キーがpostgres
に設定されたJSONオブジェクトです。ログエントリの構造は次のとおりです。
{
"level": "info",
"ts": 1619781249.7188137,
"logger": "postgres",
"msg": "record",
"record": {
"log_time": "2021-04-30 11:14:09.718 UTC",
"user_name": "",
"database_name": "",
"process_id": "25",
"connection_from": "",
"session_id": "608be681.19",
"session_line_num": "1",
"command_tag": "",
"session_start_time": "2021-04-30 11:14:09 UTC",
"virtual_transaction_id": "",
"transaction_id": "0",
"error_severity": "LOG",
"sql_state_code": "00000",
"message": "database system was interrupted; last known up at 2021-04-30 11:14:07 UTC",
"detail": "",
"hint": "",
"internal_query": "",
"internal_query_pos": "",
"context": "",
"query": "",
"query_pos": "",
"location": "",
"application_name": "",
"backend_type": "startup"
},
"logging_pod": "cluster-example-1",
}
注釈
内部的に、オペレーターはPostgreSQLのCSVログ形式を使用します。詳細については、
PostgreSQL documentation on CSV log format を参照してください。
PG監査ログ
CloudNativePGは、 PostgreSQLクラスターで PGAudit のシームレスなネイティブサポートを提供します。
PGAuditを有効にするには、クラスター構成のpostgresql
セクションに必要なpgaudit パラメーターを追加します。
注釈
PGAuditライブラリを`shared_preload_libraries` に追加する必要があります。 CloudNativePGは、PostgreSQL構成内の`pgaudit.*` パラメーターの存在に基づいて、これを自動的に管理します。オペレーターは、shared_preload_libraries からのライブラリの追加と削除の両方を処理します。
さらに、オペレーターは、クラスター内のすべてのデータベースでPGAudit拡張機能の作成と削除を管理します。
注釈
CloudNativePGは、接続を受け入れるクラスター内のすべてのデータベースで`CREATE EXTENSION` および`DROP EXTENSION` コマンドを実行します。
次の例は、PGAuditが有効および構成されたPostgreSQL Cluster
展開を示しています。
apiVersion: postgresql.cnpg.io/v1
kind: Cluster
metadata:
name: cluster-example
spec:
instances: 3
postgresql:
parameters:
"pgaudit.log": "all, -misc"
"pgaudit.log_catalog": "off"
"pgaudit.log_parameter": "on"
"pgaudit.log_relation": "on"
storage:
size: 1Gi
PGAuditによって生成された監査CSVログエントリは解析され、他のすべてのログと同様に、JSON形式で標準出力にルーティングされます。
.loggerはpgauditに設定されます。.msgはrecordに設定されます。.recordには、解析されたレコード全体がJSONオブジェクトとして含まれています。この構造は、JSONオブジェクトとしてフォーマットされたPGAudit CSVメッセージを含む.record.auditを除きlogging_collectorログの構造に似ています。
この例は、サンプルログエントリを示しています。
{
"level": "info",
"ts": 1627394507.8814096,
"logger": "pgaudit",
"msg": "record",
"record": {
"log_time": "2021-07-27 14:01:47.881 UTC",
"user_name": "postgres",
"database_name": "postgres",
"process_id": "203",
"connection_from": "[local]",
"session_id": "610011cb.cb",
"session_line_num": "1",
"command_tag": "SELECT",
"session_start_time": "2021-07-27 14:01:47 UTC",
"virtual_transaction_id": "3/336",
"transaction_id": "0",
"error_severity": "LOG",
"sql_state_code": "00000",
"backend_type": "client backend",
"audit": {
"audit_type": "SESSION",
"statement_id": "1",
"substatement_id": "1",
"class": "READ",
"command": "SELECT FOR KEY SHARE",
"statement": "SELECT pg_current_wal_lsn()",
"parameter": "<none>"
}
},
"logging_pod": "cluster-example-1",
}
レコードの各フィールドの詳細については、 PGAudit documentation を参照してください。
その他のログ
オペレーターとそのインスタンスによって生成されたすべてのログはJSON形式であり、
logger
フィールドは、それらを生成したプロセスを示します。使用可能なlogger
値は次のとおりです。
barman-cloud-wal-archivebarman-cloud-wal-archiveからのログbarman-cloud-wal-restorebarman-cloud-wal-restoreからのログinitdbinitdbの実行からのログpg_basebackuppg_basebackupの実行からのログpg_controldatapg_controldataの実行からのログpg_ctlpg_ctlサブコマンドの実行からのログpg_rewindpg_rewindの実行からのログpgauditPGAudit拡張機能からのログpostgrespostgresインスタンスからのログmsgはrecordとは異なりますwal-archiveインスタンスマネージャーのwal-archiveサブコマンドからのログwal-restoreインスタンスマネージャーのwal-restoreサブコマンドからのログinstance-managerPostgreSQL instance manager から
特定の構造に従うpostgres を除き 、他のすべてのlogger
値には、ログに記録されるエスケープメッセージを含むmsg
フィールドが含まれます。