3,634 bytes added,
10:22, 16 March 2015 [[File:UI_EventTracer.png|thumb|220px|Event Tracer]]
The Event Tracer is meant for the Studio user to monitor events happening in the system environment of {{UBIK}}. It is used to visualize events immediately in Studio while they are written by the logging mechanism in the background. This gives the Studio user the possibility to watch events as they happen in the system without the need to open the log files. These events can be errors and warnings but can also be messages that are for example generated out of the customizing code for debugging.
==Message Types==
{{UBIK}} Event Tracer is able to show the following event types:
* Errors: events the user should pay high attention to because the system is in a vulnerable state (marked with red erro symbol).
* Warnings: events that have to be investigated because they are potentially important to the productive use of the system (marked with yellow warning symbol).
* Messages: events that support the user in debugging or finding problems in general (marked with blue message symbol).
===Logging list===
The list shows all events that happened since the start of the Studio session. Every entry has an information header shown in the list, consisting of the type and the time it happened as well as the time that elapsed since it happened. Every entry then can be expanded to show the full amount of infomation included in this event:
==Toolbar==
The Event Tracer features a toolbar with the following items, from left to right:
{| class="wikitable" | width = "50%"
|-
! Item !! Purpose
|- align="left"
| Select Category || Here the user can check or uncheck the categories to be shown in the list; changing this will hide or show the selected category of events in the list
|- align="left"
| Sort by time stamp || this will sort the entries by the time stamp; clicking this repeatedly will change the direction of the sorting between ascending and descending time stamp
|- align="left"
|- align="left"
| Sort by category || this will sort the entries by the level of importance; clicking this repeatedly will change the direction of the sorting between important messages shown on top or at the bottom of the list
|- align="left"
| Expand all items || this will expand all list entries to show all the information behind
|- align="left"
| Collapse all items || this will collapse all list entries to show their headers only
|- align="left"
| Copy to Clipboard || this will copy the content of the currently selected event(s)
|- align="left"
| Copy all to Clipboard || this will copy the content of the all listed events to the clipboard
|- align="left"
| Save to file || Saves the content of the currently selected event(s) to a text file
|- align="left"
| Save all to file || Saves the content of the all listed events to a text file
|- align="left"
| Clear all items|| Clears the event list
|}
==Context Menu==
By right-clicking an event in the list, a context menu is shown:
{| class="wikitable" | width = "50%"
|-
! Item !! Purpose
| Copy to Clipboard || this will copy the content of the currently selected event(s)
|- align="left"
| Copy all to Clipboard || this will copy the content of the all listed events to the clipboard
|- align="left"
| Save to file || Saves the content of the currently selected event(s) to a text file
|- align="left"
| Save all to file || Saves the content of the all listed events to a text file
|- align="left"
| Navigate to... || Navigate to the ubik object involved in this message; this menu item is only enabled if there is information about the involved UBIK object included in the message
|}
[[Category:Studio_tools]]