Dockerで既に実行されているOracleデータベースのインスタンスの兄弟コンテナとして実行されるNew Relic Distribution of OpenTelemetry(NRDOT)Collectorを使用し、データベース監視、クエリ分析、およびシステムヘルスメトリクスを通じて、Oracleデータベースのパフォーマンスに関する包括的なインサイトを取得します。
ガイド付きインストレーション
代わりにNew Relic UIからインストールするには、one.newrelic.com > Integrations & Agents > Oracle (Database 360)にアクセスしてください。このページでは、Dockerのインストールパスについてのみ説明します。
ヒント
代わりにこれを大規模に自動化することをお考えですか?Kubernetesの場合は、Ansibleのインストール、Chefのインストール、またはHelmチャートのインストールを参照してください。
前提条件
始める前に、次のものがあることを確認してください。
- ホストにインストールされているDocker。
- 内部で
sqlplusが利用可能な、すでに実行中のOracleデータベースコンテナ(Oracleデータベース19c以降) - そのコンテナの
sysパスワード。 - 有効なNew Relicのライセンスキー。
- コレクターコンテナからNew Relic OTLPエンドポイントへのネットワーク接続。
データベースユーザーを設定し、権限を付与します。
docker exec を使用して Oracle コンテナに対して SQL を実行し、監視ユーザーを作成して、メトリクス、クエリ、およびイベント収集に必要なビューを付与します。マルチテナントのコンテナデータベース(CDB)または単一のプラガブルデータベース(PDB)のいずれかから、デプロイメントに一致するタブを選択します:
Dockerネットワークの接続を確認してください。
共有のユーザー定義ネットワークを作成し(まだない場合)、Oracle コンテナをそれに接続して、コレクターコンテナが名前で解決できるようにします:
$docker network create <YOUR_DOCKER_NETWORK> 2>/dev/null || true$docker network connect <YOUR_DOCKER_NETWORK> <YOUR_ORACLE_CONTAINER_NAME> 2>/dev/null || trueヒント
どちらのコマンドも安全に再実行できます:|| true は、前回の実行による "already exists" または "already connected" エラーを無視します。
NRDOT Collector の設定を作成します
データベースユーザーの設定と権限の付与で作成したユーザーに一致するタブを選択してください:
設定パラメーター
| パラメータ | 説明 |
|---|---|
<YOUR_ORACLE_CONTAINER_NAME> | 実行中のOracleデータベース・コンテナの名前(またはDockerでDNS解決可能なホスト名)です。 |
<YOUR_DB_USERNAME> | データベースユーザーの構成と権限の付与で作成した監視ユーザー(CDBの場合はC##プレフィックスが自動的に追加されます)。 |
<YOUR_DB_PASSWORD> | 「データベースユーザーの構成と権限の付与」で作成した監視ユーザーのパスワード。 |
<YOUR_CDB_SERVICE_NAME> / <YOUR_PDB_SERVICE_NAME> | CDBまたはPDBのOracleサービス名です。 |
<YOUR_NEWRELIC_OTLP_ENDPOINT> | New Relic OTLPエンドポイント。詳細については、New Relic OTLPエンドポイントを参照してください。 |
<YOUR_NEWRELIC_LICENSE_KEY> | あなたのNew Relic ライセンスキー 。 |
NRDOT Collectorコンテナを起動してください。
Oracleコンテナと同じDockerネットワーク上でコレクターを実行します:
$docker run -d \> --name nrdot-collector \> --network <YOUR_DOCKER_NETWORK> \> --platform linux/amd64 \> -v "$PWD/oracle-config.yaml:/etc/nrdot-collector/oracle-config.yaml" \> newrelic/nrdot-collector:latest \> --config /etc/nrdot-collector/oracle-config.yamlヒント
--platform linux/amd64 Oracleイメージ自体が通常AMD64向けにのみ提供されているApple Siliconやその他のARM64ホストでのアーキテクチャーの不一致を回避します。ホストとイメージがすでにAMD64ネイティブである場合は、これを削除してください。
コレクターコンテナが実行されていることを確認します:
$docker ps --filter name=nrdot-collector実行されていない場合は、ログでエラーを確認してください。最も一般的な原因は、oracle-config.yamlのYAMLインデントの問題、または到達不可能なOracleコンテナです:
$docker logs nrdot-collectorヒント
oracle-config.yamlを変更した後、コンテナを再起動して変更を適用してください:
$docker restart nrdot-collectorデータを探す、使う
データの収集が開始されると、New Relic UIから包括的なOracleデータベース監視にアクセスできます。
New RelicでOracleデータベースエンティティを見つけるには:
- https://one.newrelic.com > All Capabilities > Databasesに移動します。
- 検索条件を
instrumentation.provider = opentelemetryに設定します。 - エンティティのリストからOracleデータベースを選択します。
関連記事
オンホストCDB監視
オンホストのOracleコンテナデータベース監視用にNRDOT Collectorをインストールして設定する方法について説明します。
オンホストPDB監視
オンホストのOracleプラガブルデータベース監視用にNRDOT Collectorをインストールして構成する方法について説明します。
Ansibleのインストール
newrelic.newrelic_installを使用して、Oracleデータベース監視を大規模にインストールおよび設定する方法をご覧ください。Ansibleロール。
Chefのインストール
newrelic-install Chefクックブックを使用して、Oracleデータベースの監視を大規模にインストールおよび設定する方法を学びます。
Helmチャートのインストール
Helmチャートを使用して、Kubernetes上でOracleデータベース監視をインストールおよび設定する方法について説明します。
トラブルシューティング
New RelicでのOracleデータベース監視設定をトラブルシューティングする方法を学びます。
メトリクスリファレンス
NRDOT Collectorによって収集される利用可能なメトリクスについて説明します。