Monitoramento de MSSQL auto-hospedado no Windows com NRDOT

Visualização

Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!

Atualmente, esse recurso é fornecido como parte de uma prévia, de acordo com nossas políticas de pré-lançamento.

Configure o monitoramento do Microsoft SQL Server usando o NRDOT Collector em ambientes auto-hospedados do Windows, incluindo servidores físicos, máquinas virtuais e instalações autônomas do Windows. Para monitorar em um ambiente Windows RDS, consulte a instrumentação do Windows RDS.

Para instalar isso por meio da interface da New Relic, vá para one.newrelic.com > Integrations & Agents > MSSQL (OpenTelemetry) . Siga as instruções na tela para configurar a integração. Esta página abrange apenas o caminho de instalação da CLI.

Com base na sua configuração de segurança do SQL Server, você pode escolher entre três métodos de autenticação para conectar o NRDOT Collector à sua instância do SQL Server:

Pré-requisitos

Antes de monitorar seu Microsoft SQL Server com o NRDOT, certifique-se de que seu ambiente atenda a estes requisitos:

Conta do New Relic com uma chave de licençaválida
Endpoint OTLP da New Relic para sua região
Requisitos do SQL Server, será necessário:
- SQL Server 2017 ou posterior
- Acesso administrativo ao SQL Server (função sysadmin ou equivalente)
- Conectividade de rede entre o coletor e o SQL Server na porta 1433 ou porta personalizada
- SQL Server Management Studio (SSMS) ou utilitário sqlcmd
- Autenticação de domínio do Windows ou do SQL Server
Conectividade de rede para o endpoint OTLP da New Relic

Inscreva-se para visualizar

Esta integração está disponível como parte do programa de visualização pública da New Relic. Entre em contato com o gerente da sua organização para aceitar na página Previews & Trials.

Instalar o NRDOT Collector

Baixe e instale o NRDOT Collector usando o 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

Criar usuário de monitoramento

Execute este script como usuário root user/sysadmin para criar o usuário de monitoramento newrelic e conceder as permissões necessárias para coletar métricas do SQL Server.

Em seu SQL Server Management Studio (SSMS), execute o seguinte script para criar o usuário de monitoramento newrelic. Substitua <YOUR_PASSWORD> pela senha desejada:

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

Dica

Para gerenciar informações confidenciais com segurança, como credenciais de banco de dados, armazene-as em ferramentas de gerenciamento de segredos.

Configurar o NRDOT Collector

Crie um arquivo de configuração nomeado como mssql-config.yaml no PowerShell como administrador:
bash
```
$New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```
Adicione seus valores específicos do ambiente à seguinte configuração e copie-a para o arquivo mssql-config.yaml criado na etapa anterior:
configuração completa
Esta configuração foca no monitoramento essencial do banco de dados para o seu ambiente SQL Server. Para habilitar o monitoramento abrangente com todas as métricas disponíveis, consulte a referência de configuração.
Nome de usuário do SQL Server
Insira seu nome de usuário do SQL Server
Senha do SQL Server
Insira a senha do seu SQL Server
Nome do host/IP do servidor
Insira o nome do host ou endereço IP do SQL Server
Porta do servidor
Insira o número da porta do SQL Server. O valor padrão é 1433.
Endpoint New Relic OTLP
Insira o seu endpoint OTLP da New Relic. Para obter mais informações, consulte https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp/
Chave de licença da New Relic
Insira sua chave de licença de ingestão da 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]

Atualizar Registro de Serviço do Windows

Atualize o Registro de Serviço do Windows para usar o novo arquivo mssql-config.yaml usando um dos seguintes métodos:

Para PowerShell: execute o seguinte 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 prompt de comando: se o PowerShell não estiver disponível, use o prompt de comando e execute o seguinte 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 a configuração do Collector NRDOT para garantir que esteja formatada corretamente e funcione de maneira adequada.
bash
```
$& "C:\Program Files\nrdot-collector\nrdot-collector.exe" validate --config="C:\Program Files\nrdot-collector\mssql-config.yaml"
```
Dica
Para correlacionar o desempenho do aplicativo com as operações de banco de dados, é possível configurar a identificação de serviço de banco de dados. Para mais informações, consulte configurar a identificação de serviço de banco de dados.

Reiniciar o NRDOT Collector

Após atualizar sua configuração, reinicie o serviço NRDOT Collector:

bash

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

Dica

Sempre reinicie o serviço do NRDOT Collector após fazer alterações na configuração para garantir que as novas configurações entrem em vigor.

Encontre e use seus dados

Assim que seus dados estiverem sendo coletados, você poderá acessar o monitoramento abrangente do banco de dados SQL Server por meio da interface do New Relic.

Para encontrar sua entidade de banco de dados SQL Server no New Relic:

Vá para https://one.newrelic.com > All Capabilities > Databases.
Na dropdown Entity type, selecione MSSQL instance e clique em Apply.
Selecione seu banco de dados SQL Server na lista de entidades.
Após configurar o monitoramento do SQL Server com o NRDOT, você pode:
- Crie dashboards personalizados para visualizar suas métricas de banco de dados
- Configure alertas para limites críticos de desempenho do banco de dados
- Explore seus dados usando os recursos de consulta do New Relic

Pré-requisitos

Antes de monitorar seu Microsoft SQL Server com NRDOT usando a Autenticação do Windows, certifique-se de que seu ambiente atenda a estes requisitos:

Conta do New Relic com uma chave de licençaválida
Endpoint OTLP da New Relic para sua região
Requisitos do SQL Server, será necessário:
- SQL Server 2017 ou posterior
- Acesso administrativo ao SQL Server (função sysadmin ou equivalente)
- Conectividade de rede entre o coletor e o SQL Server na porta 1433 ou porta personalizada
- SQL Server Management Studio (SSMS) ou utilitário sqlcmd
Ambiente de domínio do Windows com Active Directory
SQL Server configurado para aceitar a autenticação do Windows
Conta de usuário de domínio com as permissões apropriadas do SQL Server
Conectividade de rede para o endpoint OTLP da New Relic

Inscreva-se para visualizar

Esta integração está disponível como parte do programa de visualização pública da New Relic. Entre em contato com o gerente da sua organização para aceitar na página Previews & Trials.

Instalar o NRDOT Collector

Baixe e instale o NRDOT Collector usando o 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

Criar usuário de monitoramento

Certifique-se de que seu SQL Server esteja configurado para Autenticação do Windows e verifique a conectividade.

Recupere o seu nome de usuário do Windows:
```
SELECT SYSTEM_USER;
```

Execute o seguinte comando para verificar se as permissões necessárias foram concedidas ao seu usuário do Windows. Substitua todas as ocorrências de <ACCOUNT_USERNAME> pelo nome de usuário recuperado da etapa 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) Se você não tiver as permissões necessárias, no seu SSMS ou utilitário sqlcmd, execute o seguinte comando para conceder as permissões necessárias à sua conta do Windows. Substitua todas as ocorrências de <ACCOUNT_USERNAME> pelo seu nome de usuário do Windows recuperado na etapa 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

No seu SQL Server Management Studio (SSMS), execute o seguinte script para criar um login para a sua conta gMSA e conceder as permissões necessárias. Substitua todas as ocorrências de <YOUR_DOMAIN>\<YOUR_DOMAIN_USER> pelo seu domínio e nome de conta reais.

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 o serviço NRDOT Collector para ser executado como seu usuário de domínio usando o PowerShell. Substitua YOUR_DOMAIN\YOUR_USER_ACCOUNT pelo seu domínio e nome de conta:

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 a identidade do serviço:

bash

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

Dica

Para gerenciar informações confidenciais com segurança, como credenciais de banco de dados, armazene-as em ferramentas de gerenciamento de segredos.

Configurar o NRDOT Collector

Crie um arquivo de configuração nomeado como mssql-config.yaml no PowerShell como administrador:
bash
```
$New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

Adicione a seguinte configuração ao arquivo mssql-config.yaml criado na etapa anterior:

configuração completa

Esta configuração se concentra no monitoramento essencial de banco de dados para o seu ambiente do Windows SQL Server. Para habilitar o monitoramento abrangente com toda a métrica disponível, consulte a referência de configuração.

Nome do host/IP do SQL Server

Porta do SQL Server

Endpoint New Relic OTLP

Chave de licença da 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]

Dica

Esta configuração se concentra no monitoramento essencial de banco de dados para o seu ambiente de autenticação do Windows. Para habilitar o monitoramento abrangente com todas as métricas disponíveis, consulte a referência de configuração.

Atualizar Registro de Serviço do Windows

Atualize o Registro de Serviço do Windows para usar o novo arquivo mssql-config.yaml usando um dos seguintes métodos:

Para PowerShell: execute o seguinte 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 prompt de comando: se o PowerShell não estiver disponível, use o prompt de comando e execute o seguinte 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 a configuração do Collector NRDOT para garantir que esteja formatada corretamente e funcione adequadamente:
bash
```
$& "C:\Program Files\nrdot-collector\nrdot-collector.exe" validate --config="C:\Program Files\nrdot-collector\mssql-config.yaml"
```
Dica
Para correlacionar o desempenho do aplicativo com as operações de banco de dados, é possível configurar a identificação de serviço de banco de dados. Para mais informações, consulte configurar a identificação de serviço de banco de dados.

Reiniciar o NRDOT Collector

Após atualizar sua configuração, reinicie o serviço NRDOT Collector:

bash

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

Dica

Sempre reinicie o serviço do NRDOT Collector após fazer alterações na configuração para garantir que as novas configurações entrem em vigor.

Encontre e use seus dados

Assim que seus dados estiverem sendo coletados, você poderá acessar o monitoramento abrangente do banco de dados SQL Server por meio da interface do New Relic.

Para encontrar sua entidade de banco de dados SQL Server no New Relic:

Vá para https://one.newrelic.com > All Capabilities > Databases.
Na dropdown Entity type, selecione MSSQL instance e clique em Apply.
Selecione seu banco de dados SQL Server na lista de entidades.
Após configurar o monitoramento do SQL Server com o NRDOT, você pode:
- Crie dashboards personalizados para visualizar suas métricas de banco de dados
- Configure alertas para limites críticos de desempenho do banco de dados
- Explore seus dados usando os recursos de consulta do New Relic

Pré-requisitos

Antes de monitorar seu Microsoft SQL Server com o NRDOT usando a Autenticação gMSA, certifique-se de que seu ambiente atenda a estes requisitos:

Conta do New Relic com uma chave de licençaválida
Endpoint OTLP da New Relic para sua região
Requisitos do SQL Server, será necessário:
- SQL Server 2017 ou posterior
- Acesso administrativo ao SQL Server (função sysadmin ou equivalente)
- Conectividade de rede entre o coletor e o SQL Server para a porta 1433 ou porta personalizada
- SQL Server Management Studio (SSMS) ou utilitário sqlcmd
Ambiente do Active Directory com suporte a gMSA
O host do Windows deve estar associado ao domínio e autorizado a usar a conta gMSA
Conectividade de rede para o endpoint OTLP da New Relic

Inscreva-se para visualizar

Esta integração está disponível como parte do programa de visualização pública da New Relic. Entre em contato com o gerente da sua organização para aceitar na página Previews & Trials.

Instalar o NRDOT Collector

Baixe e instale o NRDOT Collector usando o 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

Criar usuário de monitoramento

No seu SQL Server Management Studio (SSMS), execute o seguinte script para criar um login para a sua conta gMSA e conceder as permissões necessárias. Substitua todas as ocorrências de <YOUR_DOMAIN>\<YOUR_GMSA_USERNAME> pelo seu domínio real e nome da conta 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

Dica

Para gerenciar informações confidenciais com segurança, como credenciais de banco de dados, armazene-as em ferramentas de gerenciamento de segredos.

Executar como conta gMSA

Após instalar o NRDOT Collector, configure o serviço para ser executado como sua conta gMSA usando o PowerShell. Substitua YOUR_DOMAIN\YOUR_gMSA_ACCOUNT$ pelo seu domínio e nome da conta gMSA. Você deve incluir o $ no final, pois é necessário para contas 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 o NRDOT Collector

Crie um arquivo de configuração nomeado como mssql-config.yaml no PowerShell como administrador:
bash
```
$New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

Adicione a seguinte configuração ao arquivo mssql-config.yaml criado na etapa anterior:

configuração completa

Esta configuração se concentra no monitoramento essencial de banco de dados para o seu ambiente do Windows SQL Server. Para habilitar o monitoramento abrangente com todas as métricas disponíveis, consulte a referência de configuração.

Nome do host/IP do SQL Server

Porta do SQL Server

Endpoint New Relic OTLP

Chave de licença da 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]

Dica

Para correlacionar o desempenho do aplicativo com as operações de banco de dados, é possível configurar a identificação de serviço de banco de dados. Para mais informações, consulte configurar a identificação de serviço de banco de dados.

Atualizar Registro de Serviço do Windows

Atualize o Registro de Serviço do Windows para usar o novo arquivo mssql-config.yaml usando um dos seguintes métodos:

Para PowerShell: execute o seguinte 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 prompt de comando: se o PowerShell não estiver disponível, use o prompt de comando e execute o seguinte 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 a configuração do Collector NRDOT para garantir que esteja formatada corretamente e funcione adequadamente:

bash

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

Reiniciar o NRDOT Collector

Após atualizar sua configuração, reinicie o serviço NRDOT Collector:

bash

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

Dica

Sempre reinicie o serviço do NRDOT Collector após fazer alterações na configuração para garantir que as novas configurações entrem em vigor.

Encontre e use seus dados

Assim que seus dados estiverem sendo coletados, você poderá acessar o monitoramento abrangente do banco de dados SQL Server por meio da interface do New Relic.

Para encontrar sua entidade de banco de dados SQL Server no New Relic:

Vá para https://one.newrelic.com > All Capabilities > Databases.
Na dropdown Entity type, selecione MSSQL instance e clique em Apply.
Selecione seu banco de dados SQL Server na lista de entidades.
Após configurar o monitoramento do SQL Server com o NRDOT, você pode:
- Crie dashboards personalizados para visualizar suas métricas de banco de dados
- Configure alertas para limites críticos de desempenho do banco de dados
- Explore seus dados usando os recursos de consulta do New Relic

Configurar a correlação entre APM e banco de dados

Aprenda a correlacionar o desempenho do seu aplicativo com as operações de banco de dados no New Relic.

Resolução de problemas

Aprenda a solucionar problemas na sua configuração de monitoramento do MSSQL Windows no New Relic.

Referência de métricas

Saiba mais sobre as métricas disponíveis coletadas pelo NRDOT Collector.

Esta tradução de máquina é fornecida para sua comodidade.

Monitoramento de MSSQL auto-hospedado no Windows com NRDOT

Visualização

Pré-requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Inscreva-se para visualizar

Instalar o NRDOT Collector

Criar usuário de monitoramento

Dica

Configurar o NRDOT Collector

configuração completa

Atualizar Registro de Serviço do Windows

Dica

Reiniciar o NRDOT Collector

Dica

Encontre e use seus dados

Pré-requisitos

Inscreva-se para visualizar

Instalar o NRDOT Collector

Criar usuário de monitoramento

Collector em um host diferente do Windows

Dica

Configurar o NRDOT Collector

configuração completa

Dica

Atualizar Registro de Serviço do Windows

Dica

Reiniciar o NRDOT Collector

Dica

Encontre e use seus dados

Pré-requisitos

Inscreva-se para visualizar

Instalar o NRDOT Collector

Criar usuário de monitoramento

Dica

Executar como conta gMSA

Configurar o NRDOT Collector

configuração completa

Dica

Atualizar Registro de Serviço do Windows

Reiniciar o NRDOT Collector

Dica

Encontre e use seus dados

Documentação relacionada

Configurar a correlação entre APM e banco de dados

Resolução de problemas

Referência de métricas

Pré-requisitos