AWS RDSでのOracle監視のためのNRDOTのインストールと設定

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

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

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

前提条件

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

有効な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

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

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

ルートデータベースにアドミニストレーターとしてログインします。
```
CREATE USER <YOUR_DB_USERNAME> IDENTIFIED BY "<YOUR_DB_PASSWORD>";
```
新しく作成したユーザーにCONNECT権限を付与します。
```
GRANT CONNECT TO <YOUR_DB_USERNAME>;
```

RDS データベースに対する監視権限を付与する

監視権限を付与するには、以下のSQL文を実行してください。<YOUR_DB_USERNAME_UPPERCASE>あなたのユーザー名（大文字）に置き換えてください。

EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SYSMETRIC',      '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$CON_SYSMETRIC',  '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$CONTAINERS',     '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SESSION',        '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SESSION_EVENT',  '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SYSSTAT',        '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$CON_SYSSTAT',    '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$OSSTAT',         '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SGAINFO',        '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SQL',            '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SQL_PLAN_STATISTICS_ALL',       '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$PROCESS',        '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$TRANSACTION',    '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$PARAMETER',      '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$ROWCACHE',       '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$RESOURCE_LIMIT', '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$LOCK',           '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$DATABASE',       '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$INSTANCE',       '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$DATAFILE',       '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$PDBS',           '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_DATA_FILES',               '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_FREE_SPACE',               '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_RECYCLEBIN',               '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_TABLESPACES',              '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_TABLESPACE_USAGE_METRICS', '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_PROCEDURES',               '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS',                  '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('CDB_TABLESPACE_USAGE_METRICS', '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('CDB_TABLESPACES',              '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('CDB_SERVICES',                 '<YOUR_DB_USERNAME_UPPERCASE>', 'SELECT', false);
GRANT CREATE SESSION TO <YOUR_DB_USERNAME_UPPERCASE>;

NRDOT Collectorを構成する

RDS固有の設定でNRDOT Collectorを設定してください。

設定ファイルを作成します。ファイル名はoracle-config.yamlである必要があります。
bash
```
$sudo nano /etc/nrdot-collector/oracle-config.yaml
```
以下の設定内容を、前の手順で作成したoracle-config.yamlファイルに追加します。
完全な設定
この設定は、必須のベースラインメトリクスをキャプチャします。完全なメトリクスカタログを確認するには、設定リファレンスを参照してください。
Oracle RDSエンドポイント
Oracle RDS エンドポイントを入力してください。
Oracle RDSポート
Oracle データベースのポート番号を入力してください。デフォルト値は1521です。
データベースユーザー名
認証用のデータベースユーザー名を入力してください
データベースパスワード
監視ユーザーに設定したパスワードを入力してください。
サービス名
Oracle サービス名を入力してください。
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/rds: 3 endpoint: mydb-instance.xxxxxxxxxxxx.us-east-1.rds.amazonaws.com:1521 4 username: newrelic 5 password: YOUR_PASSWORD 6 service: YOUR_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/rds] 197 exporters: [otlp/newrelic] 198 logs/oracledb: 199 receivers: [nroracledb/rds] 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秒

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 RDS監視設定をトラブルシューティングする方法を学びます。

メトリクスリファレンス

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

CDB計装

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

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

AWS RDSでのOracle監視のためのNRDOTのインストールと設定

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

前提条件

NRDOT Collectorをインストールする

AMD64向けアーキテクチャー

ARM64用アーキテクチャー

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

RDS データベースに対する監視権限を付与する

NRDOT Collectorを構成する

完全な設定

NRDOT Collectorの設定を更新

ヒント

NRDOT Collectorを再起動します

ヒント

データを探す、使う

トラブルシューティング

メトリクスリファレンス

CDB計装

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

AWS RDSでのOracle監視のためのNRDOTのインストールと設定

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

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

NRDOT Collectorをインストールする

ARM64用アーキテクチャー

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

RDS データベースに対する監視権限を付与する

NRDOT Collectorを構成する

完全な設定

NRDOT Collectorの設定を更新

ヒント

NRDOT Collectorを再起動します

ヒント

データを探す、使う

関連記事

トラブルシューティング

メトリクスリファレンス

CDB計装

前提条件