Plugin-Framework
Erweitern Sie die Funktionen von Xcellerate RMM mit Community-Plugins und eigenen Plugins.
Überblick
Mit dem Plugin-Framework erweitern Sie Xcellerate RMM um zusätzliche Funktionen, ohne die Kernplattform zu verändern. Plugins können neue Dashboard-Widgets, eigene Monitore, Berichtstypen, Integrationskonnektoren und sogar komplett neue Seiten in der Oberfläche hinzufügen.
RMM Labs betreibt einen offiziellen Plugin-Marktplatz mit Plugins aus der Community und von RMM Labs selbst. Mit dem Plugin SDK und TypeScript/JavaScript können Sie auch eigene private Plugins entwickeln.
Wichtige Begriffe
- Plugin — ein eigenständiges Erweiterungspaket mit Manifest, Code und optionalen Assets (Symbole, Vorlagen). Wird auf Serverebene installiert.
- Plugin-Marktplatz — der integrierte Katalog, in dem Sie Plugins durchsuchen, installieren und aktualisieren. Erreichbar über Administration → Plugins.
- Plugin SDK — ein Entwicklungskit mit APIs für den Zugriff auf Daten, UI-Komponenten und Ereignisse von Xcellerate RMM. Verfügbar als npm-Paket.
- Hook — ein Erweiterungspunkt der Plattform, an dem Plugins eigenes Verhalten einbringen können (z. B.
onEndpointCreated,onAlertFired,beforePatchInstall). - Widget — eine von einem Plugin bereitgestellte Komponente, die Sie dem Dashboard oder den Detailseiten von Endpunkten hinzufügen können (z. B. ein eigenes Diagramm, ein Button für eine Schnellaktion).
- Plugin-Einstellungen — Konfigurationswerte, die das Plugin bereitstellt (z. B. ein API-Schlüssel für einen Drittanbieterdienst). Administratoren legen sie nach der Installation fest.
Schritt-für-Schritt-Anleitung
Marktplatz durchsuchen
Öffnen Sie Administration → Plugins → Marketplace. Stöbern Sie nach Kategorie (Monitoring, Reporting, Integrationen, UI) oder suchen Sie nach Namen. Jede Plugin-Karte zeigt Beschreibung, Autor, Version, Bewertung und Anzahl der Installationen.
Plugin installieren
Klicken Sie auf ein Plugin, um seine Detailseite zu öffnen, und dann auf Install. Das Plugin wird heruntergeladen und aktiviert. Manche Plugins erfordern einen Neustart des Servers — die Oberfläche weist Sie in diesem Fall darauf hin.
Plugin konfigurieren
Öffnen Sie nach der Installation Administration → Plugins → Installed. Klicken Sie auf den Namen des Plugins und füllen Sie die erforderlichen Einstellungen aus (z. B. API-Schlüssel, Standardparameter). Speichern Sie.
Plugin verwenden
Je nach Plugin-Typ sehen Sie einen neuen Eintrag im Seitenmenü, ein neues Widget im Dashboard, zusätzliche Optionen in Kontextmenüs oder einen neuen Berichtstyp. Details finden Sie in der Dokumentation des Plugins.
Plugin aktualisieren oder entfernen
Auf der Seite mit den installierten Plugins können Sie nach Updates suchen (ein Badge erscheint, wenn eine neue Version verfügbar ist) oder ein Plugin mit Uninstall sauber entfernen.
Eigenes Plugin entwickeln
Um ein eigenes Plugin zu erstellen, installieren Sie das Plugin SDK und legen ein neues Projektgerüst an:
npm install -g @xcellerate/plugin-sdk
xcellerate-plugin init my-custom-plugin
cd my-custom-plugin
npm run devDas erzeugte Projekt enthält eine Manifest-Datei (plugin.json), einen Einstiegspunkt und Beispiel-Hooks. Das SDK liefert TypeScript-Typen für alle Plattform-APIs sowie einen lokalen Entwicklungsserver, der Ihr Plugin per Hot Reload gegen eine isolierte Xcellerate-Instanz neu lädt.
Tipps und Best Practices
- Prüfen Sie den Marktplatz, bevor Sie eine eigene Lösung bauen — vielleicht gibt es bereits ein Plugin, das genau das kann, was Sie brauchen.
- Halten Sie Plugins aktuell — Autoren beheben in neuen Versionen oft Fehler und ergänzen Funktionen.
- Folgen Sie bei der Entwicklung eigener Plugins dem Least-Privilege-Prinzip: Fordern Sie nur die API-Berechtigungen an, die Ihr Plugin wirklich braucht.
- Testen Sie eigene Plugins in einer Staging-Umgebung, bevor Sie sie in der Produktion einsetzen.
- Nutzen Sie Hooks für ereignisgesteuerte Logik (z. B. Endpunkte bei der Erstellung automatisch taggen), statt die API regelmäßig abzufragen.
- Reichen Sie nützliche Plugins im Marktplatz ein, um sie mit der Community zu teilen und Feedback zu erhalten.