function watchdog

Logs a system message.


$type: The category to which this message belongs. Can be any string, but the general practice is to use the name of the module calling watchdog().

$message: The message to store in the log. Keep $message translatable by not concatenating dynamic values into it! Variables in the message should be added by using placeholder strings alongside the variables argument to declare the value of the placeholders. See t() for documentation on how $message and $variables interact.

$variables: Array of variables to replace in the message on display or NULL if message is already translated or not possible to translate.

$severity: The severity of the message; one of the following values as defined in RFC 3164:

$link: A link to associate with the message.

See also



131 calls to watchdog()
actions_do in includes/
Performs a given list of actions by executing their callback functions.
actions_save in includes/
Saves an action and its user-supplied parameter values to the database.
actions_synchronize in includes/
Synchronizes actions that are provided by modules in hook_action_info().
aggregator_aggregator_fetch in modules/aggregator/
Implements hook_aggregator_fetch().
aggregator_form_category_submit in modules/aggregator/
Form submission handler for aggregator_form_category().

... See full list

9 string references to 'watchdog'
actions_loop_test_watchdog in modules/simpletest/tests/actions_loop_test.module
Implements hook_watchdog().
bootstrap_hooks in includes/
Defines the critical hooks that force modules to always be loaded.
dblog_top in modules/dblog/
Page callback: Shows the most frequent log messages of a given event type.
dblog_update_7001 in modules/dblog/dblog.install
Update the {watchdog} table.
dblog_update_7002 in modules/dblog/dblog.install
Add an index to the severity column in the watchdog database table.

... See full list


includes/, line 2049


function watchdog($type, $message, $variables = array(), $severity = WATCHDOG_NOTICE, $link = NULL) {
    global $user, $base_root;
    static $in_error_state = FALSE;
    // It is possible that the error handling will itself trigger an error. In that case, we could
    // end up in an infinite loop. To avoid that, we implement a simple static semaphore.
    if (!$in_error_state && function_exists('module_invoke_all')) {
        $in_error_state = TRUE;
        // The user object may not exist in all conditions, so 0 is substituted if needed.
        $user_uid = isset($user->uid) ? $user->uid : 0;
        // Prepare the fields to be logged
        $log_entry = array(
            'type' => $type,
            'message' => $message,
            'variables' => $variables,
            'severity' => $severity,
            'link' => $link,
            'user' => $user,
            'uid' => $user_uid,
            'request_uri' => $base_root . request_uri(),
            'referer' => isset($_SERVER['HTTP_REFERER']) ? $_SERVER['HTTP_REFERER'] : '',
            'ip' => ip_address(),
            // Request time isn't accurate for long processes, use time() instead.
'timestamp' => time(),
        // Call the logging hooks to log/process the message
        module_invoke_all('watchdog', $log_entry);
        // It is critical that the semaphore is only cleared here, in the parent
        // watchdog() call (not outside the loop), to prevent recursive execution.
        $in_error_state = FALSE;

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.