# Plugin hinzufügen

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> **Plugin hinzufügen** in der rechten oberen Ecke der [Plugin-Übersicht](/docs/manual/bedienung-der-plattform/hosts/management/plugins.md#plugins-ubersicht), um ein neues Plugin zu erstellen. Es öffnet sich die Ansicht **Hosts** → **Plugins** → **Hinzufügen**.

<figure><img src="/files/nG0NFqEWbhZIviyQrkYI" alt=""><figcaption></figcaption></figure>

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Plugin hinzufügen**, nachdem du alle Einstellungen vorgenommen hast, um das neue Plugin zu erstellen.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Zurück**, um zurück zur Listenübersicht zu gelangen.

{% hint style="danger" %}
**Bitte beachte**: Verlässt du diese Ansicht, ohne auf **Plugin hinzufügen** zu klicken, sind alle bisher vorgenommenen Einstellungen unwiederbringlich verloren!
{% endhint %}

***

## Grundeinstellungen

<figure><img src="/files/88PasntLy2kp1iWx4fCf" alt=""><figcaption></figcaption></figure>

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="200.0546875">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Name</td><td>Gib dem Plugin einen aussagekräftigen Namen.</td></tr><tr><td>Beschreibung</td><td><p>Beschreibe das Plugin genauer. </p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Dieses Feld ist optional.</p></div></td></tr><tr><td>Skriptsprache</td><td><p>Lege die Skriptsprache für das Plugin-Skript fest.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Die standardmäßig ausgewählte Skriptsprache ist <strong>Bash (Shell)</strong>.</p></div><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld <strong>Skriptsprache</strong>, um eine Liste aller verfügbaren Skriptsprachen auszuklappen.<br> </p><p>Folgende Skriptsprachen stehen zur Verfügung:</p><ul><li><strong>Bash (Shell)</strong></li><li><strong>Python 3</strong></li><li><strong>PowerShell</strong></li></ul></td></tr><tr><td>Code-Feld</td><td><p>Füge das Skript in das Code-Feld ein.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Bitte beachte</strong>: Der Code des Skripts und die ausgewählte Skriptsprache müssen übereinstimmen.</p></div></td></tr></tbody></table>

***

## Extrahierte Felder

Du kannst aus dem Plugin-Skript optional Felder extrahieren, die als [benutzerdefinierte Metriken](/docs/manual/bedienung-der-plattform/host-detailansichten/monitoring/custom-metriken.md) in der Host-Detailansicht visualisiert werden können.&#x20;

<div align="left"><figure><img src="/files/riTantO1ZsunZuEcORdx" alt=""><figcaption></figcaption></figure></div>

Vorlagen für die drei zur Verfügung stehenden Skriptsprachen findest du hier:

* [PowerShell](https://github.com/enginsight/powershell-cm-template/blob/master/setup.ps1)
* [Bash](https://github.com/enginsight/bash-cm-template/blob/master/setup.sh)
* [Python](https://github.com/enginsight/python-cm-template/blob/master/setup.py)

Sobald ein Plugin ausgeführt wurde, erscheinen Name und Typ der extrahierten Felder in der jeweiligen [Plugin-Bearbeitungsansicht](/docs/manual/bedienung-der-plattform/hosts/management/plugins.md#plugin-bearbeitungsansicht).

<div align="left"><figure><img src="/files/MTOfqosnf3YW2VBkpSSj" alt=""><figcaption></figcaption></figure></div>

<i class="fa-pen">:pen:</i> Füge optional eine Beschreibung zu jedem extrahierten Feld hinzu und klicke auf **Änderungen speichern**, um die Änderungen zu übernehmen.

***

## Geplante Ausführung

Diese Einstellung ermöglicht es, das Plugins regelmäßig in einem benutzerdefinierten zeitlichen Intervall auszuführen.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld **Erweiterte Einstellungen**, um die Option **Geplante Ausführung** anzuzeigen.

<i class="fa-computer-mouse">:computer-mouse:</i> Setze einen Haken in die Checkbox <i class="fa-square">:square:</i> neben **Geplante Ausführung**, um das Plugin regelmäßig in einem bestimmten zeitlichen Intervall auszuführen. Es öffnet sich die **Zeitintervall-Auswahl**, mit der du das Intervall der Ausführung auswählen kannst.

<figure><img src="/files/Xsr4agHgSm0MOc6wOdKV" alt=""><figcaption></figcaption></figure>

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="200.328125">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Zeitzone</td><td><p>Lege die Zeitzone fest, die für das gewählte Zeitintervall gelten soll.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Die standardmäßig ausgewählte Zeitzone ist <strong>(GMT+01:00) MEZ – Europe/Berlin</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld <strong>Zeitzone</strong>, um eine Liste aller verfügbaren Zeitzonen auszuklappen.</p></td></tr><tr><td>Cron-Ausdruck</td><td><p>Zeigt das festgelegte Intervall für die regelmäßige Ausführung des Plugins als Cron-Ausdruck an.<br><br>Der Cron-Ausdruck aktualisiert sich automatisch, sobald du ein Zeitintervall manuell einstellst.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Der standardmäßig angegebene Cron-Ausdruck ist <strong>*/15***</strong>. Dies bedeutet, dass das Plugin alle 15 Minuten ausgeführt wird.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld <strong>Cron-Ausdruck</strong>, um den Cron-Ausdruck manuell anzupassen.</p></td></tr><tr><td>Nächste Ausführung (Lokale Zeitzone)</td><td>Zeigt das genaue Datum und die Uhrzeit für die nächste Ausführung des Plugins in der <em>lokalen Zeitzone deines Browsers</em> an.</td></tr><tr><td>Beschreibung</td><td>Zeigt das festgelegte Intervall für die regelmäßige Ausführung des Plugins als Beschreibung in Worten an.</td></tr><tr><td>Zeitintervall-Auswahl</td><td>Lege ein benutzerdefiniertes Ausführungsintervall fest.<br><br>Wähle dazu entsprechend die Minuten, Stunden, Tage im Monat, Monate, oder Wochentage aus.</td></tr></tbody></table>

***

## Zugeordnete Hosts

Hier kannst du definieren, für welche Hosts oder Gruppen von Hosts die vorgenommenen Einstellungen gelten sollen.

<figure><img src="/files/84OZZ67GYYOtrEa7ikL5" alt=""><figcaption></figcaption></figure>

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="199.625">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Hosts</td><td><p>Lege Hosts fest, für die die vorgenommenen Einstellungen gelten sollen.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke dazu in das Feld <strong>Hosts</strong>, um eine Liste aller verfügbaren Hosts auszuklappen, und wähle einen oder mehrere Hosts aus. Oder nutze die Freitexteingabe, um Hosts in der Liste schneller zu finden.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das <strong>Entfernen</strong>-Symbol <i class="fa-circle-xmark">:circle-xmark:</i> neben einem hinzugefügten Host, um ihn aus dem Feld <strong>Hosts</strong> zu entfernen.</p></td></tr><tr><td>Tag-Verknüpfung</td><td><p>Lege fest, wie viele Tags ein zugeordneter Host enthalten muss, damit die Einstellungen für ihn gelten.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Die standardmäßig ausgewählte Tag-Verknüpfung ist <strong>Alle Tags sind bei der Referenz vorhanden</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld <strong>Tag-Verknüpfung</strong>, um eine Liste aller verfügbaren Optionen auszuklappen.<br><br>Folgende Optionen stehen zur Verfügung:</p><ul><li><strong>Alle Tags sind bei der Referenz vorhanden</strong>: Ein zugeordneter Host muss alle angegebenen Tags enthalten, damit die Einstellungen für ihn gelten.</li><li><strong>Mindestens einer der angegebenen Tags ist vorhanden</strong>: Ein zugeordneter Host muss mindestens einen der angegebenen Tags enthalten, damit die Einstellungen für ihn gelten.</li></ul></td></tr><tr><td>Tags</td><td><p>Lege Tags für Gruppen von Hosts fest, für die die vorgenommenen Einstellungen gelten sollen.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke dazu in das Feld <strong>Tags</strong>, um eine Liste aller verfügbaren Tags auszuklappen, und wähle einen oder mehrere Tags aus. Oder nutze die Freitexteingabe, um Tags in der Liste schneller zu finden.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das <strong>Entfernen</strong>-Symbol <i class="fa-circle-xmark">:circle-xmark:</i> neben einem hinzugefügten Tag, um ihn aus dem Feld <strong>Tags</strong> zu entfernen.</p></td></tr></tbody></table>

### Ausgeschlossene Hosts

Hier kannst du definieren, welche Hosts oder Gruppen von Hosts von den vorgenommenen Einstellung explizit ausgenommen werden sollen.

{% hint style="info" %}
Die Angabe von ausgeschlossenen Hosts ist optional.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> **Ausnahmen definieren** neben **Zugeordnete Hosts**, um die Optionen für **Ausgeschlossene Hosts** anzuzeigen.

<div align="left"><figure><img src="/files/Ij7mAIQCONibozppnzEH" alt="" width="563"><figcaption></figcaption></figure></div>

<i class="fa-gear">:gear:</i> Nimm alle Einstellungen wie bei der Angabe eines zugeordneten Hosts vor.

***

## Plugin testen

{% hint style="danger" %}
**Bitte beachte**: Damit Plugins ausgeführt werden können, musst du diese unter **Hosts** → **Policies** mit einer entsprechenden Richtlinie aktivieren.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-slider">:slider:</i> **Plugin testen** in der rechten oberen Ecke, nachdem du alle Einstellungen vorgenommen hast, um das neue Plugin zu testen. Es öffnet sich das Fenster **Ausführender Host**.

<div align="left"><figure><img src="/files/dbI1t6kKqnk6GVtd8I4m" alt="" width="549"><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld **Hosts**, um eine Liste aller Hosts auszuklappen, die online sind und die zur Ausführung von Plugins berechtigt sind.&#x20;

Wähle den Host aus, auf dem das Plugin testweise ausgeführt werden soll und bestätige deine Auswahl mit **Plugin testen**.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.enginsight.com/docs/manual/bedienung-der-plattform/hosts/management/plugins/plugin-hinzufugen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.