Poner el sistema en modo de depuración

Cómo poner TAO en depuración para el registro y la resolución de problemas.

Cuando intentes localizar un error que estés teniendo, es importante que configures tu sistema en depuración para aumentar la cantidad de información en tus registros.

Para ello, deberá SSH a su servidor, y luego cd hasta donde hayas instalado TAO. A continuación, editará config/generis.conf.php y asegúrese de que DEBUG_MODE se ajusta a true como se muestra a continuación:

// mode
define('DEBUG_MODE', true);

Si necesita un registro más detallado, TAO tiene un registrador que acepta un Interfaz del registrador PSR-3. El registrador utiliza TaoMonoLog que es una envoltura para monolog. Si bien existe compatibilidad con versiones anteriores de common_log, a través de TaoLog esta funcionalidad está obsoleta.

El registrador se puede configurar en config/generis/log.conf.phpy contiene varios ejemplos. Estos ejemplos se pueden utilizar para configurar varios métodos para transmitir los registros a un archivo, una consola web, Slack, etc.

Los niveles de registro utilizados por el registrador son los siguientes:

  • DEBUG (100): Información de depuración detallada.
  • INFO (200): Eventos interesantes. Ejemplos: Inicio de sesión del usuario, registros SQL.
  • AVISO (250): Eventos normales pero significativos.
  • ADVERTENCIA (300): Sucesos excepcionales que no son errores. Ejemplos:
    Uso de APIs obsoletas, mal uso de una API, cosas indeseables que no son
    necesariamente erróneas.
  • ERROR (400): Errores de tiempo de ejecución que no requieren una acción inmediata pero
    deben ser registrados y monitoreados.
  • CRÍTICO (500): Condiciones críticas. Ejemplo: Componente de la aplicación
    no disponible, excepción inesperada.
  • ALERTA (550): Hay que actuar inmediatamente. Ejemplo: Todo el sitio web
    no funciona, la base de datos no está disponible, etc. Esto debería activar las alertas por SMS y despertarte
    a los usuarios.
  • EMERGENCIA (600): Emergencia: el sistema es inutilizable.

El siguiente es un ejemplo de configuración config/generis/log.conf.php para enviar depurar a un archivo, en este caso /var/www/html/tao/logs/test-log.log:

return new oat\oatbox\log\LoggerService(array(
    'logger' => array(
        'class' => \oat\oatbox\log\logger\TaoMonolog::class,
        'options' => array(
            'name' => 'tao',
            'handlers' => array(
                array(
                    'class' => \Monolog\Handler\StreamHandler::class,
                    'options' => array(
                        '/var/www/html/tao/logs/test-log.log',
                        \Monolog\Logger::DEBUG
                    )
                )
            )
        )
)));
return new oat\oatbox\log\LoggerService();