Process Discovery Analyzer

Process Discovery Analyzer is designed to process the recorded raw data and to generate refined data for the Kofax Analytics for RPA dashboard views.

The Analyzer is a command line application that outputs its status to the console window and the Analyzer log file.

Include the Analyzer program into your antivirus software exception list for the uninterrupted analysis.

Getting settings from the Management Console

During the startup, the Process Discovery Analyzer connects to the Management Console to receive the necessary settings and information about the Process Discovery Groups to start the analysis.

Set up Management Console URL and authentication settings to connect to the Management Console. The Process Discovery Analyzer options section explains how to set the options depending on the way the Analyzer is deployed.

Analyzing data

Process Discovery Analyzer processes all recorded data collected by the agents within the Process Discovery groups. The analysis is performed for every Process Discovery group separately. Analysis settings are specified in the Process Discovery Groups menu in Management Console.

After the connection to the Management Console is established, the Analyzer checks the connection to the database. If the database connection is established successfully, the Analyzer starts the analysis.

The Analyzer does not perform the analysis and reports an error if it cannot connect to the Management Console or the Analyzer database. One of the reasons can be different versions of the Analyzer and the Management Console.

A group is omitted from the analysis if Analyze option is not selected for a group in Management Console or if the Analyzer cannot connect to a Process Discovery group database.

Once data analysis for all groups is finished, Analyzer enters the standby mode and waits for the next run according to the schedule specified in the Management Console settings.

We recommend running Process Discovery Analyzer each day when Process Discovery Agents collect data. You can schedule Analyzer to run at the end of the day to have fresh data each morning. Analysis is a time consuming operation that may take hours and even days depending on the amount of data. To decrease the data processing time, you can increase the number of nodes in the Analyzer cluster. See Process Discovery Analyzer cluster for details.

Log files
The location of the Analyzer and cluster log files depends on the operating system and running mode. The following log files are created:
  • analyzer.log: General Process Discovery Analyzer log file.

  • spark_worker.log: Analyzer cluster worker log file.

  • spark_master.log: Analyzer cluster master log file (created on the Master node only).

Windows application

If Analyzer is installed as a Windows application, the log files are located in the Analyzer Application Data folder. For example:

C:\Users\UserName\AppData\Local\KofaxRPAProcessDiscoveryAnalyzer\<version>\Logs

Windows service
If Analyzer is installed as a Windows service, the log files are located in the Program Data folder. For example:

C:\ProgramData\KofaxRPAProcessDiscoveryAnalyzer\<version>\Logs

Linux application
If Analyzer is installed on Linux, the log files are located as follows:

/home/KofaxRPAProcessDiscoveryAnalyzer/<version>/Logs

Process Discovery Analyzer options

Process Discovery Analyzer deployed without Docker

To see the list of Analyzer options with descriptions, in the console window run either KofaxRPAProcessDiscoveryAnalyzer.exe for Windows platform or KofaxRPAProcessDiscoveryAnalyzer for Linux platform with -h or --help parameter, such as:

KofaxRPAProcessDiscoveryAnalyzer.exe --help

Process Discovery Analyzer options

Option

Description

-h, --help

Shows the help message and exits.

--version

Shows the version of the Analyzer.

--mc-url

Management Console URL and port to connect to as in the following examples:

  • Embedded Management Console: http://localhost:50080

  • Management Console on Tomcat: http://192.168.0.101:8080/ManagementConsole

--mc-user

Management Console username.

--mc-password

Management Console password.

--locale

Explicitly specifies locale, such as "ja". By default locale is retrieved from system settings.

--log

Sets logging level. Possible values are CRITICAL, ERROR, WARNING, INFO, DEBUG.

--open-doc

Opens the Analyzer documentation.

--dump

If this parameter is specified, the Analyzer records some raw data to a temporary directory for debugging purposes.

Process Discovery Analyzer saves configuration of the last run. Next time you start the Analyzer without options, it uses the configuration saved during the previous run.

Windows application and Windows service configurations are saved separately.

Analyzer default settings
--mc-url=localhost:50080
--log=info
--locale=<system settings>