' . t('About') . ''; $output .= '

' . t('The Database logging module logs system events in the Drupal database. For more information, see the online handbook entry for the Database logging module.', array('@dblog' => 'http://drupal.org/handbook/modules/dblog')) . '

'; $output .= '

' . t('Uses') . '

'; $output .= '
'; $output .= '
' . t('Monitoring your site') . '
'; $output .= '
' . t('The Database logging module allows you to view an event log on the Recent log entries page. The log is a chronological list of recorded events containing usage data, performance data, errors, warnings and operational information. Administrators should check the log on a regular basis to ensure their site is working properly.', array('@dblog' => url('admin/reports/dblog'))) . '
'; $output .= '
' . t('Debugging site problems') . '
'; $output .= '
' . t('In case of errors or problems with the site, the Recent log entries page can be useful for debugging, since it shows the sequence of events. The log entries include usage information, warnings, and errors.', array('@dblog' => url('admin/reports/dblog'))) . '
'; $output .= '
'; return $output; case 'admin/reports/dblog': return '

' . t('The Database logging module monitors your website, capturing system events in a log (shown here) to be reviewed by an authorized individual at a later time. This log is a list of recorded events containing usage data, performance data, errors, warnings and operational information. It is vital to check the Recent log entries report on a regular basis, as it is often the only way to tell what is going on.') . '

'; } } /** * Implements hook_menu(). */ function dblog_menu() { $items['admin/reports/dblog'] = array( 'title' => 'Recent log entries', 'description' => 'View events that have recently been logged.', 'page callback' => 'dblog_overview', 'access arguments' => array('access site reports'), 'weight' => -1, 'file' => 'dblog.admin.inc', ); $items['admin/reports/page-not-found'] = array( 'title' => "Top 'page not found' errors", 'description' => "View 'page not found' errors (404s).", 'page callback' => 'dblog_top', 'page arguments' => array('page not found'), 'access arguments' => array('access site reports'), 'file' => 'dblog.admin.inc', ); $items['admin/reports/access-denied'] = array( 'title' => "Top 'access denied' errors", 'description' => "View 'access denied' errors (403s).", 'page callback' => 'dblog_top', 'page arguments' => array('access denied'), 'access arguments' => array('access site reports'), 'file' => 'dblog.admin.inc', ); $items['admin/reports/event/%'] = array( 'title' => 'Details', 'page callback' => 'dblog_event', 'page arguments' => array(3), 'access arguments' => array('access site reports'), 'type' => MENU_CALLBACK, 'file' => 'dblog.admin.inc', ); return $items; } /** * Implements hook_init(). */ function dblog_init() { if (arg(0) == 'admin' && arg(1) == 'reports') { // Add the CSS for this module drupal_add_css(drupal_get_path('module', 'dblog') . '/dblog.css', array('preprocess' => FALSE)); } } /** * Implements hook_cron(). * * Remove expired log messages and flood control events. */ function dblog_cron() { // Cleanup the watchdog table if (variable_get('dblog_row_limit', 1000) > 0) { $max = db_query('SELECT MAX(wid) FROM {watchdog}')->fetchField(); db_delete('watchdog') ->condition('wid', $max - variable_get('dblog_row_limit', 1000), '<=') ->execute(); } } /** * Implements hook_user_cancel(). */ function dblog_user_cancel($edit, $account, $method) { switch ($method) { case 'user_cancel_reassign': db_update('watchdog') ->fields(array('uid' => 0)) ->condition('uid', $account->uid) ->execute(); break; case 'user_cancel_delete': db_delete('watchdog') ->condition('uid', $account->uid) ->execute(); break; } } function _dblog_get_message_types() { $types = array(); $result = db_query('SELECT DISTINCT(type) FROM {watchdog} ORDER BY type'); foreach ($result as $object) { $types[] = $object->type; } return $types; } /** * Implements hook_watchdog(). * * Note some values may be truncated for database column size restrictions. */ function dblog_watchdog(array $log_entry) { Database::getConnection('default', 'default')->insert('watchdog') ->fields(array( 'uid' => $log_entry['user']->uid, 'type' => substr($log_entry['type'], 0, 64), 'message' => $log_entry['message'], 'variables' => serialize($log_entry['variables']), 'severity' => $log_entry['severity'], 'link' => substr($log_entry['link'], 0, 255), 'location' => $log_entry['request_uri'], 'referer' => $log_entry['referer'], 'hostname' => substr($log_entry['ip'], 0, 128), 'timestamp' => $log_entry['timestamp'], )) ->execute(); } /** * Implements hook_form_FORM_ID_alter(). */ function dblog_form_system_logging_settings_alter(&$form, $form_state) { $form['dblog_row_limit'] = array( '#type' => 'select', '#title' => t('Database log entries to keep'), '#default_value' => variable_get('dblog_row_limit', 1000), '#options' => array(0 => t('All')) + drupal_map_assoc(array(100, 1000, 10000, 100000, 1000000)), '#description' => t('The maximum number of entries to keep in the database log. Requires a cron maintenance task.', array('@cron' => url('admin/reports/status'))) ); $form['actions']['#weight'] = 1; }