Monitoreo de MSSQL autohospedado en Windows 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 mediante el Collector de NRDOT en entornos autohospedados de Windows, incluidos servidores físicos, máquinas virtuales e instalaciones independientes de Windows. Para monitorear en un entorno RDS de Windows, consulte la instrumentación de RDS de Windows.

Para instalar esto a través de la UI de New Relic en su lugar, vaya a one.newrelic.com > Integrations & Agents > MSSQL (OpenTelemetry) . Siga las instrucciones en pantalla para configurar la integración. Esta página cubre únicamente la ruta de instalación de la CLI.

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

Requisitos previos

Antes de monitorear Microsoft SQL Server con NRDOT, asegúrese de que el entorno cumpla con estos requisitos:

Cuenta de New Relic con una clave de licenciaválida
Extremo OTLP de New Relic para su región
Requisitos de SQL Server, necesitará:
- SQL Server 2017 o posterior
- Acceso administrativo a SQL Server (rol sysadmin o equivalente)
- Conectividad de red entre el recolector y SQL Server en el puerto 1433 o en un puerto personalizado
- SQL Server Management Studio (SSMS) o la utilidad sqlcmd
- Autenticación de dominio de Windows o de SQL Server
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

Descarga e instala el NRDOT Collector usando PowerShell:

bash

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

Crear usuario de monitoreo

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

En su SQL Server Management Studio (SSMS), ejecute el siguiente script para crear el usuario de monitoreo newrelic. Reemplace <YOUR_PASSWORD> con su contraseña deseada:

USE [master];
GO
CREATE LOGIN [newrelic] WITH PASSWORD = '<YOUR_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 administrar de forma segura la información confidencial, como las credenciales de la base de datos, guárdelas en herramientas de gestión de secretos.

Configurar el Colector NRDOT

Cree un archivo de configuración llamado mssql-config.yaml en PowerShell como administrador:
bash
```
$New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```
Agregue los valores específicos de su entorno a la siguiente configuración y cópiela en el 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 su entorno de SQL Server. Para habilitar un monitoreo integral con todas las métricas disponibles, consulte la referencia de configuración.
Nombre de usuario de SQL Server
Ingrese su nombre de usuario de SQL Server
Contraseña de SQL Server
Ingrese la contraseña de SQL Server
Nombre de host/IP del servidor
Ingrese el nombre de host o la dirección IP de SQL Server
Puerto del servidor
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 la clave de licencia de ingesta de New Relic
mssql-config.yaml
1 receivers: 2 nrsqlserver: 3 collection_interval: 15s 4 username: newrelic 5 password: YOUR_PASSWORD 6 server: sqlserver.example.com 7 port: 1433 8 9 # Enable comprehensive database metrics 10 metrics: 11 sqlserver.database.count: 12 enabled: true 13 sqlserver.database.io: 14 enabled: true 15 sqlserver.database.latency: 16 enabled: true 17 sqlserver.database.operations: 18 enabled: true 19 sqlserver.database.tempdb.space: 20 enabled: true 21 sqlserver.database.tempdb.version_store.size: 22 enabled: true 23 sqlserver.deadlock.rate: 24 enabled: true 25 sqlserver.os.wait.duration: 26 enabled: true 27 sqlserver.processes.blocked: 28 enabled: true 29 sqlserver.memory.grants.pending.count: 30 enabled: true 31 sqlserver.database.file.size: 32 enabled: true 33 sqlserver.memory.area: 34 enabled: true 35 36 # Enable top query and query sample log collection 37 events: 38 db.server.query_sample: 39 enabled: true 40 db.server.top_query: 41 enabled: true 42 43 # Top query collection configuration 44 top_query_collection: 45 lookback_time: 60s 46 max_query_sample_count: 1000 47 top_query_count: 250 48 collection_interval: 60s 49 50 collect_full_query_text: true 51 allowed_comment_keys: 52 - nr_service_guid 53 54 # Query sample collection configuration 55 query_sample_collection: 56 max_rows_per_query: 100 57 58 processors: 59 memory_limiter: 60 check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s} 61 limit_mib: ${env:NR_MEM_LIMITER_LIMIT_MIB:-200} 62 spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50} 63 64 batch: 65 66 exporters: 67 otlp: 68 endpoint: https://otlp.nr-data.net:4318 69 headers: 70 api-key: YOUR_LICENSE_KEY 71 tls: 72 insecure: false 73 compression: gzip 74 75 service: 76 telemetry: 77 metrics: 78 level: none 79 80 pipelines: 81 metrics: 82 receivers: [nrsqlserver] 83 processors: [memory_limiter, batch] 84 exporters: [otlp] 85 86 logs: 87 receivers: [nrsqlserver] 88 processors: [memory_limiter, batch] 89 exporters: [otlp]

Actualizar el registro del servicio de Windows

Actualice el registro de servicios de Windows para usar el nuevo archivo mssql-config.yaml mediante uno de los siguientes métodos:

Para PowerShell: ejecute el siguiente comando como administrador:

bash

$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"'

Para el símbolo del sistema: si PowerShell no está disponible, use el símbolo del sistema en su lugar y ejecute el siguiente comando como administrador:

bash

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

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"
```
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 configurar la identificación del servicio de base de datos.

Reiniciar NRDOT Collector

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

bash

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

Sugerencia

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

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

Requisitos previos

Antes de monitorear Microsoft SQL Server con NRDOT usando la autenticación de Windows, asegúrese de que el entorno cumpla con estos requisitos:

Cuenta de New Relic con una clave de licenciaválida
Extremo OTLP de New Relic para su región
Requisitos de SQL Server, necesitará:
- SQL Server 2017 o posterior
- Acceso administrativo a SQL Server (rol sysadmin o equivalente)
- Conectividad de red entre el recolector y SQL Server en el puerto 1433 o en un puerto personalizado
- SQL Server Management Studio (SSMS) o la utilidad sqlcmd
Entorno de dominio de Windows con Active Directory
SQL Server configurado para aceptar la autenticación de Windows
Cuenta de usuario de dominio con los permisos apropiados de SQL Server
Conectividad de red al extremo OTLP de New Relic

Inscribirse en la vista previa

Instalar NRDOT Collector

Descarga e instala el NRDOT Collector usando PowerShell:

bash

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

Crear usuario de monitoreo

Asegúrese de que su SQL Server esté configurado para la autenticación de Windows y verifique la conectividad.

Recupere el nombre de usuario de Windows:
```
SELECT SYSTEM_USER;
```

Ejecute el siguiente comando para verificar que se otorguen los permisos necesarios al usuario de Windows. Reemplace todas las apariciones de <ACCOUNT_USERNAME> por el nombre de usuario obtenido del paso 1:

DECLARE @TargetUser SYSNAME = '<ACCOUNT_USERNAME>'; -- <-- Set your Windows user here

-- 1. Create the checklist of required permissions from your script
DECLARE @Checklist TABLE (Scope NVARCHAR(50), [Database] SYSNAME, [Permission] NVARCHAR(128));

INSERT INTO @Checklist VALUES
('Server', 'ALL', 'VIEW SERVER STATE'),
('Server', 'ALL', 'VIEW ANY DEFINITION'),
('Server', 'ALL', 'VIEW ANY DATABASE');

INSERT INTO @Checklist
SELECT 'Database Role', [name], 'db_datareader' FROM sys.databases WHERE [name] NOT IN ('master', 'msdb', 'model', 'rdsadmin', 'distribution') AND [state] = 0
UNION ALL
SELECT 'Database Explicit', [name], 'VIEW DATABASE STATE' FROM sys.databases WHERE [name] NOT IN ('master', 'msdb', 'model', 'rdsadmin', 'distribution') AND [state] = 0
UNION ALL
SELECT 'Database Explicit', [name], 'VIEW DEFINITION' FROM sys.databases WHERE [name] NOT IN ('master', 'msdb', 'model', 'rdsadmin', 'distribution') AND [state] = 0;

-- 2. Gather existing explicit permissions
WITH ExplicitPerms AS (
    SELECT 'Server' AS Scope, CAST('ALL' AS NVARCHAR(128)) COLLATE DATABASE_DEFAULT AS [Database], p.permission_name COLLATE DATABASE_DEFAULT AS [Permission]
    FROM sys.server_permissions p JOIN sys.server_principals l ON p.grantee_principal_id = l.principal_id WHERE l.name = @TargetUser
    UNION ALL
    SELECT 'Database Role', d.name COLLATE DATABASE_DEFAULT, r.name COLLATE DATABASE_DEFAULT
    FROM sys.databases d CROSS APPLY (SELECT dp_role.name FROM sys.database_role_members drm JOIN sys.database_principals dp_role ON drm.role_principal_id = dp_role.principal_id JOIN sys.database_principals dp_user ON drm.member_principal_id = dp_user.principal_id JOIN sys.server_principals sp ON dp_user.sid = sp.sid WHERE sp.name = @TargetUser) r WHERE d.state = 0
    UNION ALL
    SELECT 'Database Explicit', d.name COLLATE DATABASE_DEFAULT, p.permission_name COLLATE DATABASE_DEFAULT
    FROM sys.databases d CROSS APPLY (SELECT db_p.permission_name FROM sys.database_permissions db_p JOIN sys.database_principals dp_user ON db_p.grantee_principal_id = dp_user.principal_id JOIN sys.server_principals sp ON dp_user.sid = sp.sid WHERE sp.name = @TargetUser) p WHERE d.state = 0
)
-- 3. Output the exact verification matrix
SELECT
    chk.Scope,
    chk.[Database],
    chk.[Permission] AS [Required Permission],
    CASE
        WHEN exp.[Permission] IS NOT NULL THEN 'GRANTED'
        WHEN IS_SRVROLEMEMBER('sysadmin', @TargetUser) = 1 THEN 'PASSED (via SysAdmin Role)'
        ELSE 'MISSING'
    END AS [Verification Status]
FROM @Checklist chk
LEFT JOIN ExplicitPerms exp ON chk.Scope = exp.Scope AND chk.[Database] = exp.[Database] AND chk.[Permission] = exp.[Permission]
ORDER BY chk.Scope, chk.[Database], chk.[Permission];

(Opcional) Si no tiene los permisos necesarios, desde la utilidad SSMS o sqlcmd, ejecute el siguiente comando para otorgar los permisos requeridos a la cuenta de Windows. Reemplace todas las apariciones de <ACCOUNT_USERNAME> con el nombre de usuario de Windows recuperado en el paso 1:

USE [master];
GO

-- 1. Grant Instance-level permissions to your Windows Account
GRANT VIEW SERVER STATE TO [<ACCOUNT_USERNAME>];
GRANT VIEW ANY DEFINITION TO [<ACCOUNT_USERNAME>];
GRANT VIEW ANY DATABASE TO [<ACCOUNT_USERNAME>];
GO

-- 2. Loop through all user databases and grant read/visibility permissions
DECLARE @name SYSNAME;
DECLARE @sql NVARCHAR(MAX);

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
        PRINT 'Granting permissions on database: ' + @name;

        -- Create the database user mapping if it doesn't exist, then grant roles
        SET @sql = '
            USE [' + @name + '];
            IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = ''<ACCOUNT_USERNAME>'')
            BEGIN
                CREATE USER [<ACCOUNT_USERNAME>] FOR LOGIN [<ACCOUNT_USERNAME>];
            END;
            GRANT VIEW DATABASE STATE TO [<ACCOUNT_USERNAME>];
            GRANT VIEW DEFINITION TO [<ACCOUNT_USERNAME>];
            ALTER ROLE db_datareader ADD MEMBER [<ACCOUNT_USERNAME>];';

        EXEC sp_executesql @sql;
        PRINT 'Success: ' + @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

En SQL Server Management Studio (SSMS), ejecute el siguiente script para crear un inicio de sesión para la cuenta gMSA y otorgar los permisos necesarios. Reemplace todas las apariciones de <YOUR_DOMAIN>\<YOUR_DOMAIN_USER> con el nombre de dominio y cuenta real.

USE [master];
GO

CREATE LOGIN [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>] FROM WINDOWS;
GO

GRANT VIEW ANY DATABASE   TO [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>];
GRANT VIEW SERVER STATE TO [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>];
GRANT VIEW ANY DEFINITION TO [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>];
GO

-- Grant access to all 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;
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 = ''<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>'')
    BEGIN
      CREATE USER [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>] FOR LOGIN [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>];
    END;
    GRANT VIEW DATABASE STATE TO [<YOUR_DOMAIN>\<YOUR_DOMAIN_USER>];');
  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

Configure el servicio NRDOT Collector para que se ejecute como su usuario de dominio usando PowerShell. Reemplace YOUR_DOMAIN\YOUR_USER_ACCOUNT con el nombre de su dominio y cuenta:

bash

$# Configure service to use domain account
$# The space after obj= and password= is required syntax for sc.exe
$sc.exe config "nrdot-collector" obj= "YOUR_DOMAIN\YOUR_USER_ACCOUNT" password= "<YOUR_PASSWORD>"
$
$# Restart the service
$Restart-Service nrdot-collector

Valide la identidad del servicio:

bash

$Get-WmiObject Win32_Service -Filter "Name='nrdot-collector'" | Select Name, State, StartName
$# Expected: StartName = YOUR_DOMAIN\YOUR_USER_ACCOUNT

Sugerencia

Para administrar de forma segura la información confidencial, como las credenciales de la base de datos, guárdelas en herramientas de gestión de secretos.

Configurar el Colector NRDOT

Cree un archivo de configuración llamado mssql-config.yaml en PowerShell como administrador:
bash
```
$New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

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 de Windows SQL Server. Para habilitar un monitoreo integral con todas las métricas disponibles, consulte la referencia de configuración.

Nombre de host/IP de SQL Server

Puerto de SQL Server

Extremo OTLP de New Relic

Clave de licencia de New Relic

mssql-config.yaml

1
receivers:
2
nrsqlserver:
3
   collection_interval: 15s
4
   datasource: "server=sqlserver.example.com;port=1433;integrated security=true;encrypt=true;TrustServerCertificate=true;"
5

6
   # Enable comprehensive database metrics
7
   metrics:
8
     sqlserver.database.count:
9
       enabled: true
10
     sqlserver.database.io:
11
       enabled: true
12
     sqlserver.database.latency:
13
       enabled: true
14
     sqlserver.database.operations:
15
       enabled: true
16
     sqlserver.database.tempdb.space:
17
       enabled: true
18
     sqlserver.database.tempdb.version_store.size:
19
       enabled: true
20
     sqlserver.deadlock.rate:
21
       enabled: true
22
     sqlserver.os.wait.duration:
23
       enabled: true
24
     sqlserver.processes.blocked:
25
       enabled: true
26
     sqlserver.memory.grants.pending.count:
27
       enabled: true
28
     sqlserver.database.file.size:
29
       enabled: true
30
     sqlserver.memory.area:
31
       enabled: true
32

33
   # Enable top query and query sample log collection
34
   events:
35
     db.server.query_sample:
36
       enabled: true
37
     db.server.top_query:
38
       enabled: true
39

40
   # Top query collection configuration
41
   top_query_collection:
42
     lookback_time: 60s
43
     max_query_sample_count: 1000
44
     top_query_count: 250
45
     collection_interval: 60s
46

47
   collect_full_query_text: true
48
   allowed_comment_keys:
49
     - nr_service_guid
50

51
   # Query sample collection configuration
52
   query_sample_collection:
53
     max_rows_per_query: 100
54

55
processors:
56
memory_limiter:
57
   check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
58
   limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-200}
59
   spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}
60

61
batch:
62

63
exporters:
64
otlp:
65
   endpoint: https://otlp.nr-data.net:4318
66
   headers:
67
     api-key: YOUR_LICENSE_KEY
68
   tls:
69
     insecure: false
70
   compression: gzip
71

72
service:
73
telemetry:
74
   metrics:
75
     level: none
76

77
pipelines:
78
   metrics:
79
     receivers: [nrsqlserver]
80
     processors: [memory_limiter, batch]
81
     exporters: [otlp]
82

83
   logs:
84
     receivers: [nrsqlserver]
85
     processors: [memory_limiter, batch]
86
     exporters: [otlp]

Sugerencia

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

Actualizar el registro del servicio de Windows

Actualice el registro de servicios de Windows para usar el nuevo archivo mssql-config.yaml mediante uno de los siguientes métodos:

Para PowerShell: ejecute el siguiente comando como administrador:

bash

$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"'

Para el símbolo del sistema: si PowerShell no está disponible, use el símbolo del sistema en su lugar y ejecute el siguiente comando como administrador:

bash

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

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"
```
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 configurar la identificación del servicio de base de datos.

Reiniciar NRDOT Collector

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

bash

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

Sugerencia

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

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

Requisitos previos

Antes de monitorear Microsoft SQL Server con NRDOT mediante la autenticación gMSA, asegúrese de que el entorno cumpla con estos requisitos:

Cuenta de New Relic con una clave de licenciaválida
Extremo OTLP de New Relic para su región
Requisitos de SQL Server, necesitará:
- SQL Server 2017 o posterior
- Acceso administrativo a SQL Server (rol sysadmin o equivalente)
- Conectividad de red entre el recolector y SQL Server al puerto 1433 o a un puerto personalizado
- SQL Server Management Studio (SSMS) o la utilidad sqlcmd
Entorno de Active Directory con soporte para gMSA
El host de Windows debe estar unido al dominio y autorizado para usar la cuenta gMSA
Conectividad de red al extremo OTLP de New Relic

Inscribirse en la vista previa

Instalar NRDOT Collector

Descarga e instala el NRDOT Collector usando PowerShell:

bash

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

Crear usuario de monitoreo

En SQL Server Management Studio (SSMS), ejecute el siguiente script para crear un inicio de sesión para la cuenta gMSA y otorgar los permisos necesarios. Reemplace todas las apariciones de <YOUR_DOMAIN>\<YOUR_GMSA_USERNAME> con el dominio real y el nombre de la cuenta gMSA.

USE [master];
GO

-- Provision an engine login identity for the gMSA
CREATE LOGIN [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$] FROM WINDOWS;
GO

-- Grant monitoring permissions
GRANT VIEW SERVER STATE TO [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$];
GRANT VIEW ANY DEFINITION TO [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$];
GRANT VIEW ANY DATABASE TO [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$];
GO

-- 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 = ''<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$'')
    BEGIN
      CREATE USER [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$] FOR LOGIN [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$];
    END;
    GRANT VIEW DATABASE STATE TO [<YOUR_DOMAIN>\<YOUR_GMSA_USERNAME>$];');
  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 administrar de forma segura la información confidencial, como las credenciales de la base de datos, guárdelas en herramientas de gestión de secretos.

Ejecutar como cuenta gMSA

Después de instalar el Collector de NRDOT, configure el servicio para que se ejecute como su cuenta gMSA mediante PowerShell. Reemplace YOUR_DOMAIN\YOUR_gMSA_ACCOUNT$ con su dominio y nombre de cuenta gMSA. Debe incluir el $ al final, ya que es necesario para las cuentas gMSA.

bash

$# 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= "YOUR_DOMAIN\YOUR_gMSA_ACCOUNT$" password= ""'
$
$# Verify the configuration
$Get-WmiObject Win32_Service -Filter "Name='nrdot-collector'" | Select Name, StartName
$
$# start the NRDOT Collector service
$Start-Service nrdot-collector

Configurar el Colector NRDOT

Cree un archivo de configuración llamado mssql-config.yaml en PowerShell como administrador:
bash
```
$New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

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 de Windows SQL Server. Para habilitar el monitoreo integral con todas las métricas disponibles, consulte la referencia de configuración.

Nombre de host/IP de SQL Server

Puerto de SQL Server

Extremo OTLP de New Relic

Clave de licencia de New Relic

mssql-config.yaml

1
receivers:
2
nrsqlserver:
3
   collection_interval: 15s
4
   datasource: "server=sqlserver.example.com;port=1433;integrated security=true;encrypt=true;TrustServerCertificate=true;"
5

6
   # Enable comprehensive database metrics
7
   metrics:
8
     sqlserver.database.count:
9
       enabled: true
10
     sqlserver.database.io:
11
       enabled: true
12
     sqlserver.database.latency:
13
       enabled: true
14
     sqlserver.database.operations:
15
       enabled: true
16
     sqlserver.database.tempdb.space:
17
       enabled: true
18
     sqlserver.database.tempdb.version_store.size:
19
       enabled: true
20
     sqlserver.deadlock.rate:
21
       enabled: true
22
     sqlserver.os.wait.duration:
23
       enabled: true
24
     sqlserver.processes.blocked:
25
       enabled: true
26
     sqlserver.memory.grants.pending.count:
27
       enabled: true
28
     sqlserver.database.file.size:
29
       enabled: true
30
     sqlserver.memory.area:
31
       enabled: true
32

33
   # Enable top query and query sample log collection
34
   events:
35
     db.server.query_sample:
36
       enabled: true
37
     db.server.top_query:
38
       enabled: true
39

40
   # Top query collection configuration
41
   top_query_collection:
42
     lookback_time: 60s
43
     max_query_sample_count: 1000
44
     top_query_count: 250
45
     collection_interval: 60s
46

47
   collect_full_query_text: true
48
   allowed_comment_keys:
49
     - nr_service_guid
50

51
   # Query sample collection configuration
52
   query_sample_collection:
53
     max_rows_per_query: 100
54

55
processors:
56
memory_limiter:
57
   check_interval: ${env:NR_MEM_LIMITER_CHECK_INTERVAL:-1s}
58
   limit_mib:       ${env:NR_MEM_LIMITER_LIMIT_MIB:-200}
59
   spike_limit_mib: ${env:NR_MEM_LIMITER_SPIKE_MIB:-50}
60

61
batch:
62

63
exporters:
64
otlp:
65
   endpoint: https://otlp.nr-data.net:4318
66
   headers:
67
     api-key: YOUR_LICENSE_KEY
68
   tls:
69
     insecure: false
70
   compression: gzip
71

72
service:
73
telemetry:
74
   metrics:
75
     level: none
76

77
pipelines:
78
   metrics:
79
     receivers: [nrsqlserver]
80
     processors: [memory_limiter, batch]
81
     exporters: [otlp]
82

83
   logs:
84
     receivers: [nrsqlserver]
85
     processors: [memory_limiter, batch]
86
     exporters: [otlp]

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 configurar la identificación del servicio de base de datos.

Actualizar el registro del servicio de Windows

Actualice el registro de servicios de Windows para usar el nuevo archivo mssql-config.yaml mediante uno de los siguientes métodos:

Para PowerShell: ejecute el siguiente comando como administrador:

bash

$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"'

Para el símbolo del sistema: si PowerShell no está disponible, use el símbolo del sistema en su lugar y ejecute el siguiente comando como administrador:

bash

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

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 NRDOT Collector

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

bash

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

Sugerencia

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

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

Configurar la correlación de APM y base de datos

Aprenda a correlacionar el rendimiento de la aplicación con las operaciones de la base de datos en New Relic.

Resolución de problemas

Aprenda a solucionar problemas de la configuración de monitoreo de MSSQL Windows en New Relic.

Referencia de métricas

Obtenga información sobre las métricas disponibles recopiladas por NRDOT Collector.

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

Monitoreo de MSSQL autohospedado en Windows con NRDOT

Avance

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

Inscribirse en la vista previa

Instalar NRDOT Collector

Crear usuario de monitoreo

Sugerencia

Configurar el Colector NRDOT

configuración completa

Actualizar el registro del servicio de Windows

Sugerencia

Reiniciar NRDOT Collector

Sugerencia

Encuentra y utiliza tus datos

Requisitos previos

Inscribirse en la vista previa

Instalar NRDOT Collector

Crear usuario de monitoreo

Collector en un host de Windows diferente

Sugerencia

Configurar el Colector NRDOT

configuración completa

Sugerencia

Actualizar el registro del servicio de Windows

Sugerencia

Reiniciar NRDOT Collector

Sugerencia

Encuentra y utiliza tus datos

Requisitos previos

Inscribirse en la vista previa

Instalar NRDOT Collector

Crear usuario de monitoreo

Sugerencia

Ejecutar como cuenta gMSA

Configurar el Colector NRDOT

configuración completa

Sugerencia

Actualizar el registro del servicio de Windows

Reiniciar NRDOT Collector

Sugerencia

Encuentra y utiliza tus datos

Documentación relacionada

Configurar la correlación de APM y base de datos

Resolución de problemas

Referencia de métricas

Requisitos previos