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
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
- MongoLog::getCallback — Recupera el nombre de la función de llamada de retorno establecida anteriormente
- MongoLog::getLevel — Obtiene el nivel de registro
- MongoLog::getModule — Devuelve los módulos que están actualmente se están registrando
- MongoLog::setCallback — Establece una función de llamada de retorno para ser invocada en eventos
- MongoLog::setLevel — Establece el nivel de informe de mensajes
- MongoLog::setModule — Establece de qué funcionalidades se deben notificar eventos
