> ## Documentation Index
> Fetch the complete documentation index at: https://botpress-charmenta-pr-700.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Inspect behaviour

You can inspect your agent's behaviour in the **<Icon icon="bug" /> Inspect** section of your agent's menu. Here's a breakdown of each sub-section:

## Logs

You can view logs from all your agent's conversations in the **Logs** sub-section. This includes system logs that provide updates on your agent's status, as well as logs from any integrations you have installed:

<Frame>
  <img alt="Logs" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-700/XNznUPy3bUw8oLY5/get-started/manage-your-agent/assets/logs.png?fit=max&auto=format&n=XNznUPy3bUw8oLY5&q=85&s=054c1a9ec3da9db1e5527973bef7c69e" width="2476" height="904" data-path="get-started/manage-your-agent/assets/logs.png" />

  <img alt="Logs" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-700/XNznUPy3bUw8oLY5/get-started/manage-your-agent/assets/logs-dark.png?fit=max&auto=format&n=XNznUPy3bUw8oLY5&q=85&s=4058a5e6395b1bed7013718c241f30ad" width="2476" height="904" data-path="get-started/manage-your-agent/assets/logs-dark.png" />
</Frame>

You can filter logs by date and time to narrow down your search for a specific event or conversation.

### Custom logs

You can add custom logs when [writing code in Studio](/studio/guides/advanced/use-code)—just use JavaScript's `console.log`:

```js theme={null}
console.log('An error occured.')
```

Once you’ve published your changes, your bot will print that statement to its logs every time the code executes.

***

## Events

Events represent what happens within your bot, such as messages from users and system-level occurrences. You can view all incoming events processed by your agent in the **Events** section:

<Frame>
  <img alt="Events" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-700/XNznUPy3bUw8oLY5/get-started/manage-your-agent/assets/events.png?fit=max&auto=format&n=XNznUPy3bUw8oLY5&q=85&s=e67e29b2b4486ebfcc5ccd8f54cd9ddd" width="1826" height="756" data-path="get-started/manage-your-agent/assets/events.png" />

  <img alt="Events" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-700/XNznUPy3bUw8oLY5/get-started/manage-your-agent/assets/events-dark.png?fit=max&auto=format&n=XNznUPy3bUw8oLY5&q=85&s=ece37e5385d4942825c0719e2b1472a5" width="1826" height="756" data-path="get-started/manage-your-agent/assets/events-dark.png" />
</Frame>

<Accordion title="What counts as an event?">
  An event is any action that triggers bot activation. Only incoming messages & events that a bot listens to count towards your event quota.

  The following actions count as an incoming message & event:

  * A user saying "Hello" to a bot
  * A reaction being added to a message
  * A [Trigger](/studio/concepts/triggers) that opens the bot
  * A session timeout event
  * Opening the bot's shareable URL
  * Publishing your bot (counts as 3 events)

  The following actions don't count as an incoming message & event:
  ‍

  * A message sent by the bot in response to a user message
  * An execute code card
  * [Workflow](/studio/concepts/workflows) transitions
</Accordion>

### Event data

Select any event to view a detailed JSON representation of all its associated data:

<Frame>
  <img alt="Event JSON data" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-700/XNznUPy3bUw8oLY5/get-started/manage-your-agent/assets/event-json-data.png?fit=max&auto=format&n=XNznUPy3bUw8oLY5&q=85&s=2f488e51880b314abf6ae73069a4e71d" width="1746" height="618" data-path="get-started/manage-your-agent/assets/event-json-data.png" />

  <img alt="Event JSON data" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-700/XNznUPy3bUw8oLY5/get-started/manage-your-agent/assets/event-json-data-dark.png?fit=max&auto=format&n=XNznUPy3bUw8oLY5&q=85&s=bad0503365a54bdfd32e47e6f40f2a3e" width="1746" height="618" data-path="get-started/manage-your-agent/assets/event-json-data-dark.png" />
</Frame>

### Quota

Incoming events count towards your plan's Incoming Messages & Events quota. If you need to increase this quota, go to the [Billing](/get-started/configure-your-workspace/#billing) section.

***

## Files

You can view all files uploaded to your agent in the **Files** section. This includes:

* [Files uploaded by users](/webchat/get-started/configure-your-webchat#features)
* Files indexed as part of a [Knowledge Base](/get-started/manage-your-agent/knowledge#knowledge-bases)
* System files
* Files you've uploaded yourself using the [Files API](/api-reference/files-api/getting-started)

### Inspect file data

Select any file to view a detailed JSON representation of all its associated data:

<Frame>
  <img alt="File JSON data" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-700/XNznUPy3bUw8oLY5/get-started/manage-your-agent/assets/file-json-data.png?fit=max&auto=format&n=XNznUPy3bUw8oLY5&q=85&s=4d11357960c2f17819c600788944a6a8" width="3066" height="824" data-path="get-started/manage-your-agent/assets/file-json-data.png" />

  <img alt="File JSON data" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-700/XNznUPy3bUw8oLY5/get-started/manage-your-agent/assets/file-json-data-dark.png?fit=max&auto=format&n=XNznUPy3bUw8oLY5&q=85&s=89a6c289d5e4bc4e8b6bb49087b68b9f" width="3066" height="824" data-path="get-started/manage-your-agent/assets/file-json-data-dark.png" />
</Frame>

### View a file

To view a file, select it and open its URL.

### Download a file

To download a file, select <Icon icon="ellipsis-vertical" /> to open additional options, then <Icon icon="download" /> **Download**.

### Delete a file

To delete a file,  select <Icon icon="ellipsis-vertical" /> to open additional options, then <Icon icon="trash-2" /> **Delete**.

### Quota

Any files you store count against your File Storage quota. You can increase your quota in your dashboard's [Billing](/get-started/configure-your-workspace#billing) menu.

***

## Issues

You can view any problems or errors your agent encountered in the **Issues** sub-section:

<Frame>
  <img alt="Issues" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-700/XNznUPy3bUw8oLY5/get-started/manage-your-agent/assets/issues.png?fit=max&auto=format&n=XNznUPy3bUw8oLY5&q=85&s=2c82ed8967bb6cbc4e4a21213e6653c1" width="2028" height="698" data-path="get-started/manage-your-agent/assets/issues.png" />

  <img alt="Issues" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-700/XNznUPy3bUw8oLY5/get-started/manage-your-agent/assets/issues-dark.png?fit=max&auto=format&n=XNznUPy3bUw8oLY5&q=85&s=8590f5a2a83a44bc6cc9f813ed3d9bfb" width="2028" height="698" data-path="get-started/manage-your-agent/assets/issues-dark.png" />
</Frame>

The **Category** field tells you where the issue came from, while the **Events** field tells you how many times it occurred. Select any issue to view a list of all occurrences:

<Frame>
  <img alt="Issue events" className="block dark:hidden" src="https://mintcdn.com/botpress-charmenta-pr-700/XNznUPy3bUw8oLY5/get-started/manage-your-agent/assets/issue-events.png?fit=max&auto=format&n=XNznUPy3bUw8oLY5&q=85&s=c7e0ec40ab21b26bbc34a7851ce2e49c" width="2028" height="462" data-path="get-started/manage-your-agent/assets/issue-events.png" />

  <img alt="Issue events" className="hidden dark:block" src="https://mintcdn.com/botpress-charmenta-pr-700/XNznUPy3bUw8oLY5/get-started/manage-your-agent/assets/issue-events-dark.png?fit=max&auto=format&n=XNznUPy3bUw8oLY5&q=85&s=6b7dd2d1f5f1babf2a183913667c4bae" width="2028" height="462" data-path="get-started/manage-your-agent/assets/issue-events-dark.png" />
</Frame>

This gives you detailed information about each occurrence, like:

* Its payload
* The associated user and conversation IDs
* The channel or integration on which it occurred
