ADB監視のためのNRDOT Collectorのインストールと設定

プレビュー

この機能はまだ開発中ですが、ぜひお試しください。

この機能は現在、弊社のプレリリースポリシーに従ってプレビューの一部として提供されています。

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

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

代わりにNew Relic UIからインストールするには、one.newrelic.com > Integrations & Agents > Oracle (OpenTelemetry) にアクセスしてください。このページでは、CLIでのインストール手順のみを説明します。

前提条件

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

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

プレビューに登録

このインテグレーションは、New Relicパブリックプレビュープログラムの一部として利用可能です。Previews & Trialsページからオプトインするには、組織の管理者に連絡してください。

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_aarch64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

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

ADB Oracleデータベースインスタンスに必要な権限を持つ監視ユーザーを作成します。ターゲットADB内でSYSとして以下のステートメントを実行し、ローカル監視ユーザーを作成します：

CREATE USER <USER_NAME> IDENTIFIED BY "<YOUR_PASSWORD>";
GRANT CREATE SESSION TO <USER_NAME>;

Autonomous Databaseの監視権限の付与

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

GRANT SELECT ON SYS.V_$INSTANCE   TO <USER_NAME>;
GRANT SELECT ON SYS.V_$DATABASE   TO <USER_NAME>;
GRANT SELECT ON SYS.V_$CONTAINERS TO <USER_NAME>;
GRANT SELECT ON SYS.V_$DATAFILE   TO <USER_NAME>;
GRANT SELECT ON SYS.V_$PDBS       TO <USER_NAME>; 
GRANT SELECT ON SYS.V_$SYSSTAT                    TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SYSMETRIC                  TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SESSION                    TO <USER_NAME>;
GRANT SELECT ON SYS.V_$RESOURCE_LIMIT             TO <USER_NAME>;
GRANT SELECT ON SYS.V_$OSSTAT                     TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SGAINFO                    TO <USER_NAME>;
GRANT SELECT ON SYS.V_$ROWCACHE                   TO <USER_NAME>;
GRANT SELECT ON SYS.V_$PARAMETER                  TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_TABLESPACE_USAGE_METRICS  TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_TABLESPACES               TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_DATA_FILES                TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_FREE_SPACE                TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_RECYCLEBIN                TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SQL            TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SQL_PLAN_STATISTICS_ALL       TO <USER_NAME>;
GRANT SELECT ON SYS.V_$LOCK           TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SESSION_EVENT  TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_PROCEDURES    TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_OBJECTS       TO <USER_NAME>;

NRDOT Collectorを構成する

ADB固有の設定でNRDOT Collectorを設定します。以下の内容で設定ファイル（例：adb-config.yaml）を作成します：

データベースユーザー名

データベースパスワード

Oracle ADBホスト名

Oracle ADBポート

サービス名

New Relic OTLPエンドポイント

New Relicライセンスキー

adb-config.yaml

1
receivers:
2
  nroracledb/adb:
3
  datasource: "oracle://newrelic:YOUR_PASSWORD@adb.example.oraclecloud.com:1522/YOUR_SERVICE_NAME?ssl=true&ssl%20verify=true"
4
  collection_interval: 10s
5
events:
6
   db.server.query_sample:
7
     enabled: true
8
   db.server.top_query:
9
     enabled: true
10
   db.server.session.wait_sample:
11
     enabled: true
12

13
top_query_collection:
14
   max_query_sample_count: 1000
15
   top_query_count: 200
16
   collection_interval: 60s
17
   allowed_comment_keys:
18
     - nr_service_guid
19

20
query_sample_collection:
21
   max_rows_per_query: 100
22
   allowed_comment_keys:
23
     - nr_service_guid
24

25
session_wait_event_collection:
26
   max_rows_per_query: 100
27

28
metrics:
29
   oracledb.cpu_time:
30
     enabled: true
31
   oracledb.executions:
32
     enabled: true
33
   oracledb.parse_calls:
34
     enabled: true
35
   oracledb.hard_parses:
36
     enabled: true
37
   oracledb.logical_reads:
38
     enabled: true
39
   oracledb.physical_reads:
40
     enabled: true
41
   oracledb.physical_reads_direct:
42
     enabled: true
43
   oracledb.physical_writes:
44
     enabled: true
45
   oracledb.physical_writes_direct:
46
     enabled: true
47
   oracledb.physical_read_io_requests:
48
     enabled: true
49
   oracledb.physical_write_io_requests:
50
     enabled: true
51
   oracledb.physical_io.cache_writes:
52
     enabled: true
53
   oracledb.physical_io.requests:
54
     enabled: true
55
     attributes:
56
       - disk.io.direction
57
       - disk.io.block_size
58
   oracledb.physical_io.transferred:
59
     enabled: true
60
     attributes:
61
       - disk.io.direction
62
       - disk.io.type
63
   oracledb.sqlnet.io.transferred:
64
     enabled: true
65
     attributes:
66
       - network.io.direction
67
       - destination.type
68
   oracledb.consistent_gets:
69
     enabled: true
70
   oracledb.db_block_gets:
71
     enabled: true
72
   oracledb.data_dictionary.hit_ratio:
73
     enabled: true
74
   oracledb.pga_memory:
75
     enabled: true
76
   oracledb.enqueue_deadlocks:
77
     enabled: true
78
   oracledb.exchange_deadlocks:
79
     enabled: true
80
   oracledb.sessions.usage:
81
     enabled: true
82
     attributes:
83
       - session_type
84
       - session_status
85
   oracledb.logons:
86
     enabled: true
87
   oracledb.user_commits:
88
     enabled: true
89
   oracledb.user_rollbacks:
90
     enabled: true
91
   oracledb.tablespace_size.limit:
92
     enabled: true
93
     attributes:
94
       - tablespace_name
95
   oracledb.tablespace_size.usage:
96
     enabled: true
97
     attributes:
98
       - tablespace_name
99
   oracledb.storage.usage:
100
     enabled: true
101
   oracledb.storage.utilization:
102
     enabled: true
103
   oracledb.recycle_bin.limit:
104
     enabled: true
105
   oracledb.queries_parallelized:
106
     enabled: true
107
   oracledb.ddl_statements_parallelized:
108
     enabled: true
109
   oracledb.dml_statements_parallelized:
110
     enabled: true
111
   oracledb.parallel_operations_not_downgraded:
112
     enabled: true
113
   oracledb.parallel_operations_downgraded_1_to_25_pct:
114
     enabled: true
115
   oracledb.parallel_operations_downgraded_25_to_50_pct:
116
     enabled: true
117
   oracledb.parallel_operations_downgraded_50_to_75_pct:
118
     enabled: true
119
   oracledb.parallel_operations_downgraded_75_to_99_pct:
120
     enabled: true
121
   oracledb.parallel_operations_downgraded_to_serial:
122
     enabled: true
123

124
processors:
125
batch:
126
  resource/add_event_name:
127
attributes:
128
   - key: host.address
129
     value: YOUR_DB_HOST
130
     action: upsert
131

132
exporters:
133
  otlphttp/newrelic:
134
  endpoint: https://otlp.nr-data.net:4318
135
headers:
136
   api-key: YOUR_LICENSE_KEY
137
  compression: gzip
138
retry_on_failure:
139
   enabled: true
140
   initial_interval: 5s
141
   max_interval: 30s
142
   max_elapsed_time: 300s
143

144
service:
145
telemetry:
146
metrics:
147
   level: none
148
pipelines:
149
  metrics/oracledb:
150
   receivers: [nroracledb/adb]
151
   processors: [resource/add_event_name, batch]
152
   exporters: [otlphttp/newrelic]
153
  logs/oracledb:
154
   receivers: [nroracledb/adb]
155
   processors: [resource/add_event_name, batch]
156
   exporters: [otlphttp/newrelic]

次のメトリクスは、ADBではサポートされていません：

oracledb.database.cpu.utilization
oracledb.database.wait.utilization
oracledb.host.cpu.utilization
oracledb.execution.utilization
oracledb.parse.rate
oracledb.parse.utilization
oracledb.sort.ratio
oracledb.sql_service.response.duration
oracledb.buffer_cache.utilization
oracledb.library_cache.utilization
oracledb.shared_pool.utilization
oracledb.redo_allocation.utilization
oracledb.processes.limit
oracledb.processes.usage
oracledb.sessions.limit
oracledb.transactions.limit
oracledb.transactions.usage
oracledb.dml_locks.limit
oracledb.dml_locks.usage
oracledb.enqueue_locks.limit
oracledb.enqueue_locks.usage
oracledb.enqueue_resources.limit
oracledb.enqueue_resources.usage

ヒント

もできます。

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

NRDOT Collectorを再起動します

コレクターを設定した後、NRDOT Collectorサービスを再起動して変更を適用します：

bash

$sudo systemctl restart nrdot-collector

コレクターが正常に実行されていることを確認するには、サービスステータスを確認します：

bash

$sudo systemctl status nrdot-collector

ヒント

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

データを探す、使う

Oracle ADBインテグレーションを設定した後、New Relicでデータベースのパフォーマンスの監視と分析を開始できます：

one.newrelic.com > All Entitiesに移動します。
Oracleでフィルタリングして、データベースエンティティを見つけます。
Oracle ADBエンティティを選択して、ダッシュボード、メトリクス、およびログを表示します。
Oracleデータベースの監視について詳しくは、データベース監視のドキュメントを参照してください。

トラブルシューティング

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

メトリクスリファレンス

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

RDS計装

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

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

ADB監視のためのNRDOT Collectorのインストールと設定

プレビュー

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

前提条件

プレビューに登録

NRDOT Collectorをインストールする

AMD64向けアーキテクチャー

ARM64用アーキテクチャー

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

Autonomous Databaseの監視権限の付与

NRDOT Collectorを構成する

サポートされていないADBメトリクス

ヒント

NRDOT Collectorを再起動します

ヒント

データを探す、使う

トラブルシューティング

メトリクスリファレンス

RDS計装

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

ADB監視のためのNRDOT Collectorのインストールと設定

プレビュー

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

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

プレビューに登録

NRDOT Collectorをインストールする

ARM64用アーキテクチャー

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

Autonomous Databaseの監視権限の付与

NRDOT Collectorを構成する

サポートされていないADBメトリクス

ヒント

NRDOT Collectorを再起動します

ヒント

データを探す、使う

関連記事

トラブルシューティング

メトリクスリファレンス

RDS計装

前提条件