> 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/siem/general-collectors/log-files/add-log-file-collector.md).

# Add Log File Collector

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Collector** in the upper-right corner of the [log file overview](/docs/manual/english/platform-usage/siem/general-collectors/log-files.md#log-file-collectors-overview) to create a new log file collector. The **SIEM** → **Log Files** → **Add** view opens.

<figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FVRthZv5NC0nSTKEJyENP%2Fenginsight-screenshot-siem-general%20collectors-log%20files-add%20log%20file.jpg?alt=media&amp;token=8a3133d4-f9e2-421c-aa38-c55a231756e7" alt=""><figcaption></figcaption></figure>

<i class="fa-computer-mouse">:computer-mouse:</i> After configuring all settings, click **Add Collector** to save and create the new collector.

<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%2F4pZIpowOhJ4Vp5oFLT2A%2Fenginsight-screenshot-siem-general%20collectors-log%20files-add%20log%20file-general%20settings.jpg?alt=media&amp;token=55d89bbf-814c-44a4-9d19-281cf38f6647" alt="" width="563"><figcaption></figcaption></figure></div>

The following options are available:

<table><thead><tr><th width="200.47265625">Option</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>Enter a meaningful name for the collector.</td></tr><tr><td>Description</td><td><p>Provide a more detailed description for the collector.</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>Enabled</td><td><p>Enable the collector so that it can receive raw logs and forward them to the SIEM.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This option is enabled by default.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Select or deselct the checkbox <i class="fa-square">:square:</i> next to <strong>Enabled</strong> to enable or disable the collector.</p></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.

***

## Extractors

Here you can select one or more custom [extractors](/docs/manual/english/platform-usage/siem/advanced-settings/extractors.md) that you want to use to extract specific information from the source fields of the defined log files.

{% hint style="info" %}
Specifying extractors is optional.
{% endhint %}

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FvVMQWKdhPckXnkPTNSBn%2Fenginsight-screenshot-siem-general%20collectors-log%20files-add%20log%20file-extractors.jpg?alt=media&amp;token=368d64cc-0a2d-4d5e-aa4a-b4436037f73d" alt="" width="375"><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Extractors** field to expand a list of all available extractors, then select one or more extractors. Alternatively, use the free-text input to find extractors in the list more quickly.

{% hint style="warning" %}
**Please note**: If you have not added a custom extractor under **SIEM** → **Advanced Settings** → [Extractors](/docs/manual/english/platform-usage/siem/advanced-settings/extractors.md), this list is empty.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Remove** icon <i class="fa-circle-xmark">:circle-xmark:</i> next to an added extractor to remove it from the **Extractors** field.

***

## File Paths

Here you can enter the path to the directory that contains the log files whose data you want the collector to gather and forward to the SIEM.

<div align="left"><figure><img src="https://2423388680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV7OrHgKXA0t1jankQBYf%2Fuploads%2FeH1tVwMELxpXygTsZzrx%2Fenginsight-screenshot-siem-general%20collectors-log%20files-add%20log%20file-filepaths.jpg?alt=media&amp;token=ca2266be-7746-4184-9558-1b4b34eaa54a" alt="" width="563"><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Click in the **Filepath** field and enter the respective file path.

{% hint style="info" %}
You can use wildcards (\*) here.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Click <i class="fa-plus">:plus:</i> **Add Field** to show an additional input field where you can enter another file path.

<i class="fa-computer-mouse">:computer-mouse:</i> Click the **Delete** icon <i class="fa-trash">:trash:</i> next to an added file path to remove it.

***
