mysql_perf_analyzer

Analyseur de performances MySQL

MySQL Performance Analyzer est un projet open source pour la surveillance et l'analyse des performances MySQL. Ce référentiel comprend deux sous-projets :

• Projet d'application Web Java myperf
• Wrapper de jetée de serveur Web Java

Construire

MySQL Performance Analyzer est un projet Java Maven. JDK et Maven 3.0 ou version ultérieure sont requis pour le construire.

Bien que JDK 8 soit spécifié dans pom.xml, ce projet n'utilise pas de fonctionnalités spécifiques à Java 8, l'utilisateur peut donc modifier les fichiers pom.xml des deux sous-projets pour utiliser une version différente de JDK. Par exemple, si l'hôte de build ne dispose que du JDK 7, modifiez le fichier myperf/pom.xml, changez les lignes

  	<source>1.8</source>
	<target>1.8</target>

à

	<source>1.7</source>
	<target>1.7</target>

La construction créera un fichier zip nommé myperfserver-server.zip sous le répertoire perfJettyServer/target. Pour le construire, au niveau supérieur, exécutez

  mvn clean package

Instructions d'installation et d'utilisation

1. Condition : Java JDK 8, ou celui spécifié dans pom.xml s'il est modifié pendant la construction.

2. Décompressez myperfserver-server.zip dans le répertoire d'installation souhaité. Si vous avez l'intention d'installer sur un hôte Windows, veuillez consulter deux scripts shell et créer un équivalent Windows.

   Pour les futures mises à jour, la plupart du temps, il vous suffit de copier myperf/target/myperf.war dans le répertoire webapps sous le répertoire d'installation, puis de redémarrer.

3. Pour une installation plus formelle, il est recommandé d'avoir un serveur de base de données MySQL comme back-store pour stocker les métriques. Sinon, utilisez la base de données Derby intégrée.

   • Créez par exemple une base de données nommée métriques avec le serveur de base de données MySQL.
   • Créez un utilisateur MySQL (par exemple, 'metrics'@'my_host' -> ici my_host est la machine sur laquelle vous analysez les performances MySQL) avec tous les privilèges sur le schéma ci-dessus.
   • Les informations ci-dessus seront requises lors de votre première connexion à l'analyseur pour configurer la collecte de métriques.

4. Consultez le script start_myperf.sh pour voir si vous devez modifier des paramètres de ligne de commande. Habituellement, le numéro de port est le seul que vous devez modifier

   • -f : config, chemin du fichier de configuration. Si elles sont utilisées, les valeurs du fichier de configuration seront chargées en premier, mais peuvent être écrasées par des arguments de ligne de commande.
   • -j : jettyHome, laissez-le tel quel
   • -p : port http à utiliser, 9092 par défaut
   • -w : fichier war (archive Web), doit être myperf.war
   • -k : répertoire de travail, s'il n'est pas spécifié, il utilisera ./work
   • -c : contexte d'URL, par défaut /myperf, laissez-le tel quel.

   Voici la liste autorisée dans le fichier de configuration, qui utilise le format de fichier de propriétés Java (paires nom=valeur)

   • jetéeAccueil
   • useHttps : valeur oui/y/non/n/true/false
   • port
   • racine de contexte Web
   • répertoire de travail
   • chemin de journalisation
   • fichier de guerre
   • certKeyStorePath
   • certKeyStorePassword

   Pour prendre en charge https, un certificat SSL doit être fourni (soit auto-signé, soit signé par un tiers) et stocké dans le magasin de clés Java à l'aide de Java keytool (voir https://wiki.eclipse.org/Jetty/Howto/Configure_SSL). Si vous rencontrez un problème de connexion lors du basculement entre SSL et non SSL, vous devez supprimer le cookie du navigateur provenant du serveur hébergeant cette application, à l'aide de n'importe quel outil de cookie fourni par le navigateur.

   Modifiez le chemin de la commande Java dans start_myperf.sh, si nécessaire, par exemple lorsque plusieurs packages JDK sont installés.

5. Démarrer:

      ./start_myperf.sh
   

   Vérifiez nohup.out et le répertoire des journaux pour tous les journaux d'erreurs.

6. Fermer:

      ./stop_myperf.sh
   

7. Première connexion et configuration

Après le démarrage, pointez votre navigateur vers http://your_host:9092/myperf (ou le numéro de port que vous avez modifié). Ou https://your_host:9092/myperf si https est correctement configuré.

L'utilisateur et les informations d'identification initiales sont myperf/change.

Après vous être connecté, vous serez dirigé vers la page de configuration :

• Vous pouvez ajouter une adresse e-mail pour les notifications. L'e-mail utilise la commande "mailx" du système d'exploitation.

• Configurez la base de données de stockage des métriques à l'aide de celle que vous avez créée lors des étapes précédentes.

  Un intervalle d’analyse des métriques de 1 ou 5 minutes devrait suffire.

• Si vous utilisez DerbyDB intégré, choisissez des jours de rétention courts.

• Une fois la configuration terminée, vous devez démarrer le scanner (bouton "Démarrer le scanner" en haut de la page).

  Chaque fois que vous modifiez la configuration, vous devez redémarrer le scanner.

• Si le scanner ne fonctionne pas comme prévu, redémarrez l'analyseur

     ./stop_myperf.sh
  

  alors

     ./start_myperf.sh
  

• Si votre SNMP n'utilise pas de communauté par défaut, ou pas la version v2c, utilisez l'onglet "Paramètres SNMP" pour configurer SNMP. Actuellement, seul SNMP basé sur Linux est pris en charge. Si vos serveurs MySQL ne fonctionnent pas sous Linux, utilisez l'onglet « Paramètres d'alerte » pour désactiver l'interrogation des métriques SNMP.

8. Pour chaque serveur de base de données que vous souhaitez surveiller, vous devez créer un utilisateur MySQL avec les privilèges suivants :

   • processus
   • client de réplication
   • afficher les bases de données
   • afficher la vue
   • sélectionnez sur tout (si vous souhaitez l'utiliser pour vérifier le dictionnaire de données ou exécuter des plans d'explication)

9. L'analyseur s'appuie sur Linux SNMP pour collecter des données au niveau du système d'exploitation. Vérifiez l'état du service snmpd.

10. Intégration Hipchat : si vous utilisez hipchat pour une collaboration liée au travail, vous pouvez créer une salle hipchat pour recevoir des alertes de MySQL Perf Analyzer. Vérifiez https://developer.atlassian.com/hipchat/tutorials/building-a-simple-add-on-using-a-wizard pour savoir comment configurer l'intégration de hipchat. Après avoir obtenu l'URL de notification hipchat et le jeton d'authentification, vous pouvez configurer MySQL Perf Analyzer pour envoyer une notification à votre salle, à l'aide de la page Paramètres.

Limites connues

1. SNMP est basé sur la spécification Linux.
2. La notification par courrier électronique utilise la commande "mailx" de Linux.

Licence

Ce code est sous licence Apache. Voir le fichier LICENSE pour les termes.