Ansibleを使用したOracle監視用のNRDOTのインストールと構成

newrelic.newrelic_install Ansibleロールを使用して、Oracleデータベース監視用のNRDOT Collectorをインストールして構成できます。このロールは、単一のプレイでコレクターをインストールし、監視データベースユーザーを作成し、コレクターを構成します。

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

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

前提条件

有効なライセンスキーを持つNew Relicアカウント。
New Relic アカウントID。
Oracleデータベース19c以降。
Ansible Core 2.13または2.14、Python 3.10、およびansible.windowsとansible.utilsのコレクション。
セルフホスト型Oracleの場合：SSHユーザーがパスワードプロンプトなしでsudo su - oracleを実行できるOracleデータベースホストへのSSHアクセス（エージェント転送付き）を備えたOracle Linux 7、8、または9。
AWS RDS上のOracleの場合：Debian/UbuntuまたはCentOS/RHEL/OELを実行しているコレクター・ホスト。
Oracle Autonomousデータベース（ADB）の場合：Debian/UbuntuまたはCentOS/RHEL/OELを実行し、Oracle Instant Client（sqlplus）がインストールされてPATH上にあるコレクター・ホスト；各インスタンスのエグレスIPがADBアクセス制御リストで許可されていること；および各インスタンスのOracle Walletがダウンロードされ、ターゲット・ホスト上の独自のディレクトリに解凍されていること。

役割をインストールします

bash

$ansible-galaxy install newrelic.newrelic_install

プレイブックを設定してください

このロールは、単一のコレクターから1つ以上のOracleデータベースインスタンス（それぞれSSH経由で到達可能）をモニターします。単一のホスト/コンテナ/資格情報セットの代わりに、ターゲットホストにすでに存在している必要があるインスタンスファイル（YAML）（モニターするすべてのインスタンスをリストしたもの）と、オプションで監視ユーザーのパスワードを自動生成する代わりに固定するためのシークレットファイルを読み取ります。正確なファイル形式については、CLIインストールを参照してください。

playbook.ymlという名前のファイルを作成し、以下の内容をコピーします。targetsをoracle-otelに設定し、プレースホルダーの値を独自の値に置き換えます：

- name: Install New Relic NRDOT for Oracle Database
  hosts: all
  roles:
    - role: newrelic.newrelic_install
  vars:
    targets:
      - oracle-otel
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NR_CLI_ORACLE_INSTANCES_FILE: <path to the instances YAML file on the target host>
    NR_CLI_ORACLE_SECRETS_FILE: <optional path to a secrets file pinning monitoring passwords, on the target host>
    NR_CLI_ORACLE_CONFIG_PRESET: <1 Basic, 2 Advanced, default 1>

ヒント

デバッグロギングを有効にするには、プレイブックのvarsの下にverbosity: "debug"を追加します。

変数	説明	デフォルト
`NR_CLI_ORACLE_INSTANCES_FILE`	必須。ターゲットホストにすでに存在する、インスタンスYAMLファイルへのパス。	なし
`NR_CLI_ORACLE_SECRETS_FILE`	オプション。ターゲットホスト上にすでに存在する、インスタンスごとに`NR_CLI_ORACLE_LOGIN_PASSWORD_<i>`を固定するシークレットファイル（`KEY=VALUE`）へのパス。すべてのインスタンスに対してランダムなパスワードを自動生成するには、未設定のままにしてください。	なし
`NR_CLI_ORACLE_CONFIG_PRESET`	NRDOTの設定： `1` Basic用 `2` Advanced用	`1`

変数

説明

デフォルト

NR_CLI_ORACLE_INSTANCES_FILE

必須。ターゲットホストにすでに存在する、インスタンスYAMLファイルへのパス。

なし

NR_CLI_ORACLE_SECRETS_FILE

オプション。ターゲットホスト上にすでに存在する、インスタンスごとにNR_CLI_ORACLE_LOGIN_PASSWORD_<i>を固定するシークレットファイル（KEY=VALUE）へのパス。すべてのインスタンスに対してランダムなパスワードを自動生成するには、未設定のままにしてください。

なし

NR_CLI_ORACLE_CONFIG_PRESET

NRDOTの設定：

1 Basic用
2 Advanced用

1

ヒント

このコレクターから複数のOracleデータベースインスタンスをモニターするには、インスタンスファイルにエントリを追加します。チェックに失敗したインスタンスは、インストール全体を中止するのではなく、理由がログに記録されてスキップされます。

このロールは、セルフホスト型と同じインスタンスファイル/シークレットファイルパターンを使用して、単一のコレクターから1つ以上のRDS Oracleエンドポイントをモニターします（両方のファイルがターゲットホストにすでに存在している必要があります）。playbook.ymlという名前のファイルを作成し、次のコンテンツをコピーします。targetsをoracle-otel-rdsに設定し、プレースホルダーの値を独自の値に置き換えます：

- name: Install New Relic NRDOT for Oracle Database on RDS
  hosts: all
  roles:
    - role: newrelic.newrelic_install
  vars:
    targets:
      - oracle-otel-rds
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NR_CLI_ORACLE_INSTANCES_FILE: <path to the instances YAML file on the target host>
    NR_CLI_ORACLE_SECRETS_FILE: <path to the secrets file (KEY=VALUE per instance) on the target host>
    NR_CLI_ORACLE_CONFIG_PRESET: <1 Basic, 2 Advanced, default 1>

ヒント

デバッグロギングを有効にするには、プレイブックのvarsの下にverbosity: "debug"を追加します。

変数	説明	デフォルト
`NR_CLI_ORACLE_INSTANCES_FILE`	必須。ターゲットホストにすでに存在する、インスタンスYAMLファイルへのパス。	なし
`NR_CLI_ORACLE_SECRETS_FILE`	必須。ターゲット・ホスト上にすでに存在する、シークレット・ファイル（`KEY=VALUE`、インスタンスごとに1つのRDSマスター・ユーザー名/パスワードのペア；オプションで監視パスワードを固定するための`NR_CLI_ORACLE_LOGIN_PASSWORD_<i>`）へのパス。	なし
`NR_CLI_ORACLE_CONFIG_PRESET`	NRDOTの設定： `1` Basic用 `2` Advanced用	`1`

変数

説明

デフォルト

NR_CLI_ORACLE_INSTANCES_FILE

必須。ターゲットホストにすでに存在する、インスタンスYAMLファイルへのパス。

なし

NR_CLI_ORACLE_SECRETS_FILE

必須。ターゲット・ホスト上にすでに存在する、シークレット・ファイル（KEY=VALUE、インスタンスごとに1つのRDSマスター・ユーザー名/パスワードのペア；オプションで監視パスワードを固定するためのNR_CLI_ORACLE_LOGIN_PASSWORD_<i>）へのパス。

なし

NR_CLI_ORACLE_CONFIG_PRESET

NRDOTの設定：

1 Basic用
2 Advanced用

1

ヒント

このコレクターから複数のRDS Oracleエンドポイントをモニターするには、インスタンスファイルにエントリを追加し、シークレットファイルに一致する番号付きの資格情報を追加します。チェックに失敗したインスタンスは、インストール全体を中止するのではなく、理由がログに記録されてスキップされます。

このロールは、RDSと同じインスタンスファイル/シークレットファイルパターンを使用して、単一のコレクターから1つ以上のOracle Autonomousデータベース（ADB）インスタンスをモニターします（両方のファイルがターゲットホストにすでに存在している必要があり、各インスタンスには、そのホストにダウンロードして解凍された独自のOracle Walletも必要です）。正確なファイル形式については、CLIインストールを参照してください。playbook.ymlという名前のファイルを作成し、次のコンテンツをコピーします。targetsをoracle-otel-adbに設定し、プレースホルダーの値を独自の値に置き換えます：

- name: Install New Relic NRDOT for Oracle Autonomous Database
  hosts: all
  roles:
    - role: newrelic.newrelic_install
  vars:
    targets:
      - oracle-otel-adb
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NR_CLI_ORACLE_INSTANCES_FILE: <path to the instances YAML file on the target host>
    NR_CLI_ORACLE_SECRETS_FILE: <path to the secrets file (KEY=VALUE per instance) on the target host>

ヒント

デバッグロギングを有効にするには、プレイブックのvarsの下にverbosity: "debug"を追加します。

変数	説明	デフォルト
`NR_CLI_ORACLE_INSTANCES_FILE`	必須。ターゲットホスト上にすでに存在する、インスタンスYAMLファイルへのパス。各インスタンスのエントリには`wallet_dir`も必要です：そのインスタンスの展開されたOracle Walletへのパス。	なし
`NR_CLI_ORACLE_SECRETS_FILE`	必須。ターゲット・ホスト上にすでに存在する、シークレット・ファイル（`KEY=VALUE`、インスタンスごとに1つのADB管理者ユーザー名/パスワードのペア；オプションで監視パスワードを固定するための`NR_CLI_ORACLE_LOGIN_PASSWORD_<i>`）へのパス。	なし

ヒント

ADB用のNR_CLI_ORACLE_CONFIG_PRESETはありません：これはフルマネージド・サービスであり、ホスト・レベルのメトリクスを収集するためのホストが存在しないためです。

ヒント

このコレクターから複数のADBインスタンスをモニターするには、インスタンスファイルにエントリを追加し、シークレットファイルに一致する番号付きの資格情報を追加します。チェックに失敗したインスタンスは、インストール全体を中止するのではなく、理由がログに記録されてスキップされます。

プレイブックを実行します

bash

$ansible-playbook -i <inventory_file> <playbook_file>.yml

New RelicでOracleデータベースのエンティティを見つけるには、「データの検索と使用」をご覧ください。

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

Ansibleを使用したOracle監視用のNRDOTのインストールと構成

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

前提条件

役割をインストールします

プレイブックを設定してください

セルフホスト型Oracleデータベース

ヒント

ヒント

AWS RDS上のOracleデータベース

ヒント

ヒント

Oracle Autonomous データベース（ADB）

ヒント

ヒント

ヒント

プレイブックを実行します

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

Ansibleを使用したOracle監視用のNRDOTのインストールと構成

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

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

役割をインストールします

プレイブックを設定してください

AWS RDS上のOracleデータベース

Oracle Autonomous データベース（ADB）

プレイブックを実行します

前提条件