Servosity/prtg

Compétence PRTG Network Monitor pour Claude Code

Prérequis : Installer le CLI

Cette compétence utilise le binaire prtg-cli. Vous devez vérifier que le CLI est installé avant d'invoquer toute commande de cette compétence. S'il est manquant, installez-le d'abord :

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. Vérification : prtg-cli --version
4. Assurez-vous que ~/.local/bin (macOS / Linux) ou %LOCALAPPDATA%\Programs\msp-skills (Windows) est dans le $PATH.

L'installateur télécharge les binaires prtg-cli et prtg-mcp dans ~/.local/bin (macOS / Linux) ou %LOCALAPPDATA%\Programs\msp-skills (Windows). Il n'enregistre pas la compétence avec votre agent et n'écrit aucune configuration client MCP - voir mcp-install.md pour cette connexion.

Si --version signale "command not found" après l'installation, l'exécution ne voit pas le répertoire du binaire dans le $PATH. Ne continuez pas avec les commandes de la compétence tant que la vérification n'a pas réussi.

Enregistrez chaque cœur PRTG client une fois avec 'core add', puis exécutez 'fleet alarms', 'fleet status', 'fleet handoff' ou 'fleet drift' pour voir tous les cœurs en une fois, et 'fleet ack', 'fleet pause' et 'fleet resume' pour agir sur eux avec un aperçu préalable. Chaque opération v2 est également une commande typée que vous pouvez cibler sur un cœur avec --core.

Quand utiliser ce CLI

Utilisez ce CLI quand un agent a besoin de données ou d'actions de surveillance PRTG, en particulier sur plusieurs cœurs PRTG (un par client MSP) enregistrés avec 'core add' : alarmes actuelles, passations de garde, mises en pause de maintenance, accusés de réception et hygiène du parc. Il expose également l'intégralité de l'API PRTG v2 pour un seul cœur. Les commandes de flotte se terminent avec un code 0 lorsque certains cœurs échouent (ces lignes portent une erreur) et un code non nul uniquement lorsque tous les cœurs échouent ou qu'une action envoyée échoue ; lisez les champs error, action et failed de chaque ligne. Les commandes ack, pause et resume ne font qu'afficher un aperçu tant que --yes n'est pas ajouté.

Anti-déclencheurs

N'utilisez pas ce CLI pour :

• Ne l'utilisez pas pour les clusters PRTG ou les installations PRTG Hosted Monitor sans API v2 (Paessler documente l'API v2 comme non prise en charge sur les clusters) ; utilisez l'interface web PRTG ou l'API HTTP v1 héritée.
• Ne l'utilisez pas pour modifier les déclencheurs de notification, lire le journal des événements ou les tickets ; l'API v2 ne les expose pas encore.
• Ne l'utilisez pas pour configurer le serveur PRTG lui-même (installations, mises à niveau, paramètres du cœur).

Limitations connues

• fleet alarms, fleet handoff, fleet silenced et fleet drift lisent les points de terminaison de liste typée de PRTG (/sensors/alarms, /sensors, /devices, /groups, /probes). Paessler les marque comme dépréciés au profit de /experimental/* mais continue de les servir sans version de suppression ; ils fonctionnent également sur les cœurs antérieurs à 24.3. sync lit les mêmes listes.
• Les commandes de flotte ont été vérifiées contre des cœurs simulés, pas une installation PRTG en direct.
• L'API PRTG v2 n'est pas disponible sur les clusters PRTG ; la prise en charge de Hosted Monitor varie selon la version.

Capacités uniques

Une vue sur tous les cœurs

• fleet alarms - Voir tous les capteurs en panne, en avertissement et anormaux sur tous les cœurs PRTG de vos clients en une seule liste : d'abord le pire état (panne, avertissement, anormal, acquitté), puis la priorité la plus élevée, puis le plus ancien.

  Utilisez-le au début d'un quart de travail ou lorsqu'on vous demande ce qui est en panne chez les clients.

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

• fleet status - Une ligne par cœur client avec l'accessibilité et les comptes de capteurs par état, du pire au meilleur.

  Utilisez-le pour un aperçu rapide de la santé de tous les clients avant d'examiner un en détail.

  prtg-cli fleet status --agent
  

• fleet handoff - Ce qui a changé sur tous les cœurs depuis un moment donné : nouvelles alarmes, rétablissements, et nouveaux accusés de réception ou mises en pause avec qui et pourquoi.

  Utilisez-le pour les passations de garde et les questions sur 'ce qui s'est passé pendant la nuit'.

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

• fleet silenced - Tout ce qui a été mis en pause ou acquitté sur tous les cœurs, avec qui, quand, jusqu'à quand et pourquoi, en signalant les cas indéfinis laissés trop longtemps.

  Utilisez-le après les fenêtres de maintenance et lors des revues d'hygiène hebdomadaires pour détecter les pannes masquées.

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

• fleet exec - Exécute n'importe quelle requête API v2 en lecture seule sur chaque cœur et obtient un tableau fusionné avec une colonne core.

  Utilisez-le pour des questions transversales aux clients que les commandes de flotte dédiées ne couvrent pas.

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

Hygiène du parc

• fleet drift - Hygiène du parc PRTG sur les cœurs : versions en retard par rapport à votre cœur le plus récent, licences ou maintenance expirant bientôt, surutilisation des capteurs, sondes déconnectées, clés API rejetées et serveurs inaccessibles.

  Utilisez-le pour la revue hebdomadaire du parc au lieu d'un tableur tenu à la main.

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

• fleet sync - Rafraîchit le miroir hors ligne de chaque cœur enregistré en une seule exécution, chacun dans son propre magasin isolé.

  Exécutez-le avant les recherches hors ligne ou les analyses transversales aux clients, ou chaque nuit depuis cron.

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

Actions sécurisées sur les cœurs

• fleet ack - Acquitte les capteurs en panne correspondants sur chaque cœur en une seule fois avec un message de ticket ; affiche un aperçu par cœur et n'envoie qu'avec --yes (la clé API nécessite le niveau d'accès Acknowledge).

  Utilisez-le pour faire taire un incident connu qui concerne plusieurs clients sans ouvrir chaque cœur.

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

• fleet pause - Met en pause les appareils, groupes, capteurs ou sondes correspondants sur chaque cœur pour une fenêtre de maintenance ; affiche un aperçu par cœur et n'envoie qu'avec --yes (niveau d'accès Write).

  Utilisez-le avant les nuits de correctifs multi-clients au lieu de mettre en pause dans l'interface web de chaque cœur.

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

• fleet resume - Reprend les objets correspondants sur chaque cœur après la maintenance et déclenche éventuellement une analyse immédiate ; affiche un aperçu par cœur et n'envoie qu'avec --yes (niveau d'accès Write).

  Utilisez-le pour fermer une fenêtre de maintenance chez les clients et confirmer que tout redevient vert.

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

Référence des commandes

ai - Gérer l'IA

• prtg-cli ai aistatus - Retourne si le service PRTG AI Agent est enregistré auprès du Gestionnaire de contrôle des services Windows, s'il est en cours d'exécution
• prtg-cli ai analyze-aiincidents - Analyse les alarmes actuellement actives avec l'IA et retourne les incidents potentiels. Ce point de terminaison est expérimental.

autodiscoveries - Gérer les découvertes automatiques

• prtg-cli autodiscoveries - Retourne une liste de toutes les découvertes automatiques en cours.

autodiscoverytasks - Gérer les tâches de découverte automatique

• prtg-cli autodiscoverytasks delete-auto-discovery-task - Supprime une tâche de découverte automatique donnée. Ce point de terminaison est expérimental.
• prtg-cli autodiscoverytasks get-auto-discovery-task - Retourne une tâche de découverte automatique par son ID. Ce point de terminaison est expérimental.
• prtg-cli autodiscoverytasks list-auto-discovery-task-overview - Retourne une liste d'aperçu de toutes les tâches de découverte automatique. Ce point de terminaison est expérimental.
• prtg-cli autodiscoverytasks modify-auto-discovery-task - Modifie une tâche de découverte automatique. Ce point de terminaison est expérimental.
• prtg-cli autodiscoverytasks start-auto-discovery-task - Démarre une tâche de découverte automatique par son ID. Ce point de terminaison est expérimental.

channels - Gérer les canaux

• prtg-cli channels channels - Retourne une liste de canaux. Ce point de terminaison est expérimental.
• prtg-cli channels get - Retourne les métriques et les paramètres d'un canal.
• prtg-cli channels list - Retourne une liste de canaux. ⚠ Déprécié depuis PRTG 24.3.
• prtg-cli channels list-measurements - Obtient une liste des dernières mesures avec des références aux canaux correspondants. ⚠ Déprécié depuis PRTG 24.3.

core - Enregistrer les cœurs PRTG pour --core et les commandes de flotte

• prtg-cli core add <name> --server <host[:port]> [--tag a,b] [--insecure-tls] - Enregistre (ou met à jour) un cœur ; sa clé va dans PRTG_FLEET_KEYS sous la forme <name>=<key>, jamais sur le disque ; --insecure-tls ignore les vérifications de certificat uniquement pour ce cœur.
• prtg-cli core list - Liste les cœurs enregistrés et indique si chaque variable d'environnement de clé est définie (key_set).
• prtg-cli core remove <name> - Supprime un cœur et efface son miroir local et son cache.

devices - Gérer les appareils

• prtg-cli devices create-sensor - Crée un nouveau capteur dans un appareil. Spécifiez un type de capteur comme 'ping', 'http' ou 'paessler.snmp.traffic_sensor'.
• prtg-cli devices delete - Supprime un appareil avec tous ses capteurs et canaux enfants. Ce point de terminaison est expérimental.
• prtg-cli devices get - Retourne les métriques et les paramètres d'un appareil.
• prtg-cli devices get-icons - Retourne une liste d'icônes d'appareils.
• prtg-cli devices get-templates-experimental - Retourne une liste de modèles d'appareils. Ce point de terminaison est expérimental.
• prtg-cli devices list - Retourne une liste d'appareils. ⚠ Déprécié depuis PRTG 24.3.
• prtg-cli devices list-experimental - Retourne une liste d'appareils. Ce point de terminaison est expérimental.
• prtg-cli devices metascan - Exécute une méta-analyse sur un appareil donné pour un type de capteur donné. Certains capteurs utilisent une méta-analyse pour récupérer des informations importantes
• prtg-cli devices metascan-result - Récupère la progression/le résultat de la méta-analyse. Ce point de terminaison ne prend pas encore en charge tous les types de capteurs.
• prtg-cli devices multi-pause - Met en pause tous les appareils qui correspondent à un filtre.
• prtg-cli devices multi-resume - Reprend tous les appareils qui correspondent à un filtre.
• prtg-cli devices multi-scan-now - Déclenche une analyse de tous les appareils qui correspondent à un filtre.
• prtg-cli devices trigger-autodiscovery - Déclenche la découverte automatique pour un appareil donné. Ce point de terminaison est expérimental.
• prtg-cli devices update - Modifie un appareil.

groups - Gérer les groupes

• prtg-cli groups create-device-for - Crée un nouvel appareil dans un groupe. Ce point de terminaison est expérimental.
• prtg-cli groups create-for - Crée un nouveau groupe dans un groupe. Ce point de terminaison est expérimental.
• prtg-cli groups delete - Supprime un groupe avec tous ses groupes et appareils enfants. Ce point de terminaison est expérimental.
• prtg-cli groups get - Retourne les métriques et les paramètres d'un groupe.
• prtg-cli groups list - Obtient une liste de tous les groupes qui correspondent à un filtre. ⚠ Déprécié depuis PRTG 24.3.
• prtg-cli groups list-experimental - Retourne une liste de groupes. Ce point de terminaison est expérimental.
• prtg-cli groups multi-pause - Met en pause tous les groupes qui correspondent à un filtre.
• prtg-cli groups multi-resume - Reprend tous les groupes qui correspondent à un filtre.
• prtg-cli groups multi-scan-now - Déclenche une analyse de tous les groupes qui correspondent à un filtre.
• prtg-cli groups trigger-autodiscovery - Déclenche la découverte automatique pour un groupe donné. Ce point de terminaison est expérimental.
• prtg-cli groups update - Modifie un groupe.

health - Gérer l'état de santé

• prtg-cli health - Retourne le statut du serveur d'application PRTG.

libraries - Gérer les bibliothèques

• prtg-cli libraries - Retourne une liste de toutes les bibliothèques qui correspondent à un filtre. ⚠ Déprécié depuis PRTG 24.3.

lookup-definitions - Gérer les définitions de recherche

• prtg-cli lookup-definitions get-overview - Retourne une définition de recherche. ⚠ Déprécié depuis PRTG 24.3.100 : Ce point de terminaison fonctionne encore, mais sera remplacé.
• prtg-cli lookup-definitions list - Retourne une liste de définitions de recherche. ⚠ Déprécié depuis PRTG 24.3.

objects - Gérer les objets

• prtg-cli objects count - Retourne une liste du nombre d'objets de chaque type existant.
• prtg-cli objects list - Obtient une liste de toutes les sondes, groupes, appareils et capteurs qui correspondent à un filtre. ⚠ Déprécié depuis PRTG 24.3.
• prtg-cli objects multi-delete - Supprime plusieurs objets en fonction du filtre spécifié. Tous les enfants seront également supprimés. Ce point de terminaison est expérimental.
• prtg-cli objects objects - Retourne une liste de toutes les sondes, groupes, appareils, capteurs et canaux qui correspondent à un filtre.

probe-network - Informations réseau de la sonde

• prtg-cli probe-network <id> - Retourne les informations réseau d'une sonde.

probes - Gérer les sondes

• prtg-cli probes create-auto-discovery-task - Crée une nouvelle tâche de découverte automatique sur une sonde. Ce point de terminaison est expérimental.
• prtg-cli probes create-device-for - Crée un nouvel appareil sur une sonde. Ce point de terminaison est expérimental.
• prtg-cli probes create-group-for - Crée un nouveau groupe dans une sonde. Ce point de terminaison est expérimental.
• prtg-cli probes delete - Supprime une sonde avec tous ses groupes et appareils enfants. Ce point de terminaison est expérimental.
• prtg-cli probes get - Retourne les métriques et les paramètres d'une sonde.
• prtg-cli probes list - Obtient une liste de toutes les sondes qui correspondent à un filtre. ⚠ Déprécié depuis PRTG 24.3.
• prtg-cli probes list-experimental - Retourne une liste de sondes. Ce point de terminaison est expérimental.
• prtg-cli probes multi-pause - Met en pause toutes les sondes qui correspondent à un filtre.
• prtg-cli probes multi-resume - Reprend toutes les sondes qui correspondent à un filtre.
• prtg-cli probes multi-scan-now - Déclenche une analyse de toutes les sondes qui correspondent à un filtre.
• prtg-cli probes update - Modifie une sonde.

schemas - Gérer les schémas

• prtg-cli schemas get - Retourne un schéma OAS à utiliser dans d'autres points de terminaison. ⚠ Déprécié depuis PRTG 24.3.
• prtg-cli schemas get-create-by-parent-id - Retourne un schéma OAS pour une utilisation dans les points de terminaison POST.
• prtg-cli schemas get-kinds-for-parent - Retourne une liste de tous les types d'objets que vous pouvez créer sur un objet parent donné. Ce point de terminaison est expérimental.
• prtg-cli schemas get-read-by-object-id - Retourne un schéma OAS pour une utilisation dans les points de terminaison GET pour un objet spécifique.
• prtg-cli schemas get-update-by-object-id - Retourne un schéma OAS pour une utilisation dans les points de terminaison PATCH.

sensors - Gérer les capteurs

• prtg-cli sensors channels - Retourne les canaux d'un capteur.
• prtg-cli sensors clone - Clone un capteur.
• prtg-cli sensors create-replace - Crée un nouveau capteur ou remplace un capteur existant pour un objet parent. Ce point de terminaison est expérimental.
• prtg-cli sensors delete - Supprime un capteur. Ce point de terminaison est expérimental.
• prtg-cli sensors duplicate - Duplique un capteur.
• prtg-cli sensors get - Retourne les métriques et les paramètres d'un capteur.
• prtg-cli sensors list - Obtient une liste de tous les capteurs qui correspondent à un filtre. ⚠ Déprécié depuis PRTG 24.3.
• prtg-cli sensors list-experimental - Retourne une liste de capteurs. Ce point de terminaison est expérimental.
• prtg-cli sensors multi-ack - Acquitte tous les capteurs qui correspondent à un filtre.
• prtg-cli sensors multi-pause - Met en pause tous les capteurs qui correspondent à un filtre.
• prtg-cli sensors multi-resume - Reprend tous les capteurs qui correspondent à un filtre.
• prtg-cli sensors multi-scan-now - Déclenche une analyse de tous les capteurs qui correspondent à un filtre.
• prtg-cli sensors pause - Met en pause un capteur.
• prtg-cli sensors replace - Remplace un capteur.
• prtg-cli sensors resume - Reprend un capteur.
• prtg-cli sensors scan-now - Déclenche une analyse d'un capteur.
• prtg-cli sensors set-property - Définit la valeur d'une propriété de capteur.
• prtg-cli sensors simulate-error - Simule une erreur de capteur.
• prtg-cli sensors toggle-maintenance - Active ou désactive le mode maintenance pour un capteur.
• prtg-cli sensors update - Modifie un capteur.

servers - Gérer les serveurs

• prtg-cli servers - Retourne une liste de serveurs.

state - Gérer l'état

• prtg-cli state - Retourne une liste des dernières valeurs d'état de tous les objets de surveillance.
• prtg-cli state history - Retourne les états historiques d'un objet.
• prtg-cli state last - Retourne la dernière valeur d'état d'un objet.

status - Gérer le statut

• prtg-cli status - Retourne le statut du système PRTG, y compris les comptes d'objets pour les sondes, les groupes, les appareils, les capteurs, les notifications, les rapports, les utilisateurs.

tables - Gérer les tables

• prtg-cli tables add - Ajoute une valeur de propriété de table.
• prtg-cli tables delete - Supprime une valeur de propriété de table.
• prtg-cli tables get - Obtient un ou plusieurs enregistrements de table.

users - Gérer les utilisateurs

• prtg-cli users add - Ajoute un utilisateur.
• prtg-cli users delete - Supprime un utilisateur.
• prtg-cli users get-notification-templates - Retourne une liste de modèles de notification.
• prtg-cli users get-passhash - Obtient le hachage du mot de passe d'un utilisateur.
• prtg-cli users sessions - Retourne une liste des sessions utilisateur.
• prtg-cli users update - Modifie un utilisateur.

values - Gérer les valeurs

• prtg-cli values - Retourne les valeurs actuelles d'un canal.
• prtg-cli values history - Retourne les valeurs historiques d'un canal.

Variables d'environnement

Un certain nombre de variables d'environnement peuvent être utilisées pour la configuration.

• PRTG_FLEET_KEYS - nécessaire - Clés API PRTG pour les cœurs de flotte au format nom1=clé1,nom2=clé2, ou un chemin de fichier. Défini par core add, mais peut être modifié manuellement. L'ajout manuel de clés doit utiliser le format nom=clé ; les répétitions sont autorisées, la dernière occurrence prévaut. Peut également être un chemin de fichier (par exemple /path/to/keys.txt).
• PRTG_FLEET_DIR - optionnel - Répertoire pour les magasins hors ligne de la flotte. Par défaut : $HOME/.local/share/prtg-cli (Linux/macOS) ou %LOCALAPPDATA%/prtg-cli (Windows).
• PRTG_FLEET_SYNC_SCHEDULE - optionnel - Programme cron pour la synchronisation automatique (par exemple 0 */2 * * * pour toutes les 2 heures). Pas de synchronisation automatique si non définie.
• PRTG_HOST - VPN/localhost par défaut - Hôte PRTG (remplace le nom d'hôte du schéma).
• PRTG_PASSHASH - OAuth/préféré - Hachage de mot de passe PRTG (alternative aux jetons d'accès).
• PRTG_PORT - 80/443 (par défaut) - Port PRTG.
• PRTG_PROTOCOL - http/https (par défaut) - Protocole PRTG.
• PRTG_TOKEN - Un jeton d'accès PRTG (alternative au hachage de mot de passe).