La Libreria de ADOdb para el Monitoreo del Rendimiento

V4.92 29 Ago 2006 (c) 2000-2006 John Lim (jlim#natsoft.com.my)

Este programa tiene licencia dual BSD y LGPL. Esto significa que se puede usar in productos compilados propietarios y en productos comerciales.

Ligas utiles de ADOdb: Descarga Otros documentos

Introduccion

Este modulo, es parte del paquete ADOdb, proporciona tanto interfases CLI como HTML para ver indicadores importantes del rendimiento de su base de datos. Es muy util debido a que apilcaciones Web como el popular phpMyAdmin actualmente no proporcionan herramientas efectivas para monitorear la salud de la base de datos. Este modulo proporciona lo siguiente:

• Un chequeo rapido de salud del servidor de base de datos usando $perf->HealthCheck() o $perf->HealthCheckCLI().
• Interfase de usuario para el moniterio del rendimiento, $perf->UI(). Esta interfas de usuario (UI) muestra:
  • el estado de salud,
  • todos los enunciados SQL registrados y su plan de ejecucion,
  • una lista de todas las tablas de la base de datos actual
  • una interfase para hacer un muestreo continuo de los indicadores principales de rendimiento del servidor como CPU, Hit Ratio, Disk I/O
  • una forma donde se pueden introducir enunciados SQL y ejecutarlos interactivamente.
• Da un API para construir herramientas para monitorear bases de datos en una granja de servidores (server farm), por ejemplo invocando $perf->DBParameter('data cache hit ratio') regresa este importante valor estadistico de una manera independiente de la base de datos.

ADOdb tambien tiene la habilidad de registrar todos los enunciados SQL ejecutados usando LogSQL. Todos los SQL registrador pueden ser analizados por medio de la interfase UI del monitor de rendimiento. En el modo View SQL, se clasifican los enunciados SQL en 3 tipos:

• Suspicious SQL (sospechosos): sqls con un alto tiempo PROMEDIO de ejecucion, son candidatos pontenciales para ser reescritos.
• Expensive SQL (costosos): sqls con un alto costo TOTAL de ejecucion, (#ejecucion * tiempo promedio ejecucion). Optimizando estos preguntas reducira la carga del servidor de base de datos.
• Invalid SQL (invalidos): sqls que generaron errores.

Cada SQL tiene una hiperliga a un plan de ejecucion, y tambien se muestra cada programa PHP que ejecuto ese sql.

Por favor tome en cuenta que la informacion presentada es una verificacion de salud muy basica, y no proporciona una vision general del rendimiento de la base de datos. A pesar de que se hizo el intento para hacerlo funcionar en varias bases de datos de la misma manera, es imposible de lograrlo. Para el analisis de salid, se intenta mostrar las siguiente parametros claves para todos los drivers:

• data cache size - La cantidad de memoria asignada al cache.
• data cache hit ratio - Una media de que tan efectivo es el cache, como un porcentaje. Entre mas alto, mejor.
• current connections - La cantidad de sesiones actualmente conectadas a la base de datos.

Es necesario conectarse a la base de datos como administrador para ver la mayoria de los parametros.

Se agredecen las mejoras al codigo, partcicularmente la adicion de nuevos parametros y sugerencias automaticas de ajuste.

Uso

Actualemte se soportan los siguientes drivers: mysql, postgres, oci8, mssql, informix y db2. Para crear un monitor de rendimiento hay que llamar a NewPerfMonitor( ) omo se muestra a continuacion:

<?php
include_once('adodb/adodb.inc.php');
session_start(); # variables de sesion requeridas para monitorear 
$conn = ADONewConnection($driver);
$conn->Connect($server,$user,$pwd,$db);
$perf =& NewPerfMonitor($conn);
$perf->UI($pollsecs=5);
?>

It is also possible to retrieve a single database parameter:

$size = $perf->DBParameter('data cache size');

Gracias a Fernando Ortiz por el modulo de informix.

Metodos

function UI($pollsecs=5)

Crea una interfase de usuario en el Web para el monitoreo del rendimiento. Cuando se le da click en 'Poll', estadisticas del servidor se mostrarar cada $pollsecs sgundos. Vea Usage arriba.

Desde la version 4.11, se permite a los usuarios entroducir y ejecutar enunciados SQL interactivamente via la liga "Run SQL". Para deshabilitarla por motivos de seguridad, defina esta constante antes de llamar $perf->UI().

define('ADODB_PERF_NO_RUN_SQL',1);

Salida de ejemplo a continuacion:

funcion HealthCheck()

Regresa los parametros de estado de salud de la base de datos como una tabla HTML. Se necesita mandar con echo o print la salida de esta funcion.

funcion HealthCheckCLI()

Regresa los parametros de estado de salus de la base de datos formatedoas para una interfase de comandos de linea (modo caracter). Se necesita mandar con echo o print la salida de esta funcion. Salida de ejemplo para mysql:

-- Ratios -- 
          MyISAM cache hit ratio => 56.5635738832 
          InnoDB cache hit ratio => 0 
             sql cache hit ratio => 0 
 -- IO -- 
                      data reads => 2622 
                     data writes => 2415.5 
 -- Data Cache -- 
          MyISAM data cache size => 512K 
             BDB data cache size => 8388600
          InnoDB data cache size => 8M
 -- Memory Pools -- 
                read buffer size => 131072 
                sort buffer size => 65528 
                     table cache => 4 
 -- Connections -- 
             current connections => 3
                 max connections => 100

funcion Poll($pollSecs=5)

Corre un bucle (loop) infinito, desplegando informacion cada $pollSecs segundos. NO funcionara adecuadamente si se activa 'output buffering'. En el siguiente ejemplo $pollSecs=3:

Accumulating statistics...
 Time   WS-CPU%   Hit%   Sess        Reads/s          Writes/s
11:08:30    0.7  56.56      1         0.0000            0.0000
11:08:33    1.8  56.56      2         0.0000            0.0000
11:08:36   11.1  56.55      3         2.5000            0.0000
11:08:39    9.8  56.55      2         3.1121            0.0000
11:08:42    2.8  56.55      1         0.0000            0.0000
11:08:45    7.4  56.55      2         0.0000            1.5000

WS-CPU% es la carga de CPU del servidor Web donde PHP esta corriendo (es decir el cliente de la base de datos), y no del servidor de base de datos. Hit% es el porcentaje de exito del cache de datos. Sess es la cantidad de sesiones conectadas a la base de datos. Si se usan conexiones persistentes, este no deberoa de cambiar mucho. Reads/s y Writes/s son valores artificiales para dar al usuario a guia tosca de E/S (I/O), no son para ser tomados literalmente.

funcion SuspiciousSQL($numsql=10)

Regresa como una tabla HTML los enunciados SQL que tinen un alto tiempo promedio de ejecucion. Cada enunciados SQL tiene una hiper liga a una nueva ventana con los detalles del plan de ejecucion y los nombres de los programas PHP que lo ejecutaron.

La cantidad de enunciados a regresar es determinado por $numsql. Los datos son tomados de la tabla adodb_logsql, ahi los enunciados sql son almacenados cuando se habilita la funcion $conn->LogSQL.

Para oracle, se usa Ixora Suspicious SQL que regresa una lista de los enunciados que usan mas la memoria cache. Esos son enunciados SQL con acceso intesivo de datos que se pueden beneficiar mas de una puesta a punto (tuning).

funcion ExpensiveSQL($numsql=10)

Regresa los SQL cuyo tiempo total de ejecucion (tiempo promedio * N° ejecuciones) es alto. Cada enunciado SQL tiene una hiper liga a una nueva ventana con los detalles del plan de ejecucion y los nombred de los programas que lo ejecutaron.

La cantidad de enunciados a mostrar es determinada por $numsql. Los datos son tomados de la tabla adodb_logsql, donde son almacenados cuando se habilita la funcion $conn->LogSQL.

Para Oracle, se usa Ixora Expensive SQL que regresa una lista de los enunciados que consumen la mayoria de la carga de CPU al ejecutarse.

funcion InvalidSQL($numsql=10)

Regresa una tabla HTML con la lista de los enunciados SQL invalidos.

Los datos se toman de la tabla adodb_logsql, donde los enunciados son almacenados cuando se habilita $connection->LogSQL(true).

funcion Tables($orderby=1)

Regresa informacion de todas las tablas de una base de datos, los primeros dos campos conteniendo el nombre de la tabla y su tamaņo, los campos restantes varian para cada manejador de base de datos. Si $orderby vale 1, la tabla se ordena por nombre. Si $orderby vale 2, la tabla se orden por el tamaņo de la tabla. Algunos drivers de bases de datos (mssql y mysql) ignoran la clausula $orderby. Para postgresql, la informacion esta a la fecha del ultimo vacuum. Actualmente no funciona para db2.

Funciones crudas

Las funciones crudas regresan los valores sin ningun formateo.

funcion DBParameter($paramname)

Regresa el valor de un parametro de la base de datos, tal como $this->DBParameter("data cache size").

funcion CPULoad()

Regresa la carga del CPU del cliente de la base de datos (NO DEL SERVIDOR) como un porcentaje. Solo funciona para Linux y Windows. Para Windows, WMI debe de estar disponible.

Formato de la Propiedad $settings

Para crear un nuevo parametro de la base de datos, se necesita entender la propiedad $settings. La estructura de datos de $settings es un arreglo asociativo. Cada elemento del arreglo define un parametro de la base de datos. La llave es el nombre del parametro de la base de datos. Si noy hay llave definida se considera como un corte de seccion, y el valor es el nombre del corte de seccion. Si esto te causa confusion, ver el codigo fuente te ayuda mucho.

El valor de cada parametro de la base de datos es a su ves un arreglo formado por los siguientes elementos:

0. Codigo de categoria, usado para agrupar parametris relacionaddos, Si la categoria es 'HIDE', el parametro no se muestra cuando se invica en modo HTML().
   
1. alguno de
   1. enunciado sql para obtener un valor, ej. "select value from v\$parameter where name='db_block_size'",
   2. arreglo conteniendo el enunciado sql y el campo a buscar, ej. array('show variables','table_cache'); un tercer parametro opcional es el $rs->fields[$index] a usar (por omision $index=1), y un cuarto parametro opcional es un constante para ser multiplacdo por el resultado (tipicamente vale 100 para calculo de porcentajes),
   3. una cadena empezando con =, en este caso se invoca un metodo PHP de la clase, e.j. para invocar $this->GetIndexValue(), el elemento del arreglo debe de valer '=GetIndexValue',
      
2. Descripcion del parametro de la base de datos. Si la descripcion empieza con =, entonces se interpreta como un llamado a un metodo, como en el caso (1c) anterior, tomando un parametro, el valor actual. Ejemplo. '=GetIndexDescription' invocara $this->GetIndexDescription($val). Es util para generar sugerencias de ajustes. Para un ejemplo vea WarnCacheRatio().

Ejemplo para MySQL, parametro de la base de datos table_cache:

'table cache' => array('CACHE',            # codigo de categoria
   array("show variables", 'table_cache'), # arreglo (tipo 1b)
   'Number of tables to keep open'),       # descripcion

Ejemplo de Salida de un Estado de Salud (Health Check)

db2 informix mysql mssql oci8 postgres

informix
Parameter	Val ue	Description
Ratios
data cache hit ratio	95.89
IO
data reads	1883884	Page reads
data writes	1716724	Page writes
Connections
current connections	263.0	Number of sessions

Suspicious SQL

Expensive SQL