Instalar y configurar NRDOT para el monitoreo de MSSQL con CLI

Esta receta monitorea una o más instancia de SQL Server desde un solo recolector. En lugar de solicitar un único conjunto de host/puerto/credenciales, lee dos archivos que debe crear con anticipación: un archivo de instancia (YAML) que enumera cada instancia a monitorear, y un archivo de secretos (KEY=VALUE) con un inicio de sesión de administrador y una contraseña para cada una, indexados para que coincidan.

1. Cree el archivo de instancias. Agregue una entrada por cada instancia de SQL Server que desee que este recolector supervise, o solo una entrada si solo ejecuta una única instancia:

   bash

   Copia

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

2. Cree el archivo de secretos con un inicio de sesión y contraseña de administrador para cada instancia, indexado para que coincida con el orden del archivo de instancias. El inicio de sesión de administrador debe ser miembro del rol sysadmin (o equivalente):

   bash

   Copia

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

   bash

   Copia

   $
   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 (ejecutar en una sesión de PowerShell de administrador):

   [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

   Copia

   La CLI solicita de forma interactiva las siguientes variables. También puede configurarlas con anticipación como variables de entorno para ejecutar de forma no interactiva.

   Variable	Descripción	Por defecto
   NR_CLI_MSSQL_CONFIG_PRESET	Configuración de NRDOT: 1 para Basic 2 para Advanced	1
   NR_CLI_MSSQL_INSTANCES_FILE	Obligatorio. Ruta al archivo YAML de instancias.	Ninguno
   NR_CLI_MSSQL_SECRETS_FILE	Obligatorio. Ruta al archivo de secretos ( KEY=VALUE , un par de inicio de sesión/contraseña de administrador por instancia).	Ninguno

   Sugerencia

   Para monitorear más de una instancia de SQL Server desde este recolector, agregue más entradas al archivo de instancias y las credenciales numeradas correspondientes (_2, _3,...) al archivo de secretos. Una instancia que no pasa sus comprobaciones se omite con un motivo registrado en lugar de cancelar toda la instalación. La instalación solo falla por completo si ninguna de las instancias pasa.

Este método solo es compatible con un host de recolector de Windows. Utiliza la autenticación de Windows (integrated security=true) en lugar de los inicios de sesión de SQL, y monitorea una o más instancias de SQL Server desde un solo recolector. El recolector es un servicio de Windows con una cuenta de inicio de sesión, y se conecta a cada instancia como esa cuenta, por lo que una instalación de múltiples instancias siempre utiliza un modo de autenticación y una identidad de Windows, otorgada en cada instancia que enumere.

1. Cree el archivo de instancias. Agregue una entrada por instancia de SQL Server que desee que este recolector supervise, o solo una entrada si solo ejecuta una única instancia. Solo se necesitan host y port (sin login_name, sin archivo de secretos):

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

   Copia

   Guarde esto en cualquier lugar del host del recolector, por ejemplo, C:\mssql-instances.yml. Para una instancia con nombre, use host más su puerto TCP estático en lugar de host\INSTANCE.

   Antes de ejecutar este comando, tenga preparado:

• El archivo de instancias del paso 1

• Ya sea que utilice una cuenta de Windows o una cuenta gMSA

• Para la autenticación de Windows: ya sea que el recolector se ejecute en el mismo host que SQL Server o en un host diferente

• La cuenta de Windows (o cuenta gMSA) a la que se le otorgarán permisos (no es necesario si el recolector se ejecuta en el mismo host que SQL Server)

• Si desea métricas básicas o avanzadas

  Ejecute esto en una sesión de PowerShell de administrador:

  [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

  Copia

  La CLI solicita de forma interactiva las siguientes variables. También puede configurarlas con anticipación como variables de entorno para ejecutar de forma no interactiva.

  Variable	Descripción	Por defecto
  NR_CLI_MSSQL_CONFIG_PRESET	Configuración de NRDOT: 1 para Basic 2 para Advanced	1
  NR_CLI_MSSQL_AUTH_MODE	Autenticación de SQL Server: 1 para la autenticación de Windows 2 para gMSA	1
  NR_CLI_MSSQL_WINAUTH_LOCATION	Solo autenticación de Windows: 1 si el recolector se ejecuta en el mismo host que SQL Server (se utiliza la identidad del usuario que realiza la instalación y el servicio permanece LocalSystem, por lo que no se necesita una cuenta de dominio) 2 si se ejecuta en un host diferente	1
  NR_CLI_MSSQL_INSTANCES_FILE	Obligatorio. Ruta al archivo YAML de instancia ( host / port por instancia).	Ninguno
  NR_CLI_MSSQL_WIN_ACCOUNT	Cuenta de Windows a la que otorgar permisos, DOMAIN\username . Solo se requiere cuando NR_CLI_MSSQL_AUTH_MODE es 1 y NR_CLI_MSSQL_WINAUTH_LOCATION es 2 ; déjelo en blanco para gMSA o para el flujo del mismo host.	Ninguno
  NR_CLI_MSSQL_WIN_PASSWORD	Contraseña para esa cuenta de Windows. Solo es obligatorio cuando NR_CLI_MSSQL_AUTH_MODE es 1 y NR_CLI_MSSQL_WINAUTH_LOCATION es 2 ; déjelo en blanco para gMSA o para el flujo del mismo host.	Ninguno
  NR_CLI_MSSQL_GMSA_ACCOUNT	Cuenta gMSA, DOMAIN\gMSAName$ . Solo gMSA; déjelo en blanco para la autenticación de Windows.	Ninguno

  Sugerencia

  Para monitorear más de una instancia de SQL Server desde este recolector, agregue más entradas al archivo de instancias. Se utilizan un modo de autenticación y una identidad de Windows para cada instancia en el archivo; no se admiten diferentes identidades por instancia. Un host o puerto no válido, un host:port duplicado o una instancia que no supera su comprobación de versión o configuración de permisos se omite con un motivo registrado en lugar de cancelar toda la instalación. El flujo del mismo host (NR_CLI_MSSQL_WINAUTH_LOCATION 1) solo funciona para las instancias en esta máquina. Enumere las instancias en otros hosts mediante el flujo de host diferente o gMSA.

Esta receta monitorea uno o más extremos de RDS SQL Server desde un solo recolector, utilizando el mismo patrón de archivo de instancias/archivo de secretos que el autohospedado.

1. Cree el archivo de instancias, usando el extremo de RDS como host, con solo una entrada si solo está monitoreando una única instancia de RDS:

   bash

   Copia

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

2. Cree el archivo de secretos con el nombre de usuario y la contraseña maestros de RDS para cada instancia, indexado para que coincida con el orden del archivo de instancia:

   bash

   Copia

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

   bash

   Copia

   $
   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 (ejecutar en una sesión de PowerShell de administrador):

   [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

   Copia

   La CLI solicita de forma interactiva las siguientes variables. También puede configurarlas con anticipación como variables de entorno para ejecutar de forma no interactiva.

   Variable	Descripción	Por defecto
   NR_CLI_MSSQL_CONFIG_PRESET	Configuración de NRDOT: 1 para Basic 2 para Advanced	1
   NR_CLI_MSSQL_INSTANCES_FILE	Obligatorio. Ruta al archivo YAML de instancias, usando los extremos de RDS como host .	Ninguno
   NR_CLI_MSSQL_SECRETS_FILE	Obligatorio. Ruta al archivo de secretos ( KEY=VALUE , un par de nombre de usuario/contraseña maestro de RDS por instancia).	Ninguno

   Sugerencia

   Para monitorear más de un extremo de RDS SQL Server desde este recolector, agregue más entradas al archivo de instancia y credenciales numeradas correspondientes al archivo de secretos. Una instancia que no pasa las comprobaciones se omite con un motivo registrado en lugar de cancelar toda la instalación.

Este método solo es compatible con un host recolector de Windows y requiere que las instancias de RDS ya estén unidas a un dominio de AWS Managed Microsoft AD. Supervisa uno o más extremos de RDS SQL Server desde un único recolector. El recolector es un servicio de Windows con una cuenta de inicio de sesión, y se conecta a cada extremo como esa cuenta, por lo que una instalación de múltiples instancias siempre usa un modo de autenticación y una identidad de Windows, otorgada en cada extremo que enumere. A diferencia del método autohospedado anterior, aquí no hay una opción de "mismo host": siempre se requiere una cuenta de dominio (o gMSA).

1. Cree el archivo de instancias, utilizando cada extremo de RDS como host, con solo una entrada si solo realiza el monitoreo de una única instancia de RDS:

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

   Copia

   Guárdelo en cualquier lugar del host del recolector, por ejemplo, C:\mssql-instances.yml.

   Antes de ejecutar este comando, tenga preparado:

• El archivo de instancias del paso 1

• Ya sea que utilice una cuenta de dominio de Windows o una cuenta gMSA

• La cuenta de dominio (o cuenta gMSA) a la que se le otorgarán permisos

• Si desea métricas básicas o avanzadas

  Ejecute esto en una sesión de PowerShell de administrador:

  [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

  Copia

  La CLI solicita de forma interactiva las siguientes variables. También puede configurarlas con anticipación como variables de entorno para ejecutar de forma no interactiva.

  Variable	Descripción	Por defecto
  NR_CLI_MSSQL_CONFIG_PRESET	Configuración de NRDOT: 1 para Basic 2 para Advanced	1
  NR_CLI_MSSQL_AUTH_MODE	Autenticación de SQL Server: 1 para la autenticación de dominio de Windows 2 para gMSA	1
  NR_CLI_MSSQL_INSTANCES_FILE	Obligatorio. Ruta al archivo YAML de instancias, usando los extremos de RDS como host .	Ninguno
  NR_CLI_MSSQL_WIN_ACCOUNT	Cuenta de dominio de Windows a la que otorgar permisos, DOMAIN\username . Solo autenticación de dominio de Windows; déjelo en blanco para gMSA.	Ninguno
  NR_CLI_MSSQL_WIN_PASSWORD	Contraseña para esa cuenta de dominio. Solo autenticación de dominio de Windows; déjelo en blanco para gMSA.	Ninguno
  NR_CLI_MSSQL_GMSA_ACCOUNT	Cuenta gMSA, DOMAIN\gMSAName$ . Solo gMSA; déjelo en blanco para la autenticación de dominio de Windows.	Ninguno

  Sugerencia

  Para monitorear más de un extremo de RDS SQL Server desde este recolector, agregue más entradas al archivo de instancias. Se utilizan un modo de autenticación y una identidad de Windows para cada extremo en el archivo. Un host o puerto no válido, un host:port duplicado o un extremo que no supera su comprobación de versión o configuración de permisos se omite con un motivo registrado en lugar de cancelar toda la instalación.