• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Monitoring MSSQL auto-hébergé Windows avec NRDOT

Aperçu

Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !

Cette fonctionnalité est actuellement fournie dans le cadre d'un aperçu conformément à nos politiques de pré-sortie.

Configurez le monitoring de Microsoft SQL Server à l'aide du collecteur NRDOT sur des environnements Windows auto-hébergés, y compris les serveurs physiques, les machines virtuelles et les installations Windows autonomes.

En fonction de votre configuration de sécurité SQL Server, vous pouvez choisir parmi trois méthodes d'authentification pour connecter le NRDOT Collector à votre instance SQL Server :

Prérequis

Assurez-vous que votre environnement répond à nos exigences de compatibilité et prérequis.

Configurer le collecteur NRDOT

Installez le Collector NRDOT sur votre système Windows.

  1. Téléchargez et installez le NRDOT Collector à l'aide de 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

Configurer l'utilisateur de la base de données

Exécutez le script suivant en tant que root user/sysadmin pour créer l'utilisateur de monitoring newrelic et accorder des droits de lecture globaux.

Pour créer un utilisateur de monitoring newrelic, exécutez le script suivant à l'aide de 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

Configurer le collecteur NRDOT

Sélectionnez votre type de configuration en fonction de vos besoins de monitoring :

Paramètres de configuration

Le tableau suivant décrit les principaux paramètres de configuration du récepteur nrsqlserver :

paramètresDescription
<YOUR_USERNAME>Saisissez votre nom d'utilisateur de base de données pour l'authentification
<YOUR_PASSWORD>Saisissez le mot de passe de votre base de données pour l'authentification
<YOUR_SERVER>Saisissez le nom d'hôte ou l'adresse IP de SQL Server
<YOUR_PORT>Saisissez votre numéro de port SQL Server. La valeur par défaut est 1433.
<YOUR_OTLP_ENDPOINT>Saisissez le point de terminaison OTLP New Relic. Pour plus d'informations, consultez la documentation sur les endpoints OTLP New Relic.
<YOUR_LICENSE_KEY>Entrez votre clé de licence New Relic.
collection_intervalIntervalle en secondes pour collecter les métriques de base de données. Par défaut : 15s

Conseil

Remarque : Si vous activez toutes les métriques disponibles, augmentez la valeur limit_mib (par ex., 1000) pour éviter que le limiteur de mémoire ne supprime des données.

Conseil

Remarque : L'option max_concurrent_queries contrôle le nombre de requêtes de métriques que le récepteur exécute en parallèle sur SQL Server lors de chaque cycle de collecte.

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

Mettre à jour le registre des services Windows

Mettez à jour le registre des services Windows pour utiliser le nouveau fichier mssql-config.yaml.

Méthode 1 : PowerShell

Exécutez la commande suivante dans PowerShell en tant qu'administrateur :

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éthode 2 : invite de commande (alternative)

Si PowerShell n'est pas disponible, vous pouvez utiliser l'invite de commande à la place :

  1. Ouvrez votre menu Démarrer, tapez cmd
  2. Faites un clic droit sur l'invite de commande et choisissez Run as administrator
  3. Copiez et collez cette commande exacte dans la fenêtre CMD noire et appuyez sur Entrée :
sc config "nrdot-collector" binPath= "\"C:\Program Files\nrdot-collector\nrdot-collector.exe\" --config \"C:\Program Files\nrdot-collector\mssql-config.yaml\""

Valider la configuration du Collector NRDOT

Validez la configuration du Collector NRDOT pour vous assurer qu’elle est correctement formatée et qu’elle fonctionnera correctement.

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

Redémarrer le collecteur NRDOT

Après avoir mis à jour votre configuration, redémarrez le service NRDOT Collector :

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

Conseil

Redémarrez toujours le service de collecte NRDOT après avoir modifié la configuration pour vous assurer que les nouveaux paramètres soient pris en compte.

(Facultatif) Configurer la corrélation APM-base de données

Pour corréler les performances de votre application avec les opérations de base de données, vous pouvez configurer l'identification du service de base de données. Cette fonctionnalité vous permet de voir exactement quelles applications génèrent des workloads de base de données spécifiques. Pour plus d'informations, reportez-vous à configurer l'identification du service de base de données pour obtenir la corrélation APM-base de données dans New Relic.

Important

Pour afficher les données de performance de la base de données dans APM, les deux entités doivent se trouver dans le même compte New Relic. Si les entités se trouvent dans des comptes New Relic différents, vous devez avoir accès aux deux comptes pour visualiser les données.

(Facultatif) Configurer la gestion des secrets

La fonctionnalité de gestion des secrets vous permet de gérer en toute sécurité des informations sensibles, telles que les identifiants de base de données. Cela permet de renforcer la sécurité de votre configuration de supervision en évitant de coder en dur des données sensibles dans les fichiers de configuration. Pour plus d'informations, consultez la gestion des secrets.

Trouvez et utilisez vos données

Une fois vos données collectées, vous pouvez accéder à un monitoring complet des bases de données SQL Server via l'interface utilisateur de New Relic.

Pour trouver votre entité de base de données SQL Server dans New Relic :

  1. Allez à https://one.newrelic.com > All Capabilities > Databases.
  2. Dans la liste déroulante Entity type, sélectionnez MSSQL instance, puis cliquez sur Apply.
  3. Sélectionnez votre base de données SQL Server dans la liste des entités.

Prérequis

Assurez-vous que votre environnement répond à nos exigences de compatibilité et prérequis.

Exigences supplémentaires pour l'authentification Windows :

  • Environnement de domaine Windows avec Active Directory
  • SQL Server configuré pour accepter l'authentification Windows
  • Compte utilisateur de domaine avec les permissions SQL Server appropriées
  • Service NRDOT Collector s'exécutant dans le contexte du compte de domaine

Configurer le collecteur NRDOT

Installez le Collector NRDOT sur votre système Windows.

  1. Téléchargez et installez le NRDOT Collector à l'aide de 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

Vérifier la configuration de l'authentification Windows

Assurez-vous que votre SQL Server est configuré pour l'authentification Windows et vérifiez la connectivité.

  1. Vérifiez le nom d'utilisateur Windows :

    SELECT SYSTEM_USER;

  2. Exécutez la commande ci-dessous pour vérifier que les autorisations nécessaires sont accordées (mettez à jour <account_name> avec le nom d'utilisateur de l'étape 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. Si vous n'avez pas les autorisations nécessaires, exécutez les commandes d'octroi suivantes (remplacez <account_name> par votre compte 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

    Important

    Remarques importantes : Remplacez toutes les instances de <account_name> par votre nom de compte Windows réel (par ex., ComputerName\Username). Exécutez ces scripts à l'aide de SQL Server Management Studio (SSMS) ou de l'utilitaire sqlcmd. Le script de vérification vous montrera exactement quelles permissions sont manquantes.

Configurer le collecteur NRDOT

Choisissez votre configuration de monitoring en fonction de vos besoins :

Paramètres de configuration

Le tableau suivant décrit les principaux paramètres de configuration du récepteur nrsqlserver :

paramètresDescription
<YOUR_HOSTNAME>Saisissez le nom d'hôte ou l'adresse IP de SQL Server
<YOUR_PORT>Saisissez votre numéro de port SQL Server. La valeur par défaut est 1433.
<YOUR_OTLP_ENDPOINT>Saisissez le point de terminaison OTLP New Relic. Pour plus d'informations, consultez la documentation sur les endpoints OTLP New Relic.
<YOUR_LICENSE_KEY>Entrez votre clé de licence New Relic.
collection_intervalIntervalle en secondes pour collecter les métriques de base de données. Par défaut : 15s

Conseil

Remarque : Si vous activez toutes les métriques disponibles, augmentez la valeur limit_mib (par ex., 1000) pour éviter que le limiteur de mémoire ne supprime des données.

Conseil

Remarque : L'option max_concurrent_queries contrôle le nombre de requêtes de métriques que le récepteur exécute en parallèle sur SQL Server lors de chaque cycle de collecte.

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

Mettre à jour le registre des services Windows

Mettez à jour le registre des services Windows pour utiliser le nouveau fichier mssql-config.yaml.

Méthode 1 : PowerShell

Exécutez la commande suivante dans PowerShell en tant qu'administrateur :

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éthode 2 : invite de commande (alternative)

Si PowerShell n'est pas disponible, vous pouvez utiliser l'invite de commande à la place :

  1. Ouvrez votre menu Démarrer, tapez cmd
  2. Faites un clic droit sur l'invite de commande et choisissez Run as administrator
  3. Copiez et collez cette commande exacte dans la fenêtre CMD noire et appuyez sur Entrée :
sc config "nrdot-collector" binPath= "\"C:\Program Files\nrdot-collector\nrdot-collector.exe\" --config \"C:\Program Files\nrdot-collector\mssql-config.yaml\""

Valider la configuration du Collector NRDOT

Validez la configuration du Collector NRDOT pour vous assurer qu’elle est correctement formatée et qu’elle fonctionnera correctement.

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

Redémarrer le collecteur NRDOT

Après avoir mis à jour votre configuration, redémarrez le service NRDOT Collector :

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

Conseil

Redémarrez toujours le service de collecte NRDOT après avoir modifié la configuration pour vous assurer que les nouveaux paramètres soient pris en compte.

(Facultatif) Configurer la corrélation APM-base de données

Pour corréler les performances de votre application avec les opérations de base de données, vous pouvez configurer l'identification du service de base de données. Cette fonctionnalité vous permet de voir exactement quelles applications génèrent des workloads de base de données spécifiques. Pour plus d'informations, reportez-vous à configurer l'identification du service de base de données pour obtenir la corrélation APM-base de données dans New Relic.

Important

Pour afficher les données de performance de la base de données dans APM, les deux entités doivent se trouver dans le même compte New Relic. Si les entités se trouvent dans des comptes New Relic différents, vous devez avoir accès aux deux comptes pour visualiser les données.

(Facultatif) Configurer la gestion des secrets

La fonctionnalité de gestion des secrets vous permet de gérer en toute sécurité des informations sensibles, telles que les identifiants de base de données. Cela permet de renforcer la sécurité de votre configuration de supervision en évitant de coder en dur des données sensibles dans les fichiers de configuration. Pour plus d'informations, consultez la gestion des secrets.

Trouvez et utilisez vos données

Une fois vos données collectées, vous pouvez accéder à un monitoring complet des bases de données SQL Server via l'interface utilisateur de New Relic.

Pour trouver votre entité de base de données SQL Server dans New Relic :

  1. Allez à https://one.newrelic.com > All Capabilities > Databases.
  2. Dans la liste déroulante Entity type, sélectionnez MSSQL instance, puis cliquez sur Apply.
  3. Sélectionnez votre base de données SQL Server dans la liste des entités.

Prérequis

Assurez-vous que votre environnement répond à nos exigences de compatibilité et prérequis.

Exigences supplémentaires pour le gMSA (Group Managed Service Account) :

  • Environnement Active Directory avec prise en charge de gMSA
  • Compte gMSA créé et configuré pour l'accès à SQL Server
  • L'hôte Windows doit être joint au domaine et autorisé à utiliser le compte gMSA

Configurer le collecteur NRDOT

Installez le Collector NRDOT sur votre système Windows.

  1. Téléchargez et installez le NRDOT Collector à l'aide de 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

Activez votre Microsoft SQL Server

Ouvrez SSMS, connectez-vous via l'authentification Windows, ouvrez une nouvelle requête, et exécutez le script d'administration de base de données suivant :

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

Important

Remplacez [<DOMAIN>\<gMSA_NAME>$] par votre véritable nom de compte gMSA. Le $ à la fin est requis pour les comptes gMSA.

Configurer le service NRDOT Collector pour s'exécuter en tant que gMSA

Après avoir installé le NRDOT Collector, configurez le service pour qu'il s'exécute sous votre compte gMSA à l'aide de 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

Important

Remplacez DOMAIN\gMSA-Account$ par votre véritable nom de compte gMSA. Notez que le $ à la fin est requis pour les comptes gMSA. Aucun mot de passe n'est nécessaire car gMSA gère l'authentification automatiquement.

Configurer le collecteur NRDOT

Choisissez votre configuration de monitoring en fonction de vos besoins :

Paramètres de configuration

Le tableau suivant décrit les principaux paramètres de configuration du récepteur nrsqlserver :

paramètresDescription
<YOUR_HOSTNAME>Saisissez le nom d'hôte ou l'adresse IP de SQL Server
<YOUR_PORT>Saisissez votre numéro de port SQL Server. La valeur par défaut est 1433.
<YOUR_OTLP_ENDPOINT>Saisissez le point de terminaison OTLP New Relic. Pour plus d'informations, consultez la documentation sur les endpoints OTLP New Relic.
<YOUR_LICENSE_KEY>Entrez votre clé de licence New Relic.
collection_intervalIntervalle en secondes pour collecter les métriques de base de données. Par défaut : 15s

Conseil

Remarque : Si vous activez toutes les métriques disponibles, augmentez la valeur limit_mib (par ex., 1000) pour éviter que le limiteur de mémoire ne supprime des données.

Conseil

Remarque : L'option max_concurrent_queries contrôle le nombre de requêtes de métriques que le récepteur exécute en parallèle sur SQL Server lors de chaque cycle de collecte.

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

Mettre à jour le registre des services Windows

Mettez à jour le registre des services Windows pour utiliser le nouveau fichier mssql-config.yaml.

Méthode 1 : PowerShell

Exécutez la commande suivante dans PowerShell en tant qu'administrateur :

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éthode 2 : invite de commande (alternative)

Si PowerShell n'est pas disponible, vous pouvez utiliser l'invite de commande à la place :

  1. Ouvrez votre menu Démarrer, tapez cmd
  2. Faites un clic droit sur l'invite de commande et choisissez Run as administrator
  3. Copiez et collez cette commande exacte dans la fenêtre CMD noire et appuyez sur Entrée :
sc config "nrdot-collector" binPath= "\"C:\Program Files\nrdot-collector\nrdot-collector.exe\" --config \"C:\Program Files\nrdot-collector\mssql-config.yaml\""

Valider la configuration du Collector NRDOT

Validez la configuration du Collector NRDOT pour vous assurer qu’elle est correctement formatée et qu’elle fonctionnera correctement.

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

Redémarrer le collecteur NRDOT

Après avoir mis à jour votre configuration, redémarrez le service NRDOT Collector :

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

Conseil

Redémarrez toujours le service de collecte NRDOT après avoir modifié la configuration pour vous assurer que les nouveaux paramètres soient pris en compte.

(Facultatif) Configurer la corrélation APM-base de données

Pour corréler les performances de votre application avec les opérations de base de données, vous pouvez configurer l'identification du service de base de données. Cette fonctionnalité vous permet de voir exactement quelles applications génèrent des workloads de base de données spécifiques. Pour plus d'informations, reportez-vous à configurer l'identification du service de base de données pour obtenir la corrélation APM-base de données dans New Relic.

Important

Pour afficher les données de performance de la base de données dans APM, les deux entités doivent se trouver dans le même compte New Relic. Si les entités se trouvent dans des comptes New Relic différents, vous devez avoir accès aux deux comptes pour visualiser les données.

(Facultatif) Configurer la gestion des secrets

La fonctionnalité de gestion des secrets vous permet de gérer en toute sécurité des informations sensibles, telles que les identifiants de base de données. Cela permet de renforcer la sécurité de votre configuration de supervision en évitant de coder en dur des données sensibles dans les fichiers de configuration. Pour plus d'informations, consultez la gestion des secrets.

Trouvez et utilisez vos données

Une fois vos données collectées, vous pouvez accéder à un monitoring complet des bases de données SQL Server via l'interface utilisateur de New Relic.

Pour trouver votre entité de base de données SQL Server dans New Relic :

  1. Allez à https://one.newrelic.com > All Capabilities > Databases.
  2. Dans la liste déroulante Entity type, sélectionnez MSSQL instance, puis cliquez sur Apply.
  3. Sélectionnez votre base de données SQL Server dans la liste des entités.

Prochaines étapes

Après avoir configuré le monitoring auto-hébergé Windows :

Droits d'auteur © 2026 New Relic Inc.
RecrutementConditions de servicePolitique DMCAAvis de confidentialitéWebsite TermsAvis de brevetLoi britannique sur l'esclavage

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