Differences

This shows you the differences between two versions of the page.

--- admin:the_log [2017/08/08 00:18] – rozanna
+++ admin:the_log [2023/01/24 09:23] – [Custom query] Gary Willetts
@@ Line 1: / Line 1: @@
-{{indexmenu_n>140}}
+{{indexmenu_n>196}}
-=====The log =====
+====== 25.19. The system log ======
+The log contains records of who did what and when in the system. It's a useful place to look to find out what happened to certain records and when certain things were done. Some events (lots!) are always logged by mSupply but some are optional and are chosen in the //Log// tab of the [[preferences:general#log|General preferences]] page.
+To view the log, choose //View log...// from the //Special// menu. You will be shown all today's log entries when the window loads:
-The log contains records of who did what and when in the system. It's a useful place to look to find out what happened to certain records and when certain things were done. To view the log choose //View log// from the //Admin// menu. You will be asked how many days history to view (the default is 7 days)
+{{ :admin:view_log.png?700 |}}
-It displays a list of significant events, along with the date, the time and the user. Some events are always logged by mSupply but others can be chosen in the [[preferences:general#log|preferences]].
+The columns contain this information:
+  * **Date:** the date when the log entry was made.
-{{ :admin:view_log.png?600 |}}
+  * **Time:** the time the log entry was made.
+  * **User:** the name of the user who did the operation giving rise to the log entry.
+  * **Type:** the type of log entry. Can be used for filtering or just telling you which part of the system generated the log entry.
+  * **Event:** a description of the event that occurred.
+  * **Source table:** the name of the table that contains the affected record (if there is one).
+  * **Record ID:** if there was one, the ID of the record in the database that was affected by the event.
+  * **Extra information:** detailed information about what happened in the event in JSON format. Not always provided.
+  * **Store name:** the name of the store that the event occurred in.
 Buttons in the window:
+  * **Export** Export the log to a tab delimited text file. You can then import this into other applications (such as a spreadsheet application) for editing and printing.
-  * // OK// - exit the window
+  * **Print** Prints the displayed list of log entries on your printer.
-  * // Order by// - sort the log
+  * **Order by** Sort the log by something than the default date/time order.
-  * // Find// - find particular records in the log.
+  * **Find** Search for particular records in the log.
-  * //Export// - allows you to export the log for use in another application
+  * **OK** Close the window.
-  * //Print// - allows you to print the log
 <WRAP center round tip 60%>
@@ Line 21: / Line 29: @@
 </WRAP>
+==== Dates ====
+If you want to see log records that were generated over a different period then manually edit the dates in the **From** and **To** boxes as required or choose one of the many quick-select options in the drop down list to automatically set them (//Today// is selected by default):
+{{ :admin:log_ddl_1.jpg }}
+==== Event types ====
+Additionally, you can choose to show only certain types of event which occurred in the period you have selected. To do that, select one of the entries in the final drop down list on the right hand side (//All// is selected by default):
+{{ :admin:log_ddl_2.jpg }}
+==== Custom query ====
-Period for review:
+If you are looking for log records that are not in the list of common event types described above, you will need to create a custom query.  For example, to find a report of all the finalized POs this year:
-  * Appropriate dates may be entered in the **From** and **To** fields
-  * Several periods are available from the drop down list (the default entry is **Today**):
-{{ :admin:log_ddl_1.png?150 }}
+  - Set the date / time period
+  - Click on **Find**
+  - Click on the small right arrow to the right of the first field box
+  - Select the data type that you are looking for.  In this case, we are looking for the ''event_type''
+  - Type in the particular event type that we are looking for.  In this case, we are looking for the ''finalized_po''
+  - Click on **Query**
+  - Once you are happy with the included results, click on **Print** (or **Export** to produce a text file that can be imported to Excel and manipulated)
-Choose a specific event:
+{{ :admin:2018-10-03_10_38_15_log_query.png?650 |}}
-  * A second drop down list allows a choice to be made from a number of specific events (the default entry is **All**):
-{{ :admin:log_ddl_2.png?150 }}
-See [[.:tables_fields:foreign_keys|this section]] for a complete description of which events are recorded in the log.
+\\
+\\
+|  //  Previous:  **[[admin:printer_installation]]** | | Next: **[[admin:server_troubleshooting]]** //  |
-// Previous: [[admin:printer_installation|Printer Installation]]     Next: [[admin:server_troubleshooting|Server Troubleshooting]]//
 ---- struct data ----
+pagestatus.status    :
 ----