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

# Activity logs

## Introduction

Activity logs provide an audit trail of events completed within your company profile. At a glance you can see who performed an action, what entity it applies to, and when it happened. From here, you can select any entry for a detailed view of what happened during the activity.

## Working with activity logs

The *Activity logs* page includes summary stats for recent activity, search and filter options, then a date-grouped activity feed. For example:

<div align="left" data-with-frame="true"><figure><img src="https://2172380191-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8IqdqwZowcxtFpZfLa6k%2Fuploads%2FftU4QkYefxAlgqK6oAp3%2Factivity%20logs%20-%20main.svg?alt=media&amp;token=70d2a846-8b04-463b-8c1f-842f54e6a51d" alt=""><figcaption></figcaption></figure></div>

These options are summarised below:

{% stepper %}
{% step %}
**Event summary stats**

When viewing activity logs, summary statistics are updated every hour. Here, you can see:

* The number of events (all categories, actions, and types) logged today.
* The number of security events logged today. This is an aggregation of token, MCP, user or role activity records (for example, creating or deleting a user).
* The number of delete events (any category logged today.
* The number of active users for your company profile logged today.
  {% endstep %}

{% step %}
**Search & filter options**

Use the search bar to list activity logs matching a given text string. When combined with filters, you can find any event details quickly and easily.

{% hint style="info" %}
Search terms are not case sensitive - for example, `count` is the same as `COUNT` or `Count`.
{% endhint %}

**Filters**

Activity log search results can be filtered by `category`, `action`, and `type`. Filter options are summarised below:

<table><thead><tr><th width="138.42578125">Filter</th><th>Option</th></tr></thead><tbody><tr><td><code>category</code></td><td>Select one or more areas of Brigge to consider - for example: <code>pipeline</code>, <code>system</code>, <code>operation</code>, etc.</td></tr><tr><td><code>action</code></td><td>Select one or more actions to consider - for example: <code>created</code>, <code>updated</code>.</td></tr><tr><td><code>type</code></td><td><p>Select one or more types to consider. Current types are:</p><ul><li><code>models</code>. Activity on core Brigge resources (e.g. <a href="/documentation/notification-groups.md">Notification groups</a>, <a href="/documentation/brigge-for-transformers/pipelines/pipeline-versions-and-deployments.md">Deployments</a>, <a href="/documentation/brigge-for-engineers/systems.md#authentication-flows">Auth flows</a>, <a href="/documentation/brigge-for-engineers/systems.md">Systems</a>).</li><li><code>MCP</code>. Calls to the Brigge MCP.</li></ul></td></tr></tbody></table>

{% hint style="info" %}
You can define a single filter, or a combination of the three.
{% endhint %}
{% endstep %}

{% step %}
**Activity feed**

The activity feed lists events (subject to search criteria and filters) chronologically. From here, you can select any to view more details. For example:

<div align="left" data-with-frame="true"><figure><img src="https://2172380191-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8IqdqwZowcxtFpZfLa6k%2Fuploads%2Fgw7RAkVheJc4ZW1lTjfr%2Factivity%20logs%20-%20example%202.png?alt=media&amp;token=6b30cd07-696f-472c-844a-87c62fbebeb9" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Event details**

Click any log entry to view details. Here you'll see before and after information for the associated entity, so you can see exactly what changed. For example:

<div align="left" data-with-frame="true"><figure><img src="https://2172380191-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8IqdqwZowcxtFpZfLa6k%2Fuploads%2FpvAmfqlLG765NxsebzN7%2Factivity%20logs%20-%20example%203.png?alt=media&amp;token=6a52a63b-50e9-4058-b973-05dc858086e2" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}
