PostgreSQL のモニター

サポート対象のオペレーティング・システム

PostgreSQLのサポート対象オペレーティングシステムは、ホストエージェントの要件と一致しており、これは各ホストエージェントの「サポート対象オペレーティングシステム」セクション（例えば 「Unixのサポート対象オペレーティングシステム」） で確認できます。

対応バージョンとサポートポリシー

このセンサーは以下のバージョンの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の設定時に作成される'postgresql.confファイルに設定される設定パラメータによって制御される。 統計情報の収集を監視するには、次のパラメータを on に設定します（ yes 、 true 、 1 でも受け付けます）。

以下の表は、構成パラメータの一覧です

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

モニター・ユーザーの作成

メトリックの収集を監視するための最小限のパーミッションは、「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.

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

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

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

構成データ

実行中のPostgresインスタンスから収集される以下の設定データを参照してください：

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

パフォーマンス・メトリック

以下は、各Postgresインスタンスで収集されるパフォーマンス・メトリクスです：

正常性シグニチャー

各センサーは、入力されるメトリクスに対して継続的に評価され、ユーザーの影響に依存する問題やインシデントを提起するために使用される健康シグネチャのキュレートされた知識ベースを持っています。

組み込みイベントは、エンティティの健全性シグネチャの失敗に基づいて問題やインシデントをトリガし、カスタムイベントは、特定のエンティティの個々のメトリックのしきい値に基づいて問題やインシデントをトリガする。

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

PostgreSQL 統計が有効になっていない

モニター問題タイプ: postgresql_stats_not_enabled

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

PostgreSQL 認証が失敗する

モニター問題タイプ: postgresql_authentication_failed

PostgreSQL 認証が失敗しました。 監視ユーザーを作成し、エージェントを設定するには、監視ユーザーの作成セクションを参照してください。

PostgreSQL 接続が失敗する

モニター問題タイプ: postgresql_connection_failed

エージェントがPostgreSQLサーバに接続できません。 エージェントとセンサー間の接続が確立されていることを確認する必要がある。