Activity Log Tab (Magic xpi 4.13)
The Activity Log tab displays detailed information about the Activity Log in your project and consists of several settings:
-
Selected Filters section: Lets you determine the information that is displayed in the log for the current view. Click the Filters button to define the filters. For additional information, see the Activity Log Filters Screen section below.
-
Server ID, BP, Flow, and Step drop-down lists: You can use these lists to quickly filter the Activity Log. The default value for all of these lists is ALL, and any change to the values triggers a refresh of the view. The Monitor first tries to get the data for these drop-down lists from GigaSpaces. If GigaSpaces is not available, or if the project is not running, the data will be loaded from the MonitorOfflineMetadata.xml file, located under the projects folder. This file is created during every Build operation. In this way, filtering functionality is available in offline mode as well. However, if the MonitorOfflineMetadata.xml file does not exist, no filtering will be available and all of the filter drop-down lists will be set to ALL. There is no refresh process for reading the MonitorOfflineMetadata.xml file. It will be read only when accessing an offline project for the first time or when accessing an offline project after a project has been shut down.
-
Automatic refresh interval (seconds) check box: When selected, will refresh the view every interval. The default interval is 30 seconds. Click the button to open a dialog box where you can change the interval. This check box is only enabled on the first page. If you press any of the scroll buttons at the bottom of the screen, this check box will not be enabled.
-
Message type drop-down list, at the top right of the screen, where you can filter the messages to appear. The options are: All (default), Errors, or Component Logging.
-
Enable logging check box: To enable efficient operation of the Magic xpi Server, you can stop the Magic xpi Server from sending messages to the Activity Log. You can switch on the Activity Log on demand, without having to restart the server. This provides runtime troubleshooting capabilities. The logging option is available if there is a connection to a running server.
-
Enable component logging check box: You can enable or disable component logging using this check box. Selecting this check box will update the G.sys.ComponentLogging variable accordingly.
-
Details: This section displays detailed view of selected line in the Activity Log table. You can click on the hyperlinks that are marked in blue and underlined. The selected link takes you to an Activity Log screen and filters the view based on the Root FSID, Flow Request ID or FSID. The filtered Activity Log screen shows Date Time, BP, Flow, Step, Message Type, Message, FSID, Root FSID, Flow Request ID and Blob columns.
The hyperlinks in the Details section are very useful when investigating issues in the project since it focuses the view on the required information and eliminates the need to search for it manually.
You can also zoom from the Attached Blob button to open the BLOB file. The button is only enabled when the BLOB is available.
|
For Oracle Database Blob up to 2k is supported by default. To get support for blob field with more than 2k bytes, define the following path in the ifs.ini of the project which will then create the file for the data at the specified location and run successfully through monitor as well.
[MAGIC_IBOLT]activityBlobFileLocation=c:\\temp\\
|
-
Total number of lines: Total number of messages in the database. This is automatically refreshed regardless of the Automatic refresh interval setting.
-
Result drop-down list: Defines the amount of records on each page. The available values are 20, 50 (default), 100, and 200.
-
Delete button: Click this button to specify how many days to delete.
-
Refresh button: Click this button to manually refresh the table. This will check the information on the Magic xpi Server and update the table.
In the Time Range Filters section, you can filter the date and times that are displayed in the log. The From and To parameters have two fields each. In the first field, enter a beginning date or an ending date. You can also double click in the first From or To field to display a calendar that allows you to select a date. In the second field, enter a beginning time and an ending time.
In the Context Related Filtering section, you can filter the messages according to Root FSID, Flow Request ID, or FSID. Enter the beginning and ending FSID in the From and To fields.
From the drop-down list, you can filter the activity log messages as ALL (default), Server, Flow or Component.
From the Message section, you can select what to display in the table above.
|
|
Display
|
Select the check box next to each message that you want to be sent to the log. By default the statistic information is selected. If you clear a check box, the message is not displayed in the Activity Log even if it is relevant.
|
Write
|
Select the check box next to each message that you want to write to the log.
|
Color
|
Select a color to display if the message exceeds the exception rate.
|
When you have entered the information you need to create your filters, click OK to change the settings for this project and change the Activity Log display.
When you click on the Filters button, the following two files are saved in the: \Projects\<project name>\config folder:
-
Actlog_Write_Settings.xml – This file is responsible for writing the Activity Log messages to the database. The master template file is located in the <Magic xpi installation>\Runtime folder.
-
Actlog_Display_Settings_<user>.xml – This file is responsible for the display and colors. Each XML file will have the <user> as part of the file name so that different display settings can be applied based on the user.
The FILELOCATION column in the ifs_actlog database table stores the value from the ActivityBlobFileLocation flag concatenated with the file name when the project loads. The BLOB will be shown in the Magic Monitor whether it is saved in the BLOB variable or in the file system. If the BLOB is saved in the file system, the Magic Monitor will search the BLOB according to the FILELOCATION column. When clearing the Activity Log from the Magic Monitor, these BLOBs will be deleted whether they are saved to the database or on the disk.
The definitions are per project, which means that one project can write the BLOBs to the database and another project can write them to the file system.