Oracle Exadata のデータベースモニタリングの設定

データベースモニタリングは、クエリサンプルを公開することで、Oracle データベースを深く可視化し、さまざまなワークロードをプロファイリングして問題を診断します。

読み取り専用ユーザーとしてログインし、Agent でデータベースから直接テレメトリーを収集します。

はじめに

サポート対象の Oracle バージョン
11g、12c、18c、19c、21c
サポート対象の Agent バージョン
7.53.0+
パフォーマンスへの影響
データベースモニタリングのデフォルトの Agent コンフィギュレーションは保守的ですが、収集間隔やクエリのサンプリングレートなどの設定を調整することで、よりニーズに合ったものにすることができます。ワークロードの大半において、Agent はデータベース上のクエリ実行時間の 1 % 未満、および CPU の 1 % 未満を占めています。

データベースモニタリングは、ベースとなる Agent 上のインテグレーションとして動作します (ベンチマークを参照してください)。
プロキシ、ロードバランサー、コネクションプーラー
Agent は、監視対象のホストに直接接続する必要があります。Agent をプロキシ、ロードバランサー、コネクションプーラーを経由してデータベースに接続しないようご注意ください。また、各 Agent は基礎となるホスト名を把握し、フェイルオーバーの場合でも常に 1 つのホストのみを使用する必要があります。Datadog Agent が実行中に異なるホストに接続すると、メトリクス値の正確性が失われます。
Data security considerations
See Sensitive information for information about what data the Agent collects from your databases and how to ensure it is secure.

セットアップ

Oracle データベースでデータベースモニタリングを有効にするには、以下を実行します。

  1. Datadog ユーザーの作成
  2. Agent をインストールする
  3. Agent の構成
  4. Oracle インテグレーションをインストールまたは検証する
  5. セットアップの検証

Datadog ユーザーの作成

すでにレガシー Oracle インテグレーションがインストールされている場合、ユーザーはすでに存在するので、この手順は省略できます。

サーバーに接続するための読み取り専用ログインを作成し、必要な権限を付与します。

CREATE USER datadog IDENTIFIED BY <YOUR_PASSWORD>;

Securely store your password

Store your password using secret management software such as Vault. You can then reference this password as ENC[<SECRET_NAME>] in your Agent configuration files: for example, ENC[datadog_user_database_password]. See Secrets Management for more information.

The examples on this page use datadog_user_database_password to refer to the name of the secret where your password is stored. It is possible to reference your password in plain text, but this is not recommended.

Agent のインストール

See the DBM Setup Architecture documentation to determine where to install the Agent. The Agent doesn’t require any external Oracle clients.

For installation steps, see the Agent installation instructions.

Agent の構成

マルチノード Exadata

Configure the Agent for each node by following the instructions for Oracle RAC.

シングルノード Exadata

Configure the Agent by following the instructions for self-hosted Oracle databases.

Oracle インテグレーションをインストールまたは検証する

初めてインストールする場合

On the Integrations page in Datadog, install the Oracle integration for your organization. This installs an Oracle dashboard in your account that can be used to monitor the performance of your Oracle databases.

すでにインストール済みの場合

既存のインストールの場合、構成が conf.d/oracle-dbm.d/ ディレクトリにあることを確認します。レガシー構成を conf.d/oracle.d/ ディレクトリから移行する必要があるかもしれません。

次のコマンドを使用して、Oracle インテグレーションをレガシーインテグレーションから新しいインテグレーションに移行します。

cp /etc/datadog-agent/conf.d/oracle.d/conf.yaml /etc/datadog-agent/conf.d/oracle-dbm.d/conf.yaml

レガシーインテグレーションを非アクティブにします。

mv /etc/datadog-agent/conf.d/oracle.d/conf.yaml /etc/datadog-agent/conf.d/oracle.d/conf.yaml.bak

レガシーインテグレーションを非アクティブにすると、システムメトリクスが 2 回送信されなくなります。

Datadog Agent は外部の Oracle クライアントを必要としないので、新しいパラメーターファイル /etc/datadog-agent/conf.d/oracle-dbm.d/conf.yaml から jdbc_driver_path 構成パラメーターを削除します。

セットアップの検証

Run the Agent’s status subcommand and look for oracle under the Checks section. Navigate to the Dashboard and the Databases page in Datadog to get started.

カスタムクエリ

Database Monitoring supports custom queries for Oracle databases. See the conf.yaml.example to learn more about the configuration options available.

カスタムクエリを実行すると、Oracle によって追加コストまたは手数料が課される場合があります。

参考資料

お役に立つドキュメント、リンクや記事: