Installez & configurez NRDOT pour le monitoring MSSQL avec la CLI

Cette recette monitore une ou plusieurs instances SQL Server à partir d’un seul collecteur. Au lieu de demander un seul ensemble hôte/port/identifiants, elle lit deux fichiers que vous créez à l’avance : un fichier d’instances (YAML) listant chaque instance à monitorer, et un fichier de secrets (KEY=VALUE) avec un identifiant et un mot de passe administrateur pour chacune, indexés pour correspondre.

1. Créer le fichier d’instance. Ajoutez une entrée par instance SQL Server que vous souhaitez que ce collecteur monitore, ou juste une entrée si vous n’exécutez qu’une seule instance :

   bash

   Copier

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

2. Créez le fichier de secrets avec un identifiant et un mot de passe d’administrateur pour chaque instance, indexé pour correspondre à l’ordre du fichier d’instance. L’identifiant d’administrateur doit être membre du rôle sysadmin (ou équivalent) :

   bash

   Copier

   $
   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 (exécutez dans une session PowerShell administrateur) :

[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

La CLI affiche un prompt de manière interactive pour les variables suivantes. Vous pouvez également les définir à l’avance comme variables d’environnement pour une exécution non interactive.

Cette méthode est uniquement prise en charge sur un hôte collecteur Windows. Elle utilise l’authentification Windows (integrated security=true) au lieu des connexions SQL, et monitore une ou plusieurs instances SQL Server à partir d’un seul collecteur. Le collecteur est un service Windows avec un seul compte de connexion, et se connecte à chaque instance avec ce compte, de sorte qu’une installation multi-instance utilise toujours un seul mode d’authentification et une seule identité Windows, accordée sur chaque instance que vous listez.

1. Créez le fichier d’instance. Ajoutez une entrée par instance SQL Server que vous souhaitez que ce collecteur monitore, ou juste une entrée si vous n’exécutez qu’une seule instance. Seuls host et port sont nécessaires (pas de login_name, pas de fichier de secrets) :

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

   Copier

   Enregistrez ceci n’importe où sur l’hôte du collecteur, par exemple C:\mssql-instances.yml. Pour une instance nommée, utilisez host plus son port TCP statique plutôt que host\INSTANCE.

Avant d’exécuter cette commande, préparez :

• Le fichier d'instance de l'étape 1
• Que vous utilisiez un compte Windows ou un compte gMSA
• Pour l’authentification Windows : si le collecteur s’exécute sur le même hôte que SQL Server, ou sur un hôte différent
• Le compte Windows (ou compte gMSA) auquel accorder des autorisations (non requis si le collecteur s'exécute sur le même hôte que SQL Server)
• Que vous souhaitiez des métriques Basic ou Advanced

Exécutez ceci dans une session PowerShell administrateur :

[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

La CLI affiche un prompt de manière interactive pour les variables suivantes. Vous pouvez également les définir à l’avance comme variables d’environnement pour une exécution non interactive.

Cette recette monitore un ou plusieurs points de terminaison RDS SQL Server à partir d’un seul collecteur, en utilisant le même modèle de fichier d’instances / fichier de secrets que pour l’auto-hébergé.

1. Créez le fichier d’instance, en utilisant le point de terminaison RDS comme host, avec une seule entrée, si vous effectuez uniquement le monitoring d’une seule instance RDS :

   bash

   Copier

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

2. Créez le fichier de secrets avec le nom d’utilisateur et le mot de passe maître RDS pour chaque instance, indexé pour correspondre à l’ordre du fichier des instances :

   bash

   Copier

   $
   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 (exécutez dans une session PowerShell administrateur) :

[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

La CLI affiche un prompt de manière interactive pour les variables suivantes. Vous pouvez également les définir à l’avance comme variables d’environnement pour une exécution non interactive.

Cette méthode est uniquement prise en charge sur un hôte collecteur Windows, et nécessite que vos instances RDS soient déjà jointes à un domaine AWS Managed Microsoft AD. Elle monitore un ou plusieurs points de terminaison RDS SQL Server à partir d’un seul collecteur. Le collecteur est un service Windows avec un seul compte de connexion, et se connecte à chaque point de terminaison avec ce compte, de sorte qu’une installation multi-instance utilise toujours un seul mode d’authentification et une seule identité Windows, accordée sur chaque point de terminaison que vous listez. Contrairement à la méthode auto-hébergée ci-dessus, il n’y a pas d’option "même hôte" ici : un compte de domaine (ou gMSA) est toujours requis.

1. Créez le fichier d’instances, en utilisant chaque point de terminaison RDS comme host, avec juste une entrée si vous ne faites le monitoring que d’une seule instance RDS :

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

   Copier

   Enregistrez ceci n’importe où sur l’hôte du collecteur, par exemple C:\mssql-instances.yml.

Avant d’exécuter cette commande, préparez :

• Le fichier d'instance de l'étape 1
• Si vous utilisez un compte de domaine Windows ou un compte gMSA
• Le compte de domaine (ou le compte gMSA) auquel accorder des autorisations
• Que vous souhaitiez des métriques Basic ou Advanced

Exécutez ceci dans une session PowerShell administrateur :

[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

La CLI affiche un prompt de manière interactive pour les variables suivantes. Vous pouvez également les définir à l’avance comme variables d’environnement pour une exécution non interactive.