> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Frame>
  <img class="image-center" src="https://mintcdn.com/cognigy-15abf2ba/hl8vBbbOP4fUBVwj/_assets/ai/test/logs.png?fit=max&auto=format&n=hl8vBbbOP4fUBVwj&q=85&s=8f6232458478ec3e300ddc146827efb2" alt="Cognigy.AI Logs page showing input and output message records" style={{ width: 'auto' }} width="1896" height="928" data-path="_assets/ai/test/logs.png" />
</Frame>

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](/help/get-help). Alternatively, use the [GET Log Entries](/api-reference/logs/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: <ul><li>`info` — contains general information about the normal operation of a Flow.</li><li>`error` — contains information about errors that occur during Flow execution.</li><li>`debug` — contains detailed information about Flow execution for debugging purposes.</li></ul> |
| `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

<Tabs>
  <Tab title="GUI">
    <Note>
      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.
    </Note>

    In **Test > Logs**, you can view and filter Project logs as well as search them by user ID and Flow name.

    **Settings**

    To 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.             |
  </Tab>

  <Tab title="API">
    You can view the logs of a Project with the [Cognigy.AI API](https://api-trial.cognigy.ai/openapi#tag--Logs-v2.0).
  </Tab>
</Tabs>

### Write Logs

Use a [Code Node](/ai/for-developers/code/overview) to write logs with [api.log](/ai/for-developers/code/api-functions#api-log):

```javascript theme={null}
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](#view-logs).