Monitoring MSSQL auto-hébergé sur Linux 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 les environnements auto-hébergés Linux, y compris les serveurs physiques, les machines virtuelles et les déploiements Linux conteneurisés.

Prérequis

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

Configurer le Collector NRDOT

Installer le Collector NRDOT sur votre distribution Linux :

Important

Il est recommandé d'installer le Collector NRDOT sur le même hôte que votre instance SQL Server afin de visualiser les métriques d'infrastructure pour le monitoring des performances des requêtes.

Debian/Ubuntu
Pour l'architecture AMD64 (x86_64) :
bash
```
$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_amd64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb
```
Pour l'architecture ARM64 :
bash
```
$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb
```

RHEL/CentOS

Pour l'architecture AMD64 (x86_64) :

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_x86_64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

Pour l'architecture ARM64 :

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

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 sous Linux, créez un fichier nommé nr-grant-permission.sql sur votre instance Linux avec le contenu suivant :
```
USE [master];
GO
CREATE LOGIN [newrelic] WITH PASSWORD = '<PASSWORD>';
GO
-- Instance-level permissions
GRANT VIEW SERVER STATE TO [newrelic];
GRANT VIEW ANY DEFINITION TO [newrelic];
GRANT VIEW ANY DATABASE TO [newrelic];
GO
-- Grant read access privileges to all user databases
DECLARE @name SYSNAME;
DECLARE db_cursor CURSOR READ_ONLY FORWARD_ONLY FOR
SELECT [name]
FROM [master].[sys].[databases]
WHERE [name] NOT IN ('master', 'msdb', 'model', 'rdsadmin', 'distribution')
AND [state] = 0; -- Only online databases
OPEN db_cursor;
FETCH NEXT FROM db_cursor INTO @name;
WHILE @@FETCH_STATUS = 0
BEGIN
  EXEC('USE [' + @name + '];
          IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = ''newrelic'')
              CREATE USER [newrelic] FOR LOGIN [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
```
Pour exécuter le script, exécutez la commande suivante. Remplacez <Your_SA_Password> par votre mot de passe administrateur SQL Server :
bash
```
$sqlcmd -S localhost -U sa -P '<Your_SA_Password>' -C -i nr-grant-permission.sql
```

(Facultatif) Pour vérifier que l'utilisateur a été créé avec succès et dispose des autorisations appropriées, exécutez la commande suivante. Remplacez <Your_SA_Password> par votre mot de passe administrateur SQL Server :

bash

$sqlcmd -S localhost -U sa -P '<Your_SA_Password>' -C -Q "SELECT sp.name AS [User], p.permission_name AS [Permission_Granted] FROM sys.server_permissions p JOIN sys.server_principals sp ON p.grantee_principal_id = sp.principal_id WHERE sp.name = 'newrelic';"

Résultat attendu :

User Permission_Granted
-------------------------------------------------------------------------------------
<your_username> CONNECT SQL
<your_username> VIEW ANY DEFINITION
<your_username> VIEW ANY DATABASE
<your_username> VIEW SERVER STATE

Cette sortie confirme que votre utilisateur a été créé avec succès avec les permissions requises au niveau du serveur.

Configurer le collecteur NRDOT

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

Cette configuration inclut à la fois les métriques d'hôte d'infrastructure et le monitoring de base de données.

Créez le fichier de configuration. Le nom du fichier doit être mssql-config.yaml:
bash
```
$sudo nano /etc/nrdot-collector/mssql-config.yaml
```

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

Important

Si vous êtes déjà utilisateur du Collector NRDOT, assurez-vous de fusionner la configuration avec votre fichier config.yaml existant. Cela inclut l'ajout des nouveaux récepteurs, processeurs et exportateurs pour le monitoring de la base de données MSSQL tout en conservant vos configurations actuelles.

# NRDOT Collector Configuration for New Relic SQL Server Integration

extensions:
  health_check:

receivers:
  otlp:
    protocols:
      grpc:
      http:

  host_metrics:
    collection_interval: 60s
    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
      filesystem:
        metrics:
          system.filesystem.utilization:
            enabled: true
      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

  file_log:
    include:
      - /var/log/alternatives.log
      - /var/log/cloud-init.log
      - /var/log/auth.log
      - /var/log/dpkg.log
      - /var/log/syslog
      - /var/log/messages
      - /var/log/secure
      - /var/log/yum.log

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

    # 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:
  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, "")

  transform:
    trace_statements:
      - context: span
        statements:
          - truncate_all(span.attributes, 4095)
          - truncate_all(resource.attributes, 4095)
    log_statements:
      - context: log
        statements:
          - truncate_all(log.attributes, 4095)
          - truncate_all(resource.attributes, 4095)

  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:

  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:
        - memory_limiter
        - 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: [file_log, nrsqlserver]
      processors:
        - memory_limiter
        - transform
        - resource_detection
        - resource_detection/cloud
        - resource_detection/env
        - batch
      exporters: [otlphttp]

    traces:
      receivers: [otlp]
      processors: [memory_limiter, transform, resource_detection, resource_detection/cloud, resource_detection/env, batch]
      exporters: [otlphttp]

    metrics:
      receivers: [otlp]
      processors: [memory_limiter, transform, resource_detection, resource_detection/cloud, resource_detection/env, batch]
      exporters: [otlphttp]

    logs:
      receivers: [otlp]
      processors: [memory_limiter, transform, resource_detection, resource_detection/cloud, resource_detection/env, batch]
      exporters: [otlphttp]

Cette configuration se concentre uniquement sur le monitoring de la base de données sans les métriques d'infrastructure de l'hôte.

Créez le fichier de configuration. Le nom du fichier doit être mssql-config.yaml:
bash
```
$sudo nano /etc/nrdot-collector/mssql-config.yaml
```

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 SQL Server with SQL Authentication
# Database Monitoring Only

receivers:
  nrsqlserver:
    collection_interval: 15s
    # Direct connection to SQL Server
    username: <YOUR_USERNAME>
    password: <YOUR_PASSWORD>
    server: <YOUR_SERVER>
    port: 1433

    # 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

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

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.

Mettez à jour le fichier de configuration du collecteur
Exécutez la commande suivante pour modifier la configuration du service :
bash
```
$sudo nano /etc/nrdot-collector/nrdot-collector.conf
```
Mettez à jour le chemin de configuration pour qu'il pointe vers votre nouveau fichier mssql-config.yaml :
bash
```
$OTELCOL_CONFIG="/etc/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
```
$sudo /usr/bin/nrdot-collector validate --config=/etc/nrdot-collector/mssql-config.yaml
```

Redémarrer le collecteur NRDOT

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

bash

$sudo systemctl restart 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.

Prochaines étapes

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

Cette traduction automatique est fournie pour votre commodité.

Monitoring MSSQL auto-hébergé sur Linux avec NRDOT

Aperçu

Prérequis

Configurer le Collector NRDOT

Important

Configurer l'utilisateur de la base de données

Configurer le collecteur NRDOT

Collector NRDOT avec métriques d'hôte + monitoring de base de données

Important

Monitoring de la base de données uniquement (recommandé)

Conseil

Paramètres de configuration

Conseil

Redémarrer le collecteur NRDOT

Conseil

Prochaines étapes

Cette traduction automatique est fournie pour votre commodité.

Monitoring MSSQL auto-hébergé sur Linux avec NRDOT

Aperçu

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

Configurer le Collector NRDOT

Important

Configurer l'utilisateur de la base de données

Configurer le collecteur NRDOT

Monitoring de la base de données uniquement (recommandé)

Conseil

Paramètres de configuration

Conseil

Redémarrer le collecteur NRDOT

Conseil

Prochaines étapes

Prérequis