mysql_perf_analyzer

MySQL-Leistungsanalysator

MySQL Performance Analyzer ist ein Open-Source-Projekt zur Überwachung und Analyse der MySQL-Leistung. Dieses Repository umfasst zwei Unterprojekte:

• Java-Webanwendungsprojekt myperf
• Jetty-Wrapper für Java-Webserver

Bauen

MySQL Performance Analyzer ist ein Java Maven-Projekt. Zum Erstellen sind JDK und Maven 3.0 oder höher erforderlich.

Obwohl JDK 8 in pom.xml angegeben ist, verwendet dieses Projekt keine Java 8-spezifischen Funktionen, sodass der Benutzer die pom.xml-Dateien der beiden Unterprojekte ändern kann, um unterschiedliche JDK-Versionen zu verwenden. Wenn der Build-Host beispielsweise nur über JDK 7 verfügt, ändern Sie die Datei myperf/pom.xml und ändern Sie die Zeilen

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

Zu

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

Der Build erstellt eine ZIP-Datei mit dem Namen myperfserver-server.zip im Verzeichnis perfJettyServer/target. Um es zu erstellen, führen Sie auf der obersten Ebene Folgendes aus:

  mvn clean package

Installations- und Nutzungsanweisungen

1. Voraussetzung: Java JDK 8 oder das in pom.xml angegebene, falls es während der Erstellungszeit geändert wurde.

2. Entpacken Sie myperfserver-server.zip in das gewünschte Installationsverzeichnis. Wenn Sie beabsichtigen, auf einem Windows-Host zu installieren, überprüfen Sie bitte zwei Shell-Skripte und erstellen Sie ein Windows-Äquivalent.

   Für zukünftige Updates müssen Sie meist nur myperf/target/myperf.war in das Verzeichnis webapps unter dem Installationsverzeichnis kopieren und dann neu starten.

3. Für eine formellere Installation wird empfohlen, einen MySQL-Datenbankserver als Backstore zum Speichern der Metriken zu verwenden. Andernfalls verwenden Sie die integrierte Derby-Datenbank.

   • Erstellen Sie mit dem MySQL-Datenbankserver eine Datenbank, beispielsweise mit dem Namen metrics.
   • Erstellen Sie einen MySQL-Benutzer (zum Beispiel „metrics“@„my_host“ -> hier ist „my_host“ der Computer, auf dem Sie den MySQL-Leistungsanalysator verwenden) mit allen Berechtigungen für das obige Schema.
   • Die oben genannten Informationen sind erforderlich, wenn Sie sich zum ersten Mal beim Analysegerät anmelden, um die Metrikerfassung einzurichten.

4. Überprüfen Sie das Skript start_myperf.sh, um festzustellen, ob Sie Befehlszeileneinstellungen ändern müssen. Normalerweise ist die Portnummer die einzige, die Sie ändern müssen

   • -f: config, Pfad der Konfigurationsdatei. Bei Verwendung werden zuerst die Werte in der Konfigurationsdatei geladen, können aber durch Befehlszeileneinstellungen überschrieben werden.
   • -j: jettyHome, lass es so wie es ist
   • -p: Zu verwendender HTTP-Port, standardmäßig 9092
   • -w: WAR-Datei (Webarchiv), muss myperf.war sein
   • -k: Arbeitsverzeichnis. Wenn nicht angegeben, wird ./work verwendet
   • -c: URL-Kontext, standardmäßig /myperf, belassen Sie es so wie es ist.

   Im Folgenden finden Sie die in der Konfigurationsdatei zulässigen Listen, die das Java-Eigenschaftendateiformat verwenden (Name=Wert-Paare).

   • StegHome
   • useHttps: Wert ja/j/nein/n/wahr/falsch
   • Hafen
   • webcontextroot
   • Arbeitsverzeichnis
   • Protokollpfad
   • Warfile
   • certKeyStorePath
   • certKeyStorePassword

   Um https zu unterstützen, sollte ein SSL-Zertifikat bereitgestellt werden (entweder selbstsigniert oder von einem Dritten signiert) und im Java-Keystore mit dem Java-Keytool gespeichert werden (siehe https://wiki.eclipse.org/Jetty/Howto/Configure_SSL). Wenn beim Wechsel zwischen SSL und Nicht-SSL ein Anmeldeproblem auftritt, müssen Sie das Browser-Cookie, das vom Server stammt, der diese Anwendung hostet, mithilfe eines vom Browser bereitgestellten Cookie-Tools entfernen.

   Ändern Sie den Java-Befehlspfad in start_myperf.sh bei Bedarf, beispielsweise wenn mehrere JDK-Pakete installiert sind.

5. Start-up:

      ./start_myperf.sh
   

   Überprüfen Sie nohup.out und das Protokollverzeichnis auf Fehlerprotokolle.

6. Abschalten:

      ./stop_myperf.sh
   

7. Erstmalige Anmeldung und Einrichtung

Richten Sie Ihren Browser nach dem Start auf http://your_host:9092/myperf (oder die von Ihnen geänderte Portnummer). Oder https://your_host:9092/myperf, wenn https richtig konfiguriert ist.

Der anfängliche Anmeldebenutzer und die Anmeldeinformationen lauten myperf/change.

Nach der Anmeldung werden Sie zur Einrichtungsseite weitergeleitet:

• Sie können eine E-Mail-Adresse für Benachrichtigungen hinzufügen. Die E-Mail verwendet den Betriebssystembefehl „mailx“.

• Konfigurieren Sie die Metrikspeicherdatenbank mithilfe der Datenbank, die Sie in den vorherigen Schritten erstellt haben.

  Ein Metrik-Scan-Intervall von 1 oder 5 Minuten sollte ausreichend sein.

• Wenn Sie das integrierte Derbydb verwenden, wählen Sie kurze Aufbewahrungstage.

• Nachdem die Konfiguration abgeschlossen ist, müssen Sie den Scanner starten (Schaltfläche „Scanner starten“ oben auf der Seite).

  Jedes Mal, wenn Sie die Konfiguration ändern, müssen Sie den Scanner neu starten.

• Wenn der Scanner nicht wie erwartet funktioniert, starten Sie den Analysator neu

     ./stop_myperf.sh
  

  Dann

     ./start_myperf.sh
  

• Wenn Ihr SNMP eine nicht standardmäßige Community oder nicht die Version v2c verwendet, verwenden Sie die Registerkarte „SNMP-Einstellungen“, um SNMP zu konfigurieren. Derzeit wird nur Linux-basiertes SNMP unterstützt. Wenn Ihre MySQL-Server nicht unter Linux laufen, verwenden Sie die Registerkarte „Warnungseinstellungen“, um die SNMP-Metrikabfrage zu deaktivieren.

8. Für jeden Datenbankserver, den Sie überwachen möchten, müssen Sie einen MySQL-Benutzer mit den folgenden Berechtigungen erstellen:

   • Verfahren
   • Replikationsclient
   • Datenbanken anzeigen
   • Ansicht anzeigen
   • Alles auswählen (wenn Sie damit das Datenwörterbuch überprüfen oder Erklärungspläne ausführen möchten)

9. Der Analysator nutzt Linux SNMP, um Daten auf Betriebssystemebene zu sammeln. Überprüfen Sie den SNMPD-Dienststatus.

10. Hipchat-Integration: Wenn Sie Hipchat für die arbeitsbezogene Zusammenarbeit verwenden, können Sie einen Hipchat-Raum erstellen, um Benachrichtigungen von MySQL Perf Analyzer zu erhalten. Unter https://developer.atlassian.com/hipchat/tutorials/building-a-simple-add-on-using-a-wizard erfahren Sie, wie Sie die Hipchat-Integration einrichten. Nachdem Sie die Hipchat-Benachrichtigungs-URL und das Authentifizierungstoken haben, können Sie MySQL Perf Analyzer über die Seite „Einstellungen“ so konfigurieren, dass Benachrichtigungen an Ihren Raum gesendet werden.

Bekannte Einschränkungen

1. SNMP basiert auf der Linux-Spezifikation.
2. Die E-Mail-Benachrichtigung verwendet den Linux-Befehl „mailx“.

Lizenz

Dieser Code ist unter der Apache-Lizenz lizenziert. Die Bedingungen finden Sie in der LICENSE-Datei.