# Plugins

Plugins bieten dir die Möglichkeit, benutzerdefinierte Skripte als Reaktion auf ein bestimmtes Systemereignis oder als geplante Aktivität auf zugeordneten Hosts auszuführen. 

Die Ausführung der Skripte wird dabei durch den Pulsar übernommen, der auf einem Host installiert ist.

{% hint style="danger" %}
**Bitte beachte**: Damit benutzerdefinierte Skripte auf deinen Hosts ausgeführt werden können, musst du die Option **Plugins** in den [Einstellungen der einzelnen Hosts](/docs/manual/bedienung-der-plattform/host-detailansichten/einstellungen.md#core-feature) oder unter **Hosts** → **Policy Manager** mit [einer entsprechenden Richtlinie aktivieren](/docs/manual/bedienung-der-plattform/hosts/management/policy-manager/policy-hinzufugen.md#plugins).
{% endhint %}

***

<i class="fa-compass">:compass:</i> Navigiere zu **Hosts** → **Plugins**, um eine Auflistung aller angelegten Plugins anzuzeigen. Wenn du noch kein Plugin erstellt hast, ist diese Ansicht leer.

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

Du kannst der [Plugin-Übersicht](#plugin-ubersicht) unter anderem entnehmen:

* welches Plugin in welchem zeitlichen Intervall auf welchen Hosts ausgeführt wird.
* welche Felder aus dem Plugin extrahiert werden, die sich in der Host-Detailansicht als [benutzerdefinierte Metriken](/docs/manual/bedienung-der-plattform/host-detailansichten/monitoring/custom-metriken.md) visualisieren lassen.
* welche Skriptsprache für das Plugin verwendet wird.

Des Weiteren hast du hier die Möglichkeit, neue [Plugins hinzuzufügen](/docs/manual/bedienung-der-plattform/hosts/management/plugins/plugin-hinzufugen.md).

***

## Navigation

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld <i class="fa-magnifying-glass">:magnifying-glass:</i> **Freitextsuche** oberhalb der Liste und gib einen frei gewählten Suchbegriff ein, um bestimmte Listenelemente zu finden.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das **Aktualisieren**-Symbol <i class="fa-arrows-rotate-reverse">:arrows-rotate-reverse:</i> oberhalb der Liste, um alle Listenelemente zu aktualisieren.

<i class="fa-computer-mouse-scrollwheel">:computer-mouse-scrollwheel:</i> Scrolle in der Liste nach unten oder passe die Ergebnisanzeige pro Seite an: ![](/files/2OyJnQuiS9EayPZHDbB3) um weitere Einträge in der Liste zu sehen.\
Nutze die Seitennavigation: ![](/files/IWrRD7h50XDr2neLTKmC) um zwischen mehreren Seiten zu wechseln.&#x20;

### Liste filtern

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das **Filtern**-Symbol <i class="fa-filter">:filter:</i> oberhalb der Liste, um die Liste nach vordefinierten Parametern zu filtern.

<details>

<summary>Verfügbare Filter</summary>

<table><thead><tr><th width="206.60546875">Parameter</th><th width="116.515625">Art</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Extrahierte Felder</td><td>String</td><td>Filtere nach allen Plugins mit bestimmten aus dem Plugin-Skript extrahierten Feldern oder schließe diese aus den Ergebnissen aus. Es werden alle verfügbaren extrahierten Felder angezeigt.</td></tr><tr><td>Geplante Ausführung</td><td>Boolescher Wert</td><td><p>Filtere danach, ob eine geplante Ausführung des Plugins festgelegt wurde oder nicht. <br><br>Folgende Werte stehen zur Verfügung:</p><ul><li><strong>True</strong>: Eine geplante Ausführung wurde festgelegt.</li><li><strong>False</strong>: Eine geplante Ausführung wurde nicht festgelegt.</li></ul></td></tr><tr><td>Skriptsprache</td><td>String</td><td>Filtere nach allen Plugins mit einer bestimmten Skriptsprache oder schließe diese aus den Ergebnissen aus. Es werden alle verfügbaren Skriptsprachen angezeigt.</td></tr></tbody></table>

</details>

### Listenelemente sortieren

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke im Tabellenkopf auf das **Sortieren**-Symbol <i class="fa-sort">:sort:</i> neben einem Spaltennamen, um nach der jeweiligen Spalte in aufsteigender Reihenfolge <i class="fa-angle-up">:angle-up:</i> oder in absteigender Reihenfolge <i class="fa-chevron-down">:chevron-down:</i> zu sortieren.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das **Sortieren**-Symbol <i class="fa-bars-sort">:bars-sort:</i> oberhalb der Liste, um die Priorität der vorgenommenen Sortierung anzupassen. Es öffnet sich ein Menü, in dem alle Spalten angezeigt werden, nach denen die Liste sortiert ist. Verschiebe die angezeigten Elemente per Drag-and-Drop, um die Sortierpriorität zu ändern.

### Listenelemente löschen

<i class="fa-computer-mouse">:computer-mouse:</i> Setze einen Haken in die Checkbox <i class="fa-square">:square:</i> neben einem Listenelement, um das entsprechende Element auszuwählen. Oder setze einen Haken in die Checkbox im Tabellenkopf, um alle Listenelemente gemeinsam auszuwählen.&#x20;

Neben dem Suchfeld erscheint nun die Anzahl der ausgewählten Listenelemente.

Zudem erscheint der Button <i class="fa-trash">:trash:</i> **Löschen** in der rechten oberen Ecke. Klicke darauf und bestätige die Meldung, die erscheint, mit **Löschen**.

{% hint style="danger" %}
**Bitte beachte**: Gelöschte Elemente sind unwiederbringlich verloren!
{% endhint %}

***

## Plugins: Übersicht

<figure><img src="/files/5KP4VNGJJkVxNeFmxyYT" alt=""><figcaption></figcaption></figure>

Die Plugin-Übersicht ist als tabellarische Liste aufgebaut. Du kannst der Liste folgende Informationen entnehmen:

<table><thead><tr><th width="200.37890625">Spalte</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Name</td><td>Zeigt den benutzerdefinierten Namen des Plugins sowie eine zusätzliche Beschreibung, falls angegeben. Zudem werden Erstelldatum und -uhrzeit sowie letztes Bearbeitungsdatum und -uhrzeit angezeigt.<br><br>Falls du eine <a href="/pages/cwe1snqsQGpUmUszNvIM#geplante-ausfuhrung">geplante Ausführung</a> festgelegt hast, werden hier auch der zugehörige Cron-Ausdruck sowie die Zeitzone angezeigt.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf den Namen eines Plugins, um zur entsprechenden <a href="#plugin-bearbeitungsansicht">Bearbeitungsansicht</a> zu navigieren. Hier kannst du <a href="/pages/cwe1snqsQGpUmUszNvIM#grundeinstellungen">vorgenommene Einstellungen</a> anpassen und das Plugin löschen. Zudem erhältst du eine <a href="#ubersicht-uber-plugin-ausfuhrungen">Übersicht über Ausführungen des Plugins</a>, die bereits stattgefunden haben.</td></tr><tr><td>Zugeordnete Hosts</td><td><p>Zeigt die Namen der Hosts, auf denen das Plugin ausgeführt werden soll oder die davon ausgeschlossen sind, sowie die Tags, die auf die entsprechenden Host-Gruppen verweisen.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Ob Host-Namen oder Tags oder beides angezeigt werden, hängt von den <a href="/pages/cwe1snqsQGpUmUszNvIM#zugeordnete-hosts">Einstellungen für zugeordnete Hosts</a> ab, die du für das entsprechende Plugin vorgenommen hast. </p></div><p><br><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf den Namen eines Hosts, um zur jeweiligen <a href="/pages/2A0M45TxgQaeD6tpDIkK">Host-Detailansicht</a> zu navigieren.</p></td></tr><tr><td>Extrahierte Felder</td><td>Zeigt, falls verfügbar, aus dem Plugin-Skript extrahierte Felder, die als <a href="/pages/uwYLF1gTPOYekMKrNWDa">benutzerdefinierte Metriken</a> in der Host-Detailansicht visualisiert werden können.</td></tr><tr><td>Skriptsprache</td><td>Zeigt die Skriptsprache, die für das Plugin verwendet wird.</td></tr></tbody></table>

***

## 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, um ein [neues Plugin zu erstellen](#plugin-hinzufugen).&#x20;

***

## Plugin: Bearbeitungsansicht

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf den Namen eines Plugins, um zur entsprechenden Bearbeitungsansicht zu navigieren. Hier kannst du [vorgenommene Einstellungen](/docs/manual/bedienung-der-plattform/hosts/management/plugins/plugin-hinzufugen.md#grundeinstellungen) anpassen und das Plugin löschen. Zudem erhältst du eine [Übersicht über Ausführungen des Plugins](#ubersicht-uber-plugin-ausfuhrungen), die bereits stattgefunden haben.

Folgende Aktionen stehen zur Verfügung:

<table><thead><tr><th width="200.39453125">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Änderungen speichern</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <strong>Änderungen speichern</strong>, nachdem du Einstellungen geändert hast.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Bitte beachte</strong>: Nicht gespeicherte Änderungen sind unwiederbringlich verloren!</p></div></td></tr><tr><td>Zurück</td><td><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <strong>Zurück</strong>, um zurück zur Listenübersicht zu gelangen.</td></tr><tr><td>Löschen</td><td><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <strong>Löschen</strong> und bestätige die Meldung, die erscheint, mit <strong>Löschen</strong>, um alle vorgenommenen Einstellungen zu löschen.</p><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Bitte beachte</strong>: Gelöschte Einstellungen sind unwiederbringlich verloren!</p></div></td></tr></tbody></table>

### Plugin-Ausführungen: Übersicht

Sobald ein Plugin ausgeführt wurde, erscheint in der jeweiligen Plugin-Bearbeitungsansicht der Bereich **Geplante Ausführung**. Dieser ist als tabellarische Liste aufgebaut.

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

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Aktualisieren**, um die Liste der Plugin-Ausführungen zu aktualisieren.&#x20;

Du kannst der Liste folgende Informationen entnehmen:

<table><thead><tr><th width="199.734375">Spalte</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Host</td><td><p>Zeigt den Namen des Hosts, auf dem das Plugin ausgeführt wurde, sowie den Status der Ausführung als farbiges Symbol.<br><br>Folgende Status stehen zur Verfügung:</p><ul><li><i class="fa-circle-check" style="color:green;">:circle-check:</i> : Das Plugin wurde erfolgreich ausgeführt.</li><li><i class="fa-circle-exclamation" style="color:$danger;">:circle-exclamation:</i> : Bei der Ausführung des Plugins ist ein Fehler aufgetreten.</li></ul><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf den Namen eines Hosts, um zur jeweiligen <a href="/pages/2A0M45TxgQaeD6tpDIkK">Host-Detailansicht</a> zu navigieren.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das <strong>Analysieren</strong>-Symbol <i class="fa-magnifying-glass-waveform">:magnifying-glass-waveform:</i> um ein <a href="#plugin-ausfuhrungen-detailansicht">Fenster mit detaillierteren Informationen</a> zur Ausführung des Plugins zu öffnen.</p></td></tr><tr><td>Erstellt am</td><td>Zeigt das Datum und die Uhrzeit, an dem das Plugin ausgeführt wurde.</td></tr></tbody></table>

### Plugin-Ausführung: Detailansicht

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das **Analysieren**-Symbol <i class="fa-magnifying-glass-waveform">:magnifying-glass-waveform:</i> neben einem Hostnamen, um ein Fenster mit detaillierteren Informationen zur Ausführung des Plugins zu öffnen.

<div align="left"><figure><img src="/files/Y9ilEuTR0yNk14dnSsKF" alt="" width="551"><figcaption></figcaption></figure></div>

Folgende Informationen werden angezeigt:

<table><thead><tr><th width="200.08984375"></th><th></th></tr></thead><tbody><tr><td>Ausführender Host</td><td>Zeigt den Namen des Hosts, auf dem das Plugin ausgeführt wurde.</td></tr><tr><td>Banner</td><td>Zeigt eine Meldung, ob das Plugin erfolgreich ausgeführt wurde (grün) oder die Ausführung fehlgeschlagen ist (rot).</td></tr><tr><td>Standardausgabe (stdout)</td><td>Zeigt einen Ausschnitt aus der entsprechenden Logdatei mit Detailinformationen zur Ausführung.</td></tr><tr><td>Fehlerausgabe (stderr)</td><td><i class="fa-eye">:eye:</i> Dieser Abschnitt wird nur angezeigt, wenn die Ausführung des Plugins fehlgeschlagen ist.<br><br>Zeigt einen Ausschnitt aus der entsprechenden Logdatei mit Detailinformationen zum Fehler.</td></tr></tbody></table>

***

## Vorlagen für Plugins

<i class="fa-lightbulb">:lightbulb:</i> Vorlagen für Plugins findest du hier: [github.com/enginsight](https://github.com/enginsight)

***

## Weitere Ressourcen

**Knowledge Base**

* [Wie kann ich bei Enginsight mehrere Plugins gleichzeitig auf einem Host ausführen?](https://docs.enginsight.com/docs/knowledge-base/plugins/wie-kann-ich-bei-enginsight-mehrere-plugins-gleichzeitig-auf-einem-host-ausfuhren)


---

# 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.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.