Surveillance de Microsoft SQL Server

Le capteur « Microsoft SQL Server » est automatiquement déployé et installé une fois que vous avez installé l'agent « Instana ».

Informations de support

Pour vous assurer que le capteur d' Microsoft SQL Server s est compatible avec votre configuration actuelle, consultez les sections d'informations d'assistance suivantes :

Systèmes d'exploitation pris en charge

Le capteur est compatible avec les systèmes d'exploitation suivants :

  • Windows
  • Linux

Versions prises en charge et politique d'assistance

Le capteur prend en charge les versions suivantes d' Microsoft SQL Server :

  • SQL Server 2016
  • SQL Server 2017
  • SQL Server 2019
  • SQL Server 2022

Le capteur prend également en charge la surveillance des groupes de disponibilité (AG) Always On d' Microsoft SQL Server, pour les configurations de haute disponibilité et de reprise après sinistre.

Le tableau suivant présente la dernière version prise en charge et la politique d'assistance :

Technologie Politique de support Dernière version technologique Dernière version prise en charge
Microsoft SQL Server 45 jours 2025 2025

Pour plus d'informations sur la politique d'assistance, consultez la section « Stratégie d'assistance pour les capteurs ».

Configuration du capteur MS SQL Server

Instana prend en charge la surveillance locale et à distance pour le capteur MS SQL.

Remarque : lorsque vous configurez la surveillance de MS SQL avec Instana, assurez-vous que le nom de l'instance et le port sont corrects. Avec l'authentification « SQL Server », le numéro de port a priorité sur le nom de l'instance. Par conséquent, même si le nom de l'instance est incorrect, une connexion peut tout de même être établie en utilisant le port et les identifiants d'utilisateur indiqués. Toutefois, un port incorrect pourrait entraîner une situation où Instana surveillerait la mauvaise instance.

Locale

Vous devez installer l'agent hôte d' Instana sur le même système que celui sur lequel Microsoft SQL Server est installé. Pour installer l'agent hôte d' Instana sur Windows, consultez la rubrique « Installation de l'agent hôte sur Windows ». Pour installer l'agent hôte d' Instana sur Linux, consultez la rubrique « Installation de l'agent hôte sur Linux ».

Une fois l'agent « Instana » installé, le capteur «MS SQL Server » est activé par défaut. Vous pouvez choisir la manière dont l'agent Instana se connecte à SQL Server comme suit :

  • SQL Server Authentification : si vous indiquez l'instance, le nom d'utilisateur, le mot de passe et le port (en clair) dans le fichier de *instanaAgentDir*/etc/instana/configuration.yaml configuration de l'agent, comme le montre la configuration suivante, l'agent se connecte à l' SQL Server e en utilisant l'authentification SQL Server :

    Remarque : la conception du capteur de surveillance local a été mise à jour afin de prendre en charge plusieurs instances de base de données utilisant l'authentification par le service d'authentification de Microsoft ( SQL Server ). Par conséquent, toutes les configurations de surveillance locale doivent désormais être définies sous la local balise. Toutefois, cette conception reste compatible avec la configuration existante permettant de surveiller une seule instance de base de données, qui continue d'être prise en charge.
    com.instana.plugin.mssql:
      local: # multiple configurations supported
        - instance: 'MSSQLSERVER'  # instance name of MsSQL Server
          user: 'mssql'
          password: 'password'
          port: '1433'
          poll_rate: 60 # seconds.
          top_queries_poll_rate: 120 # seconds.
     
  • Windows Authentification : si vous laissez la section de configuration du fichier de configuration de l'agent en commentaire ou si vous ne renseignez pas le nom d'utilisateur et le mot de passe, l'agent tente de se connecter en utilisant l'authentification Windows. Lorsque l'authentification « Windows » est utilisée, l'agent s'authentifie à l'aide des identifiants sous lesquels il s'exécute.

  • poll_rate: spécifiez le taux d'interrogation. Par défaut, la valeur est 1 seconde.

  • top_queries_poll_rate: spécifiez le taux d'interrogation pour les premières requêtes. Par défaut, la valeur est de 60 secondes.

    Lorsque vous utilisez l'authentification « Windows », assurez-vous que votre compte dispose des autorisations nécessaires, comme indiqué dans la section « Autorisations requises pour le serveur ou la base de données ».

Distante

Pour la surveillance à distance, utilisez la configuration suivante :

com.instana.plugin.mssql:
  remote: # multiple configurations supported
    - host: 'host-1'
      instance: 'MSSQLSERVER02' #Instance name of MSSQL Server
      user: 'mssql'
      password: 'password'
      port: '1434'
      availabilityZone: 'MSSQLSERVER02_REMOTE'
      poll_rate: 60 # seconds
      top_queries_poll_rate: 120 # seconds
 

L'instance MS SQL distante configurée s'affiche alors dans une zone distincte, à l'emplacement spécifié availabilityZone sur le tableau de bord Infrastructure de l'interface utilisateur d' Instana.

Configuration de l'assistance pour SSL ou TLS

Pour que l'agent d' Instana puisse se connecter en toute sécurité à votre MS SQL Server, configurez les fichiers de <agent_install_dir>/etc/instana/configuration.yaml configuration de l'agent comme suit :

Locale

Pour la surveillance locale, utilisez la configuration suivante :

com.instana.plugin.mssql:
  local:
    ...
    sslTrustStoreLocation: '/path/to/truststore.jks'
    sslTrustStorePassword: 'trustStorePassword'
    certificateHostname: '<hostname>' # hostname given in SAN or CN of SSL/TLS certificate.

Distante

Pour la surveillance à distance, utilisez la configuration suivante :

com.instana.plugin.mssql:
  remote:
    ...
    sslTrustStoreLocation: '/path/to/truststore.jks'
    sslTrustStorePassword: 'trustStorePassword'
    certificateHostname: '<hostname>' # hostname given in SAN or CN of SSL/TLS certificate.

Paramètres réseau

Si vous utilisez la base de données Microsoft SQL et l'agent Instana sur un système Windows, assurez-vous que le protocole TCP/IP est activé et que le service SQL Server Browser est en cours d'exécution.

Configurer un port personnalisé

Si vous souhaitez spécifier un port personnalisé que le détecteur doit utiliser pour surveiller l'instance (autre que le port par défaut 1433), indiquez la zone de port dans le fichier de configuration de l'agent:

com.instana.plugin.mssql:
  port: 2529    # custom Microsoft SQL TCP port
 

Autorisations requises pour le serveur ou la base de données

Instana interroge les vues de gestion dynamique (DMV) sur SQL Server à l'aide des identifiants d'utilisateur spécifiés dans le fichier de configuration de l'agent. Vérifiez que l'utilisateur SQL spécifié dans le fichier de configuration de l'agent dispose des droits VIEW SERVER STATE et VIEW DATABASE STATE . Pour plus d'informations sur ces droits, voir Vues de gestion dynamique du système.

Collecte des métriques

Pour consulter les métriques, sélectionnez « Infrastructure » dans la barre latérale de l'interface utilisateur d' Instana, cliquez sur un hôte surveillé spécifique, puis vous verrez s'afficher un tableau de bord de l'hôte contenant toutes les métriques collectées et les processus surveillés.

Indicateurs au niveau de l'instance

Les indicateurs suivants sont collectés au niveau de l'instance d' SQL Server :

Données de configuration

  • Nom de l'instance
  • Version
  • ID du processus
  • Heure de début

Métriques de performance

Métrique Description Granularité
Connexions utilisateur Nombre de connexions utilisateur 1 seconde
Connexion maximum Nombre maximal de connexions utilisateur simultanées. Par défaut, la valeur est 0, ce qui signifie qu'un nombre illimité d'utilisateurs peuvent se connecter. Pour modifier cette valeur, consultez l'option de configuration du serveur « Configurer les connexions utilisateur ». 1 seconde
Temps d'attente sur le serveur Page IO-Latch EX, Page IO-Latch SH, Async Network IO, CX-Packet, Writelog 1 seconde
Lectures et écritures Lectures et écritures de fichier virtuel en octets 1 seconde
Transactions Nombre de transactions d'écriture 1 seconde
Erreurs Erreurs concernant l'utilisateur, la base de données hors ligne et la suppression de connexion 1 seconde
Verrous Nombre de demandes de verrouillage et de blocages 1 seconde
Mémoire BD Mémoire de base de données utilisée et capacité en Mo 1 seconde
Mémoire virtuelle Mémoire virtuelle en Mo 1 seconde
Délai de réponse Temps de réponse de la transaction 1 seconde
Taux de réussite en cache de la base de données Taux de réussite des recherches dans le cache de la base de données en% 1 seconde
Métriques de stockage

Les indicateurs de volume de disque suivants sont collectés au niveau de l'instance :

Métrique Description Granularité
Taille totale des fichiers de base de données Taille totale de tous les fichiers de base de données en mégaoctets 1 seconde
Taille totale du disque Capacité totale du volume de disque en mégaoctets 1 seconde
Espace disque disponible Espace libre disponible sur le disque, en mégaoctets 1 seconde
Pourcentage d'utilisation du disque par les fichiers Pourcentage de la capacité du disque utilisé par les fichiers de base de données 1 seconde
Indicateurs d'augmentation automatique de la taille des fichiers de base de données

Les indicateurs suivants permettent d'évaluer le potentiel de croissance et l'utilisation de chaque fichier de base de données :

Métrique Description Granularité
Taille actuelle du fichier de base de données Taille actuelle du fichier de base de données en mégaoctets 1 seconde
Pourcentage utilisé par Autogrow Pourcentage de la taille maximale du fichier qui est actuellement utilisé 1 seconde
Base de données
Métrique Description Granularité
Connexions utilisateur Nombre de connexions utilisateur 1 seconde
Lectures et écritures Lectures et écritures de fichier virtuel en octets 1 seconde
Transactions Nombre de transactions d'écriture 1 seconde
Principales requêtes

Vous trouverez la section « Requêtes les plus fréquentes » sur le tableau de bord de votre SQL Server. Ce tableau répertorie les 50 requêtes les plus fréquentes (en fonction du temps qu'elles prennent) adressées à l'instance surveillée. Outre l'instruction SQL traitée, vous pouvez consulter les indicateurs suivants :

Métrique Description Granularité
Durée d'exécution Durée totale et dernière exécution 60 secondes
Lectures logiques Dernières lectures logiques 60 secondes
Ecritures logiques Dernières écritures logiques 60 secondes

Indicateurs AG au niveau de l'entité

Pour les groupes de disponibilité (AG) « Always On » d’ Microsoft SQL Server, le capteur crée une entité AG distincte qui collecte les métriques agrégées et les données de configuration relatives au groupe de disponibilité et à ses répliques.

Données de configuration

Métrique Description
Nom du groupe de disponibilité Nom du groupe de disponibilité Always On
Nom du cluster WSFC Nom du cluster WSFC ( Windows -Server Failover Clustering)
Nombre de programmes d'écoute Nombre total d'écouteurs configurés pour le groupe de disponibilité

Métriques de performance

Métrique Description Granularité
État de la réplique connectée État de connexion de la réplique : déconnectée ou connectée 1 seconde
Mode de disponibilité Mode de disponibilité de la réplique : validation asynchrone, validation synchrone ou configuration uniquement 1 seconde
Santé de la synchronisation État de synchronisation de la réplique : Non conforme, Partiellement conforme ou Conforme 1 seconde
Mode de reprise en ligne Mode de basculement de la réplique : basculement automatique ou basculement manuel 1 seconde
Rôle Rôle de la réplique : de résolution, principale ou secondaire 1 seconde
Etat de la base de données État de la base de données dans le groupe de disponibilité : En ligne, En cours de restauration, En cours de récupération, Récupération en attente, Suspect, Urgence ou Hors ligne 1 seconde
Etat de la synchronisation État de synchronisation de la base de données au sein du groupe de disponibilité 1 seconde
Taille de la file d'attente d'envoi des journaux Nombre d'enregistrements de journalisation non encore envoyés à la réplique secondaire, en kilo-octets 1 seconde
Taille de la file d'attente de réexécution Nombre d'enregistrements de journal sur la réplique secondaire qui n'ont pas encore été répercutés, en kilo-octets 1 seconde
Fréquence d'envoi des journaux Fréquence à laquelle les entrées de journal sont envoyées à la réplique secondaire 1 seconde
Taux de reprise Fréquence à laquelle les entrées du journal sont réécrites sur la réplique secondaire 1 seconde
Latence (en secondes) Délai de réplication entre la réplique principale et la réplique secondaire, en secondes 1 seconde

Dépannage des connexions cryptées ( SSL ou TLS )

Si l'agent d' Instana s ne parvient pas à se connecter à votre serveur MSSQL chiffré, importez votre certificat de confiance dans le fichier (jvm/jre/lib/security/cacerts) cacerts de votre JRE à l'aide de la commande keytool suivante :

keytool -import -alias ALIAS_NAME -keystore "/path/to/jre/cacerts" -file YOUR_CERTIFICATE_NAME.crt