CLIを使用したOracle監視用NRDOTのインストールと設定

このレシピは、単一のコレクターから1つ以上のOracle データベースインスタンス（それぞれSSH経由で到達可能）をモニターします。単一のホスト/コンテナ/資格情報セットの入力を求める代わりに、モニターするすべてのインスタンスをリストしたインスタンスファイル（YAML）と、オプションで、監視ユーザーのパスワードを自動生成する代わりに特定のパスワードを固定するためのシークレットファイルを読み込みます。

このコマンドを実行する前に、以下を準備してください：

• 各ssh_userがパスワードプロンプトなしでsudo su - oracleを実行できる、リストされたすべてのOracle データベースホストへのSSHアクセス（エージェント転送付き）
• インスタンスごとのコンテナタイプ（すべてのPDBのCDB、または単一のPDB名）
• インスタンスごとのCDBまたはPDBサービス名
• BasicメトリクスとAdvancedメトリクスのどちらを希望するか

1. インスタンスファイルを作成します。このコレクターでモニターするOracle データベースインスタンスごとに1つのエントリを追加します；単一のインスタンスのみを監視する場合は、1つのエントリのみです：

   bash

   コピー

   $
   cat > ~/oracle-instances.yml << 'EOF'
   $
   instances:
   $
     - host: dbhost1.example.com
   $
       port: 1521
   $
       ssh_user: opc
   $
       container_type: 1
   $
       pdb_name:
   $
       service: ORCLCDB
   $
       login_name: newrelic
   $
   EOF

   container_type CDBの場合は1（すべてのPDBをモニターし、共通のc##<login_name>ユーザーを作成します）、単一のPDBの場合は2（その場合のみpdb_nameが必要です）です。c##プレフィックスを付けずにlogin_nameを入力してください：CDBモードではレシピによって自動的に追加されます。

2. （オプション）レシピに自動生成させる代わりに、インスタンスごとに固定の監視ユーザーパスワードを設定するシークレットファイルを作成します。セルフホスト型Oracleでは、ここで管理者資格情報は必要ありません。監視ユーザーは、SSHおよびOS認証のSYSDBAアクセスを介して作成されます：

   bash

   コピー

   $
   umask 077
   $
   cat > ~/oracle-secrets.env << 'EOF'
   $
   NR_CLI_ORACLE_LOGIN_PASSWORD_1=SomeFixedPassword1
   $
   EOF
   $
   chmod 600 ~/oracle-secrets.env

   代わりにすべてのインスタンスのランダムなパスワードを自動生成するには、secretsファイルのパスを空白のままにします（または存在しないファイルを指定します）。

インスタンスファイルにリストされているすべてのOracleデータベースホストへのSSHアクセス（エージェント転送付き）を持つホストから、これを実行します：

$
curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-oracle

CLIは、以下の変数について対話的にプロンプトを表示します。非対話的に実行するために、事前に環境変数として設定することもできます。

このレシピは、インスタンスファイルとシークレットファイルを使用して、単一のコレクターから1つ以上のRDS Oracleエンドポイントをモニターします。

このコマンドを実行する前に、以下を準備してください：

• すべてのインスタンスのRDS Oracleエンドポイント、リスナーポート、およびDBサービス名
• すべてのインスタンスのRDSマスター・ユーザー名とパスワード
• BasicメトリクスとAdvancedメトリクスのどちらを希望するか

1. インスタンスファイルを作成します（このコレクターにモニターさせるRDS Oracleエンドポイントごとに1つのエントリ。単一のインスタンスのみを監視している場合でも1つのエントリ）：

   bash

   コピー

   $
   cat > ~/oracle-instances.yml << 'EOF'
   $
   instances:
   $
     - host: rds-orders.abcdef123.us-east-1.rds.amazonaws.com
   $
       port: 1521
   $
       service: ORDERSDB
   $
       login_name: newrelic
   $
   EOF

2. インスタンスファイルの順序と一致するようにインデックス付けされた、各インスタンスのRDSマスターユーザー名とパスワードを含むシークレットファイルを作成します。オプションで、インスタンスごとに固定の監視ユーザーパスワードを設定することもできます。自動生成する場合は省略してください：

   bash

   コピー

   $
   umask 077
   $
   cat > ~/oracle-secrets.env << 'EOF'
   $
   NR_CLI_ORACLE_ADMIN_USER_1=admin
   $
   NR_CLI_ORACLE_ADMIN_PASSWORD_1=YourMasterPassword1
   $
   EOF
   $
   chmod 600 ~/oracle-secrets.env

$
curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-oracle-rds

CLIは、以下の変数について対話的にプロンプトを表示します。非対話的に実行するために、事前に環境変数として設定することもできます。

このレシピは、インスタンス・ファイルとシークレット・ファイルを使用して、単一のコレクターから1つ以上のOracle Autonomous データベース（ADB）インスタンスをモニターします。各インスタンスは、ダウンロードした独自のウォレットを使用して、相互TLS（ADBのデフォルト）経由で接続します。インスタンス間で1つのウォレット・ディレクトリを共有しないでください。

このコマンドを実行する前に、以下を準備してください：

• 各インスタンス：その接続文字列（host、port、service、ADBコンソールのDatabase connection > Connection stringsから）
• 各インスタンスについて：コレクターホスト上の独自のディレクトリに解凍された、ダウンロード済みのOracle Wallet（ADBコンソールのDatabase connection > Download wallet）
• すべてのインスタンスのADB管理者（ADMIN）のユーザー名とパスワード

1. インスタンスファイルを作成します。このコレクターでモニターするADBインスタンスごとに1つのエントリを追加します；単一のインスタンスのみを監視する場合は、1つのエントリのみを追加します：

   bash

   コピー

   $
   cat > ~/adb-instances.yml << 'EOF'
   $
   instances:
   $
     - host: adb1.adb.us-ashburn-1.oraclecloud.com
   $
       port: 1522
   $
       service: myadb1_high
   $
       login_name: newrelic
   $
       wallet_dir: /home/opc/wallet1
   $
   EOF

   wallet_dir は、そのインスタンスのウォレットが展開されたディレクトリです（cwallet.ssoとsqlnet.oraが含まれている必要があります）；ウォレット・ディレクトリが欠落しているか無効なインスタンスは、インストール全体を失敗させるのではなく、スキップされます。

2. 各インスタンスのADB管理者ユーザー名とパスワードを含むsecretsファイルを作成し、インスタンスファイルの順序と一致するようにインデックスを付けます。オプションで、インスタンスごとに固定の監視ユーザーパスワードを設定することもできます。自動生成する場合は省略してください：

   bash

   コピー

   $
   umask 077
   $
   cat > ~/adb-secrets.env << 'EOF'
   $
   NR_CLI_ORACLE_ADMIN_USER_1=ADMIN
   $
   NR_CLI_ORACLE_ADMIN_PASSWORD_1=YourAdminPassword1
   $
   EOF
   $
   chmod 600 ~/adb-secrets.env

PATHにsqlplus（Oracle Instant Client）があり、リストされているすべてのADBインスタンスへのネットワーク接続（mTLS）があるホストから、これを実行します：

$
curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-oracle-adb

CLIは、以下の変数について対話的にプロンプトを表示します。非対話的に実行するために、事前に環境変数として設定することもできます。