• /
  • EnglishEspañolFrançais日本語한국어Português
  • EntrarComeçar agora

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

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

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 coletor NRDOT em ambientes auto-hospedados do Windows, incluindo servidores físicos, máquinas virtuais e instalações autônomas do Windows.

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

Certifique-se de que seu ambiente atenda à nossa compatibilidade e pré-requisitos.

Configurar o Coletor NRDOT

Instale o NRDOT Collector no seu sistema Windows.

  1. Baixe e instale o NRDOT Collector usando o 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 usuário do banco de dados

Execute o seguinte script como um root user/sysadmin para criar o usuário de monitoramento newrelic e conceder permissões globais de leitura.

Para criar um usuário de monitoramento newrelic, execute o seguinte script usando o SQL Server Management Studio (SSMS):

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

Configurar o NRDOT Collector

Selecione o seu tipo de configuração com base nas suas necessidades de monitoramento:

Parâmetro de configuração

A tabela a seguir descreve os principais parâmetros de configuração para o receptor nrsqlserver:

ParâmetroDescrição
<YOUR_USERNAME>Insira seu nome de usuário do banco de dados para autenticação
<YOUR_PASSWORD>Insira a senha do seu banco de dados para autenticação
<YOUR_SERVER>Insira o nome do host ou endereço IP do SQL Server
<YOUR_PORT>Insira o número da porta do SQL Server. O valor padrão é 1433.
<YOUR_OTLP_ENDPOINT>Insira o endpoint OTLP da New Relic. Para mais informações, consulte a documentação dos endpoints OTLP da New Relic.
<YOUR_LICENSE_KEY>Insira sua chave de licença do New Relic.
collection_intervalIntervalo em segundos para coletar métricas de banco de dados. Padrão: 15s

Dica

Observação: se você habilitar todas as métricas disponíveis, aumente o valor de limit_mib (por exemplo, 1.000) para evitar que o limitador de memória descarte dados.

Dica

Nota: a opção max_concurrent_queries controla quantas consultas de métrica o receiver executa em paralelo no SQL Server durante cada ciclo de scrape.

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

Atualizar Registro de Serviço do Windows

Atualize o Registro de Serviço do Windows para usar o novo arquivo mssql-config.yaml.

Método 1: PowerShell

Execute o seguinte comando no 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: prompt de comando (alternativa)

Se o PowerShell não estiver disponível, você pode usar o prompt de comando em vez disso:

  1. Abra o menu Iniciar, digite cmd
  2. Clique com o botão direito do mouse no prompt de comando e escolha Run as administrator
  3. Copie e cole este comando exato na janela preta do CMD e pressione Enter:
sc config "nrdot-collector" binPath= "\"C:\Program Files\nrdot-collector\nrdot-collector.exe\" --config \"C:\Program Files\nrdot-collector\mssql-config.yaml\""

Validar a Configuração do NRDOT Collector

Valide a configuração do Collector NRDOT para garantir que esteja formatada corretamente e funcione de maneira adequada.

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

Reiniciar o coletor NRDOT

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 coletor NRDOT após fazer alterações na configuração para garantir que as novas configurações entrem em vigor.

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

Para correlacionar o desempenho da sua aplicação com as operações de banco de dados, você pode configurar a identificação de serviço de banco de dados. Este recurso permite visualizar exatamente quais aplicativos estão gerando workloads específicas de banco de dados. Para mais informações, consulte configurar a identificação de serviço de banco de dados para obter a correlação APM-banco de dados no New Relic.

Importante

Para visualizar dados de desempenho do banco de dados no APM, ambas as entidades devem estar na mesma conta New Relic. Se as entidades estiverem em contas diferentes da New Relic, você deve ter acesso a ambas as contas para visualizar os dados.

(Opcional) Configurar o gerenciamento de segredos

O recurso de gerenciamento de segredos permite gerenciar com segurança informações confidenciais, como credenciais de banco de dados. Isso ajuda a aprimorar a segurança do seu ambiente de monitoramento ao evitar a inserção direta de dados sensíveis nos arquivos de configuração. Para mais informações, consulte gerenciamento de segredos.

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:

  1. Vá para https://one.newrelic.com > All Capabilities > Databases.
  2. Na dropdown Entity type, selecione MSSQL instance e clique em Apply.
  3. Selecione seu banco de dados SQL Server na lista de entidades.

Pré-requisitos

Certifique-se de que seu ambiente atenda à nossa compatibilidade e pré-requisitos.

Requisitos adicionais para a Autenticação do Windows:

  • 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
  • Serviço do NRDOT Collector em execução no contexto da conta de domínio

Configurar o Coletor NRDOT

Instale o NRDOT Collector no seu sistema Windows.

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

Verifique a configuração da Autenticação do Windows

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

  1. Verifique o nome de usuário do Windows:

    SELECT SYSTEM_USER;

  2. Execute o comando abaixo para verificar se as permissões necessárias foram concedidas (atualize <account_name> com o nome de usuário da etapa 1):

    DECLARE @TargetUser SYSNAME = '<account_name>'; -- <-- 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];

  3. Se você não tiver as permissões necessárias, execute as seguintes concessões (substitua <account_name> pela sua conta do Windows):

    USE [master];
    GO
    

    -- 1. Grant Instance-level permissions to your Windows Account
    GRANT VIEW SERVER STATE TO [<account_name>];
    GRANT VIEW ANY DEFINITION TO [<account_name>];
    GRANT VIEW ANY DATABASE TO [<account_name>];
    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_name>'')
                BEGIN
                    CREATE USER [<account_name>] FOR LOGIN [<account_name>];
                END;
                GRANT VIEW DATABASE STATE TO [<account_name>];
                GRANT VIEW DEFINITION TO [<account_name>];
                ALTER ROLE db_datareader ADD MEMBER [<account_name>];';
    

            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

    Importante

    Notas importantes:

    • Substitua todas as instâncias de <account_name> pelo nome real da sua conta do Windows (por exemplo, ComputerName\Username)
    • Execute estes scripts usando o SQL Server Management Studio (SSMS) ou utilitário sqlcmd
    • O script de verificação mostrará exatamente quais permissões estão faltando

Configurar o NRDOT Collector

Escolha sua configuração de monitoramento com base em suas necessidades:

Parâmetro de configuração

A tabela a seguir descreve os principais parâmetros de configuração para o receptor nrsqlserver:

ParâmetroDescrição
<YOUR_HOSTNAME>Insira o nome do host ou endereço IP do SQL Server
<YOUR_PORT>Insira o número da porta do SQL Server. O valor padrão é 1433.
<YOUR_OTLP_ENDPOINT>Insira o endpoint OTLP da New Relic. Para mais informações, consulte a documentação dos endpoints OTLP da New Relic.
<YOUR_LICENSE_KEY>Insira sua chave de licença do New Relic.
collection_intervalIntervalo em segundos para coletar métricas de banco de dados. Padrão: 15s

Dica

Observação: se você habilitar todas as métricas disponíveis, aumente o valor de limit_mib (por exemplo, 1.000) para evitar que o limitador de memória descarte dados.

Dica

Nota: a opção max_concurrent_queries controla quantas consultas de métrica o receiver executa em paralelo no SQL Server durante cada ciclo de scrape.

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

Atualizar Registro de Serviço do Windows

Atualize o Registro de Serviço do Windows para usar o novo arquivo mssql-config.yaml.

Método 1: PowerShell

Execute o seguinte comando no 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: prompt de comando (alternativa)

Se o PowerShell não estiver disponível, você pode usar o prompt de comando em vez disso:

  1. Abra o menu Iniciar, digite cmd
  2. Clique com o botão direito do mouse no prompt de comando e escolha Run as administrator
  3. Copie e cole este comando exato na janela preta do CMD e pressione Enter:
sc config "nrdot-collector" binPath= "\"C:\Program Files\nrdot-collector\nrdot-collector.exe\" --config \"C:\Program Files\nrdot-collector\mssql-config.yaml\""

Validar a Configuração do NRDOT Collector

Valide a configuração do Collector NRDOT para garantir que esteja formatada corretamente e funcione de maneira adequada.

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

Reiniciar o coletor NRDOT

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 coletor NRDOT após fazer alterações na configuração para garantir que as novas configurações entrem em vigor.

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

Para correlacionar o desempenho da sua aplicação com as operações de banco de dados, você pode configurar a identificação de serviço de banco de dados. Este recurso permite visualizar exatamente quais aplicativos estão gerando workloads específicas de banco de dados. Para mais informações, consulte configurar a identificação de serviço de banco de dados para obter a correlação APM-banco de dados no New Relic.

Importante

Para visualizar dados de desempenho do banco de dados no APM, ambas as entidades devem estar na mesma conta New Relic. Se as entidades estiverem em contas diferentes da New Relic, você deve ter acesso a ambas as contas para visualizar os dados.

(Opcional) Configurar o gerenciamento de segredos

O recurso de gerenciamento de segredos permite gerenciar com segurança informações confidenciais, como credenciais de banco de dados. Isso ajuda a aprimorar a segurança do seu ambiente de monitoramento ao evitar a inserção direta de dados sensíveis nos arquivos de configuração. Para mais informações, consulte gerenciamento de segredos.

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:

  1. Vá para https://one.newrelic.com > All Capabilities > Databases.
  2. Na dropdown Entity type, selecione MSSQL instance e clique em Apply.
  3. Selecione seu banco de dados SQL Server na lista de entidades.

Pré-requisitos

Certifique-se de que seu ambiente atenda à nossa compatibilidade e pré-requisitos.

Requisitos adicionais para gMSA (Group Managed Service Account):

  • Ambiente do Active Directory com suporte a gMSA
  • Conta gMSA criada e configurada para acesso ao SQL Server
  • O host do Windows deve estar associado ao domínio e autorizado a usar a conta gMSA

Configurar o Coletor NRDOT

Instale o NRDOT Collector no seu sistema Windows.

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

Habilite seu Microsoft SQL Server

Abra o SSMS, faça login via Autenticação do Windows, abra uma Nova consulta e execute o seguinte script de administração de banco de dados:

USE master;
GO


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


-- Grant monitoring permissions
GRANT VIEW SERVER STATE TO [<DOMAIN>\<gMSA_NAME>$];
GRANT VIEW ANY DEFINITION TO [<DOMAIN>\<gMSA_NAME>$];
GRANT VIEW ANY DATABASE TO [<DOMAIN>\<gMSA_NAME>$];
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 = ''<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

Substitua [<DOMAIN>\<gMSA_NAME>$] pelo nome real da sua conta gMSA. O $ no final é obrigatório para contas gMSA.

Configurar o Serviço NRDOT Collector para Ser Executado como gMSA

Após instalar o NRDOT Collector, configure o serviço para ser executado como sua conta gMSA usando o 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= "DOMAIN\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

Importante

Substitua DOMAIN\gMSA-Account$ pelo nome real da sua conta gMSA. Observe que o $ no final é necessário para contas gMSA. Nenhuma senha é necessária, pois a gMSA lida com a autenticação automaticamente.

Configurar o NRDOT Collector

Escolha sua configuração de monitoramento com base em suas necessidades:

Parâmetro de configuração

A tabela a seguir descreve os principais parâmetros de configuração para o receptor nrsqlserver:

ParâmetroDescrição
<YOUR_HOSTNAME>Insira o nome do host ou endereço IP do SQL Server
<YOUR_PORT>Insira o número da porta do SQL Server. O valor padrão é 1433.
<YOUR_OTLP_ENDPOINT>Insira o endpoint OTLP da New Relic. Para mais informações, consulte a documentação dos endpoints OTLP da New Relic.
<YOUR_LICENSE_KEY>Insira sua chave de licença do New Relic.
collection_intervalIntervalo em segundos para coletar métricas de banco de dados. Padrão: 15s

Dica

Observação: se você habilitar todas as métricas disponíveis, aumente o valor de limit_mib (por exemplo, 1.000) para evitar que o limitador de memória descarte dados.

Dica

Nota: a opção max_concurrent_queries controla quantas consultas de métrica o receiver executa em paralelo no SQL Server durante cada ciclo de scrape.

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

Atualizar Registro de Serviço do Windows

Atualize o Registro de Serviço do Windows para usar o novo arquivo mssql-config.yaml.

Método 1: PowerShell

Execute o seguinte comando no 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: prompt de comando (alternativa)

Se o PowerShell não estiver disponível, você pode usar o prompt de comando em vez disso:

  1. Abra o menu Iniciar, digite cmd
  2. Clique com o botão direito do mouse no prompt de comando e escolha Run as administrator
  3. Copie e cole este comando exato na janela preta do CMD e pressione Enter:
sc config "nrdot-collector" binPath= "\"C:\Program Files\nrdot-collector\nrdot-collector.exe\" --config \"C:\Program Files\nrdot-collector\mssql-config.yaml\""

Validar a Configuração do NRDOT Collector

Valide a configuração do Collector NRDOT para garantir que esteja formatada corretamente e funcione de maneira adequada.

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

Reiniciar o coletor NRDOT

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 coletor NRDOT após fazer alterações na configuração para garantir que as novas configurações entrem em vigor.

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

Para correlacionar o desempenho da sua aplicação com as operações de banco de dados, você pode configurar a identificação de serviço de banco de dados. Este recurso permite visualizar exatamente quais aplicativos estão gerando workloads específicas de banco de dados. Para mais informações, consulte configurar a identificação de serviço de banco de dados para obter a correlação APM-banco de dados no New Relic.

Importante

Para visualizar dados de desempenho do banco de dados no APM, ambas as entidades devem estar na mesma conta New Relic. Se as entidades estiverem em contas diferentes da New Relic, você deve ter acesso a ambas as contas para visualizar os dados.

(Opcional) Configurar o gerenciamento de segredos

O recurso de gerenciamento de segredos permite gerenciar com segurança informações confidenciais, como credenciais de banco de dados. Isso ajuda a aprimorar a segurança do seu ambiente de monitoramento ao evitar a inserção direta de dados sensíveis nos arquivos de configuração. Para mais informações, consulte gerenciamento de segredos.

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:

  1. Vá para https://one.newrelic.com > All Capabilities > Databases.
  2. Na dropdown Entity type, selecione MSSQL instance e clique em Apply.
  3. Selecione seu banco de dados SQL Server na lista de entidades.

Próximos passos

Após configurar o monitoramento auto-hospedado do Windows:

Copyright © 2026 New Relic Inc.
CarreirasTermos de serviçoPolítica do DMCAAviso de privacidadeWebsite TermsAviso de patenteUK Slavery Act

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.