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 registro está desactivado de forma predeterminada, aunque esta clase permite activar niveles de registro específicos para determinadas áreas del controlador. Algunos ejemplos:los:

<?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 diagnóstico para conjuntos de réplicas y conexiones
MongoLog::setLevel(MongoLog::INFO|MongoLog::FINE);
MongoLog::setModule(MongoLog::RS|MongoLog::CON);

?>

Nota:

Por omisión, MongoLog emite todos los mensajes de registro como avisos de PHP. Dependiendo de la SAPI que se use, los mensajes podrían enviarse a stderr (para CLI) o al registro de errores del servidor web. Si, después de configurar MongoLog, los mensajes de registro no aparecen como se esperaba, asegúrese de que el bit de E_NOTICE está incluido den error_reporting y de que display_errors esté activado.

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 = 1 ;
const int CON = 2 ;
const int IO = 4 ;
const int SERVER = 8 ;
const int PARSE = 16 ;
/* Campos */
private static int $callback ;
private static int $level ;
private static int $module ;
/* Métodos */
public static callable 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
No registrar nada.
MongoLog::ALL
Registrar todo.

Constantes de Nivel de MongoLog

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

MongoLog::WARNING
Registrar eventos que son excepcionales de algún modo, aunque no lo suficiente como las excepciones reales (p.ej. errores de conexión recuperables).
MongoLog::INFO
Registrar eventos que podrían ser de interés para el administrador, aunque no particularmente notables (p.ej. análisis de opciones, pasos de autentiación).
MongoLog::FINE
Registrar la mayoría de los eventos que realiza el controlador (p.ej. selección de un servidor, comunicación con socket). Dependiendo del módulo a registrar, esto puede ser extremadamente ruidoso, por lo que es principalmente útil para depuración.

Constantes de módulos de MongoLog

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

MongoLog::CON
Registrar actividades de conexión. Crear nuevas conexiones, autenticación, ping tiempos límite, etc.
MongoLog::IO
Registrar el 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
Registrar el análisis de string de conexiones y opciones cuando se construye MongoClient.
MongoLog::POOL
Anteriormente usada para registrar la actividad de agrupaciones de conexiones. Esta opción ahora es un alias obsoleto de MongoLog::RS.
MongoLog::RS
Registrar la actividad de conjuntos de réplicas. Tolerancia a fallos, selección de preferencias de lectura, etc.
MongoLog::SERVER
Anteriormente usada para registrar cambios de estado del servidor. Esta opción está obsoleta en favor de MongoLog::RS.

Historial de cambios

Versión Descripción
1.3.0 Se añadió MongoLog::CON y está obsoletas MongoLog::POOL y MongoLog::SERVER.

Tabla de contenidos