セルフホスト型PDBを使用したOracle監視用のNRDOTのインストールと設定

New Relic Distribution of OpenTelemetry（NRDOT）コレクターを使用して、データベース監視、クエリ分析、およびシステムヘルスメトリクスにより、Oracleプラガブルデータベース（PDB）のパフォーマンスに関する包括的なインサイトを取得します。

ガイド付きインストレーション

代わりにNew Relic UIからインストールするには、one.newrelic.com > Integrations & Agents > Oracle (Database 360)に移動してください。このページでは、手動インストレーションについてのみ説明します。

ヒント

個別のプラガブルデータベースではなく、コンテナデータベース全体をモニターする必要がある場合は、CDB計装を参照してください。

前提条件

始める前に、次のものがあることを確認してください。

有効なNew Relicライセンスキー
サポートされているアーキテクチャー: AMD64 および ARM64 を搭載した Linux
New Relic OTLPエンドポイントへのネットワーク接続
Oracleデータベース 19c 以降

NRDOT Collectorをインストールする

Linux 環境に適したインストレーション配布方法を選択します。

Debian/Ubuntuシステムの場合は、以下を実行してください。
bash
```
$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_amd64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb
```

RHEL/CentOS/OELシステムの場合は、以下を実行してください。

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_x86_64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

Debian/Ubuntuシステムの場合は、以下を実行してください。

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb

RHEL/CentOS/OELシステムの場合は、以下を実行してください。

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

データベースユーザーを構成する

PDB Oracleデータベースインスタンスに必要な権限を持つ監視ユーザーを作成します。

ユーザーを作成したり権限を付与したりする前に、SYSとして以下のステートメントを実行します：
```
ALTER SESSION SET CONTAINER = "<YOUR_PDB>";
```
ターゲットPDB内でSYSとして次のステートメントを実行し、ローカル監視ユーザーを作成します：
```
CREATE USER <YOUR_DB_USERNAME> IDENTIFIED BY "<YOUR_DB_PASSWORD>";
GRANT CREATE SESSION TO <YOUR_DB_USERNAME>;
```

PDBの監視権限を付与してください。

PDB内でSYSユーザーとしてこれらのコマンドを実行します。これにより、監視ツールがメトリクスを収集し、イベントを追跡し、データベースインスタンスを見つけるために必要な基本的なアクセス権が付与されます。

GRANT SELECT ON V_$INSTANCE   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$DATABASE   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$CONTAINERS TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$DATAFILE   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SYSSTAT                    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SYSMETRIC                  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SESSION                    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$RESOURCE_LIMIT             TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$OSSTAT                     TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SGAINFO                    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$ROWCACHE                   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$PARAMETER                  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_TABLESPACE_USAGE_METRICS  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_TABLESPACES               TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_DATA_FILES                TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_FREE_SPACE                TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_RECYCLEBIN                TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SQL            TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SQL_PLAN_STATISTICS_ALL       TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$LOCK           TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SESSION_EVENT  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_PROCEDURES    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_OBJECTS       TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$PDBS      TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$PROCESS     TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$TRANSACTION TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$CON_SYSSTAT   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$CON_SYSMETRIC TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$ASM_DISKGROUP_STAT TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$ASM_DISK_STAT TO <YOUR_DB_USERNAME>;

ヒント

ASMディスクグループおよびディスクのメトリクスを収集する場合にのみ、V_$ASM_DISKGROUP_STATおよびV_$ASM_DISK_STATの権限が必要です。

NRDOT Collectorを構成する

PDB固有の設定でNRDOT Collectorを設定します。

設定ファイルを作成します。ファイル名はoracle-config.yamlである必要があります。
bash
```
$sudo nano /etc/nrdot-collector/oracle-config.yaml
```
前のステップで作成したoracle-config.yamlファイルに、以下の設定内容を追加してください：
完全な設定
この設定は、必須のベースラインメトリクスをキャプチャします。完全なメトリクスカタログを確認するには、設定リファレンスをご覧ください。
Oracle PDBホスト名/IP
Oracleデータベースのホスト名またはIPアドレスを入力してください
Oracle PDBポート
Oracle データベースのポート番号を入力してください。デフォルト値は1521です。
データベースユーザー名
認証用のデータベースユーザー名を入力してください
データベースパスワード
監視ユーザーに設定したパスワードを入力してください。
PDBサービス名
Oracle PDBサービス名を入力してください
New Relic OTLPエンドポイント
New Relic OTLPエンドポイントを入力します。詳細については、https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp/ を参照してください。
New Relicライセンスキー
New Relicライセンスキーを入力してください。
oracle-config.yaml
1 receivers: 2 nroracledb: 3 endpoint: oracle.example.com:1521 4 username: newrelic 5 password: YOUR_PASSWORD 6 service: YOUR_PDB_SERVICE_NAME 7 collection_interval: 15s 8 events: 9 db.server.query_sample: 10 enabled: true 11 db.server.top_query: 12 enabled: true 13 db.server.session.wait_sample: 14 enabled: true 15 db.server.top_procedure: 16 enabled: true 17 db.server.query_plan: 18 enabled: true 19 20 top_query_collection: 21 max_query_sample_count: 1000 22 top_query_count: 200 23 collection_interval: 60s 24 allowed_comment_keys: 25 - nr_service_guid 26 27 query_sample_collection: 28 max_rows_per_query: 100 29 allowed_comment_keys: 30 - nr_service_guid 31 32 session_wait_event_collection: 33 max_rows_per_query: 100 34 35 top_procedure_collection: 36 max_procedure_sample_count: 1000 37 top_procedure_count: 250 38 collection_interval: 60s 39 40 # Metrics configuration - This baseline configuration captures essential metrics. To enable advanced monitoring and extended telemetry, refer to the full configuration documentation 41 metrics: 42 oracledb.buffer_cache.utilization: 43 enabled: true 44 attributes: 45 - oracle.db.pdb 46 oracledb.consistent_gets: 47 enabled: true 48 attributes: 49 - oracle.db.pdb 50 oracledb.cpu_time: 51 enabled: true 52 attributes: 53 - oracle.db.pdb 54 oracledb.database.cpu.utilization: 55 enabled: true 56 attributes: 57 - oracle.db.pdb 58 oracledb.database.wait.utilization: 59 enabled: true 60 attributes: 61 - oracle.db.pdb 62 oracledb.db_block_gets: 63 enabled: true 64 attributes: 65 - oracle.db.pdb 66 oracledb.enqueue_deadlocks: 67 enabled: true 68 attributes: 69 - oracle.db.pdb 70 oracledb.execution.utilization: 71 enabled: true 72 attributes: 73 - oracledb.parse.type 74 - oracle.db.pdb 75 oracledb.executions: 76 enabled: true 77 attributes: 78 - oracle.db.pdb 79 oracledb.hard_parses: 80 enabled: true 81 attributes: 82 - oracle.db.pdb 83 oracledb.host.cpu.utilization: 84 enabled: true 85 attributes: 86 - oracle.db.pdb 87 oracledb.library_cache.utilization: 88 enabled: true 89 attributes: 90 - oracle.db.pdb 91 oracledb.logical_reads: 92 enabled: true 93 attributes: 94 - oracle.db.pdb 95 oracledb.logons: 96 enabled: true 97 attributes: 98 - oracle.db.pdb 99 oracledb.parse.rate: 100 enabled: true 101 attributes: 102 - oracledb.parse.result 103 - oracle.db.pdb 104 oracledb.parse_calls: 105 enabled: true 106 attributes: 107 - oracle.db.pdb 108 oracledb.pga_memory: 109 enabled: true 110 attributes: 111 - oracle.db.pdb 112 oracledb.physical_io.requests: 113 enabled: true 114 attributes: 115 - disk.io.direction 116 - disk.io.block_size 117 - oracle.db.pdb 118 oracledb.physical_reads: 119 enabled: true 120 attributes: 121 - oracle.db.pdb 122 oracledb.physical_writes: 123 enabled: true 124 attributes: 125 - oracle.db.pdb 126 oracledb.processes.usage: 127 enabled: true 128 oracledb.sessions.usage: 129 enabled: true 130 attributes: 131 - session_type 132 - session_status 133 - oracle.db.pdb 134 oracledb.sga.usage: 135 enabled: true 136 attributes: 137 - oracledb.sga.component.name 138 oracledb.shared_pool.utilization: 139 enabled: true 140 attributes: 141 - oracle.db.pdb 142 oracledb.sql_service.response.duration: 143 enabled: true 144 attributes: 145 - oracle.db.pdb 146 oracledb.sqlnet.io.transferred: 147 enabled: true 148 attributes: 149 - network.io.direction 150 - destination.type 151 - oracle.db.pdb 152 oracledb.tablespace_size.usage: 153 enabled: true 154 attributes: 155 - tablespace_name 156 - oracle.db.pdb 157 oracledb.transactions.usage: 158 enabled: true 159 oracledb.user_commits: 160 enabled: true 161 attributes: 162 - oracle.db.pdb 163 oracledb.user_rollbacks: 164 enabled: true 165 attributes: 166 - oracle.db.pdb 167 168 # Resource attributes attached to all metrics/logs (all enabled by default) 169 resource_attributes: 170 oracle.db.edition: 171 enabled: true 172 exporters: 173 otlp/newrelic: 174 endpoint: https://otlp.nr-data.net:4318 175 headers: 176 api-key: YOUR_LICENSE_KEY 177 compression: gzip 178 retry_on_failure: 179 enabled: true 180 initial_interval: 5s 181 max_interval: 30s 182 max_elapsed_time: 300s 183 sending_queue: 184 enabled: true 185 sizer: bytes 186 queue_size: 100_000_000 187 num_consumers: 10 188 batch: 189 sizer: bytes 190 max_size: 1_000_000 191 min_size: 0 192 flush_timeout: 5s 193 service: 194 pipelines: 195 metrics/oracledb: 196 receivers: [nroracledb] 197 exporters: [otlp/newrelic] 198 logs/oracledb: 199 receivers: [nroracledb] 200 exporters: [otlp/newrelic]

「イベント」セクションで、これらのイベントタイプを有効にしてメトリクスを収集します：

イベント	説明
`db.server.query_sample`	現在のSQL、待機状態、およびブロックの詳細をキャプチャするセッションごとのアクティブなクエリのサンプル。
`db.server.top_query`	実行統計とクエリプランを含む、CPUまたは経過時間ごとの上位N個のSQLステートメント。
`db.server.session.wait_sample`	`v$session_event` からのセッションごとの累積待機回数と期間。
`db.server.top_procedure`	実行統計を含む、リソース使用量でランク付けされた上位N個のストアドプロシージャです。
`db.server.query_plan`	上位クエリおよびサンプリングされたクエリの実行計画の詳細。

各イベントタイプの収集設定を構成します：

設定セクション	パラメータ	価値
`top_query_collection`	`max_query_sample_count`	1000
`top_query_collection`	`top_query_count`	200
`top_query_collection`	`collection_interval`	60秒
`query_sample_collection`	`max_rows_per_query`	100
`session_wait_event_collection`	`max_rows_per_query`	100
`top_procedure_collection`	`max_procedure_sample_count`	1000
`top_procedure_collection`	`top_procedure_count`	250
`top_procedure_collection`	`collection_interval`	60秒

ヒント

New Relic OTLPエンドポイント設定およびOpenTelemetryのベストプラクティスの詳細については、OpenTelemetry OTLPドキュメントを参照してください。

NRDOT Collectorの設定を更新

oracle-config.yamlファイルを使用するようにNRDOT Collectorの設定を更新してください：

bash

$sudo sed -i 's|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/config.yaml"|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/oracle-config.yaml"|' /etc/nrdot-collector/nrdot-collector.conf

ヒント

もできます。

複数のレシーバーを構成する：1つのコレクターから複数のOracle データベースインスタンスをモニターします。
SQLクエリレシーバーの構成：Oracleデータベースからカスタムメトリックを収集します。
OracleデータベースをAPMとリンクする：アプリケーションパフォーマンスをデータベース操作と関連付けます。これにより、どのアプリケーションが特定のデータベースワークロードを生成しているかを正確に確認できます。
シークレット管理のセットアップ：データベースの認証情報などの機密情報を安全に管理します。これにより、設定ファイルへの機密データのハードコーディングを回避し、監視セットアップのセキュリティを強化できます。

NRDOT Collectorを再起動します

設定を更新した後、NRDOT Collectorを再起動します：

bash

$sudo systemctl restart nrdot-collector.service
$sudo systemctl status nrdot-collector.service

ヒント

新しい設定を確実に適用するために、設定を変更した後は常にNRDOT Collectorを再起動してください。

データを探す、使う

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

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

https://one.newrelic.com > All Capabilities > Databasesに移動します。
検索条件をinstrumentation.provider = opentelemetryに設定します。
エンティティのリストからOracleデータベースを選択します。

トラブルシューティング

New RelicでOracle PDB監視設定をトラブルシューティングする方法を学びます。

メトリクスリファレンス

NRDOT Collectorによって収集される利用可能なメトリクスについて説明します。

RDS計装

New RelicでRDS監視用にOracleデータベースを設定する方法を学びます。

Dockerのインストール

Dockerですでに実行されているOracleデータベースインスタンスのシブリングコンテナとして、NRDOT Collectorを実行する方法について説明します。

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

セルフホスト型PDBを使用したOracle監視用のNRDOTのインストールと設定

ガイド付きインストレーション

ヒント

前提条件

NRDOT Collectorをインストールする

AMD64向けアーキテクチャー

ARM64用アーキテクチャー

データベースユーザーを構成する

PDBの監視権限を付与してください。

ヒント

NRDOT Collectorを構成する

完全な設定

ヒント

NRDOT Collectorの設定を更新

ヒント

NRDOT Collectorを再起動します

ヒント

データを探す、使う

トラブルシューティング

メトリクスリファレンス

RDS計装

Dockerのインストール

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

セルフホスト型PDBを使用したOracle監視用のNRDOTのインストールと設定

ガイド付きインストレーション

ヒント

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

NRDOT Collectorをインストールする

ARM64用アーキテクチャー

データベースユーザーを構成する

PDBの監視権限を付与してください。

ヒント

NRDOT Collectorを構成する

完全な設定

ヒント

NRDOT Collectorの設定を更新

ヒント

NRDOT Collectorを再起動します

ヒント

データを探す、使う

関連記事

トラブルシューティング

メトリクスリファレンス

RDS計装

Dockerのインストール

前提条件