History: Logs

            ^ This page should be merged with ((System log))
This page has several ((screenshot|screenshots)) that need to be replaced)^
^For advanced high capacity logging, see ((Logging using ELK Stack))^

This feature allows you to follow what a user is doing on a user basis or a category basis.
For instance, you want to know the time a user was active or how many actions (update, view, ... ) have been done by a user or by a category during a period of time.

Admins can see reports of all action logs. Each user can see the report of his/her own actions through a section which can be accessed through the last icon in the following image from  MyTiki: {img src=img/mytiki/gnome-vumeter.png width="20" }
^::{img src="img/wiki_up/mytiki_01.png" }::^

This is the ''Action log'' icon,  which links to an url like: ''tiki-admin_actionlog.php?selectedUsers[]=username'', being ''username'' the name of that user.

!! Configuration
This feature can be activated in the Admin -> Features panel.
The actions that can be recorded can be selected in the Admin -> Action Log panel. The actions that can be viewed at report time can be selected also in the Admin -> Action Log panel, for an admin, or in My Tiki -> Action log icon.  For instance,

!!! Setting for recording and viewing actions (admin)
^::{img src="img/wiki_up/action_log_setting_01.jpg" }::^

Some actions are always recorded as they are needed in other functions (the logging/loggout time and the wiki page updated) . Some others can be recorded by activating them individually through this panel, plus it can be chosen which ones are needed for each report, regardless that there may be be more actions being logged but not chosen to be displayed in the report. 

Since ((Tiki15|Tiki 15.1)), creating, modifiying or deleting __calendar events__ can also be recorded and displayed through the Action log.  

!!! Setting for viewing actions (any user)
^::{img src="img/wiki_up/actionlog_userprefs_03.png" } %%% Etc...::^

!!! Adding the permission to the group/s of interest
An admin has to grant a group of users the permission to see action logs, as it should be done for any other permission (see ((Permissions))). This permission is called __tiki_p_view_actionlog__.

!!! Choose if user's activity log has to be public or private
Another setting related to contributions is at Admin -> Login (__"Displays user's contribution in the user information page:"__). If enabled, a user will be able to see other user's activity log, including his/her contributions on the report. If not, only each owns logs will be reported, except for admin, which will be able to see the log reports of all users, groups, etc. 

!! Report and Statistics
An admin can obtain a report and some statistics on a user/s, group/s and category basis.
Any user can obtain a report and some statistics about his/her activity on a category basis.

In the Admin -> Action Log panel for an admin, or in My Tiki -> Action log for any user, the settings and filters can be selected.

!!! Reporting filters 
^::{img src="img/wiki_up/Admin_action_log_report_filter_.png" desc="Reporting filters for an admin, through Admin -> Action Log panel" }::^

^::{img src="img/wiki_up/actionlog_userprefs_02_amb_contribution.png" desc="Reporting filters for any user, through My Tiki -> Action log (when contribution feature is enabled)" }::^

Note that when ((contribution)) feature is __NOT__ enabled, the "__Graph__" button is not shown. 

Two actions have special meanings. The category action will record at the same time the action on a object is done the current category(ies) the object has. And the logging action that is only a switch to display or not the login statistics.

Notice: if you change the configuration, the previous actions will not be changed. A new selected action (except for those that are always saved) will not show this type of action that have occurred in the past. If you take away an action, the recording and/or display will be updated accordingly from then onwards.

!!! Report list of actions
Individual actions are listed:
^::{img src="img/wiki_up/Admin_action_logs_List_actions_.png" } ::^

If feature "((Contribution))" is enabled, a new column called "Contributions" is added to the list of actions reported, or exported.
 
!!! Report statistics
And some basic statistics are included below:
^::{img src="img/wiki_up/Admin_action_logs_statistics_.png" width=95% link=http://doc.tikiwiki.org/img/wiki_up/doc.tikiwiki.org/Admin_action_logs_statistics_.png desc=http://doc.tikiwiki.org/img/wiki_up/doc.tikiwiki.org/Admin_action_logs_statistics.png}::^

!!! Report Contributions
If feature "((Contribution))" was enabled, a new table reporting the evolution in time (weeks or days) of contributions is added below:

^::{img src="img/wiki_up/actionlog_user_report_contrib_01.png" }::^

~~green:Additions are shown in green~~ background, ~~red:deletions in pink~~, and the difference is shown without any special background color. Units are either bytes or kb, specified previously through the reporting filters described above, as well as start and end date, and if columns are days or weeks.

Moreover, contributions can be displayed as graphs (several graphs are produced), and they can be also saved in an image gallery for later re-use in reports through wiki pages, etc.

^::{img src="img/wiki_up/admin_actionlog_contribution_graph_01.png" }::^ 

This will produce several graphs in the following screen (and also in the image gallery, if selected), like the ones shown in this figure:

^::{img src="img/wiki_up/actionlog_graph_report_00.png" }::^

See ((Contribution)) for more information on this feature and the type of graphs generated.



-=alias=-
* (alias(Action log))
* (alias(ActionLog))
* (alias(Action logs))