mysql_perf_analyzer

Analizador de rendimiento MySQL

MySQL Performance Analyzer es un proyecto de código abierto para el seguimiento y análisis del rendimiento de MySQL. Este repositorio incluye dos subproyectos:

• Proyecto de aplicación web Java myperf
• Envoltorio de embarcadero del servidor web Java

Construir

MySQL Performance Analyzer es un proyecto Java Maven. Se requieren JDK y Maven 3.0 o posterior para compilarlo.

Aunque JDK 8 está especificado en pom.xml, este proyecto no utiliza características específicas de Java 8, por lo que el usuario puede modificar los archivos pom.xml de los dos subproyectos para usar una versión diferente de JDK. Por ejemplo, si el host de compilación solo tiene JDK 7, modifique el archivo myperf/pom.xml, cambie las líneas

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

a

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

La compilación creará un archivo zip llamado myperfserver-server.zip en el directorio perfJettyServer/target. Para construirlo, en el nivel superior, ejecute

  mvn clean package

Instrucciones de instalación y uso

1. Requisito: Java JDK 8, o el especificado en pom.xml si se modifica durante el tiempo de compilación.

2. Descomprima myperfserver-server.zip en el directorio de instalación deseado. Si desea realizar la instalación en un host de Windows, revise dos scripts de shell y cree un equivalente de Windows.

   Para futuras actualizaciones, la mayoría de las veces solo necesita copiar myperf/target/myperf.war al directorio webapps en el directorio de instalación y luego reiniciar.

3. Para una instalación más formal, se recomienda tener un servidor de base de datos MySQL como back store para almacenar las métricas. De lo contrario, utilice la base de datos derby incorporada.

   • Cree una base de datos, por ejemplo, nombrada como métricas, con el servidor de base de datos MySQL.
   • Cree un usuario de MySQL (por ejemplo, 'metrics'@'my_host' -> aquí my_host es la máquina donde analiza el rendimiento de MySQL) con todos los privilegios en el esquema anterior.
   • La información anterior será necesaria cuando inicie sesión por primera vez en el analizador para configurar la recopilación de métricas.

4. Revise el script start_myperf.sh para ver si necesita modificar alguna configuración de la línea de comando. Generalmente, el número de puerto es el único que necesita cambiar

   • -f: config, ruta del archivo de configuración. Si se usan, los valores dentro del archivo de configuración se cargarán primero, pero se pueden sobrescribir mediante elementos de línea de comando.
   • -j: embarcaderoHome, déjalo como está
   • -p: puerto http a utilizar, 9092 por defecto
   • -w: archivo war (archivo web), tiene que ser myperf.war
   • -k: directorio de trabajo, si no se especifica, usará ./work
   • -c: contexto de la URL, por defecto /myperf, déjelo como está.

   La siguiente es la lista permitida en el archivo de configuración, que utiliza el formato de archivo de propiedades de Java (pares nombre=valor)

   • embarcaderoInicio
   • useHttps: valor sí/y/no/n/true/false
   • puerto
   • raíz de contexto web
   • directorio de trabajo
   • ruta de registro
   • archivo de guerra
   • certKeyStorePath
   • certKeyStoreContraseña

   Para admitir https, se debe proporcionar un certificado SSL (ya sea autofirmado o firmado por un tercero) y almacenarlo en el almacén de claves de Java utilizando la herramienta de claves de Java (consulte https://wiki.eclipse.org/Jetty/Howto/Configure_SSL). Si encuentra un problema de inicio de sesión al cambiar entre SSL y no SSL, debe eliminar la cookie del navegador originada en el servidor que aloja esta aplicación, utilizando cualquier herramienta de cookies proporcionada por el navegador.

   Modifique la ruta del comando Java dentro de start_myperf.sh, si es necesario, por ejemplo, cuando hay varios paquetes JDK instalados.

5. Puesta en marcha:

      ./start_myperf.sh
   

   Consulte nohup.out y el directorio de registros para ver si hay registros de errores.

6. Cerrar:

      ./stop_myperf.sh
   

7. Inicio de sesión y configuración por primera vez

Después del inicio, apunte su navegador a http://your_host:9092/myperf (o el número de puerto que cambió). O https://your_host:9092/myperf si https está configurado correctamente.

El usuario y la credencial de inicio de sesión inicial son myperf/change.

Después de iniciar sesión, será dirigido a la página de configuración:

• Puede agregar una dirección de correo electrónico para notificaciones. El correo electrónico utiliza el comando "mailx" del sistema operativo.

• Configure la base de datos de almacenamiento de métricas utilizando la que creó en los pasos anteriores.

  Un intervalo de escaneo de métricas de 1 o 5 minutos debería ser suficiente.

• Si utiliza derbydb integrado, elija días de retención cortos.

• Una vez realizada la configuración, debe iniciar el escáner (botón "Iniciar escáner" en la parte superior de la página).

  Cada vez que cambia la configuración, debe reiniciar el escáner.

• Si el escáner no funciona como se esperaba, reinicie el analizador.

     ./stop_myperf.sh
  

  entonces

     ./start_myperf.sh
  

• Si su SNMP utiliza una comunidad no predeterminada o no la versión v2c, use la pestaña "Configuración de SNMP" para configurar SNMP. Actualmente sólo se admite SNMP basado en Linux. Si sus servidores MySQL no se ejecutan en Linux, use la pestaña "Configuración de alerta" para deshabilitar el sondeo de métricas SNMP.

8. Para cada servidor de base de datos que desee monitorear, debe crear un usuario MySQL con los siguientes privilegios:

   • proceso
   • cliente de replicación
   • mostrar bases de datos
   • mostrar vista
   • seleccione en todo (si desea usarlo para verificar el diccionario de datos o ejecutar planes de explicación)

9. El analizador se basa en Linux SNMP para recopilar datos a nivel del sistema operativo. Verifique el estado del servicio snmpd.

10. Integración de Hipchat: si usa Hipchat para colaboración relacionada con el trabajo, puede crear una sala de Hipchat para recibir alertas de MySQL Perf Analyzer. Consulte https://developer.atlassian.com/hipchat/tutorials/building-a-simple-add-on-using-a-wizard para saber cómo configurar la integración de Hipchat. Una vez que tenga la URL de notificación de Hipchat y el token de autenticación, puede configurar MySQL Perf Analyzer para enviar notificaciones a su sala, usando la página de Configuración.

Limitaciones conocidas

1. SNMP se basa en la especificación de Linux.
2. La notificación por correo electrónico utiliza el comando "mailx" de Linux.

Licencia

Este código tiene la licencia Apache. Consulte el archivo de LICENCIA para conocer los términos.