System Logs

Introduction

There are different System Logs in e107:

System Log

Description

This log is to record actions of system administrators

This log is to record user-related events - such as signups, setting changes, logins and log outs.

This log is intended to record transient events.

If enabled, text-based (CSV) log files are saved of every page access on daily basis

Admin Log

This log is to record the actions of system administrators.

In many cases there is no admin control over which events are logged; some plugins and core functions do provide the ability to control logging.

The level of detail varies according to the particular event (and how straightforward it was to add logging, in the case of existing code). For preferences, usually the changed values are logged. For other data there may be an array of values, or a few numbers. As a minimum, the existence of an entry in the admin log indicates that someone did something!

Developers can use the Admin Log to store information about their plugin or theme. See 👉 https://devguide.e107.org/classes-and-methods/logging for more information

User Audit Log

This log is to record user-related events - such as signups, setting changes, logins and log outs.

The level of logging is controllable. In the Preference section, you can select the types of events which are logged, as well as for which user class.

Rolling Log

This log is intended to record transient events - if enabled, older events are purged after a selected number of days. Certain core functions log information to the rolling log.

It is also useful for 👉 debugging and problem solving for developers.

Access Log

A simple text log file can be enabled, which logs every page access.

This setting can be found in Admin Area > Settings > Preferences > Advanced Features > Log all page accesses

A separate file is generated for each day. The file is stored in the e107_system/(hash)/logs directory - with the name 'logd_ddd.yyyy.csv' - where 'ddd' is the day number within the year (1 to 3 digits) and 'yyyy' is the year.

The file is in CSV ('comma separated variable') format, and can therefore be imported into many spreadsheet and database packages for analysis.

These files have to be deleted manually when no longer required!

The fields that are stored in the log file are:

Field name

Description

Unix time

Timestamp in UNIX format

Date/Time

Timestamp in 'human-readable' format: yy-mm-dd hh:mm:ss

IP

Using IPv6 format

URL

Page and query part of the current access

RenderTime

Processing time in seconds

DBTime

Database access time as percentage of overall time

Qrys

Number of database queries executed

Memory-Usage

Shows current and peak values

User-Agent

Shows the user agent (browser etc.) that was used

Request-Method

Show the request method

TIP: The above information can also be displayed on your website by enabling the setting in Admin Area > Settings > Preferences > Display Information

Last updated