Manual:Logging table

Every log action in MediaWiki is logged in the logging table.

Users can see those edits on Special:Log, with the exception of a few restricted logs (like Special:Log/suppress).

The contents of this table is what you see on the Special:Log page.

For example:



log_id
Primary key for the table.

 is a foreign key linking to this column.

log_type
The type of the log action, or the "log type".

You can filter by this type on Special:Log.

Typical values are: block, delete, import, makebot, move, newusers, protect, renameuser, rights, upload

("uploaded" in example)

Comparable to .

Values on itwiki, as of November 2014, are (including now-obsolete logs and several extensions):

MariaDB [itwiki_p]> SELECT DISTINCT log_type FROM logging; +---+ +---+ +---+ 16 rows in set (0.01 sec)
 * log_type     |
 * abusefilter  |
 * block        |
 * delete       |
 * gblblock     |
 * import       |
 * massmessage  |
 * merge        |
 * move         |
 * newusers     |
 * patrol       |
 * protect      |
 * renameuser   |
 * rights       |
 * spamblacklist |
 * thanks       |
 * upload       |

log_action
The action performed.

There may be multiple actions possible for a given type: for example, an entry with the type delete may have the action delete or restore, etc.

Comparable to .

See also .

See .

log_timestamp
The time the action was performed, in the timestamp format MediaWiki uses everywhere in the database: <tvar|format>yyyymmddhhmmss</> ("14:18, 25 June 2008" in example).

Comparable to <tvar|rc></> and <tvar|rev></>.

If the log event is a file upload, this field is not necessarily the same as the <tvar|timestamp></> generated by <tvar|recordUpload></>.

log_user
The <tvar|id></> of the user who performed the action.

This is a reference into the <tvar|user></> table (the user id of "Jacksprat" in example).

Comparable to <tvar|rc></> and <tvar|rev></>.

log_user_text
<tvar|username></> of the user who performed the action, intended primarily for anonymous users, fillable by maintenance/populateLogUsertext.php.

Comparable to <tvar|rc></> and <tvar|rev></>.

log_namespace
The man>Special:MyLanguage/Manual:Page table#page_namespace</>|namespace of the affected page.

Together with log_title, this is a reference into the <tvar|page></> table ("Image:Climb.jpg" in example). Comparable to <tvar|rc></>.


 * Special:Renameuser with log_type and log_action being either "" or "renameuser"


 * Special:Userlogin with log_type being "newusers" and log_action e.g. being "create"

log_title
The <tvar|title></> of the affected page.

Together with log_namespace, this is a reference into the <tvar|page></> table.

Comparable to <tvar|rc_title></>.

log_page
The <tvar|id></> that this log action is about.

Comparable to <tvar|id></> and <tvar|rev></>.

In the case of a page move, this is set to the page_id of the moved page (since <tvar|rev></>).

Formerly, it was the page_id of the redirect, or 0 if the page was moved without creating a redirect.

log_comment
The comment given for the action; that is the upload comment for uploads, the deletion comment for deletions, etc.

Comparable to <tvar|rc></> and <tvar|rev></>.

log_params
Additional parameters, usually empty.

Mirrored in <tvar|params>.

log_params is usually serialized, but not always; sometimes, for historical reasons, fields for log_params are separated by a newline.

Anyone creating a new log type should use the PHP serialization.

For user blocks, log_params contains the duration of the block and other data, in human readable form, e.g. "2 weeks nocreate,noautoblock,noemail".

For page moves, it contains a serialized array of the prefixed page title the page was moved to (i.e. in FULLPAGENAME format) and the boolean value of <tvar|noredir> </>.

For other examples, see <tvar|1></>.

Since 1.19, data in log_params is in a different format.

For instance, if you want to filter patrol/patrol log entries excluding autopatrol, pre-1.19 log entries need: log.log_params LIKE '%\n0'

while entries added in 1.19 and further need (serialized PHP arrays): log.log_params LIKE '%"6::auto";i:0%'

Since <tvar|ver></>, log_params is always serialized for newusers log too. An entry now looks like:

mysql> select log_params, log_action from logging where log_user = 4681690; +--++ +--++ +--++
 * log_params                      | log_action |
 * a:1:{s:9:"4::userid";i:4681690;} | autocreate |

while it used to look like:

mysql> select log_params, log_action from logging where log_user = 2298743; +++ +++ +++
 * log_params | log_action |
 * 2298743   | autocreate |

The numbers, e.g. the 4 in "4::userid", are used as the argument number for message keys (e.g. $1, $2,...).

The numbering should start with number 4, as the first three parameters are hardcoded for every message.

If there is no message key, then a number should not be used. Some data contained in log_params are also contained in <tvar|search></> to facilitate indexed queries.

Log parameters are typically set using functions such as <tvar|setParameters></> and <tvar|addEntry></>.

log_deleted
Used with the revision delete system to delete log entries.

This field is comparable to <tvar|rc></> and <tvar|rev></>.

It is a bit field. Take the sum of the following to determine what it represents:


 * 1 Action deleted
 * 2 Comment deleted
 * 4 User deleted
 * 8 If the deleted information is restricted. If this field is not set, then only deletedhistory right is needed, otherwise you need suppressrevision right.  (On Wikimedia wikis, this corresponds to if admins can view the entry, or if only oversighters can)
 * For example, if the value is 6 (4+2), then the action would be visible, but the comment and user would not be unless you had deletedhistory rights.

Schema summary
<tt>DESCRIBE logging;</tt> +---+-+--+-+++ +---+-+--+-+++ +---+-+--+-+++
 * Field        | Type                | Null | Key | Default        | Extra          |
 * log_id       | int(10) unsigned    | NO   | PRI | NULL           | AUTO_INCREMENT |
 * log_type     | varbinary(32)       | NO   | MUL | NULL           |                |
 * log_action   | varbinary(32)       | NO   |     | NULL           |                |
 * log_timestamp | binary(14)         | NO   | MUL | 19700101000000 |                |
 * log_user     | int unsigned        | NO   | MUL | 0              |                |
 * log_user_text | varchar(255) binary | NO  | MUL | NULL           |                |
 * log_namespace | int                | NO   | MUL | 0              |                |
 * log_title    | varchar(255) binary | NO   | MUL | NULL           |                |
 * log_page     | int unsigned        | YES  |     | NULL           |                |
 * log_comment  | varbinary(767)      | NO   |     | NULL           |                |
 * log_params   | blob                | NO   |     | NULL           |                |
 * log_deleted  | tinyint(3) unsigned | NO   |     | 0              |                |

<tt>DESCRIBE logging;</tt> +---+-+--+-+++ +---+-+--+-+++ +---+-+--+-+++
 * Field        | Type                | Null | Key | Default        | Extra          |
 * log_id       | int(10) unsigned    | NO   | PRI | NULL           | AUTO_INCREMENT |
 * log_type     | varbinary(32)       | NO   | MUL | NULL           |                |
 * log_action   | varbinary(32)       | NO   |     | NULL           |                |
 * log_timestamp | binary(14)         | NO   | MUL | 19700101000000 |                |
 * log_user     | int unsigned        | NO   | MUL | 0              |                |
 * log_user_text | varchar(255) binary | NO  | MUL | NULL           |                |
 * log_namespace | int                | NO   | MUL | 0              |                |
 * log_title    | varchar(255) binary | NO   | MUL | NULL           |                |
 * log_page     | int unsigned        | YES  |     | NULL           |                |
 * log_comment  | varchar(255)        | NO   |     | NULL           |                |
 * log_params   | blob                | NO   |     | NULL           |                |
 * log_deleted  | tinyint(3) unsigned | NO   |     | 0              |                |

<tt>DESCRIBE logging;</tt> +---+-+--+-+++ +---+-+--+-+++ +---+-+--+-+++
 * Field        | Type                | Null | Key | Default        | Extra          |
 * log_id       | int(10) unsigned    | NO   | PRI | NULL           | AUTO_INCREMENT |
 * log_type     | varbinary(32)       | NO   | MUL | NULL           |                |
 * log_action   | varbinary(32)       | NO   |     | NULL           |                |
 * log_timestamp | binary(14)         | NO   | MUL | 19700101000000 |                |
 * log_user     | int unsigned        | NO   | MUL | 0              |                |
 * log_user_text | varchar(255) binary | NO  |     | NULL           |                |
 * log_namespace | int                | NO   | MUL | 0              |                |
 * log_title    | varchar(255) binary | NO   | MUL | NULL           |                |
 * log_page     | int unsigned        | YES  |     | NULL           |                |
 * log_comment  | varchar(255)        | NO   |     | NULL           |                |
 * log_params   | blob                | NO   |     | NULL           |                |
 * log_deleted  | tinyint(3) unsigned | NO   |     | 0              |                |

<tt>DESCRIBE logging;</tt> +---+-+--+-+++ +---+-+--+-+++ +---+-+--+-+++
 * Field        | Type                | Null | Key | Default        | Extra          |
 * log_type     | varbinary(10)       | NO   | MUL | NULL           |                |
 * log_action   | varbinary(10)       | NO   |     | NULL           |                |
 * log_timestamp | binary(14)         | NO   | MUL | 19700101000000 |                |
 * log_user     | int unsigned        | NO   | MUL | 0              |                |
 * log_namespace | int                | NO   | MUL | 0              |                |
 * log_title    | varchar(255) binary | NO   |     | NULL           |                |
 * log_comment  | varchar(255)        | NO   |     | NULL           |                |
 * log_params   | blob                | NO   |     | NULL           |                |
 * log_id       | int(10) unsigned    | NO   | PRI | NULL           | AUTO_INCREMENT |
 * log_deleted  | tinyint(3) unsigned | NO   |     | 0              |                |

<tt>DESCRIBE logging;</tt> +---+-+--+-+++ +---+-+--+-+++ +---+-+--+-+++
 * Field        | Type                | Null | Key | Default        | Extra          |
 * log_type     | char(10)            | NO   | MUL | NULL           |                |
 * log_action   | char(10)            | NO   |     | NULL           |                |
 * log_timestamp | char(14)           | NO   | MUL | 19700101000000 |                |
 * log_user     | int unsigned        | NO   | MUL | 0              |                |
 * log_namespace | int                | NO   | MUL | 0              |                |
 * log_title    | varchar(255) binary | NO   |     | NULL           |                |
 * log_comment  | varchar(255)        | NO   |     | NULL           |                |
 * log_params   | blob                | NO   |     | NULL           |                |

<tt>DESCRIBE logging;</tt> +---+-+--+-+++ +---+-+--+-+++ +---+-+--+-+++
 * Field        | Type                | Null | Key | Default        | Extra          |
 * log_type     | char(10)            | NO   | MUL | NULL           |                |
 * log_action   | char(10)            | NO   |     | NULL           |                |
 * log_timestamp | char(14)           | NO   |     | 19700101000000 |                |
 * log_user     | int unsigned        | NO   | MUL | 0              |                |
 * log_namespace | int(11)            | NO   | MUL | 0              |                |
 * log_title    | varchar(255) binary | NO   |     | NULL           |                |
 * log_comment  | varchar(255)        | NO   |     | NULL           |                |
 * log_params   | blob                | NO   |     | NULL           |                |

<tt>DESCRIBE logging;</tt> +---+-+--+-+++ +---+-+--+-+++ +---+-+--+-+++
 * Field        | Type                | Null | Key | Default        | Extra          |
 * log_type     | char(10)            | NO   | MUL | NULL           |                |
 * log_action   | char(10)            | NO   |     | NULL           |                |
 * log_timestamp | char(14)           | NO   |     | 19700101000000 |                |
 * log_user     | int unsigned        | NO   | MUL | 0              |                |
 * log_namespace | tinyint(?) unsigned | NO  | MUL | 0              |                |
 * log_title    | varchar(255) binary | NO   |     | NULL           |                |
 * log_comment  | varchar(255)        | NO   |     | NULL           |                |
 * log_params   | blob                | NO   |     | NULL           |                |