Skip to Content

Changes for page Event Log

Last modified by Scott Kohlmann on 2023/04/21 14:08
From version 4.1
edited by Mark Kohlmann
on 2020/04/08 04:38
Change comment: There is no comment for this version
To version 6.1
edited by Mark Kohlmann
on 2022/02/04 03:04
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,5 +1,7 @@
1 -SHOWRUNNER™'s event log logs system activities to text files and/or the console.  The event log is disabled by default but it can be enabled if
1 +SHOWRUNNER™'s event log logs system activities to text files and/or the console.  The event log is disabled by default but it can be enabled if desired.  We do not recommend leaving logging on unless necessary.
2 2  
3 +The "Trace" function allows the trigger of an event to be tracked throughout the event's execution.  Trace logs the originating event and tags each eventlog entry with the identifying information on the originating device/control point.  Trace creates a small additional burden on the system, not recommended on larger 3-series systems.
4 +
3 3  === Setup ===
4 4  
5 5  * If saving to files, insert an SD card or use a USB memory card
... ... @@ -8,7 +8,8 @@
8 8  ** Enable Logging to Console: ##sr eventlog console true##
9 9  ** Enable Logging to File: ##sr eventlog file true##
10 10  * Enable event log: ##sr eventlog true##
11 -* Files are saved by default to: \RM\ShowRunner\(ProcessorHostname)\Log\EventLog
13 +* Enable Trace: ##sr eventlog trace true##
14 +* Files are saved by default to: ##\RM\sr\log\eventLog##
12 12  * (((
13 13  View the Event Log Status: ##sr eventlog status##
14 14  )))
... ... @@ -19,13 +19,15 @@
19 19  +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
20 20  ~| Property | Value |
21 21  +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
22 -~| Enabled | False |
25 +~| Enabled | True |
23 23  +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
24 24  ~| Log to Console | True |
25 25  +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
26 -~| Log to File | True |
29 +~| Log to File | False |
27 27  +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
28 -~| Log File Path | \RM\ShowRunner\CI-SJC-RMC3\Log\EventLog |
31 +~| Log File Path | \RM\sr\log\eventLog  |
32 ++~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+
33 +~| Enable Trace | True |
29 29  +~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-+~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~--+##
30 30  )))
31 31  
... ... @@ -32,11 +32,21 @@
32 32  === File Format ===
33 33  
34 34  * File is saved in a csv (comma separated values) format
35 -* Once the file reaches 2MB it will automatically be zipped and a new file will be created
40 +* Files are saved incrementally: ##EventLog_2020-02-21T11-56-21_~#~##.csv## where 2020-02-21T11-56-21 is the program start time and ~#~## is the index of the file, starting at 000.
41 +* Once the file reaches 2MB it will automatically be zipped and a new file will be created and the index will be incremented.
42 +* Text qualifier is not used.
36 36  * Columns:
37 -##AppID,Timestamp,Type,GlobalId,Name,Message,Value##
44 +##AppID,Timestamp,Trigger,Type,GlobalId,Name,Message,Value##
38 38  ** AppID - The app number on the control system that logged the message
39 39  ** Timestamp - Timestamp of the log entry in YYYY-MM-DDTHH:MM:SSTZ format. Example: 2020-02-21T11:57:21-06:00
47 +** Trigger - Empty unless Enable Trace is true.  The object that triggered the event.  Version 3.014 or later.  Multiple possible triggers.  Additional triggers may be added in the future.
48 +*** BACNET:X - BACnet instance that triggered the event. X is the BACnet name.
49 +*** FUSION:XX - Crestron Fusion triggered the event.  XX is the IP-ID.
50 +*** GID:N - Triggered by a ShowRunner object.  N is the GlobalId of the object.
51 +*** TCP:X - TCP Listener triggered the event.  X is the IP Address of the host that triggered the event.
52 +*** UDP:X - UCP Listener triggered the event.  X is the IP Address of the host that triggered the event.
53 +*** WEBSESSION-USER:X [Y] - Triggered from REST API/LWAPI. X is the SessionId, Y is the username associated with the session OR if username is not available
54 +*** WEBSESSION-HOST:X [Y] - Triggered from REST API/LWAPI. X is the SessionId, Y is the IP Address associated with the session.
40 40  ** Type - Type of object logging the message
41 41  ** GlobalId - Unique Id of the object logging the message
42 42  ** Name - Name of the object logging the message
... ... @@ -43,11 +43,15 @@
43 43  ** Message - Type of value to expect
44 44  ** Value - Current state of the type
45 45  
46 -(% class="wikigeneratedid" %)
47 47  === Notes ===
48 48  
49 49  * Before removing the SD card stop the event log: ##sr eventlog off##
64 +* There is no automatic deletion of files.  Please be aware of available disk space on the SD card.
65 +* DO NOT setup the file path to write to the internal SD card.
50 50  
51 51  === Examples ===
52 52  
53 53  * [[Area Occupancy and Scene (Power BI)>>attach:ShowRunner_LogAnalysis.pbix]]
70 +* [[Log Entries with Trace>>Log Entries with Trace]]
71 +
72 +