Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

Insert excerpt
_Banners
_Banners
nameadministration
nopaneltrue

This page is for PhixFlow administrators who need to monitor PhixFlow activity.

Overview

The system console provides details on active and completed tasks, files imported and exported by PhixFlow, and the audit trail of changes made to PhixFlow's configuration.  

Excerpt

Access to the console, depends on your privileges. Application users, analysis modellers and application designers are notified of errors that prevent their work, but are not notified of system warnings. These are only reported to the console. This means it is important for the PhixFlow administrator to monitor the console for warnings and to determine what action is required.

You require the permission:

  • View System Console to open the system console and to rollback a task
  • Cancel Tasks to stop a running task.

For logs with information related to server and Tomcat traffic, see Server Log Files.

Insert excerpt
_standard_settings
_standard_settings
nopaneltrue

Console Information

The following buttons are available at the top of the System Console:

Image Modified

Opens

...

the System Logging Configuration tab where you can configure the logging for data analysis models and objects.

Image Modified

Opens the task plan list.

...

The following tabs

...

...

Anchor
TaskLogs
TaskLogs
Task Logs

Active Tasks

Displays a log file summary for each Task Plans that is currently active. Right click on the task and select Show Log File on the context menu to bring up the detailed log file.

Active Tasks can be stopped at any time, if required (this may be useful when testing new models) by pressing the Image Modified button.

Completed Tasks

Displays a log file summary for each Task Plans that has completed.

The following buttons are available for Completed Tasks:

Image Modified

Apply a filter to the list of Completed Tasks.

Image Modified

Refresh the list of Completed Tasks.

Completed Task Colour Coding


Red

Error

This log file contains errors.


Orange

Warning

This log file contains warnings.


BlueSuspended Task

The initiator of this log file is currently suspended. This can be suspended by the user manually or set to suspend on failure.

Note

Blue overrides all of the other colours. If a task is is suspended, all instances of it in the Completed Tasks list are marked in blue.



TealSelected Task

The item has been selected by ticking the first column, one or more lines can be selected.

Note: this will override any of the above colours.


GreenMouse OverThe mouse over highlights the row in bright green. 

The following details are available for each log file:

FieldDescription
StartedThe date and time that this Analysis run was started.
FinishedThe date and time that this Analysis run finished.
Archive TimeThe date and time that this Log File was archived.
NameThe name of the Task which has been run.
CancelledWhether this Analysis run was cancelled by a user.
StatusAn icon will indicate if the

...

recordsets generated by the Analysis run were rolled back from the

...

Recordsets tab in the system console. See below for details.
TasksThe number of individual Tasks that were run as part of this Analysis run.
MessagesThe total number of messages in the Log File.
InfoThe number of information messages contained in the Log File.
ErrorsThe number of error messages contained in the Log File.
WarningsThe number of warning messages contained in the Log File.
Initiator TypeThe PhixFlow object that was used to launch this Analysis run.
Login nameThe user that stated this run.
ActionWhether the task was a

...

table-action.

To display a log file, right-click its name to open the context menu, then select the Show Log Details.

For

...

recordsets that have been rolled back from the system console

...

Recordsets tab:

  • If the

...

  • recordsets generated by an analysis run were rolled back and the analysis repeated (see Tab:

...

  • Recordsets, below), the log file entry is displayed with a Image Modified button in the Status field. Click Image Modified to open the new log file from the rerun of analysis.
  • If the

...

  • recordsets generated by an analysis run were rolled back, the log file entry is displayed with a Image Modified button in the Status field. Click Image Modified to open the log file for the rollback.

Tab: Messages

The log messages for the currently selected log file. For each message the following fields are shown:

FieldDescription
TypeThe type of message e.g. INFO, WARN, ERROR or DEBUG
CodeThe numeric error message code.
MessageThe summary message output by the analysis engine.

The following buttons are available for log messages:

Image Modified

Apply a filter to the list of log messages.

Image Modified

Refresh the list of log messages.

Log message details

Double-click on a log message to see further details. In addition to the standard fields, you will also find, on its own tab, the message detail:

FieldDescription
Message DetailDisplays the values of the variables in the parser or detailed stack trace. Populated if an error occurs during analysis or a debug attribute function has been processed.

Tab: Stream Sets

...


Tip

It may take a few moments to display log message details for HTTP communications. This is because the log messages can be long.

Tab: Recordsets

The recordsets for the currently selected log file

...

; see Managing Recordsets

If the

...

recordsets generated by an

...

analysis run produced a number of

...

cycle, and one or more

...

cycle was rolled back and repeated, then the Status field will contain a symbol to indicate whether:

  • Image Modified this

...

  • recordset was originally generated as part of this Analysis run, but has been moved forward into the log for the Analysis to generate those

...

  • recordsets that were rolled back and repeated.
  • Image Modified this

...

  • recordset was moved forward into this log from the original Analysis run, along side new

...

  • recordset generated in this Analysis run - the

...

  • new recordset are those that were rolled back to be redone from the original log.

...

The recordset in the console also provides the following buttons:

Image Modified

Roll back the data for each

...

recordset and run

...

analysis again.

...

When data is rolled back, any subsequent

...

downstream recordsets are also rolled back. After

...

reprocessing

...

a

...

log file in this way, the

...

log file will be flagged as "Reprocessed", and

...

no recordset will be associated with it.

Image Modified

Roll back the data for each

...

recordset. When data is rolled back, any subsequent

...

downstream recordset will also be rolled back.

...

Anchor
ImportedExportedFiles
ImportedExportedFiles
Imported/Exported Files

A list of files that have been read into PhixFlow by File Collectors or produced by PhixFlow File Exporters. This is found on the Imported/Exported Files tab on the 97734411, on the Imported/Exported Files tab in the 97734411 tab on the System Console, or when viewing the details of an individual file.

By right clicking on a file you can select Show Log File from the context menu. This will bring up the log file of the Analysis run that handled this file - whether as a file imported or exported.

By right clicking on a file you can select Show File Importer/Exporter. This will being up the configuration of the importer or exporter used to handle this file.

...

...

FieldDescription
CycleThe analysis cycle in which the file was processed.
Processed AtDate and time that file was processed
TypeImported or Exported
File Importer/ExporterThe Importer or Exporter used to handle this file.
StatusStatus of the file.
RecordsThe number of records in the file.
FTP SiteThe FTP Site the underlying file handler is attached to, if there is one.
LocationThe location of the file on the file system.

For information about import errors due to missing items, see Import Configuration.

Anchor
EmailMessages
EmailMessages
Email Messages

Emails which have been created by the system, from task plans or file exporters.

FieldDescription
Created Date/TimeThe date and time at which the email was created.
Send by Date/TimeThe date and time at which the system will stop trying to send the email.
StatusThe status of the email (ready, sent, failed, etc).
Status MessageA message associated with the status, such as the reason for failure.
Email SubjectThe subject of the email.
Email MessageThe message of the email.
FromThe email address the message is being sent from.
ToA list of the email addresses the email will be sent to.
CcA list of the email addresses the email will be Cc to.
BccA list of the email addresses the email will be Bcc to.
Creator NameThe name of the PhixFlow object which created the email.
Creator TypeThe type of the PhixFlow object which created the email.
Zip all attachmentsWhether any attachments are being added as a zip file.
Zip file nameThe name of the attached zip file.

PDF Chore 
Anchor
pdfchores
pdfchores

PDF Chores are the PDF

...

conversion processes that have been created by file exporters; see Configuring PDF Conversion.


Field
Description
Created Date/TimeThe date and time at which the PDF Chore was created.
StatusThe status of the Chore (ready, failed, etc).
Status MessageA message associated with the status, such as the reason for failure.
Creator NameThe name of the PhixFlow object which created the object.
Creator TypeThe type of the PhixFlow object which created the object.
Source File PathThe Path of the source file.
Source File NameThe name of the source file.
Target PathThe Target Directory Expression


Audit Summary 
Anchor
AuditSummary
AuditSummary

...

Summary details of audited actions performed on PhixFlow objects.

All Audit Summaries can be viewed from the Audit Summary tab on the 97734411. Details for an individual Audit Summary can be viewed by selecting an Audit Summary from this view, and double clicking.

The System Administrator uses Privilege Codes to configure which operations should be audited. If a given privilege has been configured for auditing, PhixFlow tracks details of every associated action and presents these in an Audit Summary.

Tip

PhixFlow database administrators can directly query the PhixFlow database for audit information in the audit_summary and audit_detail tables. Audit records that pre-date the upgrade to version 8.1.0 of PhixFlow will not have an entry in the message_text column.

Form: Audit Summary

FieldDescription
Date/TimeThe date/time the audited action took place.
UsernameName of the User who performed the audited action.
Action SummaryA summary description of the audited action.

Audit Details

The Audit Details of an audited action can be viewed with the details of an individual 97734411.

Form: Audit Details

FieldDescription
Audit DetailsA detailed description of the audited action.

Forms: Audit Summary for Object

This form shows summary details of audited actions performed on a particular PhixFlow object.

FieldDescription
Date/TimeThe date/time the audited action took place.
UsernameName of the User who performed the audited action.
Original NameOriginal Name of the Object that was changed. i.e. if the name of the object was up dated, this is the original value.
Action DescriptionA summary description of the action.