Automate Event Log 

By default, AutoMate maintains text logs that record task events, system events, and (in AutoMate Premium) audit events. These logs can be viewed via the AutoMate Event Log located in the Task Administrator. The Event Log contains a complete set of reports that display the status and condition of tasks, triggers, system events and audited events in a table format (as shown below). You can view various statistics such as whether a task ran successfully or failed, the date/time a task started and ended, the machine name where the task ran (helpful when deploying tasks to remote agents), when a task was created, deleted or updated and when the AutoMate Task Administrator was connected to or disconnected from the AutoMate Task Service. If a task failed, the Event Log can be used to determine the error that was generated. Additionally, you can export information from the Event Log onto a .csv file.

Accessing/Viewing the Event Log


To access the Event Log:

  1. From the Task Administrator, click the Log button on the toolbar (as shown below) or expand the View menu and select Log. The AutoMate Event Log window opens.

  1. Use the tabs to select the type of logged events you want to view.

  2. If you want to limit the records shown, use the drop-down boxes to limit them to specific dates and times or to show only success or only failure events. In the task events log you can also limit the records to a selected task.

Exporting Events


Clicking the Export button located at the bottom left corner of the AutoMate Event Log window (shown below) will allow the current log to be exported to a CSV (Comma Separated Value) file; a specially formatted plain text file which stores spreadsheet or basic database-style information in a very simple format, with one record on each line, and each field within that record separated by a comma. It can be opened with a spreadsheet program (i.e. Microsoft Excel) with the data already properly formatted. CSV files are often used as a simple way to transfer a large volume of spreadsheet or database information between programs, without worrying about special file types.

To export a specific table to a CSV file:

  1. Select the tab that corresponds to the desired table (i.e. Task Events, System Events or Audit Events tab).

  2. Set the available filter options to be included for that table.

  3. Click the Export button. A dialog titled Export to CSV appears.

  1. Select the location and desired file name of the CSV file.

  2. Click the Save button.

Event Categories


Events are categorized into three sections separated by tabs; Task Events, System Events and Audit Events. Task events ordinarily include the starting and ending of task executions, though tasks can be set to have step detail included in the log (see Logging Properties). System events include anything that affects the system as a whole, such as service starts and stops or task starts and stops. Audit events include changes in the state of the system, such as modifications to system properties or task properties. Each log shows the date and time of the event, the machine name, the task name if applicable, and details about the event. By default, all dates and events are shown, but you can use the filter options  to sort or limit the records shown. More details about the three event types are detailed below.

Task Events

The Task Events tab supplies detailed information with reference to executed tasks in a table view. For further details, see Logging properties.

Available Task Events Filters

Filter Name

Description

Task Name

The name of the task that ran. The available options are:

  • All Tasks (default) - The log will display information regarding all tasks.

  • Individual task (select task name) - The log will display only the individual task selected.

Task Event

Displays task execution success, failure or both. The available options are:

  • Success and Failure (default) - Both success and failure events will be displayed.

  • Success - Only successful task executions will be displayed.

  • Failure - Only failed task executions will be displayed.

Date/Time

Displays task execution information for the selected date/time. The available options are:

  • All Dates (default) - All execution dates will be displayed.

  • Today - Only tasks that ran today will be displayed.

  • Yesterday - Only tasks that ran yesterday will be displayed.

  • Last 7 days - Only tasks that ran within the last 7 days will be displayed.

  • Last 30 days - Only tasks that ran the last 30 days will be displayed.

  • After this date/time - Displays tasks that ran after the date/time specified.

  • Before this date/time - Displays tasks that ran before the date/time specified.

  • Custom - Allows you to fully customize the start and end date/time in which to display task execution details.

Viewable Task Events Columns

The available columns which can be viewed under the Task Events tab are as follows.

Column Name

Description

Date/Time

The date/time the event occurred.

Machine Name

The machine name where the task event occurred.

Task Name

The name of the task that created the event.

Event

The type of task event that occurred (i.e. task started/ended).

Step Number

The step number within the task that generated the event. Only available if the Log extended step information parameter is enabled in the Logging tab of the managed task properties. Enabling this parameter will log step by step information about that task during runtime. Each step (and its step number) then appears in this field. For more details, see Logging properties.

↑ Top of Page

System Events

The System Events tab supplies information regarding any AutoMate related system events that occurred. This generally includes anything that affects the system as a whole, such as AutoMate Task Service starts and shutdowns, task starts and stops or global enabling/disabling of task triggers. Events are displayed in detail under the Event field, which normally includes verbose information about errors generated by a task. For further details, see Logging properties.

Available System Events Filters

The System Events table can be filtered in the following ways.

 

Filter Name

Description

Result

Displays system events that succeeded, failed or both. The available options are:

  • Success and Failure (default) - Both system related success and failure events will be displayed.

  • Success - Only successful system events will be displayed.

  • Failure - Only failed system events will be displayed.

Date/Time

Displays system related events for the selected date/time. The available options are:

  • All Dates (default) - All dates/times will be displayed.

  • Today - Only events that occurred today will be displayed.

  • Yesterday - Only system events that occurred yesterday will be displayed.

  • Last 7 days - Only system events that occurred within the last 7 days will be displayed.

  • Last 30 days - Only system events that occurred the last 30 days will be displayed.

  • After this date/time - Displays system events that occurred after the date/time specified.

  • Before this date/time - Displays system events that occurred before the date/time specified

  • Custom - Allows you to fully customize the start and end date/time in which to display system event details.

Viewable System Events Columns

The available columns which can be viewed under the System Events tab are as follows.

Column Name

Description

Date/Time

The date/time the event occurred.

Machine Name

The machine name where the system event occurred.

Event

The type of system event that occurred (i.e. triggers enabled/disabled, task aborted). If a particular task generates an error, detailed information regarding the error (including the step number) will appear in this column.

Audit Events

The Audit Events tab supplies information about AutoMate related audit events that occurred. This normally includes events such as when a task was created, deleted or renamed, when the Task Service was connected/disconnected or when a specific task logs on a workstation. Particular Audit Events are displayed in detail under the Event column.

Available Audit Events Filters

The Audit Events table can be categorized in the following ways.

 

Filter Name

Description

Result

Displays audit events that succeeded, failed or both. The available options are:

  • Success and Failure (default) - Both success and failure events will be displayed.

  • Success - Only successful events will be displayed.

  • Failure - Only failed events will be displayed.

Date/Time

Displays audit event information for the selected date/time. The available options are:

  • All Dates (default) - All dates/times will be displayed.

  • Today - Only audit events that occurred today will be displayed.

  • Yesterday - Only audit events that occurred yesterday will be displayed.

  • Last 7 days - Only audit events that occurred within the last 7 days will be displayed.

  • Last 30 days - Only audit events that occurred the last 30 days will be displayed.

  • After this date/time - Displays audit events that occurred after the date/time specified.

  • Before this date/time - Displays audit events that occurred before the date/time specified.

  • Custom - Allows you to fully customize the start and end date/time in which to display audit event details.

Viewable Audit Events Columns

The available columns which can be viewed under the Audit Events tab are as follows.

Column Name

Description

Date/Time

The date/time the event occurred.

Machine Name

The machine name where the event occurred.

Task Name

Specifies the name of the task (if applicable).

Event

The type of event that occurred (i.e. task created, deleted, renamed or connection to service).

See Also

Error Handling Overview

Setting Global Error Handling

External Database Logging Configuration

↑ Top of Page