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

# Events Page

The organization-wide log of everything your Actions have triggered, and the place where open incidents are tracked.

The **Events** page (sidebar → **Events**) collects every event generated across your organization. An event is written whenever an [Action](https://docs.widgelix.com/actions-formerly-rule-engine/introduction.md) fires and its notification is sent. Actions that use an [Escalation Chain](https://docs.widgelix.com/actions-formerly-rule-engine/escalation-chain.md) also open an **incident**, which stays on the page until someone resolves it.

{% hint style="info" %}
The number badge next to **Events** in the sidebar is the number of currently **open incidents**. It matches the counter on the **Active** tab.
{% endhint %}

## Page layout

![Events page: Active tab with an incident expanded to show its escalation timeline](https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2F9Hq2uSAjaYjCs69ypU63%2Fevents-active.png?alt=media\&token=da47efd2-7250-4879-b3d1-fdd547209add)

The page has three tabs:

| Tab                  | What it shows                                                                                     |
| -------------------- | ------------------------------------------------------------------------------------------------- |
| **Active** (count)   | Open incidents that still need attention: not yet resolved, whether or not they are acknowledged. |
| **All events**       | The complete log of events for the selected period, including those without escalation.           |
| **Resolved** (count) | Incidents that have been closed, manually or automatically.                                       |

Incident handling on the **Active** and **Resolved** tabs is described in [Incidents & Escalation](https://docs.widgelix.com/events/incidents-and-escalation.md).

## Time period

Use the period selector above the list to choose the time window:

* **1h**, **24h**, **7d**, **30d**: a rolling window ending now.
* **Custom**: pick a start and end date in the date-range picker.

The period applies to the list, the counters and the report export.

## Filters

Click **Filters** to narrow the list.

![Filters panel](https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FD77wOdZZxJ6dxfamp4Po%2Fevents-filters.png?alt=media\&token=128eb722-9d5c-40ef-a616-3bd90b5da54a)

| Filter         | Description                                                                        |
| -------------- | ---------------------------------------------------------------------------------- |
| **Asset**      | Show only events from one or more selected assets.                                 |
| **Tag name**   | Show events from assets that have a given tag (“Has tag…”).                        |
| **Tag value**  | Match a tag and its value, in the form `name: value`.                              |
| **Event type** | **Info**, **Warning** or **Critical**, i.e. the severity configured in the Action. |

You can combine filters. They stay applied while you switch between tabs. Clear a filter to return to the full list.

## All events

![All events tab with one event expanded](https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FfsFQDlFmAczFXW4K3cDl%2Fevents-all.png?alt=media\&token=d45fa9cf-36ff-4007-a49c-62a2f2d600f4)

Each row in **All events** shows:

| Column            | Description                                                                                                 |
| ----------------- | ----------------------------------------------------------------------------------------------------------- |
| **Message**       | The event message generated by the Action (with placeholders already filled in, e.g. asset name and value). |
| **Time Stamp**    | When the event was created.                                                                                 |
| **Type**          | Severity: Info, Warning or Critical.                                                                        |
| **Notifications** | Which channels were used (icon per channel) and how many notifications were sent, e.g. “2 sent”.            |

Click a row to expand it. The expanded view shows the **DEFAULT** event message plus the exact message that was delivered through each notification channel (for example **Slack**). This is the quickest way to check what a recipient actually received.

## Exporting a report

Click **Get report** in the page header to download the events that match the current tab, period and filters. Set the filters first, then export, to get exactly the slice you need (for example, all Critical events of one site over the last 7 days).

## Events on the asset page

Each asset also has its own **Events** tab that shows only that asset’s events. See [Asset Page](https://docs.widgelix.com/assets/asset-page.md).

## Permissions

Access to the page is controlled by the **Events** menu item and the **Events** module permission (Read to view, Delete to remove events). The built-in **Viewer** role has no Events access by default. See [Roles & Permissions](https://docs.widgelix.com/roles-and-permissions/user-guide.md).
