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

# Logs

> Analyze and debug your agents’ executions through Devic’s technical logs and event timeline.

# Log Analysis and Execution Traceability

Devic incorporates a complete **logging and traceability** system that allows you to inspect the internal behavior of agents during each execution.\
Through the logs, you can follow step by step the actions performed, the tools used, the messages exchanged with the model, and the state of each task.

This module facilitates **debugging, auditing, and continuous optimization** of agent performance, providing full visibility into every process.

***

## Accessing Logs

From the agent’s execution history, each entry includes options to **inspect its technical log**.\
When selected, the **Thread Log** panel opens, showing in real time all events generated during the execution.

<img src="https://mintcdn.com/devic/YOievnawCrUEt20I/open-console-logs-agent.png?fit=max&auto=format&n=YOievnawCrUEt20I&q=85&s=1c42ef4d6b0177c3793fe0021c7b101a" alt="Main logs panel" width="1915" height="983" data-path="open-console-logs-agent.png" />

##

<img src="https://mintcdn.com/devic/YOievnawCrUEt20I/logs-console.png?fit=max&auto=format&n=YOievnawCrUEt20I&q=85&s=a5dd4188c07b7832f5342924a753fd3c" alt="Main logs panel" width="1915" height="983" data-path="logs-console.png" />

The logs panel is divided into three information levels:

| Level            | Description                                                                     |
| ---------------- | ------------------------------------------------------------------------------- |
| **LOG / INFO**   | Informational messages about the execution process.                             |
| **DEBUG**        | Low-level details about tool calls, internal steps, and intermediate variables. |
| **WARN / ERROR** | Incidents or errors detected during the process.                                |

***

## Thread Log

The **Thread Log** records in a structured way the technical conversation between the agent, the tools, and the model.\
Each event is documented with its type, execution timestamp, and content.

<img src="https://mintcdn.com/devic/aFJXBWtVjE-Hvyi0/thread-logs-access.png?fit=max&auto=format&n=aFJXBWtVjE-Hvyi0&q=85&s=9d9d726c785787b9284d33ada8db7d37" alt="Thread Log view with events" width="1915" height="983" data-path="thread-logs-access.png" />

##

<img src="https://mintcdn.com/devic/aFJXBWtVjE-Hvyi0/thread-logs.png?fit=max&auto=format&n=aFJXBWtVjE-Hvyi0&q=85&s=0f3517e9667436a04e9e3f7e51a4ab3e" alt="Thread Log view with events" width="1915" height="983" data-path="thread-logs.png" />

Among the available information:

* **Tool calls** and the arguments used.
* **Model responses (LLM Response)**.
* **Internal system messages** (start, planning, completion).
* **Task states** and completed steps.

***

## Message Details

Selecting a specific event opens the **Assistant Message Details** panel, where the tools called by the agent are displayed, along with their payload and the generated response.

<img src="https://mintcdn.com/devic/aFJXBWtVjE-Hvyi0/tool-message-detail.png?fit=max&auto=format&n=aFJXBWtVjE-Hvyi0&q=85&s=0bc9cb809dd7e47d732b7870f9d4d986" alt="Tool call detail" width="1915" height="983" data-path="tool-message-detail.png" />

This view allows you to precisely verify which instruction the agent executed, what data it processed, and how each tool responded.\
It is especially useful for **auditing complex workflows or debugging unexpected behaviors**.

***

## Event Timeline

The **Thread Events Timeline** offers a visual and sequential representation of the agent’s entire execution, showing how user actions, the model, and tools interact.

<img src="https://mintcdn.com/devic/YOievnawCrUEt20I/flow-view-access.png?fit=max&auto=format&n=YOievnawCrUEt20I&q=85&s=de9659c469271026e4a576a089704139" alt="Event timeline visualization" width="1915" height="983" data-path="flow-view-access.png" />

##

<img src="https://mintcdn.com/devic/aFJXBWtVjE-Hvyi0/timeline-logs.png?fit=max&auto=format&n=aFJXBWtVjE-Hvyi0&q=85&s=13ca0bad5dc29157a9da486b7861fcbc" alt="Event timeline visualization" width="1915" height="983" data-path="timeline-logs.png" />

Each block in the timeline represents a step in the workflow:

| Element              | Description                                                         |
| -------------------- | ------------------------------------------------------------------- |
| **User**             | Initial message or instruction sent to the agent.                   |
| **Planning**         | Internal planning stage before executing actions.                   |
| **Tool Call**        | Execution of a tool (e.g., RAG query, task update, PDF generation). |
| **Tool Response**    | Result returned by the tool.                                        |
| **Finish Execution** | Closing stage where the agent completes the task.                   |

***

## Export and External Analysis

Logs can be **exported** for analysis in external tools or integrated into corporate auditing and observability systems.\
This ensures **complete traceability** of the agents and reinforces operational control in production environments.

***

<Note>
  Devic’s logging system not only provides technical visibility but also serves as an essential tool for continuous improvement and validation of agent behavior.
</Note>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Human in the Loop" icon="user-check" href="/devic/agents/continuous-optimization/human-in-the-loop">
    Discover how to integrate human validation into your agents’ flow to approve, correct, or enrich decisions before final execution.
  </Card>

  <Card title="Tasks" icon="list-check" href="/devic/agents/continuous-optimization/tasks">
    Manage tasks generated by the agents, monitor their status, and control their progress within each execution.
  </Card>

  <Card title="Automatic Evaluations" icon="check-circle" href="/devic/agents/continuous-optimization/evaluations">
    Configure metrics and automatic evaluations to measure the performance, accuracy, and consistency of your agents.
  </Card>

  <Card title="Costs" icon="coins" href="/devic/agents/continuous-optimization/costs">
    Monitor token consumption, analyze execution costs, and optimize the use of models and resources.
  </Card>
</CardGroup>
