Servosity/prtg

PRTG Network Monitor Claude Code Skill

Voraussetzungen: CLI installieren

Dieser Skill steuert das prtg-cli-Binary. Du musst sicherstellen, dass die CLI installiert ist, bevor du einen Befehl aus diesem Skill aufrufst. Wenn sie fehlt, installiere sie zuerst:

1. macOS / Linux:

   bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/prtg/install.sh)
   

2. Windows (PowerShell):

   iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/prtg/install.ps1 | iex
   

3. Überprüfen: prtg-cli --version
4. Stelle sicher, dass ~/.local/bin (macOS / Linux) oder %LOCALAPPDATA%\Programs\msp-skills (Windows) im $PATH ist.

Das Installationsprogramm lädt die Binärdateien prtg-cli und prtg-mcp in ~/.local/bin (macOS / Linux) oder %LOCALAPPDATA%\Programs\msp-skills (Windows) herunter. Es registriert den Skill nicht bei deinem Agenten und schreibt keine MCP-Client-Konfiguration – siehe mcp-install.md für die Verkabelung.

Wenn --version nach der Installation „command not found“ meldet, kann die Laufzeit das Binärverzeichnis nicht im $PATH finden. Fahre nicht mit Skill-Befehlen fort, bis die Überprüfung erfolgreich ist.

Registriere jeden PRTG-Core eines Kunden einmal mit core add, führe dann fleet alarms, fleet status, fleet handoff oder fleet drift aus, um alle Cores auf einmal zu sehen, und fleet ack, fleet pause und fleet resume, um mit einer Vorschau zuerst Aktionen über alle Cores hinweg durchzuführen. Jeder v2-Vorgang ist auch ein getippter Befehl, den du mit --core auf einen einzelnen Core ausrichten kannst.

Wann diese CLI verwenden

Verwende diese CLI, wenn ein Agent PRTG-Überwachungsdaten oder -Aktionen benötigt, insbesondere über mehrere PRTG-Cores (einen pro MSP-Kunde) hinweg, die mit core add registriert wurden: aktuelle Alarme, Schichtübergaben, Wartungspausen, Bestätigungen und Systemhygiene. Sie macht auch jeden PRTG-API-v2-Vorgang für einen einzelnen Core verfügbar. Flottenbefehle beenden mit Exit-Code 0, wenn einige Cores fehlschlagen (diese Zeilen enthalten einen Fehler), und nur dann ungleich Null, wenn alle Cores fehlschlagen oder eine gesendete Aktion fehlschlägt; lies die Felder error, action und failed jeder Zeile. ack, pause und resume zeigen nur eine Vorschau an, bis --yes hinzugefügt wird.

Anti-Trigger

Verwende diese CLI nicht für:

• PRTG-Cluster oder PRTG Hosted Monitor-Installationen ohne API v2 (Paessler dokumentiert API v2 als nicht unterstützt auf Clustern); verwende die PRTG-Weboberfläche oder die ältere v1-HTTP-API.
• Bearbeiten von Benachrichtigungstriggern, Lesen des Ereignislogs oder Tickets; API v2 macht sie noch nicht verfügbar.
• Konfiguration des PRTG-Servers selbst (Installationen, Upgrades, Core-Einstellungen).

Bekannte Einschränkungen

• fleet alarms, fleet handoff, fleet silenced und fleet drift lesen die getippten Listen-Endpunkte von PRTG (/sensors/alarms, /sensors, /devices, /groups, /probes). Paessler markiert sie zugunsten von /experimental/* als veraltet, stellt sie aber weiterhin ohne Entfernungsversion zur Verfügung; sie funktionieren auch auf Cores älter als 24.3. sync liest dieselben Listen.
• Die Flottenbefehle wurden gegen Mock-Cores getestet, nicht gegen eine Live-PRTG-Installation.
• PRTG API v2 ist auf PRTG-Clustern nicht verfügbar; der Hosted Monitor-Support variiert je nach Version.

Einzigartige Fähigkeiten

Eine Ansicht über alle Cores hinweg

• fleet alarms – Zeige jeden ausgefallenen, warnenden und ungewöhnlichen Sensor über alle PRTG-Cores deiner Kunden in einer Liste: zuerst den schlimmsten Status (Down, Warning, Unusual, Acknowledged), dann höhere Priorität, dann älteste.

  Nutze dies zu Beginn einer Schicht oder wenn gefragt wird, was bei Kunden defekt ist.

  prtg-cli fleet alarms --status down --unacked --agent
  

• fleet status – Eine Zeile pro Kunden-Core mit Erreichbarkeit und Sensoranzahl nach Status, schlimmste zuerst.

  Verwende es für einen schnellen Gesundheitscheck über alle Kunden hinweg, bevor du in einen eintauchst.

  prtg-cli fleet status --agent
  

• fleet handoff – Was sich seit einem bestimmten Zeitpunkt über alle Cores geändert hat: neue Alarme, Wiederherstellungen und neue Bestätigungen oder Pausen mit wem und warum.

  Verwende es für Schichtübergaben und Fragen zu „was ist über Nacht passiert“.

  prtg-cli fleet handoff --since 12h --agent
  

• fleet silenced – Alles, was jemand über alle Cores hinweg pausiert oder bestätigt hat, mit wem, wann, bis wann und warum, wobei unbefristete, die zu lange bestehen, markiert werden.

  Verwende es nach Wartungsfenstern und bei wöchentlichen Hygieneüberprüfungen, um stummgeschaltete Ausfälle zu erkennen.

  prtg-cli fleet silenced --indefinite --older-than 7d --agent
  

• fleet exec – Führe jede schreibgeschützte API-v2-Abfrage auf jedem Core aus und erhalte eine einzige zusammengeführte Tabelle mit einer Core-Spalte.

  Verwende es für kundenübergreifende Fragen, die die dedizierten Flottenbefehle nicht abdecken.

  prtg-cli fleet exec /experimental/probes --agent
  

Systemhygiene (Estate Hygiene)

• fleet drift – PRTG-Systemhygiene über Cores hinweg: Versionen hinter deinem neuesten Core, ablaufende Lizenzen oder Wartung, Sensorüberlastung, getrennte Probes, abgelehnte API-Schlüssel und nicht erreichbare Server.

  Verwende es für die wöchentliche Systemüberprüfung anstelle einer manuell geführten Tabelle.

  prtg-cli fleet drift --within 30d --agent
  

• fleet sync – Aktualisiere den Offline-Spiegel jedes registrierten Cores in einem Durchlauf, jeder in seinen eigenen isolierten Speicher.

  Führe es vor Offline-Suchen oder Analysen über Kunden hinweg oder nachts per Cron aus.

  prtg-cli fleet sync --resources sensors,devices --agent
  

Sichere Aktionen über Cores hinweg

• fleet ack – Bestätige passende Down-Sensoren auf jedem Core gleichzeitig mit einer Ticket-Nachricht; zeigt eine Vorschau pro Core und sendet nur mit --yes (der API-Schlüssel benötigt die Zugriffsebene „Acknowledge“).

  Verwende es, um einen bekannten Vorfall zu stummschalten, der mehrere Kunden betrifft, ohne jeden Core einzeln zu öffnen.

  prtg-cli fleet ack --filter 'name = "Ping"' --message 'TKT-4411 ISP outage' --duration 2h
  

• fleet pause – Pausiere passende Geräte, Gruppen, Sensoren oder Probes auf jedem Core für ein Wartungsfenster; zeigt eine Vorschau pro Core und sendet nur mit --yes (Schreibzugriffsebene).

  Verwende es vor kundenübergreifenden Patch-Nächten anstatt in der Weboberfläche jedes Cores zu pausieren.

  prtg-cli fleet pause --kind device --filter 'name = "fw01"' --duration 2h --message 'Patch night'
  

• fleet resume – Setze passende Objekte auf jedem Core nach der Wartung fort und löse optional einen sofortigen Scan aus; zeigt eine Vorschau pro Core und sendet nur mit --yes (Schreibzugriffsebene).

  Verwende es, um ein Wartungsfenster über Kunden hinweg zu schließen und zu bestätigen, dass alles wieder grün ist.

  prtg-cli fleet resume --kind device --filter 'name = "fw01"' --scan
  

Befehlsreferenz

ai – KI verwalten

• prtg-cli ai aistatus – Gibt zurück, ob der PRTG AI Agent-Dienst beim Windows Service Control Manager registriert ist und ob er läuft.
• prtg-cli ai analyze-aiincidents – Analysiert die aktuell aktiven Alarme mit KI und gibt mögliche Vorfälle zurück. Dieser Endpunkt ist experimentell.

autodiscoveries – Auto-Discoveries verwalten

• prtg-cli autodiscoveries – Gibt eine Liste aller laufenden Auto-Discoveries zurück.

autodiscoverytasks – Auto-Discovery-Aufgaben verwalten

• prtg-cli autodiscoverytasks delete-auto-discovery-task – Löscht eine bestimmte Auto-Discovery-Aufgabe. Dieser Endpunkt ist experimentell.
• prtg-cli autodiscoverytasks get-auto-discovery-task – Gibt die Auto-Discovery-Aufgabe anhand der angegebenen Aufgaben-ID zurück. Dieser Endpunkt ist experimentell.
• prtg-cli autodiscoverytasks list-auto-discovery-task-overview – Gibt eine Übersichtsliste aller Auto-Discovery-Aufgaben zurück. Dieser Endpunkt ist experimentell.
• prtg-cli autodiscoverytasks modify-auto-discovery-task – Ändert eine Auto-Discovery-Aufgabe. Dieser Endpunkt ist experimentell.
• prtg-cli autodiscoverytasks start-auto-discovery-task – Startet eine Auto-Discovery-Aufgabe anhand der angegebenen Aufgaben-ID. Dieser Endpunkt ist experimentell.

channels – Kanäle verwalten

• prtg-cli channels channels – Gibt eine Liste von Kanälen zurück. Dieser Endpunkt ist experimentell.
• prtg-cli channels get – Gibt die Metriken und Einstellungen eines Kanals zurück.
• prtg-cli channels list – Gibt eine Liste von Kanälen zurück. ⚠ Veraltet ab PRTG 24.3.
• prtg-cli channels list-measurements – Ruft eine Liste der letzten Messungen mit Verweisen auf die entsprechenden Kanäle ab. ⚠ Veraltet ab PRTG 24.3.

core – PRTG-Cores für --core und die Flottenbefehle registrieren

• prtg-cli core add <name> --server <host[:port]> [--tag a,b] [--insecure-tls] – Registriert (oder aktualisiert) einen Core; sein Schlüssel kommt in PRTG_FLEET_KEYS als <name>=<key>, niemals auf der Festplatte; --insecure-tls überspringt die Zertifikatsprüfung nur für diesen Core.
• prtg-cli core list – Listet registrierte Cores auf und ob jede Schlüssel-Umgebungsvariable gesetzt ist (key_set).
• prtg-cli core remove <name> – Entfernt einen Core und löscht seinen lokalen Spiegel und Cache.

devices – Geräte verwalten

• prtg-cli devices create-sensor – Erstellt einen neuen Sensor in einem Gerät. Gib eine Sensorart wie 'ping', 'http' oder 'paessler.snmp.traffic_sensor' an.
• prtg-cli devices delete – Löscht ein Gerät mit allen untergeordneten Sensoren und Kanälen. Dieser Endpunkt ist experimentell.
• prtg-cli devices get – Gibt die Metriken und Einstellungen eines Geräts zurück.
• prtg-cli devices get-icons – Gibt eine Liste von Gerätesymbolen zurück.
• prtg-cli devices get-templates-experimental – Gibt eine Liste von Gerätevorlagen zurück. Dieser Endpunkt ist experimentell.
• prtg-cli devices list – Gibt eine Liste von Geräten zurück. ⚠ Veraltet ab PRTG 24.3.
• prtg-cli devices list-experimental – Gibt eine Liste von Geräten zurück. Dieser Endpunkt ist experimentell.
• prtg-cli devices metascan – Führt einen Meta-Scan auf einem bestimmten Gerät für eine bestimmte Sensorart durch. Einige Sensoren verwenden einen Meta-Scan, um wichtige Informationen abzurufen.
• prtg-cli devices metascan-result – Ruft den Fortschritt/das Ergebnis des Meta-Scans ab. Dieser Endpunkt unterstützt noch nicht alle Sensorarten.
• prtg-cli devices multi-pause – Pausiert alle Geräte, die einem Filter entsprechen.
• prtg-cli devices multi-resume – Setzt alle Geräte fort, die einem Filter entsprechen.
• prtg-cli devices multi-scan-now – Löst einen Scan aller Geräte aus, die einem Filter entsprechen.
• prtg-cli devices trigger-autodiscovery – Löst die Auto-Discovery für ein bestimmtes Gerät aus. Dieser Endpunkt ist experimentell.
• prtg-cli devices update – Bearbeitet ein Gerät.

groups – Gruppen verwalten

• prtg-cli groups create-device-for – Erstellt ein neues Gerät in einer Gruppe. Dieser Endpunkt ist experimentell.
• prtg-cli groups create-for – Erstellt eine neue Gruppe in einer Gruppe. Dieser Endpunkt ist experimentell.
• prtg-cli groups delete – Löscht eine Gruppe mit allen untergeordneten Gruppen und Geräten. Dieser Endpunkt ist experimentell.
• prtg-cli groups get – Gibt die Metriken und Einstellungen einer Gruppe zurück.
• prtg-cli groups list – Ruft eine Liste aller Gruppen ab, die einem Filter entsprechen. ⚠ Veraltet ab PRTG 24.3.
• prtg-cli groups list-experimental – Gibt eine Liste von Gruppen zurück. Dieser Endpunkt ist experimentell.
• prtg-cli groups multi-pause – Pausiert alle Gruppen, die einem Filter entsprechen.
• prtg-cli groups multi-resume – Setzt alle Gruppen fort, die einem Filter entsprechen.
• prtg-cli groups multi-scan-now – Löst einen Scan aller Gruppen aus, die einem Filter entsprechen.
• prtg-cli groups trigger-autodiscovery – Löst die Auto-Discovery für eine bestimmte Gruppe aus. Dieser Endpunkt ist experimentell.
• prtg-cli groups update – Bearbeitet eine Gruppe.

health – Status verwalten

• prtg-cli health – Gibt den Status des PRTG-Anwendungsservers zurück.

libraries – Bibliotheken verwalten

• prtg-cli libraries – Gibt eine Liste aller Bibliotheken zurück, die einem Filter entsprechen. ⚠ Veraltet ab PRTG 24.3.

lookup-definitions – Lookup-Definitionen verwalten

• prtg-cli lookup-definitions get-overview – Gibt eine Lookup-Definition zurück. ⚠ Veraltet ab PRTG 24.3.100: Dieser Endpunkt funktioniert noch, wird aber ersetzt.
• prtg-cli lookup-definitions list – Gibt eine Liste von Lookup-Definitionen zurück. ⚠ Veraltet ab PRTG 24.3.

objects – Objekte verwalten

• prtg-cli objects count – Gibt eine Liste zurück, wie viele Objekte jeder Art existieren.
• prtg-cli objects list – Ruft eine Liste aller Probes, Gruppen, Geräte und Sensoren ab, die einem Filter entsprechen. ⚠ Veraltet ab PRTG 24.3.
• prtg-cli objects multi-delete – Löscht mehrere Objekte basierend auf dem angegebenen Filter. Alle untergeordneten Elemente werden ebenfalls gelöscht. Dieser Endpunkt ist experimentell.
• prtg-cli objects objects – Gibt eine Liste aller Probes, Gruppen, Geräte, Sensoren und Kanäle zurück, die einem Filter entsprechen.

probe-network – Probe-Netzwerkinformationen

• prtg-cli probe-network <id> – Gibt die Netzwerkinformationen einer Probe zurück.

probes – Probes verwalten

• prtg-cli probes create-auto-discovery-task – Erstellt eine neue Auto-Discovery-Aufgabe auf einer Probe. Dieser Endpunkt ist experimentell.
• prtg-cli probes create-device-for – Erstellt ein neues Gerät auf einer Probe. Dieser Endpunkt ist experimentell.
• prtg-cli probes create-group-for – Erstellt eine neue Gruppe in einer Probe. Dieser Endpunkt ist experimentell.
• prtg-cli probes delete – Löscht eine Probe mit allen untergeordneten Gruppen und Geräten. Dieser Endpunkt ist experimentell.
• prtg-cli probes get – Gibt die Metriken und Einstellungen einer Probe zurück.
• prtg-cli probes list – Ruft eine Liste aller Probes ab, die einem Filter entsprechen. ⚠ Veraltet ab PRTG 24.3.
• prtg-cli probes list-experimental – Gibt eine Liste von Probes zurück. Dieser Endpunkt ist experimentell.
• prtg-cli probes multi-pause – Pausiert alle Probes, die einem Filter entsprechen.
• prtg-cli probes multi-resume – Setzt alle Probes fort, die einem Filter entsprechen.
• prtg-cli probes multi-scan-now – Löst einen Scan aller Probes aus, die einem Filter entsprechen.
• prtg-cli probes update – Bearbeitet eine Probe.

schemas – Schemata verwalten

• prtg-cli schemas get – Gibt ein OAS-Schema zurück, das in anderen Endpunkten verwendet werden kann. ⚠ Veraltet ab PRTG 24.3.
• prtg-cli schemas get-create-by-parent-id – Gibt ein OAS-Schema zur Verwendung in POST-Endpunkten zurück.
• prtg-cli schemas get-kinds-for-parent – Gibt eine Liste aller Objektarten zurück, die du auf einem bestimmten übergeordneten Objekt erstellen kannst. Dieser Endpunkt ist experimentell.
• prtg-cli schemas get-read-by-object-id – Gibt ein OAS-Schema zur Verwendung in GET-Endpunkten für ein bestimmtes Objekt zurück.
• prtg-cli schemas get-update-by-object-id – Gibt ein OAS-Schema zur Verwendung in PATCH-Endpunkten für ein bestimmtes Objekt zurück.