Monitoreo de Windows RDS MSSQL con NRDOT

Avance

Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras!

Esta función se proporciona actualmente como parte de una vista previa de conformidad con nuestras políticas de prelanzamiento.

Configure el monitoreo de Microsoft SQL Server usando el recolector NRDOT en entornos Windows para monitorear las instancias de AWS RDS para SQL Server.

Según su configuración de seguridad de RDS SQL Server, puede elegir entre tres métodos de autenticación para conectar el NRDOT Collector a su instancia de RDS:

Requisitos previos

Asegúrese de que su entorno cumpla con nuestra compatibilidad y requisitos previos.

Configurar el colector NRDOT

Instale el Collector NRDOT en una instancia EC2 de Windows o en una máquina local de Windows que pueda conectarse a su instancia de RDS SQL Server.

Importante

Para el monitoreo de RDS, instale el Collector NRDOT en una instancia EC2 en la misma VPC que su instancia de RDS para obtener una conectividad de red óptima y una menor latencia.

Descarga e instala el NRDOT Collector usando PowerShell:
```
[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $NRDOT_VERSION = (Invoke-RestMethod -Uri "https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest").tag_name; $WebClient = New-Object System.Net.WebClient; $WebClient.Headers.Add("User-Agent", "Mozilla/5.0"); $WebClient.DownloadFile("https://github.com/newrelic/nrdot-collector-releases/releases/download/$NRDOT_VERSION/nrdot-collector_${NRDOT_VERSION}_windows_x64.msi", "$env:TEMP\nrdot-collector.msi"); Start-Process msiexec.exe -ArgumentList "/i `"$env:TEMP\nrdot-collector.msi`" /qn /norestart /L*V `"$env:TEMP\nrdot_install.log`"" -Wait; Get-Service nrdot-collector -ErrorAction SilentlyContinue
```
Asegúrese de que su grupo de seguridad permita conexiones entrantes desde el host del Collector de NRDOT a su instancia de RDS en el puerto 1433 (o su puerto personalizado).

Configurar el usuario de la base de datos

Conéctese a su instancia de RDS SQL Server usando SQL Server Management Studio (SSMS) o sqlcmd con sus credenciales de administrador.

Ejecute el siguiente script para crear el usuario de monitoreo de newrelic con los permisos adecuados:

USE [master];
GO
CREATE LOGIN [newrelic] WITH PASSWORD = '<PASSWORD>';
GO

GRANT VIEW SERVER STATE TO [newrelic];
GRANT VIEW ANY DEFINITION TO [newrelic];
GRANT VIEW ANY DATABASE TO [newrelic];
GO

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;
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

Sugerencia

Para RDS: use su nombre de usuario maestro de RDS (o un usuario con el rol rds_superuser) para ejecutar estos comandos. El script excluye automáticamente la base de datos rdsadmin que está reservada por AWS.

Configurar el Colector NRDOT

Seleccione su tipo de configuración según sus necesidades de monitoreo:

Esta configuración se centra en el monitoreo esencial de la base de datos con métricas principales.

Sugerencia

Formato del extremo de RDS: su extremo de RDS tendrá el formato: your-db-instance.xxxxxxxxxxxx.region.rds.amazonaws.com (por ejemplo, mydb-instance.c9akciq32.us-east-1.rds.amazonaws.com). Encuentre esto en su consola de AWS RDS en "Conectividad y seguridad".

Cree el archivo de configuración. El nombre del archivo debe ser mssql-config.yaml. Ejecute el siguiente comando en PowerShell como administrador:
```
New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

Agregue el contenido de configuración a continuación al archivo mssql-config.yaml que creó en el paso anterior.

receivers:
  nrsqlserver:
    collection_interval: 15s
    username: <YOUR_USERNAME>
    password: <YOUR_PASSWORD>
    server: <YOUR_SERVER>
    port: <YOUR_PORT>

    # Enable comprehensive database metrics
    metrics:
      sqlserver.database.count:
        enabled: true
      sqlserver.database.io:
        enabled: true
      sqlserver.database.latency:
        enabled: true
      sqlserver.database.operations:
        enabled: true
      sqlserver.database.tempdb.space:
        enabled: true
      sqlserver.database.tempdb.version_store.size:
        enabled: true
      sqlserver.deadlock.rate:
        enabled: true
      sqlserver.os.wait.duration:
        enabled: true
      sqlserver.processes.blocked:
        enabled: true
      sqlserver.memory.grants.pending.count:
        enabled: true
      sqlserver.database.file.size:
        enabled: true
      sqlserver.memory.area:
        enabled: true

    # Enable top query and query sample log collection
    events:
      db.server.query_sample:
        enabled: true
      db.server.top_query:
        enabled: true

    # Top query collection configuration
    top_query_collection:
      lookback_time: 60s
      max_query_sample_count: 1000
      top_query_count: 250
      collection_interval: 60s

    collect_full_query_text: true
    allowed_comment_keys:
      - nr_service_guid

    # Query sample collection configuration
    query_sample_collection:
      max_rows_per_query: 100

processors:
  memory_limiter:
    check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
    limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-200}
    spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}

  batch:

exporters:
  otlphttp:
    endpoint: <YOUR_OTLP_ENDPOINT>
    headers:
      api-key: <YOUR_LICENSE_KEY>
    tls:
      insecure: false
    compression: gzip

service:
  telemetry:
    metrics:
      level: none

  pipelines:
    metrics:
      receivers: [nrsqlserver]
      processors: [memory_limiter, batch]
      exporters: [otlphttp]

    logs:
      receivers: [nrsqlserver]
      processors: [memory_limiter, batch]
      exporters: [otlphttp]

Esta configuración proporciona un monitoreo integral de la base de datos con todas las métricas disponibles.

Sugerencia

Formato del extremo de RDS: su extremo de RDS utiliza el formato: YOUR_DB_INSTANCE.YOUR_AWS_IDENTIFIER.YOUR_REGION.rds.amazonaws.com (por ejemplo, mydb-instance.c9akciq32.us-east-1.rds.amazonaws.com). Ubique esto en la consola de AWS RDS en Conectividad y seguridad.

Cree el archivo de configuración. El nombre del archivo debe ser mssql-config.yaml. Ejecute el siguiente comando en PowerShell como administrador:
```
New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

Agregue el siguiente contenido de configuración al archivo mssql-config.yaml que creó en el paso anterior.

# NRDOT Collector Configuration for New Relic SQL Server Integration
extensions:
  health_check:

receivers:
  otlp:
    protocols:
      grpc:
      http:

  host_metrics:
    collection_interval: 30s
    scrapers:
      cpu:
        metrics:
          system.cpu.time:
            enabled: false
          system.cpu.utilization:
            enabled: true
      load:
      memory:
        metrics:
          system.memory.utilization:
            enabled: true
      paging:
        metrics:
          system.paging.utilization:
            enabled: false
          system.paging.faults:
            enabled: false
      disk:
        metrics:
          system.disk.merged:
            enabled: false
          system.disk.pending_operations:
            enabled: false
          system.disk.weighted_io_time:
            enabled: false
      network:
        metrics:
          system.network.connections:
            enabled: false
      processes:
      process:
        mute_process_name_error: true
        mute_process_exe_error: true
        mute_process_user_error: true
        mute_process_io_error: true
        metrics:
          process.cpu.utilization:
            enabled: true
          process.memory.utilization:
            enabled: true

  nrsqlserver:
    collection_interval: 30s
    username: <YOUR_USERNAME>
    password: <YOUR_PASSWORD>
    server: <YOUR_SERVER>
    port: <YOUR_PORT>

    # Enable comprehensive database metrics
    metrics:
      # Database
      sqlserver.database.count:
        enabled: true
      sqlserver.database.file.size:
        enabled: true 
      sqlserver.database.io:
        enabled: true
      sqlserver.database.latency:
        enabled: true
      sqlserver.database.operations:
        enabled: true
      sqlserver.database.transactions.active:
        enabled: true
      sqlserver.database.backup_or_restore.rate:
        enabled: true
      sqlserver.database.execution.errors:
        enabled: true
      sqlserver.database.full_scan.rate:
        enabled: true
      sqlserver.database.tempdb.space:
        enabled: true
      sqlserver.database.tempdb.version_store.size:
        enabled: true
      # Locks
      sqlserver.lock.timeout.rate:
        enabled: true
      sqlserver.lock.wait.count:
        enabled: true
      sqlserver.deadlock.rate:
        enabled: true
      # Transactions
      sqlserver.transaction.delay:
        enabled: true
      sqlserver.transaction.longest_running_time:
        enabled: true
      sqlserver.transaction.version_cleanup.rate:
        enabled: true
      sqlserver.transaction.version_generation.rate:
        enabled: true
      # Memory
      sqlserver.memory.area:
        enabled: true
      sqlserver.memory.cache.object.count:
        enabled: true
      sqlserver.memory.grants.pending.count:
        enabled: true
      sqlserver.memory.page.count:
        enabled: true
      sqlserver.memory.target:
        enabled: true
      sqlserver.memory.usage:
        enabled: true
      # OS
      sqlserver.os.memory.usage:
        enabled: true
      sqlserver.os.memory.utilization:
        enabled: true
      sqlserver.os.scheduler.runnable_tasks.count:
        enabled: true
      sqlserver.os.wait.duration:
        enabled: true
      sqlserver.os.wait.tasks.count:
        enabled: true
      # Pages / Buffer
      sqlserver.page.buffer_cache.free_list.stalls.rate:
        enabled: true
      sqlserver.page.lookup.rate:
        enabled: true
      # Batch / Compilation
      sqlserver.batch.compilation.utilization:
        enabled: true
      sqlserver.batch.page_split.utilization:
        enabled: true
      sqlserver.recompilation.ratio:
        enabled: true
      sqlserver.parameterization.rate:
        enabled: true
      sqlserver.plan.execution.rate:
        enabled: true
      sqlserver.attention.rate:
        enabled: true
      # Processes / Connections
      sqlserver.process.count:
        enabled: true
      sqlserver.processes.blocked:
        enabled: true
      sqlserver.login.rate:
        enabled: true
      sqlserver.logout.rate:
        enabled: true
      # Thread Pool
      sqlserver.thread_pool.tasks.count:
        enabled: true
      sqlserver.thread_pool.workers.count:
        enabled: true
      sqlserver.thread_pool.workers.max:
        enabled: true
      sqlserver.thread_pool.workers.utilization:
        enabled: true
      # TempDB
      sqlserver.tempdb.allocation.wait_time.total:
        enabled: true
      sqlserver.tempdb.contention.waiters.count:
        enabled: true
      sqlserver.tempdb.data_files.count:
        enabled: true
      sqlserver.tempdb.file.size:
        enabled: true
      sqlserver.tempdb.space.usage:
        enabled: true
      # Latch
      sqlserver.latch.superlatch.count:
        enabled: true
      sqlserver.latch.superlatch.transition.rate:
        enabled: true
      sqlserver.latch.wait.rate:
        enabled: true
      sqlserver.latch.wait_time.avg:
        enabled: true
      sqlserver.latch.wait_time.total:
        enabled: true
      # Index
      sqlserver.index.search.rate:
        enabled: true
      # Resource Pool
      sqlserver.resource_pool.disk.operations:
        enabled: true
      sqlserver.resource_pool.disk.throttled.read.rate:
        enabled: true
      sqlserver.resource_pool.disk.throttled.write.rate:
        enabled: true
      # Replica / Always-On
      sqlserver.replica.data.rate:
        enabled: true
      # Server Properties
      sqlserver.computer.uptime:
        enabled: true
      sqlserver.cpu.count:
        enabled: true
      # Tables
      sqlserver.table.count:
        enabled: true
      # Errors
      sqlserver.kill_connection.error.rate:
        enabled: true
    # Enable top query and query sample log collection
    events:
      db.server.query_sample:
        enabled: true
      db.server.top_query:
        enabled: true
    # Top query collection configuration
    top_query_collection:
      lookback_time: 60s
      max_query_sample_count: 500
      top_query_count: 200
      collection_interval: 60s
    collect_full_query_text: true
    allowed_comment_keys:
      - nr_service_guid
    # Query sample collection configuration
    query_sample_collection:
      max_rows_per_query: 100
processors:
  metrics_transform:
    transforms:
      - include: system.cpu.utilization
        action: update
        operations:
          - action: aggregate_labels
            label_set: [state]
            aggregation_type: mean
      - include: system.paging.operations
        action: update
        operations:
          - action: aggregate_labels
            label_set: [direction]
            aggregation_type: sum
  filter/exclude_cpu_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "interrupt"'
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "nice"'
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "softirq"'
  filter/exclude_memory_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_unreclaimable"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "inactive"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "cached"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "buffered"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_reclaimable"'
  filter/exclude_memory_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.memory.usage" and attributes["state"] == "slab_unreclaimable"'
        - 'metric.name == "system.memory.usage" and attributes["state"] == "inactive"'
  filter/exclude_filesystem_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.utilization" and attributes["type"] == "squashfs"'
  filter/exclude_filesystem_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.usage" and attributes["type"] == "squashfs"'
        - 'metric.name == "system.filesystem.usage" and attributes["state"] == "reserved"'
  filter/exclude_filesystem_inodes_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.inodes.usage" and attributes["type"] == "squashfs"'
        - 'metric.name == "system.filesystem.inodes.usage" and attributes["state"] == "reserved"'
  filter/exclude_system_disk:
    metrics:
      datapoint:
        - 'metric.name == "system.disk.operations" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.merged" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.io" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.io_time" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.operation_time" and IsMatch(attributes["device"], "^loop.*") == true'
  filter/exclude_system_paging:
    metrics:
      datapoint:
        - 'metric.name == "system.paging.usage" and attributes["state"] == "cached"'
        - 'metric.name == "system.paging.operations" and attributes["type"] == "cached"'
  filter/exclude_network:
    metrics:
      datapoint:
        - 'IsMatch(metric.name, "^system.network.*") == true and attributes["device"] == "lo"'
  attributes/exclude_system_paging:
    include:
      match_type: strict
      metric_names:
        - system.paging.operations
    actions:
      - key: type
        action: delete
  cumulativetodelta:
  transform/host:
    metric_statements:
      - context: metric
        statements:
          - set(metric.description, "")
          - set(metric.unit, "")
  batch:
  resource_detection:
    detectors: ["system"]
    system:
      hostname_sources: ["os"]
      resource_attributes:
        host.id:
          enabled: true
  resource_detection/cloud:
    detectors: ["gcp", "ec2", "azure"]
    timeout: 2s
    override: true
  resource_detection/env:
    detectors: ["env"]
    timeout: 2s
    override: true
exporters:
  otlphttp:
    endpoint: <YOUR_OTLP_ENDPOINT>
    headers:
      api-key: <YOUR_LICENSE_KEY>
    tls:
      insecure: false
    compression: gzip
service:
  telemetry:
    metrics:
      level: none
  extensions: [health_check]
  pipelines:
    metrics/host:
      receivers: [host_metrics, nrsqlserver]
      processors:
        - metrics_transform
        - filter/exclude_cpu_utilization
        - filter/exclude_memory_utilization
        - filter/exclude_memory_usage
        - filter/exclude_filesystem_utilization
        - filter/exclude_filesystem_usage
        - filter/exclude_filesystem_inodes_usage
        - filter/exclude_system_disk
        - filter/exclude_network
        - attributes/exclude_system_paging
        - transform/host
        - resource_detection
        - resource_detection/cloud
        - resource_detection/env
        - cumulativetodelta
        - batch
      exporters: [otlphttp]
    logs/host:
      receivers: [nrsqlserver]
      processors:
        - resource_detection
        - resource_detection/cloud
        - resource_detection/env
        - batch
      exporters: [otlphttp]
    traces:
      receivers: [otlp]
      processors: [resource_detection, resource_detection/cloud, resource_detection/env, batch]
      exporters: [otlphttp]
    metrics:
      receivers: [otlp]
      processors: [resource_detection, resource_detection/cloud, resource_detection/env, batch]
      exporters: [otlphttp]
    logs:
      receivers: [otlp]
      processors: [resource_detection, resource_detection/cloud, resource_detection/env, batch]
      exporters: [otlphttp]

Parámetro de configuración

La siguiente tabla describe los parámetros de configuración clave para el receptor nrsqlserver:

Parámetro	Descripción
`<YOUR_USERNAME>`	Ingrese su nombre de usuario de la base de datos para la autenticación
`<YOUR_PASSWORD>`	Ingrese su contraseña de la base de datos para la autenticación
`<YOUR_SERVER>`	Ingrese el nombre de host o la dirección IP de SQL Server
`<YOUR_PORT>`	Ingrese el número de puerto de SQL Server. El valor predeterminado es 1433.
`<YOUR_OTLP_ENDPOINT>`	Ingrese el endpoint OTLP de New Relic. Para obtener más información, consulta la documentación de los endpoints OTLP de New Relic.
`<YOUR_LICENSE_KEY>`	Ingresa tu clave de licencia de New Relic.
`collection_interval`	Intervalo en segundos para recopilar métricas de base de datos. Predeterminado: 15s

Sugerencia

Nota: La opción max_concurrent_queries controla cuántas consultas de métricas ejecuta el receptor en paralelo contra SQL Server durante cada ciclo de recopilación.

receivers:
  nrsqlserver:
    max_concurrent_queries: 4  # default is 4 if omitted or set to 0

Sugerencia

Nota: si habilita todas las métricas disponibles, aumente el valor de limit_mib (por ejemplo, 1000) para evitar que el limitador de memoria descarte datos.

Actualizar el registro del servicio de Windows

Actualice el registro de servicios de Windows para usar el nuevo archivo mssql-config.yaml.

Método 1: PowerShell

Ejecute el siguiente comando en PowerShell como administrador:

Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Services\nrdot-collector" -Name "ImagePath" -Value '"C:\Program Files\nrdot-collector\nrdot-collector.exe" --config "C:\Program Files\nrdot-collector\mssql-config.yaml"'

Método 2: símbolo del sistema (alternativo)

Si PowerShell no está disponible, puede usar el símbolo del sistema en su lugar:

Abra el menú Inicio, escriba cmd
Haz clic derecho en el símbolo del sistema y elige Run as administrator
Copie y pegue este comando exacto en la ventana negra de CMD y presione Enter:

sc config "nrdot-collector" binPath= "\"C:\Program Files\nrdot-collector\nrdot-collector.exe\" --config \"C:\Program Files\nrdot-collector\mssql-config.yaml\""

Validar la configuración del NRDOT Collector

Valide la configuración del NRDOT Collector para asegurarse de que tenga el formato correcto y funcione correctamente.

& "C:\Program Files\nrdot-collector\nrdot-collector.exe" validate --config="C:\Program Files\nrdot-collector\mssql-config.yaml"

Reiniciar el colector NRDOT

Después de actualizar la configuración, reinicie el servicio NRDOT Collector en su máquina EC2 o Windows local:

net stop nrdot-collector
net start nrdot-collector

Sugerencia

Siempre reinicie el servicio de recopilador NRDOT después de realizar cambios de configuración para garantizar que los nuevos ajustes surtan efecto.

(Opcional) Configurar la correlación de APM y base de datos

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. Esta función le permite ver exactamente qué aplicaciones están generando workloads de base de datos específicas. Para obtener más información, consulte configurar la identificación de servicios de base de datos para obtener la correlación entre APM y la base de datos en New Relic.

Importante

Para ver los datos de rendimiento de la base de datos en APM, ambas entidades deben estar en la misma cuenta de New Relic. Si las entidades están en diferentes cuentas de New Relic, debe tener acceso a ambas cuentas para ver los datos.

(Opcional) Configurar la gestión de secretos

La función de gestión de secretos le permite administrar de forma segura información confidencial, como las credenciales de bases de datos. Esto ayuda a mejorar la seguridad de su configuración de monitoreo al evitar la codificación rígida de datos sensibles en los archivos de configuración. Para obtener más información, consulta gestión de secretos.

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:

Vaya a https://one.newrelic.com > All Capabilities > Databases.
En el menú desplegable Entity type, seleccione MSSQL instance y luego haga clic en Apply.
Seleccione su base de datos SQL Server de la lista de entidades.

Requisitos previos

Asegúrese de que su entorno cumpla con nuestra compatibilidad y requisitos previos.

Requisitos adicionales para la autenticación de dominio de Windows con RDS:

Entorno de dominio de Windows con Active Directory
Instancia EC2 de Windows unida al dominio o máquina local
RDS SQL Server configurado para aceptar la autenticación de Windows
Cuenta de usuario de dominio con los permisos apropiados de SQL Server
Grupo de seguridad configurado para permitir conexiones en el puerto de SQL Server (predeterminado 1433)

Habilite su servidor Microsoft SQL

Conéctese a su instancia de RDS SQL Server usando SQL Server Management Studio (SSMS) o sqlcmd con sus credenciales de administrador.

Ejecute el siguiente script para crear un inicio de sesión de dominio de Windows y otorgar los permisos necesarios:

USE master;
CREATE LOGIN [DomainName\DomainUser] FROM WINDOWS;
GRANT VIEW ANY DATABASE   TO [DomainName\DomainUser];
GRANT VIEW SERVER STATE TO [DomainName\DomainUser];
GRANT VIEW ANY DEFINITION TO [DomainName\DomainUser];
GO

Importante

Reemplace DomainName\DomainUser con su dominio y nombre de usuario reales (por ejemplo, CORP\SQLMonitor).

Otorgar privilegios de acceso de LECTURA

Utilice las siguientes sentencias para otorgar privilegios de acceso de LECTURA al usuario de dominio en todas las bases de datos:

-- Grant access to all databases (required for query monitoring and tempdb metrics)
  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;
  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 = ''DomainName\DomainUser'')
      BEGIN
        CREATE USER [DomainName\DomainUser] FOR LOGIN [DomainName\DomainUser];
      END;
      GRANT VIEW DATABASE STATE TO [DomainName\DomainUser];');
    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

Sugerencia

Para RDS: El script excluye automáticamente la base de datos rdsadmin que está reservada por AWS. Asegúrese de reemplazar DomainName\DomainUser con sus credenciales de dominio reales.

Configurar el NRDOT Collector

Instale el Collector de NRDOT en una instancia EC2 de Windows unida al dominio o en una máquina local de Windows que sea parte del mismo dominio y pueda conectarse a su instancia de RDS SQL Server.

Importante

Para el monitoreo de RDS, instale el Collector NRDOT en una instancia EC2 en la misma VPC que su instancia de RDS para obtener una conectividad de red óptima y una menor latencia.

Descarga e instala el NRDOT Collector usando PowerShell:

[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $NRDOT_VERSION = (Invoke-RestMethod -Uri "https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest").tag_name; $WebClient = New-Object System.Net.WebClient; $WebClient.Headers.Add("User-Agent", "Mozilla/5.0"); $WebClient.DownloadFile("https://github.com/newrelic/nrdot-collector-releases/releases/download/$NRDOT_VERSION/nrdot-collector_${NRDOT_VERSION}_windows_x64.msi", "$env:TEMP\nrdot-collector.msi"); Start-Process msiexec.exe -ArgumentList "/i `"$env:TEMP\nrdot-collector.msi`" /qn /norestart /L*V `"$env:TEMP\nrdot_install.log`"" -Wait; Get-Service nrdot-collector -ErrorAction SilentlyContinue

Cambiar el inicio de sesión del servicio a la cuenta de dominio (usando PowerShell):
Configure el servicio NRDOT Collector para que se ejecute como su usuario de dominio usando PowerShell:
```
# Configure service to use domain account
# The space after obj= and password= is required syntax for sc.exe
sc.exe config "nrdot-collector" obj= "DomainName\DomainUser" password= "<password>"

# Restart the service
Restart-Service nrdot-collector
```
Verifique la identidad del servicio:
```
Get-WmiObject Win32_Service -Filter "Name='nrdot-collector'" | Select Name, State, StartName
# Expected: StartName = DomainName\DomainUser
```
Importante
Reemplace DomainName\DomainUser con su dominio y nombre de usuario reales (por ejemplo, CORP\SQLMonitor), y <password> con la contraseña del usuario del dominio.
Asegúrese de que su grupo de seguridad permita conexiones entrantes desde el host del Collector de NRDOT a su instancia de RDS en el puerto 1433 (o su puerto personalizado).

Configurar el Colector NRDOT

Seleccione su tipo de configuración según sus necesidades de monitoreo:

Esta configuración se centra en el monitoreo esencial de la base de datos con métricas principales.

Sugerencia

Formato del extremo de RDS: su extremo de RDS tendrá el formato: your-db-instance.xxxxxxxxxxxx.region.rds.amazonaws.com. Encuentre esto en su consola de AWS RDS en "Conectividad y seguridad".

Importante

La autenticación de dominio de Windows utiliza seguridad integrada (autenticación de Windows), que utiliza el mismo enfoque de configuración que la autenticación gMSA. Simplemente actualice el valor del servidor datasource a su extremo de RDS. El servicio NRDOT se autenticará utilizando la cuenta de dominio que configuró en el paso 3.

Cree el archivo de configuración. El nombre del archivo debe ser mssql-config.yaml. Ejecute el siguiente comando en PowerShell como administrador:
```
New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```
Agregue el contenido de configuración a continuación al archivo mssql-config.yaml que creó en el paso anterior.
Use la configuración a continuación con su extremo de RDS:

# NRDOT Collector Configuration for RDS SQL Server - Windows Domain Auth
# NRDOT Collector Configuration for SQL Server with gMSA Authentication


receivers:
  nrsqlserver:
    collection_interval: 15s
    datasource: "server=<YOUR_RDS_ENDPOINT>;port=<YOUR_PORT>;integrated security=true;encrypt=true;TrustServerCertificate=true;"

    # Enable comprehensive database metrics
    metrics:
      sqlserver.database.count:
        enabled: true
      sqlserver.database.io:
        enabled: true
      sqlserver.database.latency:
        enabled: true
      sqlserver.database.operations:
        enabled: true
      sqlserver.database.tempdb.space:
        enabled: true
      sqlserver.database.tempdb.version_store.size:
        enabled: true
      sqlserver.deadlock.rate:
        enabled: true
      sqlserver.os.wait.duration:
        enabled: true
      sqlserver.processes.blocked:
        enabled: true
      sqlserver.memory.grants.pending.count:
        enabled: true
      sqlserver.database.file.size:
        enabled: true
      sqlserver.memory.area:
        enabled: true

    # Enable top query and query sample log collection
    events:
      db.server.query_sample:
        enabled: true
      db.server.top_query:
        enabled: true

    # Top query collection configuration
    top_query_collection:
      lookback_time: 60s
      max_query_sample_count: 1000
      top_query_count: 250
      collection_interval: 60s

    collect_full_query_text: true
    allowed_comment_keys:
      - nr_service_guid

    # Query sample collection configuration
    query_sample_collection:
      max_rows_per_query: 100

processors:
  memory_limiter:
    check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
    limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-200}
    spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}

  batch:

exporters:
  otlphttp:
    endpoint: <YOUR_OTLP_ENDPOINT>
    headers:
      api-key: <YOUR_LICENSE_KEY>
    tls:
      insecure: false
    compression: gzip

service:
  telemetry:
    metrics:
      level: none

  pipelines:
    metrics:
      receivers: [nrsqlserver]
      processors: [memory_limiter, batch]
      exporters: [otlphttp]

    logs:
      receivers: [nrsqlserver]
      processors: [memory_limiter, batch]
      exporters: [otlphttp]

Sugerencia

Nota: La opción max_concurrent_queries controla cuántas consultas de métricas ejecuta el receptor en paralelo contra SQL Server durante cada ciclo de recopilación.

receivers:
  nrsqlserver:
    max_concurrent_queries: 4  # default is 4 if omitted or set to 0

Sugerencia

Nota: si habilita todas las métricas disponibles, aumente el valor de limit_mib (por ejemplo, 1000) para evitar que el limitador de memoria descarte datos.

Esta configuración proporciona un monitoreo integral de la base de datos con todas las métricas disponibles.

Sugerencia

Cree el archivo de configuración. El nombre del archivo debe ser mssql-config.yaml. Ejecute el siguiente comando en PowerShell como administrador:
```
New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

Agregue el contenido de configuración a continuación al archivo mssql-config.yaml que creó en el paso anterior.

# NRDOT Collector Configuration for New Relic SQL Server Integration
extensions:
  health_check:

receivers:
  otlp:
    protocols:
      grpc:
      http:

  host_metrics:
    collection_interval: 30s
    scrapers:
      cpu:
        metrics:
          system.cpu.time:
            enabled: false
          system.cpu.utilization:
            enabled: true
      load:
      memory:
        metrics:
          system.memory.utilization:
            enabled: true
      paging:
        metrics:
          system.paging.utilization:
            enabled: false
          system.paging.faults:
            enabled: false
      disk:
        metrics:
          system.disk.merged:
            enabled: false
          system.disk.pending_operations:
            enabled: false
          system.disk.weighted_io_time:
            enabled: false
      network:
        metrics:
          system.network.connections:
            enabled: false
      processes:
      process:
        mute_process_name_error: true
        mute_process_exe_error: true
        mute_process_user_error: true
        mute_process_io_error: true
        metrics:
          process.cpu.utilization:
            enabled: true
          process.memory.utilization:
            enabled: true

  nrsqlserver:
    collection_interval: 30s
    datasource: "server=<YOUR_RDS_ENDPOINT>;port=<YOUR_PORT>;integrated security=true;encrypt=true;TrustServerCertificate=true;"

    # Enable comprehensive database metrics
    metrics:
      # Database
      sqlserver.database.count:
        enabled: true
      sqlserver.database.file.size:
        enabled: true 
      sqlserver.database.io:
        enabled: true
      sqlserver.database.latency:
        enabled: true
      sqlserver.database.operations:
        enabled: true
      sqlserver.database.transactions.active:
        enabled: true
      sqlserver.database.backup_or_restore.rate:
        enabled: true
      sqlserver.database.execution.errors:
        enabled: true
      sqlserver.database.full_scan.rate:
        enabled: true
      sqlserver.database.tempdb.space:
        enabled: true
      sqlserver.database.tempdb.version_store.size:
        enabled: true
      # Locks
      sqlserver.lock.timeout.rate:
        enabled: true
      sqlserver.lock.wait.count:
        enabled: true
      sqlserver.deadlock.rate:
        enabled: true
      # Transactions
      sqlserver.transaction.delay:
        enabled: true
      sqlserver.transaction.longest_running_time:
        enabled: true
      sqlserver.transaction.version_cleanup.rate:
        enabled: true
      sqlserver.transaction.version_generation.rate:
        enabled: true
      # Memory
      sqlserver.memory.area:
        enabled: true
      sqlserver.memory.cache.object.count:
        enabled: true
      sqlserver.memory.grants.pending.count:
        enabled: true
      sqlserver.memory.page.count:
        enabled: true
      sqlserver.memory.target:
        enabled: true
      sqlserver.memory.usage:
        enabled: true
      # OS
      sqlserver.os.memory.usage:
        enabled: true
      sqlserver.os.memory.utilization:
        enabled: true
      sqlserver.os.scheduler.runnable_tasks.count:
        enabled: true
      sqlserver.os.wait.duration:
        enabled: true
      sqlserver.os.wait.tasks.count:
        enabled: true
      # Pages / Buffer
      sqlserver.page.buffer_cache.free_list.stalls.rate:
        enabled: true
      sqlserver.page.lookup.rate:
        enabled: true
      # Batch / Compilation
      sqlserver.batch.compilation.utilization:
        enabled: true
      sqlserver.batch.page_split.utilization:
        enabled: true
      sqlserver.recompilation.ratio:
        enabled: true
      sqlserver.parameterization.rate:
        enabled: true
      sqlserver.plan.execution.rate:
        enabled: true
      sqlserver.attention.rate:
        enabled: true
      # Processes / Connections
      sqlserver.process.count:
        enabled: true
      sqlserver.processes.blocked:
        enabled: true
      sqlserver.login.rate:
        enabled: true
      sqlserver.logout.rate:
        enabled: true
      # Thread Pool
      sqlserver.thread_pool.tasks.count:
        enabled: true
      sqlserver.thread_pool.workers.count:
        enabled: true
      sqlserver.thread_pool.workers.max:
        enabled: true
      sqlserver.thread_pool.workers.utilization:
        enabled: true
      # TempDB
      sqlserver.tempdb.allocation.wait_time.total:
        enabled: true
      sqlserver.tempdb.contention.waiters.count:
        enabled: true
      sqlserver.tempdb.data_files.count:
        enabled: true
      sqlserver.tempdb.file.size:
        enabled: true
      sqlserver.tempdb.space.usage:
        enabled: true
      # Latch
      sqlserver.latch.superlatch.count:
        enabled: true
      sqlserver.latch.superlatch.transition.rate:
        enabled: true
      sqlserver.latch.wait.rate:
        enabled: true
      sqlserver.latch.wait_time.avg:
        enabled: true
      sqlserver.latch.wait_time.total:
        enabled: true
      # Index
      sqlserver.index.search.rate:
        enabled: true
      # Resource Pool
      sqlserver.resource_pool.disk.operations:
        enabled: true
      sqlserver.resource_pool.disk.throttled.read.rate:
        enabled: true
      sqlserver.resource_pool.disk.throttled.write.rate:
        enabled: true
      # Replica / Always-On
      sqlserver.replica.data.rate:
        enabled: true
      # Server Properties
      sqlserver.computer.uptime:
        enabled: true
      sqlserver.cpu.count:
        enabled: true
      # Tables
      sqlserver.table.count:
        enabled: true
      # Errors
      sqlserver.kill_connection.error.rate:
        enabled: true
    # Enable top query and query sample log collection
    events:
      db.server.query_sample:
        enabled: true
      db.server.top_query:
        enabled: true
    # Top query collection configuration
    top_query_collection:
      lookback_time: 60s
      max_query_sample_count: 500
      top_query_count: 200
      collection_interval: 60s
    collect_full_query_text: true
    allowed_comment_keys:
      - nr_service_guid
    # Query sample collection configuration
    query_sample_collection:
      max_rows_per_query: 100
processors:
  metrics_transform:
    transforms:
      - include: system.cpu.utilization
        action: update
        operations:
          - action: aggregate_labels
            label_set: [state]
            aggregation_type: mean
      - include: system.paging.operations
        action: update
        operations:
          - action: aggregate_labels
            label_set: [direction]
            aggregation_type: sum
  filter/exclude_cpu_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "interrupt"'
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "nice"'
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "softirq"'
  filter/exclude_memory_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_unreclaimable"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "inactive"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "cached"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "buffered"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_reclaimable"'
  filter/exclude_memory_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.memory.usage" and attributes["state"] == "slab_unreclaimable"'
        - 'metric.name == "system.memory.usage" and attributes["state"] == "inactive"'
  filter/exclude_filesystem_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.utilization" and attributes["type"] == "squashfs"'
  filter/exclude_filesystem_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.usage" and attributes["type"] == "squashfs"'
        - 'metric.name == "system.filesystem.usage" and attributes["state"] == "reserved"'
  filter/exclude_filesystem_inodes_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.inodes.usage" and attributes["type"] == "squashfs"'
        - 'metric.name == "system.filesystem.inodes.usage" and attributes["state"] == "reserved"'
  filter/exclude_system_disk:
    metrics:
      datapoint:
        - 'metric.name == "system.disk.operations" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.merged" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.io" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.io_time" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.operation_time" and IsMatch(attributes["device"], "^loop.*") == true'
  filter/exclude_system_paging:
    metrics:
      datapoint:
        - 'metric.name == "system.paging.usage" and attributes["state"] == "cached"'
        - 'metric.name == "system.paging.operations" and attributes["type"] == "cached"'
  filter/exclude_network:
    metrics:
      datapoint:
        - 'IsMatch(metric.name, "^system.network.*") == true and attributes["device"] == "lo"'
  attributes/exclude_system_paging:
    include:
      match_type: strict
      metric_names:
        - system.paging.operations
    actions:
      - key: type
        action: delete
  cumulativetodelta:
  transform/host:
    metric_statements:
      - context: metric
        statements:
          - set(metric.description, "")
          - set(metric.unit, "")
  batch:
  resource_detection:
    detectors: ["system"]
    system:
      hostname_sources: ["os"]
      resource_attributes:
        host.id:
          enabled: true
  resource_detection/cloud:
    detectors: ["gcp", "ec2", "azure"]
    timeout: 2s
    override: true
  resource_detection/env:
    detectors: ["env"]
    timeout: 2s
    override: true
exporters:
  otlphttp:
    endpoint: <YOUR_OTLP_ENDPOINT>
    headers:
      api-key: <YOUR_LICENSE_KEY>
    tls:
      insecure: false
    compression: gzip
service:
  telemetry:
    metrics:
      level: none
  extensions: [health_check]
  pipelines:
    metrics/host:
      receivers: [host_metrics, nrsqlserver]
      processors:
        - metrics_transform
        - filter/exclude_cpu_utilization
        - filter/exclude_memory_utilization
        - filter/exclude_memory_usage
        - filter/exclude_filesystem_utilization
        - filter/exclude_filesystem_usage
        - filter/exclude_filesystem_inodes_usage
        - filter/exclude_system_disk
        - filter/exclude_network
        - attributes/exclude_system_paging
        - transform/host
        - resource_detection
        - resource_detection/cloud
        - resource_detection/env
        - cumulativetodelta
        - batch
      exporters: [otlphttp]
    logs/host:
      receivers: [nrsqlserver]
      processors:
        - resource_detection
        - resource_detection/cloud
        - resource_detection/env
        - batch
      exporters: [otlphttp]
    traces:
      receivers: [otlp]
      processors: [resource_detection, resource_detection/cloud, resource_detection/env, batch]
      exporters: [otlphttp]
    metrics:
      receivers: [otlp]
      processors: [resource_detection, resource_detection/cloud, resource_detection/env, batch]
      exporters: [otlphttp]
    logs:
      receivers: [otlp]
      processors: [resource_detection, resource_detection/cloud, resource_detection/env, batch]
      exporters: [otlphttp]

Parámetro de configuración

La siguiente tabla describe los parámetros de configuración clave para el receptor nrsqlserver:

Parámetro	Descripción
`<YOUR_RDS_ENDPOINT>`	Ingrese su extremo de RDS SQL Server
`<YOUR_PORT>`	Ingrese el número de puerto de SQL Server. El valor predeterminado es 1433.
`<YOUR_OTLP_ENDPOINT>`	Ingrese el extremo OTLP de New Relic (por ejemplo, https://otlp.nr-data.net). Para obtener más información, consulta la documentación de los endpoints OTLP de New Relic.
`<YOUR_LICENSE_KEY>`	Ingresa tu clave de licencia de New Relic.
`collection_interval`	Intervalo en segundos para recopilar métricas de base de datos. Predeterminado: 15s

Actualizar el registro del servicio de Windows

Actualice el registro de servicios de Windows para usar el nuevo archivo mssql-config.yaml.

Método 1: PowerShell

Ejecute el siguiente comando en PowerShell como administrador:

Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Services\nrdot-collector" -Name "ImagePath" -Value '"C:\Program Files\nrdot-collector\nrdot-collector.exe" --config "C:\Program Files\nrdot-collector\mssql-config.yaml"'

Método 2: símbolo del sistema (alternativo)

Si PowerShell no está disponible, puede usar el símbolo del sistema en su lugar:

Abra el menú Inicio, escriba cmd
Haz clic derecho en el símbolo del sistema y elige Run as administrator
Copie y pegue este comando exacto en la ventana negra de CMD y presione Enter:

sc config "nrdot-collector" binPath= "\"C:\Program Files\nrdot-collector\nrdot-collector.exe\" --config \"C:\Program Files\nrdot-collector\mssql-config.yaml\""

Validar la configuración del NRDOT Collector

Valide la configuración del NRDOT Collector para asegurarse de que tenga el formato correcto y funcione correctamente.

& "C:\Program Files\nrdot-collector\nrdot-collector.exe" validate --config="C:\Program Files\nrdot-collector\mssql-config.yaml"

Reiniciar el colector NRDOT

Después de actualizar la configuración, reinicie el servicio NRDOT Collector en su instancia de Windows EC2 unida al dominio:

net stop nrdot-collector
net start nrdot-collector

Sugerencia

Verifique que el servicio se esté ejecutando bajo la cuenta de dominio comprobando los Servicios de Windows (services.msc). La columna "Iniciar sesión como" debería mostrar su cuenta de dominio (por ejemplo, CORP\SQLMonitor).

(Opcional) Configurar la correlación de APM y base de datos

Importante

(Opcional) Configurar la gestión de secretos

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:

Vaya a https://one.newrelic.com > All Capabilities > Databases.
En el menú desplegable Entity type, seleccione MSSQL instance y luego haga clic en Apply.
Seleccione su base de datos SQL Server de la lista de entidades.

Requisitos previos

Asegúrese de que su entorno cumpla con nuestra compatibilidad y requisitos previos.

Requisitos adicionales para gMSA (cuenta de servicio administrada de grupo) con RDS:

Entorno de Active Directory con soporte para gMSA
Cuenta gMSA creada y configurada para el acceso a SQL Server
Instancia EC2 de Windows unida al dominio autorizada para usar la cuenta gMSA
Grupo de seguridad configurado para permitir conexiones en el puerto de SQL Server (predeterminado 1433)

Habilite su servidor Microsoft SQL

Conéctese a su instancia de RDS SQL Server y ejecute los siguientes comandos SQL para crear un inicio de sesión para la cuenta gMSA y otorgar los permisos necesarios:

USE master;
  CREATE LOGIN [DomainName\gMSA] FROM WINDOWS;
  GRANT VIEW ANY DATABASE TO [DomainName\gMSA];
  GRANT VIEW SERVER STATE TO [DomainName\gMSA];
  GRANT VIEW ANY DEFINITION TO [DomainName\gMSA];

Importante

Reemplace DomainName\gMSA con su nombre de dominio real y el nombre de la cuenta gMSA (por ejemplo, CORP\SQL-gMSA$). Tenga en cuenta que las cuentas gMSA generalmente terminan con un símbolo $.

Otorgar privilegios de acceso de LECTURA

Use las siguientes sentencias para otorgar privilegios de acceso de LECTURA a la cuenta gMSA en todas las bases de datos:

-- Grant access to all databases (required for query monitoring and tempdb metrics)
  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;
  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 = ''<DOMAIN>\<gMSA_NAME>$'')
      BEGIN
        CREATE USER [<DOMAIN>\<gMSA_NAME>$] FOR LOGIN [<DOMAIN>\<gMSA_NAME>$];
      END;
      GRANT VIEW DATABASE STATE TO [<DOMAIN>\<gMSA_NAME>$];');
    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

Importante

Reemplace DomainName\gMSA con su nombre de dominio real y el nombre de la cuenta gMSA (por ejemplo, CORP\SQL-gMSA$). Este script crea un usuario de base de datos para la cuenta gMSA en todas las bases de datos de usuario, excluyendo las bases de datos del sistema y las bases de datos específicas de RDS.

Configurar el NRDOT Collector

Instale el Collector de NRDOT en una instancia EC2 de Windows que esté unida al dominio y autorizada para usar la cuenta gMSA.

Importante

Para RDS con gMSA, el NRDOT Collector debe instalarse en una instancia EC2 de Windows unida al dominio que tenga permisos para usar la cuenta gMSA. Asegúrese de que su grupo de seguridad permita conexiones a RDS en el puerto 1433.

Descarga e instala el NRDOT Collector usando PowerShell:

[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $NRDOT_VERSION = (Invoke-RestMethod -Uri "https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest").tag_name; $WebClient = New-Object System.Net.WebClient; $WebClient.Headers.Add("User-Agent", "Mozilla/5.0"); $WebClient.DownloadFile("https://github.com/newrelic/nrdot-collector-releases/releases/download/$NRDOT_VERSION/nrdot-collector_${NRDOT_VERSION}_windows_x64.msi", "$env:TEMP\nrdot-collector.msi"); Start-Process msiexec.exe -ArgumentList "/i `"$env:TEMP\nrdot-collector.msi`" /qn /norestart /L*V `"$env:TEMP\nrdot_install.log`"" -Wait; Get-Service nrdot-collector -ErrorAction SilentlyContinue

Configurar el servicio NRDOT Collector para ejecutarse como gMSA

Después de instalar el Collector NRDOT, configure el servicio para que se ejecute como su cuenta gMSA mediante PowerShell:

# Stop the NRDOT Collector service
Stop-Service nrdot-collector

# Configure service to use gMSA account
# Use cmd /c to avoid PowerShell treating $ as a variable
cmd /c 'sc config nrdot-collector obj= "DomainName\gMSA" password= ""'

# Verify the configuration
Get-WmiObject Win32_Service -Filter "Name='nrdot-collector'" | Select Name, StartName

# Start the NRDOT Collector service 
Start-Service nrdot-collector

Importante

Reemplace DomainName\gMSA con su dominio real y nombre de cuenta gMSA (por ejemplo, CORP\SQL-gMSA$). Tenga en cuenta la contraseña vacía — las cuentas gMSA no requieren contraseñas.

Configurar el Colector NRDOT

Seleccione su tipo de configuración según sus necesidades de monitoreo:

Esta configuración se centra en el monitoreo esencial de la base de datos con métricas principales.

Sugerencia

Formato del extremo de RDS: su extremo de RDS tendrá el formato: your-db-instance.xxxxxxxxxxxx.region.rds.amazonaws.com. Encuentre esto en su consola de AWS RDS en "Conectividad y seguridad".

Importante

La configuración utiliza la seguridad integrada de Windows (gMSA). Simplemente actualice el valor del servidor datasource a su extremo de RDS.

Cree el archivo de configuración. El nombre del archivo debe ser mssql-config.yaml. Ejecute el siguiente comando en PowerShell como administrador:
```
New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

Agregue el contenido de configuración a continuación al archivo mssql-config.yaml que creó en el paso anterior.

Use la configuración a continuación con su extremo de RDS:

receivers:
  nrsqlserver:
    collection_interval: 15s
    datasource: "server=<YOUR_RDS_ENDPOINT>;port=<YOUR_PORT>;integrated security=true;encrypt=true;TrustServerCertificate=true;"

    # Enable comprehensive database metrics
    metrics:
      sqlserver.database.count:
        enabled: true
      sqlserver.database.io:
        enabled: true
      sqlserver.database.latency:
        enabled: true
      sqlserver.database.operations:
        enabled: true
      sqlserver.database.tempdb.space:
        enabled: true
      sqlserver.database.tempdb.version_store.size:
        enabled: true
      sqlserver.deadlock.rate:
        enabled: true
      sqlserver.os.wait.duration:
        enabled: true
      sqlserver.processes.blocked:
        enabled: true
      sqlserver.memory.grants.pending.count:
        enabled: true
      sqlserver.database.file.size:
        enabled: true
      sqlserver.memory.area:
        enabled: true

    # Enable top query and query sample log collection
    events:
      db.server.query_sample:
        enabled: true
      db.server.top_query:
        enabled: true

    # Top query collection configuration
    top_query_collection:
      lookback_time: 60s
      max_query_sample_count: 1000
      top_query_count: 250
      collection_interval: 60s

    collect_full_query_text: true
    allowed_comment_keys:
      - nr_service_guid

    # Query sample collection configuration
    query_sample_collection:
      max_rows_per_query: 100

processors:
  memory_limiter:
    check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
    limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-200}
    spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}

  batch:

exporters:
  otlphttp:
    endpoint: <YOUR_OTLP_ENDPOINT>
    headers:
      api-key: <YOUR_LICENSE_KEY>
    tls:
      insecure: false
    compression: gzip

service:
  telemetry:
    metrics:
      level: none

  pipelines:
    metrics:
      receivers: [nrsqlserver]
      processors: [memory_limiter, batch]
      exporters: [otlphttp]

    logs:
      receivers: [nrsqlserver]
      processors: [memory_limiter, batch]
      exporters: [otlphttp]

Ejemplo con el extremo de RDS: server=mydb-instance.c9akciq32.us-east-1.rds.amazonaws.com

Esta configuración proporciona un monitoreo integral de la base de datos con todas las métricas disponibles.

Sugerencia

Cree el archivo de configuración. El nombre del archivo debe ser mssql-config.yaml. Ejecute el siguiente comando en PowerShell como administrador:
```
New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

Agregue el siguiente contenido de configuración al archivo mssql-config.yaml que creó en el paso anterior.

# NRDOT Collector Configuration for New Relic SQL Server Integration
extensions:
  health_check:

receivers:
  otlp:
    protocols:
      grpc:
      http:

  host_metrics:
    collection_interval: 30s
    scrapers:
      cpu:
        metrics:
          system.cpu.time:
            enabled: false
          system.cpu.utilization:
            enabled: true
      load:
      memory:
        metrics:
          system.memory.utilization:
            enabled: true
      paging:
        metrics:
          system.paging.utilization:
            enabled: false
          system.paging.faults:
            enabled: false
      disk:
        metrics:
          system.disk.merged:
            enabled: false
          system.disk.pending_operations:
            enabled: false
          system.disk.weighted_io_time:
            enabled: false
      network:
        metrics:
          system.network.connections:
            enabled: false
      processes:
      process:
        mute_process_name_error: true
        mute_process_exe_error: true
        mute_process_user_error: true
        mute_process_io_error: true
        metrics:
          process.cpu.utilization:
            enabled: true
          process.memory.utilization:
            enabled: true

  nrsqlserver:
    collection_interval: 30s
    datasource: "server=<YOUR_RDS_ENDPOINT>;port=<YOUR_PORT>;integrated security=true;encrypt=true;TrustServerCertificate=true;"

    # Enable comprehensive database metrics
    metrics:
      # Database
      sqlserver.database.count:
        enabled: true
      sqlserver.database.file.size:
        enabled: true 
      sqlserver.database.io:
        enabled: true
      sqlserver.database.latency:
        enabled: true
      sqlserver.database.operations:
        enabled: true
      sqlserver.database.transactions.active:
        enabled: true
      sqlserver.database.backup_or_restore.rate:
        enabled: true
      sqlserver.database.execution.errors:
        enabled: true
      sqlserver.database.full_scan.rate:
        enabled: true
      sqlserver.database.tempdb.space:
        enabled: true
      sqlserver.database.tempdb.version_store.size:
        enabled: true
      # Locks
      sqlserver.lock.timeout.rate:
        enabled: true
      sqlserver.lock.wait.count:
        enabled: true
      sqlserver.deadlock.rate:
        enabled: true
      # Transactions
      sqlserver.transaction.delay:
        enabled: true
      sqlserver.transaction.longest_running_time:
        enabled: true
      sqlserver.transaction.version_cleanup.rate:
        enabled: true
      sqlserver.transaction.version_generation.rate:
        enabled: true
      # Memory
      sqlserver.memory.area:
        enabled: true
      sqlserver.memory.cache.object.count:
        enabled: true
      sqlserver.memory.grants.pending.count:
        enabled: true
      sqlserver.memory.page.count:
        enabled: true
      sqlserver.memory.target:
        enabled: true
      sqlserver.memory.usage:
        enabled: true
      # OS
      sqlserver.os.memory.usage:
        enabled: true
      sqlserver.os.memory.utilization:
        enabled: true
      sqlserver.os.scheduler.runnable_tasks.count:
        enabled: true
      sqlserver.os.wait.duration:
        enabled: true
      sqlserver.os.wait.tasks.count:
        enabled: true
      # Pages / Buffer
      sqlserver.page.buffer_cache.free_list.stalls.rate:
        enabled: true
      sqlserver.page.lookup.rate:
        enabled: true
      # Batch / Compilation
      sqlserver.batch.compilation.utilization:
        enabled: true
      sqlserver.batch.page_split.utilization:
        enabled: true
      sqlserver.recompilation.ratio:
        enabled: true
      sqlserver.parameterization.rate:
        enabled: true
      sqlserver.plan.execution.rate:
        enabled: true
      sqlserver.attention.rate:
        enabled: true
      # Processes / Connections
      sqlserver.process.count:
        enabled: true
      sqlserver.processes.blocked:
        enabled: true
      sqlserver.login.rate:
        enabled: true
      sqlserver.logout.rate:
        enabled: true
      # Thread Pool
      sqlserver.thread_pool.tasks.count:
        enabled: true
      sqlserver.thread_pool.workers.count:
        enabled: true
      sqlserver.thread_pool.workers.max:
        enabled: true
      sqlserver.thread_pool.workers.utilization:
        enabled: true
      # TempDB
      sqlserver.tempdb.allocation.wait_time.total:
        enabled: true
      sqlserver.tempdb.contention.waiters.count:
        enabled: true
      sqlserver.tempdb.data_files.count:
        enabled: true
      sqlserver.tempdb.file.size:
        enabled: true
      sqlserver.tempdb.space.usage:
        enabled: true
      # Latch
      sqlserver.latch.superlatch.count:
        enabled: true
      sqlserver.latch.superlatch.transition.rate:
        enabled: true
      sqlserver.latch.wait.rate:
        enabled: true
      sqlserver.latch.wait_time.avg:
        enabled: true
      sqlserver.latch.wait_time.total:
        enabled: true
      # Index
      sqlserver.index.search.rate:
        enabled: true
      # Resource Pool
      sqlserver.resource_pool.disk.operations:
        enabled: true
      sqlserver.resource_pool.disk.throttled.read.rate:
        enabled: true
      sqlserver.resource_pool.disk.throttled.write.rate:
        enabled: true
      # Replica / Always-On
      sqlserver.replica.data.rate:
        enabled: true
      # Server Properties
      sqlserver.computer.uptime:
        enabled: true
      sqlserver.cpu.count:
        enabled: true
      # Tables
      sqlserver.table.count:
        enabled: true
      # Errors
      sqlserver.kill_connection.error.rate:
        enabled: true
    # Enable top query and query sample log collection
    events:
      db.server.query_sample:
        enabled: true
      db.server.top_query:
        enabled: true
    # Top query collection configuration
    top_query_collection:
      lookback_time: 60s
      max_query_sample_count: 500
      top_query_count: 200
      collection_interval: 60s
    collect_full_query_text: true
    allowed_comment_keys:
      - nr_service_guid
    # Query sample collection configuration
    query_sample_collection:
      max_rows_per_query: 100
processors:
  metrics_transform:
    transforms:
      - include: system.cpu.utilization
        action: update
        operations:
          - action: aggregate_labels
            label_set: [state]
            aggregation_type: mean
      - include: system.paging.operations
        action: update
        operations:
          - action: aggregate_labels
            label_set: [direction]
            aggregation_type: sum
  filter/exclude_cpu_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "interrupt"'
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "nice"'
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "softirq"'
  filter/exclude_memory_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_unreclaimable"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "inactive"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "cached"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "buffered"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_reclaimable"'
  filter/exclude_memory_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.memory.usage" and attributes["state"] == "slab_unreclaimable"'
        - 'metric.name == "system.memory.usage" and attributes["state"] == "inactive"'
  filter/exclude_filesystem_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.utilization" and attributes["type"] == "squashfs"'
  filter/exclude_filesystem_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.usage" and attributes["type"] == "squashfs"'
        - 'metric.name == "system.filesystem.usage" and attributes["state"] == "reserved"'
  filter/exclude_filesystem_inodes_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.inodes.usage" and attributes["type"] == "squashfs"'
        - 'metric.name == "system.filesystem.inodes.usage" and attributes["state"] == "reserved"'
  filter/exclude_system_disk:
    metrics:
      datapoint:
        - 'metric.name == "system.disk.operations" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.merged" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.io" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.io_time" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.operation_time" and IsMatch(attributes["device"], "^loop.*") == true'
  filter/exclude_system_paging:
    metrics:
      datapoint:
        - 'metric.name == "system.paging.usage" and attributes["state"] == "cached"'
        - 'metric.name == "system.paging.operations" and attributes["type"] == "cached"'
  filter/exclude_network:
    metrics:
      datapoint:
        - 'IsMatch(metric.name, "^system.network.*") == true and attributes["device"] == "lo"'
  attributes/exclude_system_paging:
    include:
      match_type: strict
      metric_names:
        - system.paging.operations
    actions:
      - key: type
        action: delete
  cumulativetodelta:
  transform/host:
    metric_statements:
      - context: metric
        statements:
          - set(metric.description, "")
          - set(metric.unit, "")
  batch:
  resource_detection:
    detectors: ["system"]
    system:
      hostname_sources: ["os"]
      resource_attributes:
        host.id:
          enabled: true
  resource_detection/cloud:
    detectors: ["gcp", "ec2", "azure"]
    timeout: 2s
    override: true
  resource_detection/env:
    detectors: ["env"]
    timeout: 2s
    override: true
exporters:
  otlphttp:
    endpoint: <YOUR_OTLP_ENDPOINT>
    headers:
      api-key: <YOUR_LICENSE_KEY>
    tls:
      insecure: false
    compression: gzip
service:
  telemetry:
    metrics:
      level: none
  extensions: [health_check]
  pipelines:
    metrics/host:
      receivers: [host_metrics, nrsqlserver]
      processors:
        - metrics_transform
        - filter/exclude_cpu_utilization
        - filter/exclude_memory_utilization
        - filter/exclude_memory_usage
        - filter/exclude_filesystem_utilization
        - filter/exclude_filesystem_usage
        - filter/exclude_filesystem_inodes_usage
        - filter/exclude_system_disk
        - filter/exclude_network
        - attributes/exclude_system_paging
        - transform/host
        - resource_detection
        - resource_detection/cloud
        - resource_detection/env
        - cumulativetodelta
        - batch
      exporters: [otlphttp]
    logs/host:
      receivers: [nrsqlserver]
      processors:
        - resource_detection
        - resource_detection/cloud
        - resource_detection/env
        - batch
      exporters: [otlphttp]
    traces:
      receivers: [otlp]
      processors: [resource_detection, resource_detection/cloud, resource_detection/env, batch]
      exporters: [otlphttp]
    metrics:
      receivers: [otlp]
      processors: [resource_detection, resource_detection/cloud, resource_detection/env, batch]
      exporters: [otlphttp]
    logs:
      receivers: [otlp]
      processors: [resource_detection, resource_detection/cloud, resource_detection/env, batch]
      exporters: [otlphttp]

Parámetro de configuración

La siguiente tabla describe los parámetros de configuración clave para el receptor nrsqlserver:

Parámetro	Descripción
`<YOUR_RDS_ENDPOINT>`	Ingrese su extremo de RDS SQL Server
`<YOUR_PORT>`	Ingrese el número de puerto de SQL Server. El valor predeterminado es 1433.
`<YOUR_OTLP_ENDPOINT>`	Ingrese el endpoint OTLP de New Relic. Para obtener más información, consulta la documentación de los endpoints OTLP de New Relic.
`<YOUR_LICENSE_KEY>`	Ingresa tu clave de licencia de New Relic.
`collection_interval`	Intervalo en segundos para recopilar métricas de base de datos. Predeterminado: 15s

Sugerencia

La opción max_concurrent_queries controla cuántas consultas de métricas ejecuta el receptor en paralelo contra SQL Server durante cada ciclo de extracción.

receivers:
  nrsqlserver:
    max_concurrent_queries: 4  # default is 4 if omitted or set to 0

Sugerencia

Nota: si habilita todas las métricas disponibles, aumente el valor de limit_mib (por ejemplo, 1000) para evitar que el limitador de memoria descarte datos.

Actualizar el registro del servicio de Windows

Actualice el registro de servicios de Windows para usar el nuevo archivo mssql-config.yaml.

Método 1: PowerShell

Ejecute el siguiente comando en PowerShell como administrador:

Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Services\nrdot-collector" -Name "ImagePath" -Value '"C:\Program Files\nrdot-collector\nrdot-collector.exe" --config "C:\Program Files\nrdot-collector\mssql-config.yaml"'

Método 2: símbolo del sistema (alternativo)

Si PowerShell no está disponible, puede usar el símbolo del sistema en su lugar:

Abra el menú Inicio, escriba cmd
Haz clic derecho en el símbolo del sistema y elige Run as administrator
Copie y pegue este comando exacto en la ventana negra de CMD y presione Enter:

sc config "nrdot-collector" binPath= "\"C:\Program Files\nrdot-collector\nrdot-collector.exe\" --config \"C:\Program Files\nrdot-collector\mssql-config.yaml\""

Validar la configuración del NRDOT Collector

Valide la configuración del NRDOT Collector para asegurarse de que tenga el formato correcto y funcione correctamente.

bash

$& "C:\Program Files\nrdot-collector\nrdot-collector.exe" validate --config="C:\Program Files\nrdot-collector\mssql-config.yaml"

Reiniciar el colector NRDOT

Después de actualizar la configuración, reinicie el servicio NRDOT Collector en su instancia de Windows EC2 unida al dominio:

bash

$net stop nrdot-collector
$  net start nrdot-collector

Sugerencia

Verifique que el servicio se esté ejecutando bajo la cuenta gMSA comprobando los servicios de Windows (services.msc). La columna "Iniciar sesión como" debería mostrar su cuenta gMSA (por ejemplo, CORP\SQL-gMSA$).

(Opcional) Configurar la correlación de APM y base de datos

Importante

(Opcional) Configurar la gestión de secretos

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:

Vaya a https://one.newrelic.com > All Capabilities > Databases.
En el menú desplegable Entity type, seleccione MSSQL instance y luego haga clic en Apply.
Seleccione su base de datos SQL Server de la lista de entidades.

Próximos pasos

Después de configurar el monitoreo de Windows RDS:

Te ofrecemos esta traducción automática para facilitar la lectura.

Monitoreo de Windows RDS MSSQL con NRDOT

Avance

Requisitos previos .css-21sua1{background:none;border:none;width:0;padding:0;}

Configurar el colector NRDOT

Importante

Configurar el usuario de la base de datos

Sugerencia

Configurar el Colector NRDOT

Configuración de características completas

Parámetro de configuración

Sugerencia

Sugerencia

Actualizar el registro del servicio de Windows

Validar la configuración del NRDOT Collector

Reiniciar el colector NRDOT

Sugerencia

(Opcional) Configurar la correlación de APM y base de datos

Importante

(Opcional) Configurar la gestión de secretos

Encuentra y utiliza tus datos

Requisitos previos

Habilite su servidor Microsoft SQL

Importante

Otorgar privilegios de acceso de LECTURA

Sugerencia

Configurar el NRDOT Collector

Importante

Importante

Configurar el Colector NRDOT

Configuración estándar

Configuración de características completas

Parámetro de configuración

Actualizar el registro del servicio de Windows

Validar la configuración del NRDOT Collector

Reiniciar el colector NRDOT

Sugerencia

(Opcional) Configurar la correlación de APM y base de datos

Importante

(Opcional) Configurar la gestión de secretos

Encuentra y utiliza tus datos

Requisitos previos

Habilite su servidor Microsoft SQL

Importante

Otorgar privilegios de acceso de LECTURA

Importante

Configurar el NRDOT Collector

Importante

Configurar el servicio NRDOT Collector para ejecutarse como gMSA

Importante

Configurar el Colector NRDOT

Configuración estándar

Configuración de características completas

Parámetro de configuración

Sugerencia

Sugerencia

Actualizar el registro del servicio de Windows

Validar la configuración del NRDOT Collector

Reiniciar el colector NRDOT

Sugerencia

(Opcional) Configurar la correlación de APM y base de datos

Importante

(Opcional) Configurar la gestión de secretos

Encuentra y utiliza tus datos

Próximos pasos

Requisitos previos