> 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/configuring-command-centre/viewer-configuration-overall-process/configuring-tiles/configuring-individual-tile-types/configuring-an-event-trail-tile.md).

# Configuring an Event Trail Tile

This tile displays a list of the most recent Events for use in a Monitor Site scenario or when viewing a specific Alarm or Cardholder.

The Event Trail tile can be added to any Viewer and configured to show the most recent events for:

* the selected Cardholder (to be used on the Cardholder Viewer),
* the Cardholder associated with the selected Event,
* the source of the Event,
* the Cardholder related to the Event and/or Source of the Event, as determined by the system based on the following:
  * if the Event has a related Cardholder, the tile will show events for the Cardholder (by default), with the ability for the user to choose in Operation, to view events for the Event Source. A 'Door Open Too Long' event is considered to have a related Cardholder, in the form of the Last Cardholder through the door
  * if the Event does NOT have a related Cardholder, the tile will show events for the Event Source,
* a selected Site Item, which should be selected using the *Browse Tool\**,

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>*Browse Tool</strong></p><p>A mechanism for quickly finding and selecting one or more items. It presents only the relevant data/options based on where the user selects the tool from.</p></div>
* if the Event Trail Tile is on a Monitor Site Viewer, specific Divisions,
* if the Event Trail Tile is on a Monitor Site Viewer, results can be also filtered by one or more Specific Event Types, or
* the Site. This will show the most recent events the Operator is able to see.

**Notes:**

* If Event Aggregation is **not** enabled and the Event Trail tile is being viewed for an Alarm where the Event Source is a remote item, only events occurring while the tile is 'open' will display. If the Operator switches to a different Alarm and back again the Events displayed may be different as any remote Events generated while the tile was last viewed will be lost.
* If Event Aggregation is **not** enabled and the Event Trail tile has been configured for all Events, when the tile is first displayed only local Events will display. For the period during which the tile is displayed any events occurring remotely will display. If the Operator switches to another Viewer any remote Events received since the tile was first displayed will remain (as the tile is still considered to be 'open'), but if they switch to a different Panel on the same Viewer they will be lost.
* If Event Aggregation is **not** enabled, any events generated for the Cardholder on a remote server while the Event Trail tile is 'open' will be included, but any while the tile is not 'open' will not be included, in which case the Events displayed will not be complete.

### How to configure

1. Double-click on **Event Trail** on the 'Tile Toolbox'.

   The Event Trail Tile appears on the Configuration Panel section of the screen in preview mode with columns for Occurrence Time, Message and Event Type. The data content displayed is 'dummy data' to give you an idea of what it will look like in Operational mode.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-4231f79bdf2e4c9705728523414edb7e7b93ddae%2Feventtrailtile_previewmode.png?alt=media)
2. Move the mouse over the Event Trail Tile you have added, and click on the **Click to configure** button that appears.

   The Event Trail Tile Configuration pop-up displays.

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

   **Note:** This is how the Configuration pop-up looks when you are adding an Event Trail tile to an Alarm Viewer, Controlled Challenge Viewer or a Spot Monitor Viewer. If you are adding this tile to a Cardholder Viewer, Monitor Site Viewer or an Intercom Viewer, not all the Event Source options will be available.

   If you have added the Event Trail Tile to a Monitor Site Viewer, an enhanced Event Trail Tile Configuration pop-up displays.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-4d634c3971083c2fde1933c4261e9657a4466800%2Fenhancedeventtrailtileconfiguration_popup.png?alt=media)
3. Enter an appropriate **Title** for this Tile.
4. Uncheck the **Show Tile Header** checkbox if you want the tile header to be removed in operational mode.

   **Note:** While this feature maximises the available screen real estate, be aware that Tile maximise/minimise can only be achieved using hot keys < **Ctrl** + **M** >.
5. In the **Prior Events** section, the most recent events to show can be determined either by:

   * last \<number> events (the default = 20), OR
   * events generated in last \<number> minutes/hours/days/weeks.

   Enter a value in the **Show** field, and select the required criteria from the drop-down list.
6. Uncheck the **Automatically update event list** checkbox if you do not want events to display automatically on the Event Trail tile, (i.e. events will only populate the tile once the **Load Events** button is clicked).
7. Click the appropriate radio button for the **Event Source** you require.

   What event source did you select?

   <table><thead><tr><th width="427">If...</th><th>then...</th></tr></thead><tbody><tr><td><ul><li>Based on selected item plus Cardholder,</li><li>Based on the selected item only,</li><li>All events, or</li><li>All items on a Site Plan based on the selected Alarm/Event,</li></ul></td><td>go to Step 9.</td></tr><tr><td><ul><li>All items on a specifc Site Plan,</li></ul></td><td>you must select a Site Plan. Go to Step 8.</td></tr><tr><td><ul><li>Specific Divisions,</li></ul></td><td>you must select a specific Division. Go to Step 9.</td></tr><tr><td><ul><li>Specific Event Sources,</li></ul></td><td>you must select at least one specific item. Go to Step 10.</td></tr></tbody></table>
8. Select the specific Site Plan as follows:
   1. Click the **Select Site Plan** button.\
      A browse tool displays.\ <img src="https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-f07d360b8d43f2bf955db6736b90889b17699241%2Fselectsiteplanpopup.png?alt=media" alt="" data-size="original">
   2. Check the Site Plan you want to use.
   3. Click the **OK** button.\
      The pop-up closes and each of the Select Site Plan button changes to the name of the Site Plan you selected.
9. If your Event Trail Tile is on a Monitor Site Viewer, select specific Division(s) as follows:
   1. Click the **Add Divisions** button.\
      A browse tool displays.\
      ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-f93002f77fd6b6735d3dc5457d4b92a761d0e14e%2Feventtrailtile_selectdivisions.png?alt=media)
   2. Check the Division(s) you want to use.
   3. Click the **Add Selection** button.\
      The pop-up closes and the Name(s) of all divisions selected are displayed.
10. Select specific item(s) as follows:
    1. Click the **Add Items** button.\
       A browse tool displays.\
       ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-cc01ee50dace5e761c37c7cd44a2439cde4af159%2Fselectspecificsource_popup2.png?alt=media)
    2. Search for the item(s) you want to add to this tile by entering search criteria in the **Search** field and/or refining the filters.\
       The grid becomes populated with items that match the search criteria.
    3. Click the checkbox next to each item name you want to include, or click the **Select All** button if you want to include all items.
    4. Click the **Add Selection** button.\
       The pop-up closes and each of the item(s) that was selected individually appears beneath the button, with a check box to the left of it's name ticked. An item can be excluded from the Event Trail tile by unchecking the box.
11. Is your Event Trial Tile on a Monitor Site Viewer?

    <table><thead><tr><th width="279">If...</th><th>then...</th></tr></thead><tbody><tr><td>no, OR you do not want to configure filters,</td><td>click the <strong>Close</strong> button.</td></tr><tr><td>yes,</td><td>a <strong>Filter</strong> column will appear to the right of the pop-up.</td></tr></tbody></table>
12. Select Specific Filter(s) as follows:

    <table><thead><tr><th width="279">If...</th><th>then...</th></tr></thead><tbody><tr><td>All Event Types,</td><td>all event types will be displayed. Go to Step 14.</td></tr><tr><td>Specific Event Types,</td><td>you must select at least one specific event type. Go to Step 13.</td></tr></tbody></table>
13. Select Specific event type(s) as follows:
    1. Click the **Add Event Types** button.\
       A browse tool displays.\
       ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-b60499138a00c569d07eee12b3d6c184d7f69fef%2Feventtrailtile_selecteventtypes.png?alt=media)
    2. Search for the event types(s) you want to add to this tile by entering search criteria in the Search field and/or refining the filters.\
       The grid becomes populated with event types that match the search criteria.
    3. Click the checkbox next to each item name you want to include, or click the **Select All** button if you want to include all event types.
    4. Click **OK**.\
       The pop-up closes and each of the event type(s) selected individually appears beneath the button, with a check box to the left of its name ticked. An event type can be excluded from the Event Trail tile by unchecking the box.
14. Click the **Close** button.

    The preview mode of the Event Trail Tile now displays the title given, and still displays 'dummy data'.


---

# 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/configuring-command-centre/viewer-configuration-overall-process/configuring-tiles/configuring-individual-tile-types/configuring-an-event-trail-tile.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.
