29/Depuración

Esta página necesita actualizarse con la información existente en la documentación vigente/moderna/actualizada en el idioma inglés original para Moodle. Se le sugiere al lector que consulte la página original en idioma inglés cuyo enlace está al fondo de esta página. y que, por favor, actualice esta información y quite la plantilla {{Actualizar}} cuando haya terminado.     (otras páginas pendientes de actualizar)

Los mensajes de depuración (debugging) pueden habilitarse por un administrador en Configuraciones > Administración del sitio > Desarrollo > Depuración.

Los mensajes de depuración están diseñados para ayudarle a diagnosticar los problemas o para ayudar a los desarrolladores de Moodle. Si Usted tiene un problema con su sitio Moodle y pide ayuda en un foro de Moodle.org , un desarrollador puede pedirle que active los mensajes de depuuración, para poder localizar la causa del problema. Por defecto, Moodle no muestra mensaje alguno de errores. Si Usted está teniendo problemas (por ejemplo: pantalllas vacías o pantallas incompletas), el activar la depuración es generalmente lo primero que deberá intentar.

Configuraciones de depuración

Aquí están las configuraciones en la página de Depuración:

Mensajes de depuración

Por defecto está en NINGUNO/NADA, sus opciones son:

Raramente hay ventajas de poner el nivel de DESARROLLADOR, a menos que Usted realmente sea un desarrollador, en cuyo caso estará fuertemente recomendado.

Una vez que Usted haya visto el mensaje de error, lo copió y pegó en algun lado, ES ALTAMENTE RECOMENDABLE que desactive la depuración (debugging) poniéndo esta opción en NINGUNO, porque los mensajes de error que se muestarn al activar la depuración pueden darle pistas a los hackers acerca de la configuración de su sitio.

Mostrar mensajes de depuración

Hay una opción para elegir si se muestran los mensajes de error en el navegador de Internet o simplemente se graban en las bitácoras del servidor.

Depurar envío de Email

Determinea si se habilita o no información verbosa sobre depuración durante el envío de mensajes Email al servidor SMTP.

Más herramientas para depurar el correo saliente (SMTP)

Nota: Pendiente de Traducir. ¡Anímese a traducir esta página!.     ( y otras páginas pendientes)

Usted también puede usar el archivo config.php para activar más "herramientas" que le asistirán con la depuración de los Emails salientes (y la configuración delseervidor SMTP):

• Redireccionar todos los Emails salientes a una dirección específica:

// Divert all outgoing emails to this address to test and debug emailing features // $CFG->divertallemailsto = 'root@localhost.local'; // NOT FOR PRODUCTION SERVERS!

• Activar depuración del CRON y correr el 'script' por Interfaz por Línea de Comando cron.php.

// Force developer level debug and add debug info to the output of cron // $CFG->showcrondebugging = true; And then use SSH (or putty.exe, on windows) to run: you@moodle-server(/var/www/html/moodle)# php admin/cli/cron.php

• Activar depuración verbosa SMTP y sacarla hacia error_log del sistema ('hack' del código):

As suggested on Moodle's discussion forums: Open lib/moodlelib.php L5379 and change it to: if (!empty($CFG->debugsmtp)) {

   $mailer->SMTPDebug = 1;  // 0 - no debug ... 4 - low level full debug
   $mailer->Debugoutput = "error_log";

} Vea más información acerca de SMTPDebug parameters & Debugoutput parameters, Configure mailcatcher (https://mailcatcher.me/).

Información sobre rendimiento (desempeño)

La opción sobre información del desempeño determina si se incluirá o no información acerca del desempeño en elpie de página del tema estándar (y en algunos otros temas). La información sobre desempeño incluye el tiempo para cargar la página, la cantidad de memoria usada para generar la página, uso de CPU, carga y el registro de la proporción de aciertos/fallas del caché.

Si Usted añade define('MDL_PERF', true); define('MDL_PERFDB', true); define('MDL_PERFTOLOG', true); define('MDL_PERFTOFOOT', true); a su archivo config.php, entonces también contará las consultas a la base de datos. ¡Esto debe estar en config.php, porque Moodle empieza a hacer consultas a la base de datos antes de cargar la información de configuración en la base de datos!

Mostrar orígen de cadenas de idioma

• Ayuda con traducción y también con Personalización del idioma. A veces debería de añadirse el parámetro ?strings=1 ; y en otras veces &strings=1 a la petición de URL (dirección de la página).
• Ejemplo: http://mi_servidor_moodle.com.mx/admin/settings.php?section=debugging&lang=es_mx&strings=1 dará el siguiente resultado:

• Vea el artículo de la Wikipedia en Query string para más detalles.

Mostrar enlaces de validador

Sea cuidadoso, lea la advertencia.

Mostrar información de página

Para mostrar información de la página impresa en el pie de la página.

Qué hacer si usted no puede entrar a las pantallas de administración

Si un error le impide entrar a las pantallas de administración para activar la depuración, entonces Usted puede configurar manualmente la depuración.

Intente escribir la URL directamente

The debug settings are at the URL http://.../admin/settings.php?section=debugging on your server. Sometimes that URL will work, even though the pages you need to go to to get there (for example the site front page) do not. So it is worth trying to enter that URL directly.

En config.php

En el archivo config.php Usted puede descomentar líneas (eliminar los caracteres // al principio de la línea) debajo de la Sección 7 para habilitar la depuración para todos los usuarios o solamente para algunos usuarios específicos:

Nota: Pendiente de Traducir. ¡Anímese a traducir esta página!.     ( y otras páginas pendientes)

//========================================================================= // 7. SETTINGS FOR DEVELOPMENT SERVERS - not intended for production use!!! //========================================================================= // // Force a debugging mode regardless the settings in the site administration // @error_reporting(E_ALL | E_STRICT); // NOT FOR PRODUCTION SERVERS! // @ini_set('display_errors', '1'); // NOT FOR PRODUCTION SERVERS! // $CFG->debug = (E_ALL | E_STRICT); // === DEBUG_DEVELOPER - NOT FOR PRODUCTION SERVERS! // $CFG->debugdisplay = 1; // NOT FOR PRODUCTION SERVERS! // // You can specify a comma separated list of user ids that that always see // debug messages, this overrides the debug flag in $CFG->debug and $CFG->debugdisplay // for these users only. // $CFG->debugusers = '2';

Remember to comment those lines again (reinsert the // at the start of the line) when you have finished diagnosing your problem.

NOTE 1: do not try to modify the config database table directly, it will not work because the values are cached in MUC.

NOTE 2: if you find your config.php does not have the above settings (you have a cut down approx 30 lines config.php) look for a "config-dist.php" file that contains the full details. I would suggest transferring your details in the current config.php file you have into the full config file and renaming that one to "config.php".

En la base de datos

Usando una herramienta como phpMyAdmin, ejecute los siguientes comandos SQL:

UPDATE mdl_config SET value = 2047 WHERE name = 'debug'; UPDATE mdl_config SET value = 1 WHERE name = 'debugdisplay';

Para apagarlo, use las pantallas de administración, o los comandos:

UPDATE mdl_config SET value = 0 WHERE name = 'debug'; UPDATE mdl_config SET value = 0 WHERE name = 'debugdisplay';

(Si usa un prefijo de base de datos diferente, necesitará ajustar apropiadamente esos comandos.)

Vea también

• Developers can also use XDEBUG (Installed as a module on the Apache server) to further dig into the code, step by step using an XDEBUG client application. Probably, as part of their favorite IDE. For example: NetBeans, phpStorm or...

• https://docs.moodle.org/26/en/Debugging/Bug_fixing_as_knowledge_creation Información publicada por Tim Hunt en Planet Moodle el 28 de noviembre del 2013.