> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tracer/tracers.md).

# Tracers

A Tracer for Machine Learning (ML)-based time series analysis defines the metric that is monitored and analyzed over time on assigned hosts. This way, deviations from the normal value that may indicate a potential attack can be automatically detected. Tracers are used to train the [ML models](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tracer/models.md) for monitoring the assigned hosts.

***

<i class="fa-compass">:compass:</i> Navigate to **Hosts** → **Tracer** → **Tracers** to show a list of all Tracers. If you have not created a Tracer yet, this view is empty.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FFs8C7ZNowPyXArBaWPx6%2Fenginsight-screenshot-hosts-tracer-tracers.jpg?alt=media&amp;token=effe9ade-8423-4d1d-bf48-36e6887ac8be" alt=""><figcaption></figcaption></figure>

The [Tracer overview](#tracers-overview) provides information such as:

* which hosts or groups of hosts the Tracer was created to monitor.
* which metric is monitored and analyzed over time with the Tracer.

You can also [add new Tracers](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tracer/tracers/add-tracer.md).

***

## Navigation

<i class="fa-magnifying-glass">:magnifying-glass:</i> Click the **Text Search** field above the list and enter a search term of your choice to find specific list items more quickly.

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Refresh** icon <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i> above the list to update all list items.

<i class="fa-computer-mouse-scrollwheel">:computer-mouse-scrollwheel:</i> Scroll down the list or adjust the number of results shown per page ![](https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FfjKACCt2SKXcFd3S7Xb5%2FEnginsight-EN-Results%20per%20Page.jpg?alt=media\&token=e1650160-7a41-4965-aaca-6975db758dbe) to view additional entries. Use the page navigation ![](https://content.gitbook.com/content/V7OrHgKXA0t1jankQBYf/blobs/wnxVw06QGoSsYjhwMJRF/Enginsight-Seitennavigation-2.jpg) to switch between pages.&#x20;

### Filtering the List

<details>

<summary>Available filters</summary>

<table><thead><tr><th width="206.60546875">Parameter</th><th width="116.515625">Type</th><th>Description</th></tr></thead><tbody><tr><td>Field Name</td><td>String</td><td>Filter by a specific metric that is to be monitored and analyzed over time, or exclude it from the results. All available metrics are shown.</td></tr><tr><td>Assigned References</td><td>String</td><td>Filter by a specific host that is to be monitored, or exclude it from the results. All available hosts are shown.</td></tr><tr><td>Assigned Tags</td><td>String</td><td>Filter by a specific tag for a host group that is to be monitored, or exclude it from the results. All available tags are shown.</td></tr></tbody></table>

</details>

### Sorting List Items

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Sort** icon <i class="fa-sort">:sort:</i> next to a column name in the table header to sort by that column in ascending <i class="fa-angle-up">:angle-up:</i> or descending order <i class="fa-chevron-down">:chevron-down:</i> .

<i class="fa-computer-mouse">:computer-mouse:</i> Click the sort icon <i class="fa-bars-sort">:bars-sort:</i> above the list to adjust the priority of the applied sorting. A menu opens that shows all columns by which the list is currently sorted. Drag and drop the shown items to change the sorting priority.

### Further Actions for List Items

You can find additional actions for list items at the end of the row of each list item:

<table><thead><tr><th width="200.23046875">Action</th><th>Description</th></tr></thead><tbody><tr><td>Edit</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Edit</strong> icon <i class="fa-pencil">:pencil:</i> to open the <a href="#tracer-edit-view">edit view</a> of the respective Tracer.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Please note</strong>: The metric defined in the Tracer is used to train the ML models for the assigned hosts. For this reason, once a Tracer has been created, you can only change its display name and the assigned hosts or groups of hosts. If you want to monitor a different metric, you must add a new Tracer.</p></div></td></tr><tr><td>Delete</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Delete</strong> icon <i class="fa-trash">:trash:</i> and confirm the message that appears to remove the Tracer.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note</strong>: Deleted Tracers cannot be recovered.</p></div></td></tr></tbody></table>

***

## Tracers: Overview

The Tracer overview is structured as a table.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FMBLRud3jUqu4ZGsTXWxx%2Fenginsight-screenshot-hosts-tracer-tracers%20overview.jpg?alt=media&amp;token=861db88f-7428-4c14-b4b9-54d0488df285" alt=""><figcaption></figcaption></figure>

The following information is shown:

<table><thead><tr><th width="200.23828125">Column</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td><p>Shows the custom name of the tracer as well as an additional description, if provided.</p><p></p><p>The date and time of creation and last edit are also shown.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a Tracer to navigate to the respective <a href="#tracer-edit-view">edit view</a>. Here you can adjust configured settings and delete the Tracer.</p></td></tr><tr><td>Assigned References</td><td>Shows the names of the hosts that are monitored with the Tracer or that are excluded from monitoring, or the tags that refer to the corresponding host groups.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a host to navigate to the respective <a href="https://docs.enginsight.com/docs/manual/english/platform-usage/host-detail-view.md">host detail view</a>.</td></tr><tr><td>Field Name</td><td>Shows the name of the metric that is monitored and analyzed over time with the Tracer.</td></tr></tbody></table>

***

## Adding a Tracer

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Tracer** in the upper-right corner to [create a new Tracer](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tracer/tracers/add-tracer.md).

***

## Tracer: Edit View

<i class="fa-computer-mouse">:computer-mouse:</i> Click the name of a tracer to navigate to the respective edit view. Here you can adjust [configured settings](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tracer/tracers/add-tracer.md#general-settings) and delete the Tracer.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FYkz4M9RlvmxiCHt08tK6%2Fenginsight-hosts-tracer-tracers-edit%20view.jpg?alt=media&amp;token=0ebecacd-c92c-4a8a-b0e6-dbe8eb475c80" alt=""><figcaption></figcaption></figure>

The following actions are available:

<table><thead><tr><th width="200.39453125">Option</th><th>Description</th></tr></thead><tbody><tr><td>Save Changes</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Click <strong>Save Changes</strong> after adjusting any settings.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note:</strong> Unsaved changes cannot be recovered.</p></div></td></tr><tr><td>Back</td><td><i class="fa-computer-mouse">:computer-mouse:</i> Click <strong>Back</strong> to return to the list overview.</td></tr><tr><td>Remove</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Click <strong>Remove</strong>, then confirm the prompt that appears to delete the object that you are editing.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Please note:</strong> Deleted objects cannot be recovered.</p></div></td></tr></tbody></table>

***
