CLIを使用したMSSQL監視用のNRDOTのインストールおよび構成

このレシピは、単一のコレクターから1つ以上のSQL Serverインスタンスをモニターします。単一のホスト/ポート/資格情報セットの入力を求める代わりに、事前に作成した次の2つのファイルを読み込みます：モニターするすべてのインスタンスをリストしたインスタンス・ファイル（YAML）、およびそれぞれに一致するようにインデックス付けされた、管理者ログインとパスワードを含むシークレット・ファイル（KEY=VALUE）です。

1. インスタンスファイルを作成します。このコレクターでモニターするSQL Serverインスタンスごとに1つのエントリを追加するか、単一のインスタンスのみを実行している場合は1つのエントリのみを追加します：

   bash

   コピー

   $
   cat > ~/mssql-instances.yml << 'EOF'
   $
   instances:
   $
     - host: localhost
   $
       port: 1433
   $
       login_name: newrelic
   $
   EOF

2. 各インスタンスのadminログインとパスワードを含むシークレットファイルを作成し、インスタンスファイルの順序と一致するようにインデックスを付けます。adminログインは、sysadminロール（または同等のもの）のメンバーである必要があります：

   bash

   コピー

   $
   umask 077
   $
   cat > ~/mssql-secrets.env << 'EOF'
   $
   NR_CLI_MSSQL_ADMIN_USER_1=<YOUR_ADMIN_USERNAME>
   $
   NR_CLI_MSSQL_ADMIN_PASSWORD_1=<YOUR_ADMIN_PASSWORD>
   $
   EOF
   $
   chmod 600 ~/mssql-secrets.env

Linux：

$
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-mssql

Windows（アドミニストレーターのPowerShellセッションで実行）：

[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $WebClient = New-Object System.Net.WebClient; $WebClient.DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install -n nrdot-collector-mssql

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

このメソッドは、Windowsコレクターホストでのみサポートされています。SQLログインの代わりにWindows認証（integrated security=true）を使用し、単一のコレクターから1つ以上のSQL Serverインスタンスをモニターします。コレクターは1つのログオンアカウントを持つ1つのWindowsサービスであり、そのアカウントとしてすべてのインスタンスに接続します。そのため、マルチインスタンスインストールでは常に1つの認証モードと1つのWindows IDが使用され、リストされたすべてのインスタンスで付与されます。

1. インスタンスファイルを作成します。このコレクターでモニターするSQL Serverインスタンスごとに1つのエントリを追加するか、単一のインスタンスのみを実行している場合は1つのエントリのみを追加します。hostとportのみが必要です（login_nameやシークレットファイルは不要です）：

   instances:
     - host: sql01.contoso.com
       port: 1433
     - host: sql02.contoso.com
       port: 1433

   コピー

   これをコレクターホストの任意の場所（たとえばC:\mssql-instances.yml）に保存してください。名前付きインスタンスの場合は、host\INSTANCEではなくhostとその静的TCPポートを使用してください。

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

• ステップ1のインスタンスファイル
• WindowsアカウントとgMSAアカウントのどちらを使用しているか
• Windows認証の場合：コレクターがSQL Serverと同じホストで実行されるか、別のホストで実行されるか
• 権限を付与するWindowsアカウント（またはgMSAアカウント）（コレクターがSQL Serverと同じホストで実行されている場合は不要）
• BasicメトリクスとAdvancedメトリクスのどちらを希望するか

これをアドミニストレーターのPowerShellセッションで実行してください：

[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $WebClient = New-Object System.Net.WebClient; $WebClient.DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install -n nrdot-collector-mssql-winauth

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

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

1. RDSエンドポイントをhostとして使用し、単一のRDSインスタンスのみを監視している場合はエントリを1つだけ記述して、インスタンスファイルを作成します：

   bash

   コピー

   $
   cat > ~/mssql-instances.yml << 'EOF'
   $
   instances:
   $
     - host: mydb1.abcdefg12345.us-east-1.rds.amazonaws.com
   $
       port: 1433
   $
       login_name: newrelic
   $
   EOF

2. 各インスタンスのRDSマスターユーザー名とパスワードを含むシークレットファイルを作成し、インスタンスファイルの順序と一致するようにインデックスを付けます：

   bash

   コピー

   $
   umask 077
   $
   cat > ~/mssql-secrets.env << 'EOF'
   $
   NR_CLI_MSSQL_ADMIN_USER_1=admin
   $
   NR_CLI_MSSQL_ADMIN_PASSWORD_1=YourMasterPassword1
   $
   EOF
   $
   chmod 600 ~/mssql-secrets.env

Linux：

$
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-mssql-rds

Windows（アドミニストレーターのPowerShellセッションで実行）：

[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $WebClient = New-Object System.Net.WebClient; $WebClient.DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install -n nrdot-collector-mssql-rds

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

このメソッドはWindowsコレクターホストでのみサポートされており、RDSインスタンスがすでにAWS Managed Microsoft ADドメインに参加している必要があります。単一のコレクターから1つ以上のRDS SQL Serverエンドポイントをモニターします。コレクターは1つのログオンアカウントを持つ1つのWindowsサービスであり、そのアカウントとしてすべてのエンドポイントに接続します。そのため、マルチインスタンスインストールでは常に1つの認証モードと1つのWindows IDが使用され、リストされたすべてのエンドポイントで付与されます。上記のセルフホストメソッドとは異なり、ここには"同一ホスト"オプションはありません：ドメインアカウント（またはgMSA）が常に必要です。

1. 各RDSエンドポイントをhostとして使用してインスタンスファイルを作成します。単一のRDSインスタンスのみを監視している場合は、エントリを1つだけにします：

   instances:
     - host: mydb1.xxxxxxxxxx.us-east-1.rds.amazonaws.com
       port: 1433
     - host: mydb2.xxxxxxxxxx.us-east-1.rds.amazonaws.com
       port: 1433

   コピー

   これをコレクターホスト上の任意の場所、たとえばC:\mssql-instances.ymlに保存してください。

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

• ステップ1のインスタンスファイル
• Windowsドメインアカウントを使用しているか、gMSAアカウントを使用しているか
• 権限を付与するドメインアカウント（またはgMSAアカウント）
• BasicメトリクスとAdvancedメトリクスのどちらを希望するか

これをアドミニストレーターのPowerShellセッションで実行してください：

[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $WebClient = New-Object System.Net.WebClient; $WebClient.DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install -n nrdot-collector-mssql-rds-winauth

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