By default, events Events and errors encountered in the system are saved in the System Log. The System Log handles duplicate events within a time frame. Therefore , and therefore every event and error has a first and last occurred date, as well as information of on how many times it was repeated. The System Log allows the user to browse and purge this log.
There are three types of categories:
System-related log entries
Workflow related log
User-related log entries
For instance, if a workflow aborts, the reason may be tracked through the System LogYou can select to filter out which events you want to see as well as delete selected events from the log.
| Info |
|---|
The System Log table will display a maximum of 500 000 entries. If you want to modify the maximum number of entries, add the Platform property |
To open the System Log, click the button in the upper left part of the Desktop window, and go to Manage → Tools & Monitoring and then select System Log from the menu.
The System Log
Initially, the dialog is empty and must be populated with data using the Search System Log dialog. For further information, see the section below, Searching the System Log.
...
Show Entries
...
Entries matching the search criteria are displayed in groups of 500. Show Entries contains a list of all groups of 500, from which one is selected. Note that the full content of the log messages for a group is fetched from the database once the group is selected. This is to have as little impact as possible on the overall performance of the system.
...
The severity of the message can be any of the following:
...
If you have had the System Log open for a while, you can refresh the view by clicking on the Refresh button in the table action bar.
System Log Table
The System Log table displays the following options and values
Column | Description |
|---|---|
 Selection Checkbox | The selection check boxes can be used for selecting specific entries that you want to delete. If you select one or several check boxes, the table action bar will change to display a Clear and a Delete button. |
Last Occurred | This column shows the date and time when the event last occurred. |
Severity | This column shows the severity of the event:
|
|
|
|
|
|
|
|
|
Last Occurred
| |
Type | This column shows the event type:
|
Message | This column shows the message heading. If you display Event Details you will see the full message. |
First Occurred | This column shows the date and time when the event first occurred. |
Repeated |
This column shows how many times this |
event has occurred. | |
Area | Indicates which part of the system the message originates from; user, system or workflow. |
Workflow/Agent | The name of the workflow/agent from which the message originates. |
Message |
The message. Note that selecting an entry from the list will display its full contents.
First Occurred
The date when this message first occurred.
Area | If an entry is selected from the list, further details about it is displayed in this area. |
Filter
Use the Filter button to set filters for a more curated list of entries in the System Log.
| Note | ||
|---|---|---|
| ||
The search result is restricted to a maximum of 500 000 entries. If you want to modify the maximum number of entries, add the Platform property mz.systemlog.maxresults to the platform.conf and modify the value. For further information, see Platform Properties the in the System Administrator's Guide. |
System Log Filter
...
| Anchor | ||||
|---|---|---|---|---|
|
If you click on the entry in the System Log table, you will see additional details about the event:
...
Apart from the Last occurred, Message heading you will also see the following information:
Information | Description |
|---|---|
Creation date | The date and time when the entry was registered. |
Origin | The origin of the event, for example an IP address and port for a user event, or the host and port for a workflow event. |
Agent name | Name of any agent involved. |
User name | The user name of the user being the origin of the event. This information is only displayed for user events. |
Stack trace | The full stack trace for errors. This information is only displayed for workflow events. |
Filter
...
You can click on the Filter button to set filters for a more curated list of entries in the System Log. The Filter dialog will then open where you can configure your filter.
...
An entry has to match all configured filter settings to be displayed in the System Log table.
Item | Description |
|---|---|
Severity | The severity of the log entry |
; Info, Warning, Error, Fatal | |
Type | The affected entity. |
Date Range | Within which period entries will be viewed. A few predefined options are available. If none are selected, all are considered. The default period is Today. The available options are:
|
If you select User-defined |
, |
enter the Start date and time |
and |
End date and time |
. If |
neither are specified, all entries will match. |
Workflow |
Select to only view events relating to a selected workflow. All workflows for which entries have been registered are selectable in this drop-down-list. Only one workflow can be selected. |
Workflow Group |
Select to only view events relating to a selected workflow group. All workflow groups for which entries have been registered are selectable in this drop-down-list. Only one workflow group can be selected. |
Agent |
Select to only view events relating to a selected agent. All agents for which entries have been registered are selectable in this drop-down-list. Only one agent can be selected.
|
|
Username
If enabled, all activities performed by the selected user will match. If disabled, all user activities will match.
| Note | ||
|---|---|---|
| ||
This only applies to events invoked by users, such as inserting, updating and deleting data in the system. Thus, it does not apply to workflow ownership and can therefore not be utilized to filter out a specific user's workflows. |
Message
| |||
Username | Select to only view events relating to a selected user. All users for which entries have been registered are selectable in this drop-down-list. Only one user can be selected.
| ||
Message | Enter a free text search string to be matched by the messages in the entries you want to display. |
When you are finished, click OK to apply your filter settings. If you want to clear all filters, you can open the Filter dialog again and click on the Reset button.
Deleting Entries
You can delete either all entries in the System Log, or specific entries.
To delete all entries, click on the Delete button in the table action bar. You will be prompted to confirm that you want to delete all entries. Click on the Delete button to confirm.
If you want to only delete specific entries, select the check boxes for the entries you want to delete. The table action bar will change and display a Clear button and a Delete button. Click on the Clear button to clear all your selections, or on the Delete button if you want to delete selected entries. You will be prompted to confirm that you want to delete all entries. Click on the Delete button to confirm.