Monitoreo de Linux RDS MSSQL con NRDOT

Requisitos previos

• Cuenta de New Relic con una clave de licenciaválida

• Extremo OTLP de New Relic para su región

• Requisitos de AWS RDS SQL Server:

  • AWS RDS SQL Server 2017 o posterior
  • Nombre de usuario y contraseña maestros de RDS
  • Grupo de seguridad que permite conexiones entrantes en el puerto 1433 o en un puerto personalizado

• Requisitos del sistema de Linux:

  • sqlcmd utilidad instalada en el sistema Linux
  • Conectividad de red al extremo OTLP de New Relic

Inscribirse en la vista previa

Esta integración está disponible como parte del programa de vista previa pública (public preview) de New Relic. Comuníquese con el gerente de la organización para activarla desde la página de Previsualizaciones y pruebas (Previews & Trials).

Instalar NRDOT Collector

Descargue e instale el paquete NRDOT para su distribución de Linux. Reemplace <NRDOT_VERSION> con la última etiqueta de versión de la página nrdot-collector-releases.

Crear usuario de monitoreo

Ejecute este script como usuario root para crear el usuario de monitoreo newrelic y otorgar los permisos necesarios para recopilar las métricas de RDS SQL Server.

1. Cree un archivo llamado nr-grant-permission-rds.sql.

2. Pegue el siguiente script de SQL para crear el usuario de monitoreo de newrelic y reemplace <YOUR_PASSWORD> con la contraseña deseada:

   USE [master];
   GO
   CREATE LOGIN [newrelic] WITH PASSWORD = '<YOUR_PASSWORD>';
   GO
   -- Instance-level permissions
   GRANT VIEW SERVER STATE TO [newrelic];
   GRANT VIEW ANY DEFINITION TO [newrelic];
   GRANT VIEW ANY DATABASE TO [newrelic];
   GO
   -- Grant read access privileges to all user databases
   DECLARE @name SYSNAME;
   DECLARE db_cursor CURSOR READ_ONLY FORWARD_ONLY FOR
   SELECT [name]
   FROM [master].[sys].[databases]
   WHERE [name] NOT IN ('master', 'msdb', 'model', 'rdsadmin', 'distribution')
   AND [state] = 0; -- Only online databases
   OPEN db_cursor;
   FETCH NEXT FROM db_cursor INTO @name;
   WHILE @@FETCH_STATUS = 0
   BEGIN
     BEGIN TRY
       EXEC('USE [' + @name + '];
         IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = ''newrelic'')
         BEGIN
           CREATE USER [newrelic] FOR LOGIN [newrelic];
         END;
         GRANT VIEW DATABASE STATE TO [newrelic];');
     END TRY
     BEGIN CATCH
       PRINT 'Error on ' + @name + ': ' + ERROR_MESSAGE();
     END CATCH
     FETCH NEXT FROM db_cursor INTO @name;
   END
   CLOSE db_cursor;
   DEALLOCATE db_cursor;
   GO

   Copia

3. Ejecute el script usando sqlcmd. Reemplace <YOUR-RDS-ENDPOINT> con su extremo de RDS y <YOUR_MASTER_PASSWORD> con su contraseña maestra:

   bash

   Copia

   $
   sqlcmd -S <YOUR-RDS-ENDPOINT> -U <YOUR_MASTER_USER> -P '<YOUR_MASTER_PASSWORD>' -C -i nr-grant-permission-rds.sql

4. (Opcional) Verifique que el usuario se haya creado correctamente con los permisos correctos:

   bash

   Copia

   $
   sqlcmd -S <YOUR-RDS-ENDPOINT> -U <YOUR_MASTER_USER> -P '<YOUR_MASTER_PASSWORD>' -C -Q "SELECT sp.name AS [User], p.permission_name AS [Permission_Granted] FROM sys.server_permissions p JOIN sys.server_principals sp ON p.grantee_principal_id = sp.principal_id WHERE sp.name = 'newrelic';"

   Sugerencia

   Use el nombre de usuario y la contraseña maestros de RDS para ejecutar estos comandos. El script excluye automáticamente la base de datos rdsadmin, que está reservada por AWS. Para administrar de forma segura la información confidencial, como las credenciales de la base de datos, almacénelas en herramientas de gestión de secretos.

Configurar el Colector NRDOT

Seleccione la opción de configuración según sus requisitos de monitoreo:

1. Cree un archivo de configuración llamado mssql-config.yaml:

   bash

   Copia

   $
   sudo nano /etc/nrdot-collector/mssql-config.yaml

2. Agregue la siguiente configuración al archivo mssql-config.yaml creado en el paso anterior:

   configuración completa

   Esta configuración se centra en el monitoreo esencial de la base de datos para el entorno RDS. Para habilitar un monitoreo integral con todas las métricas disponibles, consulte la referencia de configuración.

   Nombre de usuario de la base de datos

   Ingrese su nombre de usuario de la base de datos para la autenticación (generalmente newrelic)

   Contraseña de la base de datos

   Ingrese la contraseña que estableció para el usuario newrelic

   Extremo de RDS

   Ingrese su extremo de RDS SQL Server

   Puerto de SQL Server

   Ingrese el número de puerto de SQL Server. El valor predeterminado es 1433.

   Extremo OTLP de New Relic

   Ingrese el extremo OTLP de New Relic. Para obtener más información, consulte https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp/

   Clave de licencia de New Relic

   Ingrese su clave de licencia de New Relic

   mssql-config.yaml

   DownloadCopia

   1
   receivers:
   2
   nrsqlserver:
   3
      collection_interval: 15s
   4
      # Connection details - Use your RDS endpoint
   5
      username: newrelic
   6
      password: YOUR_PASSWORD
   7
      server: mydb-instance.xxxxxxxxxxxx.us-east-1.rds.amazonaws.com
   8
      port: 1433
   9
   
   10
      # Enable comprehensive database metrics
   11
      metrics:
   12
        sqlserver.database.count:
   13
          enabled: true
   14
        sqlserver.database.io:
   15
          enabled: true
   16
        sqlserver.database.latency:
   17
          enabled: true
   18
        sqlserver.database.operations:
   19
          enabled: true
   20
        sqlserver.database.tempdb.space:
   21
          enabled: true
   22
        sqlserver.database.tempdb.version_store.size:
   23
          enabled: true
   24
        sqlserver.deadlock.rate:
   25
          enabled: true
   26
        sqlserver.os.wait.duration:
   27
          enabled: true
   28
        sqlserver.processes.blocked:
   29
          enabled: true
   30
        sqlserver.memory.grants.pending.count:
   31
          enabled: true
   32
        sqlserver.database.file.size:
   33
          enabled: true
   34
        sqlserver.memory.area:
   35
          enabled: true
   36
   
   37
      # Enable top query and query sample log collection
   38
      events:
   39
        db.server.query_sample:
   40
          enabled: true
   41
        db.server.top_query:
   42
          enabled: true
   43
   
   44
      # Top query collection configuration
   45
      top_query_collection:
   46
        lookback_time: 60s
   47
        max_query_sample_count: 1000
   48
        top_query_count: 250
   49
        collection_interval: 60s
   50
   
   51
      collect_full_query_text: true
   52
      allowed_comment_keys:
   53
        - nr_service_guid
   54
   
   55
      # Query sample collection configuration
   56
      query_sample_collection:
   57
        max_rows_per_query: 100
   58
   
   59
   processors:
   60
   memory_limiter:
   61
      check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
   62
      limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-200}
   63
      spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}
   64
   
   65
   batch:
   66
   
   67
   exporters:
   68
   otlp:
   69
      endpoint: https://otlp.nr-data.net:4318
   70
      headers:
   71
        api-key: YOUR_LICENSE_KEY
   72
      tls:
   73
        insecure: false
   74
      compression: gzip
   75
   
   76
   service:
   77
   telemetry:
   78
      metrics:
   79
        level: none
   80
   
   81
   pipelines:
   82
      metrics:
   83
        receivers: [nrsqlserver]
   84
        processors: [memory_limiter, batch]
   85
        exporters: [otlp]
   86
   
   87
      logs:
   88
        receivers: [nrsqlserver]
   89
        processors: [memory_limiter, batch]
   90
        exporters: [otlp]

Actualizar la configuración de NRDOT Collector

Después de configurar su archivo YAML con las entradas interactivas anteriores, complete la configuración de NRDOT Collector:

1. Edite el archivo de configuración del servicio usando el siguiente comando:

   bash

   Copia

   $
   sudo nano /etc/nrdot-collector/nrdot-collector.conf

2. Actualice la ruta de configuración para que apunte a su nuevo archivo mssql-config.yaml:

   bash

   Copia

   $
   OTELCOL_CONFIG="/etc/nrdot-collector/mssql-config.yaml"

3. (Opcional) Valide la configuración del Collector de NRDOT:

   bash

   Copia

   $
   sudo /usr/bin/nrdot-collector validate --config=/etc/nrdot-collector/mssql-config.yaml

   Sugerencia

   Para correlacionar el rendimiento de su aplicación con las operaciones de la base de datos, puede configurar la identificación del servicio de base de datos. Para obtener más información, consulte la guía de configuración de identificación del servicio de base de datos.

Reiniciar NRDOT Collector

Después de actualizar su configuración, reinicie el servicio NRDOT Collector:

$
sudo systemctl restart nrdot-collector

Encuentra y utiliza tus datos

Una vez que sus datos se estén recopilando, puede acceder al monitoreo integral de bases de datos SQL Server a través de la UI de New Relic.

Para encontrar su entidad de base de datos SQL Server en New Relic:

1. Vaya a one.newrelic.com > All capabilities > Databases.

2. En el menú desplegable Entity type, seleccione MSSQL instance y luego haga clic en Apply.

3. Seleccione su base de datos SQL Server de la lista de entidades.

   Después de configurar el monitoreo de SQL Server con NRDOT, puede:

   • Crea dashboards personalizados para visualizar las métricas de tu base de datos
   • Configura alertas para umbrales críticos de rendimiento de la base de datos
   • Explore los datos con las capacidades de consulta de New Relic