Skip to main content

Utilizing Workflow Result Logs

When you execute a workflow, each node's output is displayed on the console in real-time. Output lines are prefixed with [node-name] to identify which node generated them. Step boundaries are marked with cowsay-style ASCII art.

Logs can also be saved to files, but actor-IaC automatically saves all logs to an H2 database. The log database is automatically created in the current directory, requiring no user configuration. H2's AUTO_SERVER mode allows multiple terminals to execute workflows simultaneously while writing to the same database. Writing is performed via asynchronous batch processing, so it does not affect workflow execution speed.

You can query the database using the log-info command to display session lists, extract logs for specific nodes, filter by log level, and compare with past execution results. When some nodes fail, you can investigate the failure cause from the log database. The db-clear command clears the database.

This section contains the following related documents:

Output Destinations

DocumentDescription
Console OutputUnderstanding real-time console output format
Cowsay CharacterCustomizing cowsay ASCII art characters
Log File OutputSaving logs to files
Database LocationConfiguring the H2 log database location
Output MultiplexerHow output is delivered to multiple destinations

Database Operations

DocumentDescription
Multi-Process WriteHow multiple processes write to the same database
Database WriteInternal details of database writing
Database ReadQuerying the log database

Debugging and Troubleshooting

DocumentDescription
TroubleshootingCommon issues and solutions
Sub-workflow DebuggingDebugging sub-workflow execution

Log Analysis

DocumentDescription
Extract Node LogsExtracting logs for specific nodes
Compare with PastComparing with past execution results
Check Error LogsFiltering and analyzing error logs
DB Clear CommandClearing the log database