Monitoring de Windows RDS MSSQL 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 dans les environnements Windows pour monitorer les instances AWS RDS pour SQL Server.

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

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 une instance EC2 Windows ou une machine Windows locale qui peut se connecter à votre instance RDS SQL Server.

Important

Pour le monitoring RDS, installez le Collector NRDOT sur une instance EC2 dans le même VPC que votre instance RDS pour une connectivité réseau optimale et une latence plus faible.

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
```
Assurez-vous que votre groupe de sécurité autorise les connexions entrantes de l'hôte du Collector NRDOT vers votre instance RDS sur le port 1433 (ou votre port personnalisé).

Configurer l'utilisateur de la base de données

Connectez-vous à votre instance RDS SQL Server à l'aide de SQL Server Management Studio (SSMS) ou sqlcmd avec vos identifiants d'administrateur.

Exécutez le script suivant pour créer l'utilisateur de monitoring newrelic avec les autorisations appropriées :

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

Conseil

Pour RDS : utilisez votre nom d'utilisateur principal RDS (ou un utilisateur avec le rôle rds_superuser) pour exécuter ces commandes. Le script exclut automatiquement la base de données rdsadmin qui est réservée par AWS.

Configurer le collecteur NRDOT

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

Cette configuration se concentre sur le monitoring essentiel de la base de données avec les métriques principales.

Conseil

Format du point de terminaison RDS : Votre point de terminaison RDS sera au format : your-db-instance.xxxxxxxxxxxx.region.rds.amazonaws.com (par ex., mydb-instance.c9akciq32.us-east-1.rds.amazonaws.com). Trouvez ceci dans votre console AWS RDS sous « Connectivité et sécurité ».

Créez le fichier de configuration. Le nom de fichier doit être mssql-config.yaml. Exécutez la commande suivante dans PowerShell en tant qu'administrateur :
```
New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

Ajoutez le contenu de configuration ci-dessous au fichier mssql-config.yaml que vous avez créé à l'étape précédente.

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

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

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

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

    collect_full_query_text: true
    allowed_comment_keys:
      - nr_service_guid

    # Query sample collection configuration
    query_sample_collection:
      max_rows_per_query: 100

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

  batch:

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

service:
  telemetry:
    metrics:
      level: none

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

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

Cette configuration fournit un monitoring complet de la base de données avec toutes les métriques disponibles.

Conseil

Format du point de terminaison RDS : votre point de terminaison RDS utilise le format : YOUR_DB_INSTANCE.YOUR_AWS_IDENTIFIER.YOUR_REGION.rds.amazonaws.com (par exemple, mydb-instance.c9akciq32.us-east-1.rds.amazonaws.com). Localisez ceci dans la console AWS RDS sous Connectivité et sécurité.

Créez le fichier de configuration. Le nom de fichier doit être mssql-config.yaml. Exécutez la commande suivante dans PowerShell en tant qu'administrateur :
```
New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

Ajoutez le contenu de configuration ci-dessous au fichier mssql-config.yaml que vous avez créé à l'étape précédente.

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

receivers:
  otlp:
    protocols:
      grpc:
      http:

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

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

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

Paramètres de configuration

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

paramètres	Description
`<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_interval`	Intervalle en secondes pour collecter les métriques de base de données. Par défaut : 15s

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

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.

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 :

Ouvrez votre menu Démarrer, tapez cmd
Faites un clic droit sur l'invite de commande et choisissez Run as administrator
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 du Collector NRDOT sur votre machine EC2 ou Windows locale :

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 :

Allez à https://one.newrelic.com > All Capabilities > Databases.
Dans la liste déroulante Entity type, sélectionnez MSSQL instance, puis cliquez sur Apply.
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 de domaine Windows avec RDS :

Environnement de domaine Windows avec Active Directory
Instance EC2 Windows jointe à un domaine ou machine locale
RDS SQL Server configuré pour accepter l’authentification Windows
Compte utilisateur de domaine avec les permissions SQL Server appropriées
Groupe de sécurité configuré pour autoriser les connexions sur le port SQL Server (1433 par défaut)

Activez votre Microsoft SQL Server

Connectez-vous à votre instance RDS SQL Server à l'aide de SQL Server Management Studio (SSMS) ou sqlcmd avec vos identifiants d'administrateur.

Exécutez le script suivant pour créer une connexion de domaine Windows et accorder les autorisations nécessaires :

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

Important

Remplacez DomainName\DomainUser par votre domaine et nom d'utilisateur réels (par ex. CORP\SQLMonitor).

Accorder les privilèges d'accès READ

Utilisez les instructions suivantes pour accorder des privilèges d'accès READ à l'utilisateur du domaine sur toutes les bases de données :

-- Grant access to all databases (required for query monitoring and tempdb metrics)
  DECLARE @name SYSNAME;
  DECLARE db_cursor CURSOR READ_ONLY FORWARD_ONLY FOR
    SELECT [name] FROM [master].[sys].[databases]
    WHERE [name] NOT IN ('master','msdb','model','rdsadmin','distribution')
      AND [state] = 0;
  OPEN db_cursor;
  FETCH NEXT FROM db_cursor INTO @name;
  WHILE @@FETCH_STATUS = 0
  BEGIN
    BEGIN TRY
      EXEC('USE [' + @name + '];
      IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = ''DomainName\DomainUser'')
      BEGIN
        CREATE USER [DomainName\DomainUser] FOR LOGIN [DomainName\DomainUser];
      END;
      GRANT VIEW DATABASE STATE TO [DomainName\DomainUser];');
    END TRY
    BEGIN CATCH
      PRINT 'Error on ' + @name + ': ' + ERROR_MESSAGE();
    END CATCH
    FETCH NEXT FROM db_cursor INTO @name;
  END
  CLOSE db_cursor;
  DEALLOCATE db_cursor;
  GO

Conseil

Pour RDS : Le script exclut automatiquement la base de données rdsadmin qui est réservée par AWS. Assurez-vous de remplacer DomainName\DomainUser par vos véritables identifiants de domaine.

Configurer le Collector NRDOT

Installez le Collector NRDOT sur une instance EC2 Windows jointe au domaine ou une machine Windows locale qui fait partie du même domaine et peut se connecter à votre instance RDS SQL Server.

Important

Pour le monitoring RDS, installez le Collector NRDOT sur une instance EC2 dans le même VPC que votre instance RDS pour une connectivité réseau optimale et une latence plus faible.

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

Modifier la connexion au service pour un compte de domaine (à l'aide de PowerShell) :
Configurez le service Collector NRDOT pour qu’il s’exécute en tant qu’utilisateur de domaine à l’aide de PowerShell :
```
# Configure service to use domain account
# The space after obj= and password= is required syntax for sc.exe
sc.exe config "nrdot-collector" obj= "DomainName\DomainUser" password= "<password>"

# Restart the service
Restart-Service nrdot-collector
```
Vérifiez l’identité du service :
```
Get-WmiObject Win32_Service -Filter "Name='nrdot-collector'" | Select Name, State, StartName
# Expected: StartName = DomainName\DomainUser
```
Important
Remplacez DomainName\DomainUser par votre domaine et nom d'utilisateur réels (par ex., CORP\SQLMonitor), et <password> par le mot de passe de l'utilisateur du domaine.
Assurez-vous que votre groupe de sécurité autorise les connexions entrantes de l'hôte du Collector NRDOT vers votre instance RDS sur le port 1433 (ou votre port personnalisé).

Configurer le collecteur NRDOT

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

Cette configuration se concentre sur le monitoring essentiel de la base de données avec les métriques principales.

Conseil

Format du point de terminaison RDS : Votre point de terminaison RDS sera au format : your-db-instance.xxxxxxxxxxxx.region.rds.amazonaws.com. Trouvez ceci dans votre console AWS RDS sous « Connectivité et sécurité ».

Important

L’authentification de domaine Windows utilise la sécurité intégrée (authentification Windows), qui utilise la même approche de configuration que l’authentification gMSA. Mettez simplement à jour la valeur du serveur datasource vers votre point de terminaison RDS. Le service NRDOT s’authentifiera à l’aide du compte de domaine que vous avez configuré à l’étape 3.

Créez le fichier de configuration. Le nom de fichier doit être mssql-config.yaml. Exécutez la commande suivante dans PowerShell en tant qu'administrateur :
```
New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

Ajoutez le contenu de configuration ci-dessous au fichier mssql-config.yaml que vous avez créé à l'étape précédente. Utilisez la configuration ci-dessous avec votre point de terminaison RDS :

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

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

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

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

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

    collect_full_query_text: true
    allowed_comment_keys:
      - nr_service_guid

    # Query sample collection configuration
    query_sample_collection:
      max_rows_per_query: 100

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

  batch:

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

service:
  telemetry:
    metrics:
      level: none

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

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

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

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.

Cette configuration fournit un monitoring complet de la base de données avec toutes les métriques disponibles.

Conseil

Créez le fichier de configuration. Le nom de fichier doit être mssql-config.yaml. Exécutez la commande suivante dans PowerShell en tant qu'administrateur :
```
New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

Ajoutez le contenu de configuration ci-dessous au fichier mssql-config.yaml que vous avez créé à l'étape précédente.

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

receivers:
  otlp:
    protocols:
      grpc:
      http:

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

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

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

Paramètres de configuration

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

paramètres	Description
`<YOUR_RDS_ENDPOINT>`	Saisissez votre point de terminaison RDS 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 (par ex., https://otlp.nr-data.net). Pour plus d'informations, consultez la documentation sur les points de terminaison OTLP New Relic.
`<YOUR_LICENSE_KEY>`	Entrez votre clé de licence New Relic.
`collection_interval`	Intervalle en secondes pour collecter les métriques de base de données. Par défaut : 15s

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 :

Ouvrez votre menu Démarrer, tapez cmd
Faites un clic droit sur l'invite de commande et choisissez Run as administrator
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 du Collector NRDOT sur votre instance EC2 Windows jointe au domaine :

net stop nrdot-collector
net start nrdot-collector

Conseil

Vérifiez que le service s’exécute sous le compte de domaine en vérifiant les services Windows (services.msc). La colonne « Ouvrir une session en tant que » devrait afficher votre compte de domaine (par ex., CORP\SQLMonitor).

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

Important

(Facultatif) Configurer 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 :

Allez à https://one.newrelic.com > All Capabilities > Databases.
Dans la liste déroulante Entity type, sélectionnez MSSQL instance, puis cliquez sur Apply.
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 gMSA (Group Managed Service Account) avec RDS :

Environnement Active Directory avec prise en charge de gMSA
Compte gMSA créé et configuré pour l'accès à SQL Server
Instance EC2 Windows jointe au domaine autorisée à utiliser le compte gMSA
Groupe de sécurité configuré pour autoriser les connexions sur le port SQL Server (1433 par défaut)

Activez votre Microsoft SQL Server

Connectez-vous à votre instance RDS SQL Server et exécutez les commandes SQL suivantes pour créer une connexion pour le compte gMSA et accorder les autorisations nécessaires :

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

Important

Remplacez DomainName\gMSA par votre nom de domaine réel et le nom de votre compte gMSA (par ex., CORP\SQL-gMSA$). Notez que les comptes gMSA se terminent généralement par un symbole $.

Accorder les privilèges d'accès READ

Utilisez les instructions suivantes pour accorder les privilèges d'accès READ au compte gMSA sur toutes les bases de données :

-- 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 DomainName\gMSA par votre nom de domaine réel et le nom de votre compte gMSA (par ex., CORP\SQL-gMSA$). Ce script crée un utilisateur de base de données pour le compte gMSA dans toutes les bases de données utilisateur, à l'exclusion des bases de données système et des bases de données spécifiques à RDS.

Configurer le Collector NRDOT

Installez le Collector NRDOT sur une instance EC2 Windows jointe au domaine et autorisée à utiliser le compte gMSA.

Important

Pour RDS avec gMSA, le Collector NRDOT doit être installé sur une instance EC2 Windows jointe au domaine qui possède les autorisations pour utiliser le compte gMSA. Assurez-vous que votre groupe de sécurité autorise les connexions à RDS sur le port 1433.

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 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= "DomainName\gMSA" password= ""'

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

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

Important

Remplacez DomainName\gMSA par votre domaine et nom de compte gMSA réels (par ex. CORP\SQL-gMSA$). Notez le mot de passe vide – les comptes gMSA ne nécessitent pas de mot de passe.

Configurer le collecteur NRDOT

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

Cette configuration se concentre sur le monitoring essentiel de la base de données avec les métriques principales.

Conseil

Important

La configuration utilise la sécurité intégrée de Windows (gMSA). Mettez simplement à jour la valeur du serveur datasource vers votre point de terminaison RDS.

Créez le fichier de configuration. Le nom de fichier doit être mssql-config.yaml. Exécutez la commande suivante dans PowerShell en tant qu'administrateur :
```
New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

Ajoutez le contenu de configuration ci-dessous au fichier mssql-config.yaml que vous avez créé à l'étape précédente.

Utilisez la configuration ci-dessous avec votre point de terminaison RDS :

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

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

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

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

    collect_full_query_text: true
    allowed_comment_keys:
      - nr_service_guid

    # Query sample collection configuration
    query_sample_collection:
      max_rows_per_query: 100

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

  batch:

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

service:
  telemetry:
    metrics:
      level: none

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

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

Exemple avec le point de terminaison RDS : server=mydb-instance.c9akciq32.us-east-1.rds.amazonaws.com

Cette configuration fournit un monitoring complet de la base de données avec toutes les métriques disponibles.

Conseil

Créez le fichier de configuration. Le nom de fichier doit être mssql-config.yaml. Exécutez la commande suivante dans PowerShell en tant qu'administrateur :
```
New-Item -Path "C:\Program Files\nrdot-collector\mssql-config.yaml" -ItemType File
```

Ajoutez le contenu de configuration ci-dessous au fichier mssql-config.yaml que vous avez créé à l'étape précédente.

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

receivers:
  otlp:
    protocols:
      grpc:
      http:

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

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

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

Paramètres de configuration

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

paramètres	Description
`<YOUR_RDS_ENDPOINT>`	Saisissez votre point de terminaison RDS 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_interval`	Intervalle en secondes pour collecter les métriques de base de données. Par défaut : 15s

Conseil

L'option max_concurrent_queries contrôle combien de requêtes de métriques le Récepteur exécute en parallèle sur SQL Server pendant chaque cycle de récupération.

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

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.

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 :

Ouvrez votre menu Démarrer, tapez cmd
Faites un clic droit sur l'invite de commande et choisissez Run as administrator
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.

bash

$& "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 du Collector NRDOT sur votre instance EC2 Windows jointe au domaine :

bash

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

Conseil

Vérifiez que le service s’exécute sous le compte gMSA en vérifiant les services Windows (services.msc). La colonne « Log On As » devrait afficher votre compte gMSA (par ex., CORP\SQL-gMSA$).

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

Important

(Facultatif) Configurer 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 :

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

Prochaines étapes

Après avoir configuré le monitoring RDS Windows :

Cette traduction automatique est fournie pour votre commodité.

Monitoring de Windows RDS MSSQL avec NRDOT

Aperçu

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

Configurer le collecteur NRDOT

Important

Configurer l'utilisateur de la base de données

Conseil

Configurer le collecteur NRDOT

Configuration avec toutes les fonctionnalités

Paramètres de configuration

Conseil

Conseil

Mettre à jour le registre des services Windows

Valider la configuration du Collector NRDOT

Redémarrer le collecteur NRDOT

Conseil

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

Important

(Facultatif) Configurer la gestion des secrets

Trouvez et utilisez vos données

Prérequis

Activez votre Microsoft SQL Server

Important

Accorder les privilèges d'accès READ

Conseil

Configurer le Collector NRDOT

Important

Important

Configurer le collecteur NRDOT

Configuration standard

Configuration avec toutes les fonctionnalités

Paramètres de configuration

Mettre à jour le registre des services Windows

Valider la configuration du Collector NRDOT

Redémarrer le collecteur NRDOT

Conseil

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

Important

(Facultatif) Configurer la gestion des secrets

Trouvez et utilisez vos données

Prérequis

Activez votre Microsoft SQL Server

Important

Accorder les privilèges d'accès READ

Important

Configurer le Collector NRDOT

Important

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

Important

Configurer le collecteur NRDOT

Configuration standard

Configuration avec toutes les fonctionnalités

Paramètres de configuration

Conseil

Conseil

Mettre à jour le registre des services Windows

Valider la configuration du Collector NRDOT

Redémarrer le collecteur NRDOT

Conseil

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

Important

(Facultatif) Configurer la gestion des secrets

Trouvez et utilisez vos données

Prochaines étapes

Prérequis