khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2026-01-03 02:09:45 +07:00
Code Issues Packages Projects Releases Wiki Activity

rewrite logging page

Browse Source
This commit is contained in:
Carla Schroder
2015-08-17 12:59:50 -07:00
parent e78bc4d32f
commit 39f4cbc7fe
1 changed files with 22 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files

52
admin_manual/configuration_server/logging_configuration.rst
View File

@@ -1,46 +1,40 @@
=====================
Logging Configuration
=====================
To get an idea of how the current status of an ownCloud system is or to
solve issues log information is a good point to start with. ownCloud allows
the way, and which depth of information should be logged to be configured.
Use your ownCloud log to review system status, or to help debug problems. You may adjust logging levels, and choose between using the ownCloud log or your syslog.
Parameters
----------
First you need to decide in which way logging should be done. You can
choose between the two options **owncloud** and **syslog**. Then you need
to configure the log level which directly influences how much information
will be logged. You can choose between:
* **0**: DEBUG
* **1**: INFO
* **2**: WARN
* **3**: ERROR
* **4**: FATAL
Logging levels range from **DEBUG**, which logs all activity, to **ERROR**, which logs only errors.
The most detailed information will be written if **0** (DEBUG) is set, the
least information will be written if **3** (ERROR) is set. Keep in mind that
it might slow down the whole system if too detailed logging has been
configured. By default the log level is set to **2** (WARN).
* **0**: DEBUG: All activity; the most detailed logging.
* **1**: INFO: Activity such as user logins and file activities, warning, errors, and fatal errors.
* **2**: WARN: Operations succeed, but with warnings of potential problems, plus errors and fatal errors.
* **3**: ERROR: An operation fails, but other services and operations continue.
* **4** FATAL: The server stops.
These parameters can be set in the :file:`config/config.php`
By default the log level is set to **2** (WARN).. Use **DEBUG** when you have a problem to diagnose, and then reset your log level to a less-verbose level as **DEBUG** outputs a lot of information, and can affect your server performance.
Logging level parameters are set in the :file:`config/config.php`, or on the Admin page of your ownCloud Web GUI.
ownCloud
~~~~~~~~
All log information will be written to a separate log file which can be
viewed using the log menu in the admin menu of ownCloud. By default a log
file named **owncloud.log** will be created in the directory which has
been configured by the **datadirectory** parameter.
The desired date format can optionally be defined using the **logdateformat**.
By default the `PHP date function`_ parameter "*c*" is used and therefore the
All log information will be written to a separate log file which can be
viewed using the log viewer on your Admin page. By default, a log
file named **owncloud.log** will be created in the directory which has
been configured by the **datadirectory** parameter in :file:`config/config.php`.
The desired date format can optionally be defined using the **logdateformat** parameter in :file:`config/config.php`.
By default the `PHP date function`_ parameter "*c*" is used, and therefore the
date/time is written in the format "*2013-01-10T15:20:25+02:00*". By using the
date format in the example the date/time format will be written in the format
date format in the example below, the date/time format will be written in the format
"*January 10, 2013 15:20:25*".
.. code-block:: php
<?php
"log_type" => "owncloud",
"logfile" => "owncloud.log",
"loglevel" => "3",
@@ -48,16 +42,14 @@ date format in the example the date/time format will be written in the format
syslog
~~~~~~
All log information will be sent to the default syslog daemon of a system.
All log information will be sent to your default syslog daemon.
.. code-block:: php
<?php
"log_type" => "syslog",
"logfile" => "",
"loglevel" => "3",
.. _PHP date function: http://www.php.net/manual/en/function.date.php