> For the complete documentation index, see [llms.txt](https://imbrace.gitbook.io/imbrace-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://imbrace.gitbook.io/imbrace-documentation/governance/conversation-logs.md).

# Conversation Logs

Conversation Logs (AI Tracing) lets you review how AI agents processed individual conversations. Use it for troubleshooting, quality checks, and understanding why an AI agent responded in a particular way.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2Fik8N7G0wZCKpLhW6OWvL%2Fimage.png?alt=media&amp;token=d04fcac2-6fa7-4854-8557-8cb196847fab" alt=""><figcaption></figcaption></figure>

Logs can be browsed in two ways:

* **By Session:** Review the trace for a single chat session.
* **By Agent:** Review sessions handled by a specific AI Agent within a date range.

### **Viewing Logs by Session**

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2Fco2UvcsHNTDqCvz6VneT%2Fimage.png?alt=media&amp;token=5d3b2ee7-9dcf-46f1-b3d5-46769212dd27" alt=""><figcaption></figcaption></figure>

1. Click the **Conversation Logs (AI Tracing)** tab.
2. Click **By Session**.
3. Click the **Chat Session** drop-down and select a session.&#x20;

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2Fsra0020ZMsoxuvHLAhfq%2Fimage.png?alt=media&amp;token=3c07277b-2feb-43a3-a019-dc88eba56903" alt=""><figcaption></figcaption></figure>

4. Once a trace is loaded, the page displays summary cards, aggregate performance metrics and a list of AI Agent responses.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2Fg2YMf4mc7jdpdDcd4css%2Fimage.png?alt=media&amp;token=c4e427e1-06e1-48aa-a574-b3f10e5a044f" alt=""><figcaption></figcaption></figure>

5. Click **REFRESH** to load the trace again for the selected session.

> **Note:** The **REFRESH** button is only available after a chat session is selected.

### **Viewing Logs by Agent**

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FI2F2rrr9wFeJtxymrwkm%2Fimage.png?alt=media&amp;token=dcf20d9a-9294-4e12-b29f-dd04585ed950" alt=""><figcaption></figcaption></figure>

1. Click the **Conversation Logs (AI Tracing)** tab.
2. Click **By Agent**.
3. Click the **Use Case (Agent)** drop-down and select an AI Agent. To find an AI Agent quickly, enter its name in the **Search** field within the drop-down. Once results are loaded, the page displays summary cards, latency metrics and tool performance for the selected AI Agent.

<figure><img src="https://3400071099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FypCKq44Psaly6khgrY7x%2Fuploads%2FycaKTUg9MePYyWeikgaJ%2Fimage.png?alt=media&amp;token=7e9fca48-8926-4482-8db6-4ca88a79863b" alt=""><figcaption></figcaption></figure>

4. To search for a specific response of AI agent in a certain time period, add the dates in **From** & **To** field and search. Click **APPLY** to load the logs.

> **Tip:** Use **By Agent** when investigating an issue reported for a specific AI Agent, then narrow the date range to the period when the issue occurred.
