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 ».
Prise en charge du traçage côté client
Pour cette technologie, Instana prend en charge le traçage côté client pour les langages et environnements d'exécution suivants :
Configuration du capteur MS SQL Server
Instana prend en charge la surveillance locale et à distance pour le capteur MS SQL.
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.yamlconfiguration 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 lalocalbalise. 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.
| 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