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'
    
 

Distante

Pour la surveillance à distance, utilisez la configuration suivante :

com.instana.plugin.mssql:
  remote:
    ...
    sslTrustStoreLocation: '/path/to/truststore.jks'
    sslTrustStorePassword: 'trustStorePassword'
    
 

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
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 au niveau des instances AG

Pour les instances d' SQL Server s faisant partie d'un groupe de disponibilité Always On, les métriques supplémentaires suivantes sont collectées au niveau de l'instance.

Remarque : ces indicateurs n'apparaissent pas sur le tableau de bord par défaut de l'instance, mais peuvent être utilisés dans les tableaux de bord personnalisés et lors de la création d'événements.
Métrique Description Granularité
Rôle de réplique Rôle actuel de la réplique : résolutrice, principale ou secondaire 1 seconde
Etat connecté État de connexion de la réplique : déconnectée ou connectée 1 seconde
Santé de la synchronisation État général de la synchronisation de la réplique : Correct, Partiellement correct ou Incorrect 1 seconde

Indicateurs AG au niveau de l'entité

Pour les groupes de disponibilité (AG) Always On d' Microsoft SQL Server, le capteur crée également une entité AG distincte qui recueille des métriques agrégées et des données de configuration.

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é
Nombre de répliques Nombre total de répliques dans le groupe de disponibilité 1 seconde
Nombre de bases de données Nombre total de bases de données dans le groupe de disponibilité 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