08 System Monitor

System Monitor

The System Monitor display allows for viewing the status of the system. The behaviour of the System Monitor is different depending on the use of the system, i.e. whether you are using the system in Stand Alone mode or as an Operator Client.

In the Stand Alone mode the System Monitor will display the Log Browser and Batch Forecast tab. In an Operator Client the System Monitor will show a number of tabs for monitoring various aspects of the live system. Each System Monitor tab is detailed in the following paragraphs.

Log Browser tab

The Log Browser contains a spreadsheet like form with a list of system messages. Messages can be sorted based on user defined criteria. Fatal and severe system errors can be acknowledged as being reviewed by the forecaster. If all errors within the past 48 hours are acknowledged the system status icon at the lower right of the FEWS explorer will become green again.

With [Refresh] the browser is updated with new messages in the system. Please note that the query settings (see below) define what messages will be displayed. With [Close], a user can leave the Log Browser.

Upon opening, the same information is displayed as in the Log Viewer. Per message, the Log Browser provides the following information:

• Log level (see table above)
• Log creation time
• Event code (see Appendix A for listing)
• Log message (description)
• taskRunId

The following type of system messages are identified in the table below.

The Log Messages can be sorted by clicking on the header of a column.

Double click a message to view the message details (see example below). The message can then be saved to file or printed.

Query definition
A query can be defined to select a subset of the messages to be displayed in the Log Browser. The following options are available:

• Loglevel
  A log level from the dropdown list and all messages with a higher alert level will be displayed This means that for example selection of INFO shows all messages and selection of FATAL shows only messages with log level FATAL.

• Log creation time
  Messages can be displayed that have been created within a given period of time. The period is defined by entering an end time and the length of a view period in hours preceding the end time .
• Event code
  By entering symbols in this field, only messages will be displayed starting with the symbols entered by the user.

The display will be updated on the basis of the user defined query upon pressing [Refresh].
Acknowledging messages
All messages having a level ERROR or FATAL should be can be acknowledged to identify that the message has been seen and appropriate action taken.

Double click the icon to acknowledge a message or click the Acknowledge button. Multiple messages may also be selected and acknowledged in a single action.

To select all messages that have not been acknowledged select the 'not acknowledged' item in the Log Level selection box,, then refresh the log messages.
Tip: to quickly select all messages, click on a single message and hit [ctrl-A]

When all ERROR messages are acknowledged, the status icon in explorer will change to green.

Debug messages
Please note that a System Manager can configure the system to also provide Debug Messages . These are used to log application internal events for system development and management. Typical debug events are the creation of a database connection or exceptions that occurred due to programming or configuration errors. Debug messages are not displayed in the Log Viewer but only written to a log file called log.txt in the regional configuration folder.

Live System Status tab

The Live System Status tab is used to show the status of the live system. Three lists show the status of the:

• Currently dispatched forecasts (taskruns)
• Currently executing forecasts (taskruns)
• Status of the Master Controllers
• Status of the Forecasting Shells

The status lists show the currently configured master controllers and forecasting shells. From this list a user can see if the systems are Alive or if they are down.

Scheduled Forecasts tab

The Scheduled Forecasts tab includes a list with all scheduled forecasts together with some critical information of these forecasts. The following information is included:

• Task ID: The Task ID is a unique ID generated by the Master Controller
• Description The description is given by the user that scheduled the forecast
• Workflow ID The Workflow ID is the id of the workflow that is scheduled. The workflow id's can include Forecasting Shell workflows and Master controller workflows.
• MC ID ID of the Master Controller where the task is scheduled on
• Priority This can be a high or normal priority
• Repeat Time The repeat time of the task in minutes
• Next Due Time The next time when the task is scheduled to run
• Task Status The status can be suspended or pending. Suspended tasks normally depend on an action to trigger them, such an action can be a threshold crossing.

The Scheduled Forecast tab allows to cancel, pause or suspend tasks. By that it's possible to change the start time of ascheduled forecast.

Running Forecasts tab

The Running Forecasts Tab includes a list with all tasks that are currently running on a Forecasting Shell. The list includes information on the task that is running and the Forecasting Shell it is running on.

From the example below can be seen that the first task is a Rolling Barrel task, running on the Master Controller. The second task is a Riverflow Forecast running on forecasting Shell FSS00.

This display is refreshed after each synchronisation of the Operator Client with the Master Controller.

Synchronisation Status tab

The Synchronisation Status tab provides the status of all synchronisation activities. For each synchronisation activity the following information is provided:

• Activity: identifies the synchronisation activity
• Type: single or continuous. A single type activity is only started after certain manual actions
• Frequency: only applicable for continuous synchronisation activities. The frequency is given in minutes.
• Last Synch Time: the date and time the synchronisation activity has last taken place.
• Status: is either empty or shows 'synchronising', meaning that this activity is now synchronising.
• Progress: shows the number of records of the maximum number of records to synchronise. This field is only used for the activity being synchronised.
  
  

  Synchronisation Monitor tab

  In the Synchronisation Monitor tab the log messages are shown that are generated by the synchronisation module. These messages will inform the user of synchronisation problems.

Import Status tab

The Import Status tab provides information on the files that were last imported. For each import task the file name of the last imported file is shown including the date and time of the import. Also the number of files that were imported in that task are shown, with the number of failed imports.

Batch Forecasts tab

Batch forecasts can be made in Stand Alone mode only. The batch forecast option will dispatch all the forecasts as scheduled with different settings for the T0. The Batch Forecasts tab then provides an overview of the forecasts that are dispatched. Under normal operation this tab will show no forecasts.