Overview of Log Viewer

The Log Viewer application allows you to view the historical data related to system activities and events directly without creating and configuring a report from the Reports application.

The information related to all the system activities and events displays in a tabular format.
You can create a subset of this information by applying the necessary configurations such as filters, identifying the columns to display, specifying the number of records to display,
and other settings, such as resizing the column width or re-ordering the columns.

Once configured, this information can be saved as a log view definition that can be used later.
When you access the log view definition at a later date, the latest data, according to the configurations that you have applied to the definition, displays.

When you save the data as a log view definition that has sorting applied, the sort criteria is also saved.
The next time when you load the log view definition, the data with the saved sort criteria displays.

In a distributed system, the data from all the systems displays in the log view grid.

You can view log data using any of the following procedures:

  • Selecting the Log Viewer root node, a log view folder, or a saved log view definition from the System Browser.
  • Selecting an object from System Browser: This displays the Activity and Event Log records for the selected object in the Detailed Log tab.
  • Selecting an object from any application such as Graphics, Trends, Textual Viewer, or Reports:
    This displays the latest 100 Activity and Event Log records for the object in the Detailed Log tab.
  • Selecting an Activity type or Event type record in the log view:
    When you select an Activity type record from a log view, the latest 100 Activity and Event Logs for the selected object display in the Detailed Log tab.
    However, if an Event type record is selected, the details of the selected event including the different state changes of the event and the user activities performed in context of the event are displayed in the Detailed Log tab.
    For example, a single event type can trigger multiple notifications, therefore, the multiple activity logs for the messages gets added in the platform’s activity log.
  • Selecting an event from Event List: Displays information about the object involved in the event in the Detailed Log tab.

However, if you have selected more than one object, the Detailed Log tab does not display any information.

NOTE:
When you select the Log Viewer root node, a log view folder, or a saved log view definition from System Browser, you may see the following message above the log view table: Configured View Size reached! Refine search via Search Filter. This means that there are more records in the database than can be displayed in the defined view size. In order to view such records you must either specify filters or modify existing filters.

 

Default Columns in a Log View

The following table lists the default columns that display in the Log Viewer. In addition to these columns, you can add other columns from the Select Columns dialog box.

Default Columns in the Log View

Name

Description

System Name

Displays the name of the system to which the source object belongs. This is particularly helpful when working with a distributed environment, where you have data displaying from multiple systems.

Date/Time

Date/Time when the activity is performed or state change of event occurred.

Source Description

Description of the source object associated with the activity or event.

Record Type

Type of information displayed. This information can be of type Activity or Event.

Source Property

Name of the property associated with the source object on change of which the activity or event occurred.

Event Message Text

Event message text associated with the source object.

Event Category

Category of the event.

Event Time

Date/Time of the occurrence of the event.

Event State

State of the event.

Event Cause

Reason that triggered the event.

ID associated with the event.

Event ID

Log Type

The Desigo CC application where the activity, such as event printing or commanding is performed.

Action

Nature of the activity performed by the source object. For example, for a Users object type, the value of the Action field could be Login, Primary Authentication and so on.

Value

New value of the Source Property when an activity is performed.

Quality

Quality of the new value.

Previous Value

Previous value of the Source Property when an activity is performed.

Previous Quality

Quality of previous value.

Unit

Unit of measurement of value of source property.

 

NOTE:
Values are displayed as per value scaled units (if configured). See Value Scale Units.

 

Additional Columns in a Log View

Additional Columns

Name

Description

Action Details

Additional descriptive information of the activity performed.

Action Result

Status of a user activity. Possible values are Succeeded, Partially Succeeded, Failed, Unknown.

Attachment

Displays the link to the report output document that is created when performing the Operating Procedure Steps such as alarm printout, report, or treatment form.

Event mode

Mode in which the event is generated. Possible values are Normal and Maintenance.

Management Station

Displays the host name of the Desigo CC client from where the activity is performed.

Alias [Observer]

Alias of the event enrollment object that monitors any BACnet object.

Alias [Source]

Alias of the source object.

Source Designation

Default hierarchy of the source object composed using the names of the nodes present in the hierarchy.

Source Designation [Application View]

Hierarchy of the source object from Application View composed using the names of the nodes present in the hierarchy.

Source Designation [Current View]

Hierarchy of the source object from the currently selected view in the System Browser composed using the names of the nodes present in the hierarchy.

Source Designation [Management View]

Hierarchy of the source object from Management View composed using the names of the nodes present in the hierarchy.

Source Identifier [Internal]

Internal ID associated with the source object.

Source Location

Default hierarchy of the source object composed using the description of the nodes present in the hierarchy.

Source Location [Application View]

Hierarchy of the source object from the Application View composed using the description of the nodes present in the hierarchy.

Source Location [Current View]

Hierarchy of the source object from the currently selected view in the System Browser composed using the description of the nodes present in the hierarchy.

Source Location [Management View]

Hierarchy of the source object from Management View composed using the description of the nodes present in the hierarchy.

Source Name

Name of the source object.

Observer Description

Description of the event enrollment object that monitors the source BACnet object.

Observer Property

Name of the property associated with the event enrollment object on change of which the activity or event occurred.

Observer Designation

Default hierarchy of the event enrollment object composed using the names of the nodes present in the hierarchy.

Observer Location

Default hierarchy of the event enrollment object composed using the description of the nodes present in the hierarchy.

Observer Name

Name of the Event Enrollment Object that monitors the source BACnet object.

Observer Identifier [Internal]

Internal Id for the Event Enrollment Object that monitors the source BACnet object.

Discipline

Discipline of the source object (for example, Building Automation).

Subdiscipline

Subdiscipline of the source object (for example, Communication for management platform discipline).

Type

Type of the source object (for example, network).

Subtype

Subtype of the source object (for example, BACnet for type Network).

Alert ID

Internal unique ID associated with an event.

User

Name of the user performing the activity or treating the event.

Validation Profile

Validation profile associated with the source object.

Audit Trail

Displays Audit Trail if the validated object creates an activity log. However, if an activity log is created by a non-validated object, then this column displays Activity.

Object Version

Displays the version number of the validated object. The version number is incremented each time you perform an activity on the validated object. In case of a non-validated object the Object Version column does not display any value.

Comment

Validation comment entered.

Reference Time

Displays the original time stamp of the record that is added, modified, or deleted using the Manual Correction snap-in.

Event Details

Message text associated with the event.

Category Priority

Priority associated with the event.

Supervisor

Name/ID of the supervisor who is designated as the second approver to approve the "Regulated" and "Monitored" validation states before the command or configuration change is executed on the selected object.