Logs

Logs are system records that contain information about input and output messages that AI Agents receive and send. The primary purpose of the logs is to debug workflows by observing if and where errors are occurring.

Cognigy.AI Logs page showing input and output message records

You can track logs in real time or load the log history to review outputs that occurred in the past.

Limitations

Log entries on the Logs page are retained for up to 24 hours. By default, the Logs page displays the logs of the last 2 hours. To change this value, contact Cognigy technical support. Alternatively, use the GET Log Entries API method to view all retained logs.

Log entries

The following table provides an overview of the log entries.

Field	Description
`timestamp`	The date and time of the log entry. The format is `YYYY-MM-DD HH:MM:SS`.
`log type`	One of the following log levels: `info` — contains general information about the normal operation of a Flow. `error` — contains information about errors that occur during Flow execution. `debug` — contains detailed information about Flow execution for debugging purposes.
`message`	Describes the event of the log entry.
`metadata`	Additional data associated with the log entry, for example, `organisationID`, `flowID`, `text`, and other.

Working with Logs

View Logs

To improve browser performance, the log list uses virtualization. This means your browser loads only the log entries visible on your screen at any given time. As a result, you can’t copy more lines than what’s currently visible.

In Test > Logs, you can view and filter Project logs as well as search them by user ID and Flow name.SettingsTo configure the log entries displayed in the log list, use the following settings:

Setting Name	Function
Live Logging	Activates real-time log updates. This setting is activated by default.
Show Timestamp	Includes the timestamp of the log entries. This setting is activated by default.
Show Additional Metadata	Includes metadata related to input and output messages. This setting is activated by default.
Info	Includes log entries of the `info` type. This setting is activated by default.
Error	Includes log entries of the `error` type. This setting is activated by default.
Debug	Includes log entries of the `debug` type. This setting is deactivated by default.

Write Logs

Use a Code Node to write logs with api.log:

api.log("info", "This is an informational log message.");
api.log("error", "An error occurred during execution.");
api.log("debug", "Detailed debug information.");

The recorded logs are available on the Logs page and via API.

Overview

AI Agents

Human Escalation

Platform Features

For Developers

Administration and Installation

Limitations

Log entries

Working with Logs

View Logs

Write Logs

​Limitations

​Log entries

​Working with Logs

​View Logs

​Write Logs

Limitations

Log entries

Working with Logs

View Logs

Write Logs