CLIを使用してPostgreSQL監視用のNRDOTをインストールおよび設定します。

New Relic CLIを使用して、PostgreSQL監視用のNRDOT Collectorをインストールおよび設定できます。CLIは1つのコマンドで、コレクターをインストールし、監視ロールとその権限を作成し、コレクターを設定します。

前提条件

有効なライセンスキーを持つNew Relicアカウント。
New Relic アカウントID。
PostgreSQL 14以降。
curlとsystemdがインストールされ、psqlクライアントが利用可能な、Debian/UbuntuまたはRHEL/CentOSを実行しているLinuxコレクターホスト。
pg_stat_statements shared_preload_libraries経由でロードする必要があります。インストーラはこれを確認し、そうでない場合は失敗します。以下のサーバーレベルの前提条件を参照してください。
セルフホスト型PostgreSQLの場合：PostgreSQLサーバーへの管理アクセス（postgresスーパーユーザーまたは同等のユーザー）。
AWS RDS/Aurora PostgreSQLの場合：コレクターホストからRDSエンドポイントへのネットワーク接続（RDSセキュリティグループのPostgreSQLポートでのインバウンドアクセス）、およびRDSマスターのユーザー名とパスワード。
ご利用のリージョンのNew Relic OTLPエンドポイントへのネットワーク接続。
詳細な要件については、互換性をご覧ください。

サーバーレベルの前提条件

pg_stat_statements shared_preload_librariesなしでは作成できず、そのパラメーターはデータベースの再起動を必要とするため、CLIでは設定できません。インストールを実行する前に、これらのパラメーターを設定してください：

パラメータ	価値
`shared_preload_libraries`	`pg_stat_statements`
`pg_stat_statements.track`	`ALL`
`pg_stat_statements.max`	`10000`
`pg_stat_statements.save`	`on`
`track_activity_query_size`	`4096`
`track_functions`	`all`

セルフホスト型：これらをpostgresql.confに設定し、PostgreSQLを再起動します。一部のディストリビューションでは、pg_stat_statementsを利用可能にするためにpostgresql-contribパッケージをインストールする必要があります。
AWS RDSまたはAurora：これらは設定ファイルではなく、DBのパラメーターグループで設定します。track_activity_query_size と pg_stat_statements.max は静的パラメーターです：apply_method: pending-reboot で適用してから、インスタンスを再起動してください。Aurora の場合、パラメーターグループのファミリー名はエンジンのメジャーバージョンと完全に一致する必要があります。たとえば aurora-postgresql16 です。

NRDOT Collectorのインストールと設定

このレシピは、単一のコレクターから1つ以上のPostgreSQLインスタンスをモニターします。単一のホスト/ポート/資格情報セットの入力を求める代わりに、事前に作成した2つのファイルを読み込みます：モニターするすべてのインスタンスとそれぞれでモニターするデータベースをリストしたインスタンスファイル（YAML）、および一致するようにインデックス付けされた、それぞれに対するスーパーユーザーのログインとパスワードを含むシークレットファイル（KEY=VALUE）です。

インスタンスファイルを作成します。このコレクターでモニターするPostgreSQLインスタンスごとに1つのエントリを追加します；単一のインスタンスのみを実行している場合でも、エントリは1つだけです。各インスタンスには少なくとも1つのデータベースが必要です：PostgreSQLにはすべてのデータベースをモニターするモードはありません：
bash
```
$cat > ~/postgresql-instances.yml << 'EOF'
$instances:
$  - host: localhost
$    port: 5432
$    login_name: newrelic
$    databases: [app1, app2]
$EOF
```

インスタンスファイルの順序と一致するようにインデックス付けされた、各インスタンスのスーパーユーザーロール（任意のスーパーユーザーロールで機能します；postgresである必要はありません）とパスワードを含むシークレットファイルを作成してください：

bash

$umask 077
$cat > ~/postgresql-secrets.env << 'EOF'
$NR_CLI_POSTGRES_SUPERUSER_USER_1=postgres
$NR_CLI_POSTGRES_SUPERUSER_PASSWORD_1=YourSuperuserPassword1
$EOF
$chmod 600 ~/postgresql-secrets.env

bash

$curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-postgresql

重要

このインストーラはパスワードを使用してTCP経由でPostgreSQLに接続するため、各インスタンスのスーパーユーザーにはパスワードが設定されている必要があり、pg_hba.confはTCP接続に対してパスワードベースのホスト認証（md5またはscram-sha-256）を許可する必要があります。新規インストールの場合、デフォルトではpostgresにパスワードが設定されていません。まずパスワードを設定してください：

bash

$sudo -u postgres psql -c "ALTER USER postgres WITH PASSWORD '<password>';"

RHEL/CentOSでは、デフォルトのpg_hba.confはパスワードベースのホスト認証をまったく許可しないことがよくあります。これを確認して更新し、インストールを実行する前にPostgreSQLをリロードしてください。

CLIは、以下の変数について対話的にプロンプトを表示します。非対話的に実行するために、事前に環境変数として設定することもできます。

変数	説明	デフォルト
`NR_CLI_POSTGRES_CONFIG_PRESET`	NRDOTの設定： `1` Basic、 `2` Advanced。	`1`
`NR_CLI_POSTGRES_INSTANCES_FILE`	必須。インスタンスYAMLファイルへのパス。	なし
`NR_CLI_POSTGRES_SECRETS_FILE`	必須。シークレットファイルへのパス（ `KEY=VALUE` 、インスタンスごとに1つのスーパーユーザーのログイン/パスワードのペア）。	なし
`NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER`	ロック/書き込みステートメントのクエリプランも収集します。各モニターデータベースに `SECURITY DEFINER` ヘルパー関数（ `otel.explain_statement` ）を作成し、DMLアクセスを付与せずに監視ユーザー `EXPLAIN` に実行権限を付与します。これはプレビュー機能です。 `y` / `N` 。	`n`

ヒント

このコレクターから複数のPostgreSQLインスタンスをモニターするには、instancesファイルにさらにエントリーを追加し、secretsファイルに対応する番号付きの認証情報（_2、_3、...）を追加してください。チェックに失敗した（またはリストされているデータベースがない）インスタンスは、インストール全体を中止するのではなく、理由をログに記録してスキップされます；インストールが完全に失敗するのは、チェックを通過したインスタンスが1つもない場合のみです。

このレシピは、セルフホスト型と同じインスタンスファイル/シークレットファイルのパターンを使用して、単一のコレクターから1つ以上のRDS PostgreSQLまたはAuroraエンドポイントをモニターします。

RDSまたはAuroraのエンドポイントをhostとして使用して、インスタンスファイルを作成します；単一のインスタンスのみを監視している場合でも、エントリは1つだけです。各インスタンスには少なくとも1つのデータベースが必要です：PostgreSQLにはすべてのデータベースをモニターするモードはありません：
bash
```
$cat > ~/postgresql-instances.yml << 'EOF'
$instances:
$  - host: mydb1.abcdefg12345.us-east-1.rds.amazonaws.com
$    port: 5432
$    login_name: newrelic
$    databases: [app1, app2]
$EOF
```

各インスタンスのRDSマスターユーザー名とパスワードを含むシークレットファイルを作成し、インスタンスファイルの順序と一致するようにインデックスを付けます：

bash

$umask 077
$cat > ~/postgresql-secrets.env << 'EOF'
$NR_CLI_POSTGRES_ADMIN_USER_1=postgres
$NR_CLI_POSTGRES_ADMIN_PASSWORD_1=YourMasterPassword1
$EOF
$chmod 600 ~/postgresql-secrets.env

bash

$curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-postgresql-rds

CLIは、以下の変数について対話的にプロンプトを表示します。非対話的に実行するために、事前に環境変数として設定することもできます。

変数	説明	デフォルト
`NR_CLI_POSTGRES_CONFIG_PRESET`	NRDOTの設定： `1` Basic、 `2` Advanced。	`1`
`NR_CLI_POSTGRES_INSTANCES_FILE`	必須。 RDSまたはAuroraのエンドポイントを `host` として使用する、インスタンスYAMLファイルへのパス。	なし
`NR_CLI_POSTGRES_SECRETS_FILE`	必須。シークレットファイルへのパス（ `KEY=VALUE` 、インスタンスごとに1つのRDSマスターユーザー名/パスワードのペア）。	なし
`NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER`	ロック/書き込みステートメントのクエリプランも収集します。各モニターデータベースに `SECURITY DEFINER` ヘルパー関数（ `otel.explain_statement` ）を作成し、DMLアクセスを付与せずに監視ユーザー `EXPLAIN` に実行権限を付与します。これはプレビュー機能です。 `y` / `N` 。	`n`

ヒント

このコレクターから複数のRDS PostgreSQLまたはAuroraエンドポイントをモニターするには、インスタンスファイルにエントリを追加し、シークレットファイルに一致する番号付きの認証情報を追加してください。チェックに失敗した（またはデータベースがリストされていない）インスタンスは、インストール全体を中止するのではなく、理由をログに記録してスキップされます。

データを探す、使う

データの収集が開始されると、New Relic UIから包括的なPostgreSQLデータベース監視にアクセスできます。

New RelicでPostgreSQLデータベースエンティティを見つけるには：

one.newrelic.com > All capabilities > Databasesに移動します。
Entity typeドロップダウンからPostgreSQL instanceを選択し、Applyをクリックします。
エンティティのリストからPostgreSQLデータベースを選択します。
データが到着していることを確認するには、クエリビルダーで次のクエリを実行します：
```
SELECT count(*) FROM Metric
WHERE metricName LIKE 'postgresql.%'
AND instrumentation.provider = 'opentelemetry'
SINCE 10 minutes ago
```

NRDOTを使用したPostgreSQL監視の概要

New Relicを使用したPostgreSQL監視で利用可能なすべてのインストレーション方法をご覧ください。

Ansibleのインストール

newrelic.newrelic_installを使用して、大規模なPostgreSQL監視をインストールおよび構成する方法について説明しますAnsibleロール。

Chefのインストール

newrelic-install Chefクックブックを使用して、PostgreSQLの監視を大規模にインストールおよび設定する方法について説明します。

Helmチャートのインストール

postgresql-otel Helmチャートを使用して、Kubernetes上でPostgreSQLの監視をインストールおよび設定する方法について説明します。

Dockerのインストール

Dockerですでに実行されているPostgreSQLインスタンスの兄弟コンテナとしてNRDOT Collectorを実行する方法をご覧ください。

この機械翻訳は、参考として提供されています。

CLIを使用してPostgreSQL監視用のNRDOTをインストールおよび設定します。

前提条件 .css-21sua1{background:none;border:none;width:0;padding:0;}

サーバーレベルの前提条件

NRDOT Collectorのインストールと設定

AWS RDS/Aurora PostgreSQL

データを探す、使う

関連ドキュメント

NRDOTを使用したPostgreSQL監視の概要

Ansibleのインストール

Chefのインストール

Helmチャートのインストール

Dockerのインストール

前提条件