Miscelánea
PHP Manual

La clase MongoLog

(PECL mongo >=1.2.3)

Introducción

El registro se puede usar para obetner información detallada de lo que está haciendo el controlador. El mecanismo de registro como lo usa MongoLog emite todos los mensajes de registro como un aviso de PHP. Dependiendo de la interfaz del servidor que se use, esto significa que serán enviados a strerr (con PHP-CLI), o, de lo contrario, al registro de errores del servidor web. Para que PHP pueda imprimir los mensajes de registro, no se neceistan configurar sus niveles (E_NOTICE) para que sean mostrados. Esto significa que el bit de E_NOTICE necesita ser parte del nivel de error_reporting y que display_errors esté establecido a 1.

Por omisión, el registro está deshabilitado. Esta clase permite habilitar niveles específicos de informes para determinadas áreas del driver. Algunos ejemplos:

<?php

// muestra todos los mensajes posibles
MongoLog::setLevel(MongoLog::ALL); // todos los niveles de registros
MongoLog::setModule(MongoLog::ALL); // todas las partes del driver

// muestra eventos significativos sobre fallos en conjuntos de réplicas
MongoLog::setLevel(MongoLog::INFO);
MongoLog::setModule(MongoLog::RS);

// muestra registros de nivel de información y de ajustes sobre conjuntos de réplicas y sobre agrupamientos de conexiones
MongoLog::setLevel(MongoLog::INFO|MongoLog::FINE);
MongoLog::setModule(MongoLog::RS|MongoLog::POOL);

?>

Sinopsis de la Clase

MongoLog {
/* Constantes */
const int NONE = 0 ;
const int ALL = 31 ;
constantes de niveles {
const int WARNING = 1 ;
const int INFO = 2 ;
const int FINE = 4 ;
constantes de módulos {
const int RS = 1 ;
const int POOL = 2 ;
const int IO = 4 ;
const int SERVER = 8 ;
const int PARSE = 16 ;
/* Campos */
public int $level ;
public int $module ;
/* Métodos */
public static void getCallback ( void )
public static int getLevel ( void )
public static int getModule ( void )
public static void setCallback ( callable $log_function )
public static void setLevel ( int $level )
public static void setModule ( int $module )
}

Constantes predefinidas

Constantes de MongoLog

Estas constantes pueden usarse tanto por MongoLog::setLevel() como por MongoLog::setModule().

MongoLog::NONE
Constante para deshabilitar los registros.
MongoLog::ALL
Constante para notificar todos los registros.

Constantes de Nivel de MongoLog

Estas constantes pueden usarse por MongoLog::setLevel().

MongoLog::WARNING
Muestra mensajes sobre situaciones excepcionales no críticas.
MongoLog::INFO
Muestra eventos que pudieran ser de interes para administradores, pero no especialmente notorios.
MongoLog::FINE
Muestra la mayor parte de eventos que realiza el driver. Dependiendo del módulo que se esté analizando, este nivel podría ser demasiado ruidoso. Se usa principalmente para depuración.

Constantes de módulos de MongoLog

Estas constantes pueden usarse por MongoLog::setModule().

MongoLog::IO
Crea registros del tráfico generado de y desde la base de datos. A no ser que se trate de un programa trivial, esto creará un gran volumen de registros.
MongoLog::PARSE
Crear registro de los análisis de textos realizados.
MongoLog::POOL
Registra las actividades de los agrupamientos de conexiones. Creación de nuevas conexiones, reutilización de conexiones, y cierre de conexiones.
MongoLog::RS
Registra las actividades de los conjuntos de réplicas. Caídas, comprobaciones, elección de secundarios a los que leer, etc..
MongoLog::SERVER
Registra cambios de estado en el servidor. Detecta en primarios, secundarios y en duplicados.

Tabla de contenidos

Miscelánea
PHP Manual