PostgreSQL のモニター

PostgreSQL センサーの対応OSは、ホストエージェントの要件と一致しています。これについては、各ホストエージェントの「対応OS」セクションで確認できます。例： Unix の対応OS。

このセンサーは、以下のバージョンの PostgreSQL: に対応しています

• PostgreSQL 8.0.x 8.4.x 宛てに
• PostgreSQL 9.0.x 9.6.x 宛てに
• PostgreSQL 10.x
• PostgreSQL 11.x
• PostgreSQL 12.x
• PostgreSQL 13.x
• PostgreSQL 14.x
• PostgreSQL 15.x
• PostgreSQL 16.6
• PostgreSQL 17.2

以下の表は、最新のサポート対象バージョンとサポート方針を示しています：

サポートポリシーに関する詳細については、 「センサーのサポート戦略」 を参照してください。

この技術において、 Instana は以下の言語およびランタイムのクライアントサイドトレースをサポートしています：

• Java
• Node.js
• PHP
• .NET Framework
• .Net Core
• Go の対応ライブラリおよびプラットフォーム
• Python

統計の収集は、 postgresql.conf ファイルに設定されている構成パラメーターによって制御されます。このファイルは、postgresql の構成時に作成されます。 統計情報の収集を監視するには、以下のパラメータを設定してください on （yes, true, および も 1 有効です）。

ファイル postgresql.conf の場所を確認するには、次のSQLクエリを実行してください：

SHOW config_file;

このクエリは、 PostgreSQLpostgresql.conf サーバー上のファイルへのフルパスを返します。

次の表に設定パラメータを一覧で示します：

統計情報の収集設定に関する詳細については、『 PostgreSQL 』のドキュメントを参照してください。

環境によっては、 PostgreSQL の設定ファイルが再起動後も保持されないことがあります。 に直接行った変更は、システムの postgresql.conf 再起動後に失われる可能性があります。 再起動後も統計情報の収集設定が有効なままになるようにするには、コマンド ALTER SYSTEM を使用することをお勧めします。 このコマンドは、設定をファイル postgresql.auto.conf に保存します。このファイルは PostgreSQL のデータディレクトリの一部であり、永続ボリュームが使用されている場合、設定が永続化されます。

統計情報の収集を有効にするには、次のコマンドを実行してください：

• ALTER SYSTEM SET track_activities = 'on';
• ALTER SYSTEM SET track_counts = 'on';
• ALTER SYSTEM SET track_io_timing = 'on';

設定を再読み込みするには、次の SELECT pg_reload_conf(); コマンドを実行してください。 以下のコマンドを実行して、設定を確認してください：

• SHOW track_activities;
• SHOW track_counts;
• SHOW track_io_timing;

また、コマンド ALTER SYSTEM を使用して適用された設定の変更を確認するには、ファイルを確認 postgresql.auto.conf することもできます。 このファイルには、更新された設定が含まれています。

設定用のコマンド ALTER SYSTEM の使用方法の詳細については、『 PostgreSQL 』のドキュメントを参照してください。

cluster_name = 'PostgreSQL_cluster'

PostgreSQL のrootless Podman コンテナで統計情報の収集を有効にするには、ファイル postgresql.conf 内のパラメータを有効にし、 PostgreSQL サーバーのリスンポートを、rootless Podman コンテナがホストされているホスト上の同じポートにマッピングする必要があります。 接続を確立し、必要なメトリクスを収集するには、ポートマッピングが必要です。 最後に、エージェントの設定ファイルで isRootlessPodman キーを true に設定してください。

メトリック収集をモニターするための最小限の権限は、 pg_stat_database データベースに対する SELECT です。 以下の例は、エージェントのニーズに対応するユーザーを作成する方法を示しています。

create user <USERNAME> with password <PASSWORD>;
grant SELECT ON pg_stat_database to <USERNAME>;
 

センサーがPostgreSQL,以下のステップを実行します：

1. エージェント構成ファイル <agent_install_dir>/etc/instana/configuration.yamlの構成セクションを有効にして、ユーザー資格情報を構成します。

2. ユーザー名とパスワードを入力します。

   パスワードは平文のパスワードです。

パスワード・ベースの認証の場合、対応する PostgreSQL ユーザーの認証メカニズムは、 md5、 scram-sha-256 (バージョン 10 以降)、またはパスワードでなければなりません。 詳細については、『 PostgreSQL 』のドキュメントにある「 パスワード認証 」および「クライアント認証」のセクションを参照してください。

センサーとPostgreSQL,の間で接続を確立するためには、PostgreSQLにユーザー名と同じ名前のデータベースが含まれていなければなりません：

com.instana.plugin.postgresql:
  user: '<USERNAME>'
  password: '<PASSWORD>'
  database: '' # by default PostgreSQL will use 'user' as database to connect to.
  poll_rate: 10 #Values are in seconds. Default Value 1 Sec.
  isRootlessPodman: true/false # Optional. Use this field only if you are running postgres inside a rootless podman container. Default value is false.
 

database フィールドは認証目的でのみ使用されます。 エージェントは設定ファイルの変更内容を自動的に <agent_install_dir>/etc/instana/configuration.yaml読み取ります。 したがって、この構成ファイルに対する変更はホット・リロードされます (エージェントを再始動する必要はありません)。

データベース・メトリックを収集するには、指定した user に、 PostgreSQL インスタンス内に存在するすべてのデータベースに対する CONNECT 特権を割り当てる必要があります。 以下の例は、 CONNECT 特権をユーザーに付与する方法を示しています。

GRANT CONNECT ON DATABASE <DATABASE_NAME> TO <USERNAME>;
 

実行中の Postgres インスタンスから収集された以下の構成データを参照してください。

• プロセス ID
• 開始時刻
• ポート
• バージョン
• 役割
• 最大接続数

以下は、 Postgres インスタンスごとに収集されるパフォーマンス・メトリックです。

各センサーには、着信メトリックに対して継続的に評価され、ユーザーの影響に依存する問題またはインシデントを発生させるために使用される、キュレートされたヘルス・シグネチャーの知識ベースがあります。

組み込みイベントは、エンティティのヘルスシグネチャの異常に基づいて課題やインシデントをトリガーし、 カスタムイベントは、特定のエンティティの個々のメトリクスのしきい値に基づいて課題やインシデントをトリガーします。

PostgreSQL センサーの組み込みイベントについて詳しくは、 組み込みイベントのリファレンスを参照してください。

監視対象の種類： postgresql_stats_not_enabled

PostgreSQL サーバーが検出されましたが、統計の収集が有効になっていません。 統計収集を有効にする必要があります。 詳しくは、「 統計収集の有効化 」セクションを参照してください。

監視対象の種類： postgresql_authentication_failed

PostgreSQL 認証が失敗しました。 モニター・ユーザーを作成してエージェントを構成するには、「 モニター・ユーザーの作成 」セクションを参照してください。

監視対象の種類： postgresql_connection_failed

エージェントが PostgreSQL サーバーへの接続に失敗します。 エージェントとセンサーの間の接続が確立されていることを確認する必要があります。