> 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/add-tracer.md).

# Add Tracer

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Tracer** in the upper-right corner of the [Tracer overview](https://docs.enginsight.com/docs/manual/english/platform-usage/hosts/tracer/tracers.md#tracers-overview) to create a new Tracer for Machine Learning (ML)-based time series analysis on the assigned hosts. The **Hosts** → **Tracers** → **Add** view opens.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FIbvS6zE1Cj9tmsL7uTuc%2Fenginsight-screenshot-hosts-tracer-tracers-add%20tracer.jpg?alt=media&amp;token=9299ee34-d9e8-4906-9eb2-14c89b174680" alt=""><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Add Tracer** after you configured all settings to create the new tracer.

<i class="fa-computer-mouse">:computer-mouse:</i> Click **Back** to return to the list overview.

{% hint style="danger" %}
**Please note**: If you leave this view without saving, all configured settings will be lost and cannot be recovered.
{% endhint %}

***

## General Settings

Here you can configure various basic settings.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2Fv3yMmst6qajb4RQVB52T%2Fenginsight-screenshot-hosts-tracer-tracers-add%20tracer-general%20settings.jpg?alt=media&amp;token=d9ff83b8-b103-42d1-904b-d05c8aa8a5ec" alt=""><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="199.8828125">Option</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td><p>Enter a meaningful name for the Tracer.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>We recommend that you name the Tracer after the metric that is to be monitored and analyzed over time.</p></div></td></tr><tr><td>Description</td><td><p>Provide a more detailed description for the Tracer.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This field is optional.</p></div></td></tr><tr><td>Field Name</td><td><p>Define the metric that is to be monitored and analyzed over time on the assigned hosts.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Please note</strong>: Only one Tracer can be created per host metric.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click in the <strong>Field Name</strong> field to expand a list of all available host metrics.</p></td></tr><tr><td>Aggregator</td><td><p>Define how the values measured for the metric are to be aggregated and shown over time.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Depending on the data type of the selected metric, not all aggregators are useful or available. Numeric fields are suitable, for example, for average or sum calculations, while text fields can usually only be used for minimum and maximum values.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click in the <strong>Aggregator</strong> field to expand a list of all available options.<br><br>The following options are available:</p><ul><li><strong>Average</strong>: The average value per measurement is shown.</li><li><strong>Minimum</strong>: The minimum value per measurement is shown.</li><li><strong>Maximum</strong>: The maximum value per measurement is shown.</li><li><strong>Sum</strong>: The sum of all measured values is shown.</li></ul></td></tr></tbody></table>

***

## Assigned References

Here you can define the hosts or groups of hosts to which the configured settings should apply.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FYR7UyXLPL5lH4nfJExPa%2FEnginsight-EN-Assigned%20References.jpg?alt=media&amp;token=cebf4535-0c6c-4404-a071-76821b8fc228" alt=""><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="199.625">Option</th><th>Description</th></tr></thead><tbody><tr><td>Hosts</td><td><p>Define the hosts to which the configured settings should apply.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Hosts</strong> field to expand a list of all available hosts, then select one or more hosts. Alternatively, use the free-text search to find hosts in the list more quickly.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Remove</strong> icon <i class="fa-circle-xmark">:circle-xmark:</i> next to an added host to remove it from the <strong>Hosts</strong> field.</p></td></tr><tr><td>Tag Logic</td><td><p>Define how many tags an assigned host must have for the settings to apply to it.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The default tag logic is <strong>All Tags are Present in the Reference</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Tag Logic</strong> field to expand a list of all available options.<br><br>The following options are available:</p><ul><li><strong>All Tags are Present in the Reference:</strong> An assigned host must have all specified tags for the settings to apply to it.</li><li><strong>At Least One of the Specified Tags is Present:</strong> An assigned host must have at least one of the specified tags for the settings to apply to it.</li></ul></td></tr><tr><td>Tags</td><td><p>Define tags for groups of hosts to which the configured settings should apply.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Tags</strong> field to expand a list of all available tags, then select one or more tags. Alternatively, use the free-text search to find tags in the list more quickly.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Click the <strong>Remove</strong> icon <i class="fa-circle-xmark">:circle-xmark:</i> next to an added tag to remove it from the <strong>Tags</strong> field.</p></td></tr></tbody></table>

### Excluded References

Here you can define which hosts or groups of hosts should be explicitly excluded from the configured settings.

{% hint style="info" %}
Defining excluded hosts is optional.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Define Exceptions** next to **Assigned Hosts** to show the options for **Excluded Hosts**.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FOwkoC0RXeV3yJg6fqoh0%2FEnginsight-EN-Excluded%20References.jpg?alt=media&amp;token=25189e42-a39b-4936-a80a-3780807e258f" alt=""><figcaption></figcaption></figure></div>

<i class="fa-gear">:gear:</i> Configure all settings as described for an assigned host.

***
