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.
Related Documents
This section contains the following related documents:
Output Destinations
| Document | Description |
|---|---|
| Console Output | Understanding real-time console output format |
| Cowsay Character | Customizing cowsay ASCII art characters |
| Log File Output | Saving logs to files |
| Database Location | Configuring the H2 log database location |
| Output Multiplexer | How output is delivered to multiple destinations |
Database Operations
| Document | Description |
|---|---|
| Multi-Process Write | How multiple processes write to the same database |
| Database Write | Internal details of database writing |
| Database Read | Querying the log database |
Debugging and Troubleshooting
| Document | Description |
|---|---|
| Troubleshooting | Common issues and solutions |
| Sub-workflow Debugging | Debugging sub-workflow execution |
Log Analysis
| Document | Description |
|---|---|
| Extract Node Logs | Extracting logs for specific nodes |
| Compare with Past | Comparing with past execution results |
| Check Error Logs | Filtering and analyzing error logs |
| DB Clear Command | Clearing the log database |