> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/command-centre-client/using-command-centre/working-with-viewers/tile-actions/event-trail-tile-actions.md).

# Event Trail Tile actions

The Event Trail tile displays, in a grid, a list of events as determined by the configuration of the tile. It can appear on an Alarm Viewer, Cardholder Viewer, Controlled Challenge Viewer and a Monitor Site Viewer.

How events load on the tile depends on whether or not the **Automatically update event list** option was enabled when the tile was configured, as follows:

<table><thead><tr><th width="262">If it...</th><th>and...</th></tr></thead><tbody><tr><td>was enabled, a loading indicator <img src="https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-4ed66686c3463e7a01920080873a2b15b7372bd2%2Feventtrail_loadingindicator.png?alt=media" alt=""> will display,</td><td>the tile will actively monitor for events.</td></tr><tr><td>was not enabled, a <img src="https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-170d2e1098c2182d3be44b7d422fb6f5bb547b55%2Feventtrail_loadeventsbutton.png?alt=media" alt=""> button will display,</td><td>a manual refresh is required.<br>The tile will not actively monitor for events and will only populate the tile with events when the button is clicked.</td></tr></tbody></table>

To view an individual event in the list, operators need either the "View Events and Alarms", "Edit Alarms" or "View Events" privilege in the division of the source of the Event.

Events are displayed in descending Occurrence Date/Time order, and the columns displayed are:

* Occurrence Time (date and time the event occurred)

  **Note:** The format in which these dates appear is determined by the regional settings of the Client PC.
* Message
* Event Type

**Note:** Columns on the Event Trail Tile can be resized and/or reordered if required. See below for further detail.

<details>

<summary>Resizing/reordering columns</summary>

It is possible to resize and/or reorder columns on any of the Administration Viewer Panels and some tiles if required, as follows:

<table><thead><tr><th width="126">To...</th><th>Steps</th></tr></thead><tbody><tr><td>reorder columns</td><td>Click on the column tile and drag it to the required position.</td></tr><tr><td>resize columns</td><td><ol><li>Hover over the column divider until the mouse pointer changes to a "double-ended arrow".<br><img src="https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-7ca7c1c062c2f40f24571968c0c20565b4351b89%2Fresize_macrocolumn.png?alt=media" alt=""></li><li>Click and hold down the mouse button.</li><li>Move the mouse in the required direction until the column is the required size.</li></ol></td></tr></tbody></table>

</details>

By clicking on a particular Event, additional details display for the Event.

![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-825f6906c3985fa01561f6a37e997b72601c79ee%2Feventtrail_operational.png?alt=media)

When the tile is viewed on an Alarm Viewer, if you select an alarm in the Navigation Panel the Event Trail tile updates so that alarm becomes highlighted and expands out the information about it.

![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-b84421d09439451288b5c1f4164fef3ed35bb975%2Feventtrailtile_expanded.png?alt=media)

When the tile is viewed on a Monitor Site Viewer, the most recent events criteria will be applied from the current date and time. For example, if the tile has been configured to show all events generated for a specific door in the last 2 hours, new events for that door should be displayed as they occur, and 'old' events drop off once the two hours has expired. When the tile is configured to display in response to an Alarm, the 'most recent events' criteria applies from the time of the Alarm. No events that have occurred since that time will be added to the display, and no events will drop off.

A maximum of 500 events can populate the Event Trail tile. In the situation where more than 500 events meet the criteria, a message displays beneath the 500th entry explaining that the display limit has been exceeded.

**Notes:**

* In a multi-server environment, for any given server where event aggregation is enabled, an operator will be able to view event history related to a remote item's alarm.

  If you are unable to view the remote event, the message *"Content is unavailable"* displays.
* If the Tile has been configured with either the "All items on a Site Plan based on the selected Alarm/Event" option or the "All items on a specific Site Plan" option, and you do not have the privilege to view the Site Plan, the message *"There is no content to display or you are not authorised to view the content"* will display on the Tile. This is independent of whether you have the privilege to view events.
* In all other cases, (i.e. where you either do not have the privilege to view events, or there are no events that meet the criteria, or it is taking more than 20 seconds to return events to the tile), the loading indicator ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-4ed66686c3463e7a01920080873a2b15b7372bd2%2Feventtrail_loadingindicator.png?alt=media) will disappear and no message will display. If the reason nothing is displayed is due to privileges, it will be because you do not have a privilege which allows you to view qualifying events in the necessary divisions.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/command-centre-client/using-command-centre/working-with-viewers/tile-actions/event-trail-tile-actions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
