Surveillance de MySQL

Le capteur prend en charge les mêmes systèmes d'exploitation que les agents hôtes d' Instana. Pour plus de détails, consultez la section « Systèmes d'exploitation pris en charge » de chaque agent hôte, par exemple :

• Systèmes d'exploitation pris en charge par l' Unix
• Systèmes d'exploitation pris en charge par l' Linux
• Systèmes d'exploitation pris en charge par l' Windows

Le capteur prend en charge les versions suivantes d' MySQL:

• 5.6.x
• 5.7.x
• 8.0.x
• 8.4.x
• 9.1.x

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

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

Pour cette technologie, Instana prend en charge le traçage côté client pour les langages et environnements d'exécution suivants :

• Java
• Go
• Node.js
• PHP
• Python
• .NET Framework
• .Net Core

Pour que l'agent d' Instana s puisse se connecter en toute sécurité à votre base de données MySQL, utilisez les paramètres suivants dans le fichier de <agent_install_dir>/etc/instana/configuration.yamlconfiguration de l'agent :

com.instana.plugin.mysql:
  enabled: true
  user: '<username>'
  password: '<password>'
  poll_rate: 10 #Values are in seconds. Default Value 1 Sec.
  schema_excludes: ['INFORMATION_SCHEMA', 'PERFORMANCE_SCHEMA'] #optional
  sslKeyStore: '/path/to/keystore.jks'
  sslKeyStorePassword: '<keystore password>'
  #disableSslHostnameVerification: true

Les clés doivent être au format Java Keystore (JKS). L'outil keytool permet de les créer.

Pour assurer la compatibilité avec les versions récentes d' MySQL (en particulier celles qui utilisent caching_sha2_password l'authentification), vous devez utiliser une version mise à jour du pilote Connector/J d' MySQL :

1. Téléchargez la dernière version du pilote Connector/J d' MySQL sur la page de téléchargement du site MySQL.

2. Copiez le fichier JAR téléchargé (par exemple, mysql-connector-j-9.6.0.jar) dans le répertoire de déploiement de l'agent Instana :

   cp mysql-connector-j-9.6.0.jar <agent_install_dir>/deploy/

Pour que le capteur puisse collecter des informations de performance sur le SGBD, un accès en lecture seule au schéma PERFORMANCE_SCHEMA est requis.

• Pour les versions de MySQL antérieures à 8.0.0, consultez l'exemple suivant pour savoir comment créer un compte avec les droits requis:

  GRANT REPLICATION CLIENT ON *.* TO '<instana_mon_user>'@'localhost' IDENTIFIED BY 'instana_mon_pwd';
  GRANT SELECT ON 'performance_schema'.'events_waits_summary_global_by_event_name' TO '<instana_mon_user>'@'localhost' IDENTIFIED BY 'instana_mon_pwd';
  GRANT SELECT ON 'performance_schema'.'events_statements_summary_by_digest' TO '<instana_mon_user>'@'localhost' IDENTIFIED BY 'instana_mon_pwd';
  GRANT SELECT ON 'performance_schema'.'events_statements_summary_global_by_event_name' TO '<instana_mon_user>'@'localhost' IDENTIFIED BY 'instana_mon_pwd';
  GRANT SELECT ON 'performance_schema'.'replication_connection_status' TO '<instana_mon_user>'@'localhost' IDENTIFIED BY 'instana_mon_pwd';
   

• Pour MySQL version 8.0.0 ou ultérieure, consultez l'exemple suivant pour savoir comment créer un compte avec les droits requis:

  GRANT REPLICATION CLIENT ON *.* TO '<instana_mon_user>'@'localhost';
  GRANT SELECT ON performance_schema.events_waits_summary_global_by_event_name TO '<instana_mon_user>'@'localhost';
  GRANT SELECT ON performance_schema.events_statements_summary_by_digest TO '<instana_mon_user>'@'localhost';
  GRANT SELECT ON performance_schema.events_statements_summary_global_by_event_name TO '<instana_mon_user>'@'localhost';
  GRANT SELECT ON performance_schema.replication_connection_status TO '<instana_mon_user>'@'localhost';
   

• Pour les versions de MySQL antérieures à 8.0.0, pour accorder le droit PROCESS à tous les schémas de base de données de l'utilisateur SQL, exécutez la commande suivante:

  GRANT PROCESS ON *.* TO <instana_mon_user>'@'localhost' IDENTIFIED BY 'instana_mon_pwd';
   

• Pour MySQL version 8.0.0 ou ultérieure, pour accorder le droit PROCESS à tous les schémas de base de données de l'utilisateur SQL, exécutez la commande suivante:

  GRANT PROCESS ON *.* TO '<instana_mon_user>'@'localhost';
   

  La partie nom d'hôte du nom de compte dépend de votre configuration MySQL .

• Pour activer ces compteurs, exécutez les commandes suivantes:

  SET GLOBAL innodb_monitor_enable = 'trx_nl_ro_commits';
  SET GLOBAL innodb_monitor_enable = 'trx_ro_commits';
  SET GLOBAL innodb_monitor_enable = 'trx_rollbacks';
  SET GLOBAL innodb_monitor_enable = 'trx_rw_commits';
   

À partir de la version 266, Instana surveille automatiquement MySQL 8.0.0 et les versions ultérieures. Vous n'avez pas besoin d'ajouter manuellement le fichier JAR du pilote « MySQL » au dossier de déploiement de l'agent « Instana ».

Pour les versions antérieures, Instana ne propose pas de surveillance automatique d' MySQL pour MySQL 8.0.0 et les versions ultérieures, pour des raisons liées aux licences. Vous devez donc récupérer manuellement le fichier JAR du pilote « MySQL » à partir du référentiel Maven, puis l'ajouter au dossier de deploy l'agent Instana à l'aide de la <agent_install_dir>/deploy/ commande. La version fichier jar du pilote MySQL obtenu à partir du référentiel Maven doit être 8.0.16 ou une version plus récente.

• ID du processus
• Port
• Version
• Heure de début
• Rôle
• Nombre max de connexions

Pour chaque capteur, il existe une base de connaissances des signatures d'intégrité qui sont évaluées en permanence par rapport aux métriques entrantes et qui sont utilisées pour traiter les problèmes ou les incidents en fonction de l'impact sur l'utilisateur.

Les événements intégrés déclenchent des problèmes ou des incidents en fonction de signatures d'intégrité défaillantes sur des entités, tandis que les événements personnalisés déclenchent des problèmes ou des incidents en fonction des seuils d'une métrique spécifique à une entité donnée.

Pour plus d'informations sur les événements générés pour le détecteur MySQL , voir la référence des événements intégrés.

Si un message d'erreur similaire à :

java.sql.SQLSyntaxErrorException: (conn=2) Table 'performance_schema.global_status' doesn't exist
 

apparaît dans le journal de l'agent Instana, il est fort probable que votre copie de serveur MySQL a été compilée avec le schéma de performances désactivé par défaut. Il s'agit d'un bogue connu.

Pour résoudre le problème, vous pouvez essayer de l'activer à partir de l'interface de ligne de commande MySQL :

mysql> set @@global.show_compatibility_56=ON;
Query OK, 0 rows affected (0.00 sec)
 

puis vérifier qu'il est bien activé :

mysql>select @@show_compatibility_56;
+-------------------------+
| @@show_compatibility_56 |
+-------------------------+
|                       1 |
+-------------------------+
1 row in set (0.00 sec)
 

Une fois activé, mysql>show status; doit maintenant fonctionner. Redémarrez l'agent Instana.

Si un message d'erreur similaire à :

The server time zone value 'CEST' is unrecognized or represents more than one time zone.
You must configure either the server or JDBC driver (via the serverTimezone configuration property)
to use a more specifc time zone value if you want to utilize time zone support.
 

apparaît dans le journal de l'agent Instana, le fuseau horaire du serveur doit être configuré.

Il s'agit d'un problème connu car MySQL ne lit pas correctement le fuseau horaire de l'hôte.

L'erreur peut être corrigée comme expliqué dans MySQL Server Time Zone Support.

Si un message d'erreur similaire à :

Client does not support authentication protocol requested by server
 

apparaît dans le journal de l'agent Instana. Vous devez utiliser mysql_native_password à la place du mécanisme caching_sha2_password :

mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password'
mysql> flush privileges;
 

Il peut arriver que vous voyiez apparaître le message d'erreur suivant dans le journal de l'agent hôte d' Instana :

Agent could not connect to MySQL.  Could not connect: Access denied for user 'user'@'ipaddress/hostname' (using password: YES)
 

Dans ce cas, vous devez modifier l'utilisateur MySQL pour utiliser un autre nom d'hôte dans le côté MySQL . Par exemple, si vous avez créé un utilisateur MySQL sous le nom de user@localhost, vous devez modifier le nom de l'utilisateur dans la section MySQL pour le remplacer par « user »@« adresse IP ou nom d'hôte », comme indiqué dans le message d'erreur, puis mettre à jour le champ com.instana.plugin.mysql > user dans le fichier de configuration de l'agent en indiquant le « nom d'utilisateur » sans le nom d'hôte, car l'agent détecte automatiquement le nom d'hôte. Cette erreur peut se produire lorsque MySQL est exécuté dans un conteneur.