Skip to main content

Bot Logs

The Bot Logs page is your primary tool for observing and debugging your bot's behaviour. It provides a detailed record of every flow that is triggered, showing you exactly what happened, in what order, and whether any errors occurred.

Each row in the logs table represents a single "flow iteration" or a complete execution of one of your bot's flows, from the trigger to the end.

The Logs Table​

The main feature of this page is a real-time table of log entries with the following columns:

  • Status: A quick visual indicator of the outcome of the flow. A green checkmark means the flow completed successfully, while a red 'X' indicates that at least one error occurred during execution.
  • Started At: The exact date and time when the flow was triggered.
  • Ended At: The time when the flow finished. If the flow is still running, this will show as "In Progress".
  • Page: The name of the page that contains the flow that was executed. This is a clickable link that will take you directly to the editor for that page and version, allowing you to quickly inspect the relevant flow.
  • Version: The version number of the bot that was running when the flow was executed.
  • Actions: This provides a "View" action that opens a detailed view of all the individual log entries for that specific flow iteration.

Detailed Log View​

When you click "View" on a log row, you are presented with a detailed, step-by-step breakdown of that flow's execution. This view shows:

  • Each module that was executed, in order.
  • Log messages which show whether a module executed successfully or not.
  • Any error messages that were generated.

This granular view is invaluable for debugging complex flows and understanding why your bot behaved in a certain way.

Real-time Updates and Filtering​

  • Real-time Logs: The logs table updates in real-time as your bot operates. You can click the Live button above the table to freeze the stream and examine the current set of logs without interruption.
  • Filtering: You can filter the logs by Status, Page, and Version to narrow down the entries and find the specific information you're looking for. This is especially useful for isolating errors or focusing on the activity of a particular flow.