The watchdog module monitors your web site, capturing system events in a log to be reviewed by an authorized individual at a later time. The watchdog log is simply a list of recorded events containing usage data, performance data, errors, warnings and operational information. It is vital to check the watchdog report on a regular basis as it is often the only way to tell what is going on.

'); case 'admin/modules#description': return t('Logs and records system events.'); } } /** * Implementation of hook_menu(). */ function watchdog_menu($may_cache) { $items = array(); if ($may_cache) { $items[] = array('path' => 'admin/logs', 'title' => t('logs'), 'callback' => 'watchdog_overview', 'access' => user_access('administer watchdog')); $items[] = array('path' => 'admin/logs/event', 'title' => t('details'), 'callback' => 'watchdog_event', 'access' => user_access('administer watchdog'), 'type' => MENU_CALLBACK); } return $items; } /** * Implementation of hook_perm(). */ function watchdog_perm() { return array('administer watchdog'); } /** * Implementation of hook_cron(). * * Remove expired log messages and flood control events. */ function watchdog_cron() { db_query('DELETE FROM {watchdog} WHERE timestamp < %d', time() - variable_get('watchdog_clear', 604800)); db_query('DELETE FROM {flood} WHERE timestamp < %d', time() - 3600); } /** * Menu callback; displays a listing of log messages. */ function watchdog_overview() { $icons = array(WATCHDOG_NOTICE => '', WATCHDOG_WARNING => theme('image', 'misc/watchdog-warning.png', t('warning'), t('warning')), WATCHDOG_ERROR => theme('image', 'misc/watchdog-error.png', t('error'), t('error'))); $classes = array(WATCHDOG_NOTICE => 'watchdog-notice', WATCHDOG_WARNING => 'watchdog-warning', WATCHDOG_ERROR => 'watchdog-error'); $names['all'] = t('all messages'); $queries['all'] = ''; foreach (_watchdog_get_message_types() as $type) { $names[$type] = t('%type messages', array('%type' => t($type))); $queries[$type] = "WHERE type = '". db_escape_string($type) ."'"; } if (empty($_SESSION['watchdog_overview_filter'])) { $_SESSION['watchdog_overview_filter'] = 'all'; } $op = $_POST['op']; if ($op == t('Filter') && isset($_POST['edit']['filter'])) { $_SESSION['watchdog_overview_filter'] = $_POST['edit']['filter']; } $form = form_select(t('Filter by message type'), 'filter', $_SESSION['watchdog_overview_filter'], $names); $form .= form_submit(t('Filter')); $header = array( ' ', array('data' => t('Type'), 'field' => 'w.type'), array('data' => t('Date'), 'field' => 'w.timestamp', 'sort' => 'desc'), array('data' => t('Message'), 'field' => 'w.message'), array('data' => t('User'), 'field' => 'u.name'), array('data' => t('Operations'), 'colspan' => '2') ); $sql = 'SELECT w.*, u.name, u.uid FROM {watchdog} w INNER JOIN {users} u ON w.uid = u.uid '. $queries[$_SESSION['watchdog_overview_filter']] . tablesort_sql($header); $result = pager_query($sql, 50); while ($watchdog = db_fetch_object($result)) { $rows[] = array('data' => array( // Cells $icons[$watchdog->severity], t($watchdog->type), format_date($watchdog->timestamp, 'small'), truncate_utf8($watchdog->message, 64), format_name($watchdog), $watchdog->link, l(t('details'), "admin/logs/event/$watchdog->wid") ), // Attributes for tr 'class' => "watchdog-". preg_replace('/[^a-z]/i', '-', $watchdog->type) .' '. $classes[$watchdog->severity] ); } if (!$rows) { $rows[] = array(array('data' => t('No log messages available.'), 'colspan' => '7')); } $pager = theme('pager', NULL, 50, 0, tablesort_pager()); if (!empty($pager)) { $rows[] = array(array('data' => $pager, 'colspan' => '7')); } $output = '
'. form($form) .'
'; $output .= theme('table', $header, $rows); return $output; } /** * Menu callback; displays details about a log message. */ function watchdog_event($id) { $severity = array(WATCHDOG_NOTICE => t('notice'), WATCHDOG_WARNING => t('warning'), WATCHDOG_ERROR => t('error')); $output = ''; $result = db_query('SELECT w.*, u.name, u.uid FROM {watchdog} w INNER JOIN {users} u ON w.uid = u.uid WHERE w.wid = %d', $id); if ($watchdog = db_fetch_object($result)) { $output .= ''; $output .= ' '; $output .= ' '; $output .= ' '; $output .= ' "; $output .= ' "; $output .= ' '; $output .= ' "; $output .= '
'. t('Type') .'' . t($watchdog->type) . '
'. t('Date') .''. format_date($watchdog->timestamp, 'large') .'
'. t('User') .''. format_name($watchdog) .'
'. t('Location') ."". l($watchdog->location, $watchdog->location) ."
'. t('Message') ."$watchdog->message
'. t('Severity') .''. $severity[$watchdog->severity] .'
'. t('Hostname') ."$watchdog->hostname
'; } return $output; } function _watchdog_get_message_types() { $types = array(); $result = db_query('SELECT DISTINCT(type) FROM {watchdog} ORDER BY type'); while ($object = db_fetch_object($result)) { $types[] = $object->type; } return $types; } ?>