Log Files
The system can produce the following types of log files during run-time:
Pico logs: Logs generated from each Pico
Debug logs: Debug logs are generated when workflows have turned on logging to file. See Log and Notification Functions.
APL logs: When some log commands are used in APL they are logged to a file, see Log and Notification Functions.
See Log Properties for more information.
To view the Log Files, go to Manage → Tools & Monitoring and then select Log Files.
Filter Dialog
Before anything is visible in the tables a selection needs to be made in the filter dialog. Click on the Get Started button to see the Filter dialog.
Field | Description |
---|---|
Pico* | This dropdown lists all available Picos/ECs from which logs can be retrieved. You must select at least one Pico to view logs, as this field cannot be left blank. It filters capture logs from both platform-level and application-level components, as they all operate within the Pico framework. As a result, applying filters like Note! For each selected Pico, a request will be sent to that Pico to list all files in a specific folder. If you select Picos in bulk, the response time might be slow depending on the network of each Pico. |
Date Range | Define a range of dates to filter log entries. If no date range is defined, all entries are displayed. The default date range is set to Today. A few predefined options are available:
If you select User-defined, enter the Start date and time and End date and time. |
Hide Empty files | Select this to remove files with a size of 0 |
File Name | Use this field to filter by file name. If you enter multiple file names or parts of names, the filter will show logs that match any of the values you enter. |
Each Pico lists log files from specific directories based on the following properties:
pico.stderr
points to the directory containing standard error logs.pico.stdout
points to the directory containing standard output logs.log4j.configurationFile
specifies the log configuration file. If not defined, it defaults to$MZ_HOME/etc/log4j2.xml
, which manages both regular and history log directories.
If multiple Picos point to the same log directories, identical files may appear across different Picos. The UI automatically filters duplicates, showing only one file with the same name and timestamp.
Debug Log File Tab
On each EC it will list files from the debug folder decided by the parameter mz.wf.debugdir
. If this parameter is not set it will list files from the debug folder inside the temporary folder decided by the parameter pico.tmpdir
.
Field | Description |
---|---|
EC | This dropdown lists all available Execution Contexts (ECs) from which debug logs can be retrieved. You must select at least one EC to view logs, as this field cannot be left blank. |
Date Range | Define a range of dates to filter log entries. If no date range is defined, all entries are displayed. The default date range is set to Today. A few predefined options are available:
If you select User-defined, enter the Start date and time and End date and time. |
Hide Empty files | Select this to remove files with a size of 0 |
APL Log File Tab
On each EC it will read the log4j configuration described here, log4j APL Logging Configurations, to list the files in the directory specified by log4j.
Field | Description |
---|---|
EC* | This dropdown lists all available Execution Contexts (ECs) from which APL logs can be retrieved. You must select at least one EC to view logs, as this field cannot be left blank. |
Date Range | Define a range of dates to filter log entries. If no date range is defined, all entries are displayed. The default date range is set to Today. A few predefined options are available:
If you select User-defined, enter the Start date and time and End date and time. |
Hide Empty files | Select this to remove files with a size of 0 |
Log Files Table
All three tabs have the same table layout.
Table Item | Description |
---|---|
Filter Button | Displays the filter dialog |
Refresh Button | Updates the file list |
Name Column | The name of the log file |
Last Modified Column | The date and time when the file was last modified |
Pico/EC Column | The Pico/EC file is present |
Size Column | Size of the log file |
Actions | Opens the Actions menubar with the option Download and Preview. |
Preview
You can view the first 10 Mb of a file, by clicking Preview in the Actions column. You can also download the log file from the Preview dialog.
Â