Event Log: Difference between revisions

From Knowledge Base
No edit summary
No edit summary
Line 1: Line 1:
[[Category:TMAC]]
[[Category:TMAC]]
[[:Category:TMAC|Back to TMAC Categories Page]]


== '''Overview''' ==
== '''Overview''' ==

Revision as of 14:09, 31 August 2022

Back to TMAC Categories Page

Overview

The Event Log button in the TMAC action bar opens a separate window displaying data pertaining to system events. System events include but are not limited to alarms, system resets, job loads, starts and stops. The user can add additional data columns beyond the defaults for the events displayed in the Event Viewer. Additionally, the user can apply filters to columns that limit the events displayed based on configured logic statements.

Event Viewer Interface

The Event Viewer interface is split into the following three sections:

  1. Events: A tabulated list of system events based on the columns and filters chosen.
  2. Filters: A list of applied filters.
  3. Data: Additional data displayed for a selected event. A specific event can be selected from the list of events by clicking anywhere in the row of the specified event. The additional data displayed is dependent on the type of system event selected.

Column and Filters

TMAC stores a large amount of event data, but not all event data is displayed in the Event Viewer by default. Users may want to display more data or specific events that meet certain criteria. This can be done utilizing Columns and Filters.

Adding a column amends the event viewer by displaying the additional data correlated with that column for each event. For example if a user desires to have alarm descriptions displayed in the Event Viewer, adding the "Alarm Description" column amends the column to Event Viewer.

Filters allow the user to remove undesired events from the Event Viewer. Filters work in conjunction with columns by utilizing filter conditions to remove data that doesn't satisfy the proposed conditions. For example, if a user wants to view only "Alarm" type events, a filter needs to be applied to the "Type" column. Set- ting a filter with the condition "Equal to ALARM" displays only events that contain "ALARM" in the "Type" column

Adding Columns to the Event Viewer

To add columns to the Event Viewer, perform the following steps:

  1. Click the Settings button
  2. Click the Select Columns button to open a list of column types
  3. Each column type has an associated check-box. Mark all desired columns by clicking the associated check-boxes.
    1. Note: The Data Columns list can be filtered using the drop-down menu. Columns for all event types are displayed by default. Additionally the DESELECT ALL and SELECT ALL buttons can be used mark all columns for selection.
  4. Click Apply to close the Edit Columns Window
  5. Click SAVE to close the Event Viewer Settings window

All selected columns are added to the Event Viewer

Reordering Columns

After adding a column to the event log, the column is amended at the end of the list of columns by default. The list of columns in the Event Viewer Settings win- dow are listed in the order they appear in the event log (left to right). If desired, a column can be moved up or down the list using the following steps:

  1. Select a column from the list in the Event Viewer Settings
  2. Move the column to the desired position using the MOVE UP or MOVE DOWN buttons
  3. Press SAVE

Adding a Filter to a Column

To add a filter to a column, perform the following steps:

  1. Click the SETTINGS button
  2. Select a column to apply a filter to
  3. Click the FILTERS button
  4. Click the ADD button
  5. Select a filter condition from the drop-down menu. The following options are available:
    1. Equal To
    2. Less Than
    3. Greater Than
    4. Between
  6. After a filter condition has been selected, complete the logical expression by entering a value.
    1. Note: When utilizing the Between filter condition, the user must input a minimum and maximum value.
  7. Click APPLY
  8. Repeat steps 4-7 for any additional filters that need to be applied or continue to step 9
  9. Click SAVE to close the Event Viewer Settings window

The filter looks for event data in the column that the filter was applied to and removes all events that do not satisfy the filter conditions.  

Time Filters

The Event log can be filtered based on time and date, in addition to columns and row filters. After opening the Event Viewer Settings, the following time filters can be selected:

  • All Time: Displays all events recorded since system installation or the last data purge.
  • Today: Displays events that occurred on today's date.
  • Past Week: Displays all events that have occurred in the past week.
  • Past Month: Displays all events that have occurred in the past month.
  • Past Year: Displays all events that have occurred in the past year.
  • Custom: Allows the user to input a date range, limiting the displayed events to those that have occurred inside of the date range.

Presets

Presets allow the user to save applied columns and filters to easily switch between specific data sets. For example, a user could have a preset that displays only alarm events and a preset with only Job Load events. Switching between presets prevents the user from having to remove and re-add the columns and filters every time different data needs to be viewed. TMAC is installed with a system default preset.

A user created preset can also be set as the default in place of the system default.

Saving a Preset

Perform the following steps to save a preset

  1. Add or remove any data columns desired for the custom preset
  2. Apply any filters to eliminate unwanted events
  3. Click the SAVE AS button
  4. Enter a name for the preset
  5. Click SAVE

Manage Presets

Pressing the PRESETS button opens the Manage Presets window. In this win- dow, users can open, delete, import, and export presets. Additionally, any user created preset can be set as the default preset.

TMAC HMI Action Bar Functionality
Exporting a Preset

Use the following steps to export preset:

  1. In the Manage Presets window, click the EXPORT PRESET button
  2. Navigate to the desired directory and name the preset file
  3. Click Save
Importing a Preset

Use the following steps to import preset for use in the Event Log:

  1. In the Manage Presets window, click the IMPORT PRESET button
  2. Browse to and select the desired preset file
  3. Click Open

Exporting Event Log Data

The data from the event log can be exported to a file. To export event log data, use the following steps:

  1. Click the EXPORT button
  2. Select a time frame from the following options:
    1. All Time
    2. Today
    3. Past Week
    4. Past Month
    5. Past Year
    6. Custom: Enter a custom date range
  3. Select a Format
    1. CSV: Exports the event log data to a .csv file
    2. HTML: Exports data to a file in HTML format
  4. Select additional options
    1. Export all columns: If enabled, TMAC exports data from all columns instead of the currently configured columns.
    2. Export all events: If enabled, TMAC exports data from all events within the selected time frame, ignoring any applied filters.
  5. Click EXPORT
  6. Navigate to the desired directory and name the file
  7. Press Save
  8. Click DONE to close the window