Servosity/prtg

Skill de PRTG Network Monitor para Claude Code

Prerrequisitos: Instalar la CLI

Esta skill utiliza el binario prtg-cli. Debes verificar que la CLI esté instalada antes de invocar cualquier comando de esta skill. Si falta, instálala primero:

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. Verifica: prtg-cli --version
4. Asegúrate de que ~/.local/bin (macOS / Linux) o %LOCALAPPDATA%\Programs\msp-skills (Windows) esté en $PATH.

El instalador descarga los binarios prtg-cli y prtg-mcp en ~/.local/bin (macOS / Linux) o %LOCALAPPDATA%\Programs\msp-skills (Windows). No registra la skill con tu agente ni escribe configuración de cliente MCP; consulta mcp-install.md para esa conexión.

Si --version informa "command not found" después de la instalación, el entorno de ejecución no puede ver el directorio de binarios en $PATH. No continúes con los comandos de la skill hasta que la verificación tenga éxito.

Registra cada núcleo PRTG de cada cliente una vez con 'core add', luego ejecuta 'fleet alarms', 'fleet status', 'fleet handoff' o 'fleet drift' para ver todos los núcleos a la vez, y 'fleet ack', 'fleet pause' y 'fleet resume' para actuar sobre todos con una vista previa primero. Cada operación v2 también es un comando tipado que puedes apuntar a un solo núcleo con --core.

Cuándo usar esta CLI

Usa esta CLI cuando un agente necesite datos o acciones de monitoreo de PRTG, especialmente en varios núcleos PRTG (uno por cliente MSP) registrados con 'core add': alarmas actuales, traspasos de turno, pausas de mantenimiento, reconocimientos e higiene del parque. También expone todas las operaciones de la API v2 de PRTG para un solo núcleo. Los comandos de flota salen con 0 cuando algunos núcleos fallan (esas filas llevan un error) y con código distinto de cero solo cuando todos los núcleos fallan o una acción enviada falla; lee los campos error, action y failed de cada fila. ack, pause y resume solo muestran vista previa hasta que se añade --yes.

Anti-activaciones

No uses esta CLI para:

• No la uses para clústeres PRTG o instalaciones de PRTG Hosted Monitor sin API v2 (Paessler documenta la API v2 como no soportada en clústeres); usa la interfaz web de PRTG o la API HTTP v1 heredada.
• No la uses para editar disparadores de notificaciones, leer el registro de eventos o tickets; la API v2 aún no los expone.
• No la uses para configurar el propio servidor PRTG (instalaciones, actualizaciones, ajustes del núcleo).

Limitaciones conocidas

• fleet alarms, fleet handoff, fleet silenced y fleet drift leen los endpoints de listas tipadas de PRTG (/sensors/alarms, /sensors, /devices, /groups, /probes). Paessler los marca como obsoletos en favor de /experimental/* pero aún los sirve sin versión de eliminación; también funcionan en núcleos anteriores a 24.3. sync lee las mismas listas.
• Los comandos de flota se verificaron contra núcleos simulados, no contra una instalación real de PRTG.
• La API v2 de PRTG no está disponible en clústeres PRTG; el soporte de Hosted Monitor varía según la versión.

Capacidades Únicas

Una vista en todos los núcleos

• fleet alarms - Ve todos los sensores caídos, en advertencia e inusuales en todos los núcleos PRTG de tus clientes en una lista: peor estado primero (caído, advertencia, inusual, reconocido), luego mayor prioridad, luego más antiguo.

  Úsalo al inicio de un turno o cuando te pregunten qué está roto en todos los clientes.

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

• fleet status - Una fila por núcleo cliente con accesibilidad y conteos de sensores por estado, peor primero.

  Úsalo para una vista rápida de salud en todos los clientes antes de profundizar en uno.

  prtg-cli fleet status --agent
  

• fleet handoff - Qué cambió en todos los núcleos desde un punto en el tiempo: nuevas alarmas, recuperaciones y nuevos reconocimientos o pausas con quién y por qué.

  Úsalo para traspasos de turno y preguntas de 'qué pasó anoche'.

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

• fleet silenced - Todo lo que alguien pausó o reconoció en todos los núcleos, con quién, cuándo, hasta cuándo y por qué, marcando los indefinidos dejados demasiado tiempo.

  Úsalo después de ventanas de mantenimiento y en revisiones de higiene semanales para detectar apagones silenciados.

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

• fleet exec - Ejecuta cualquier consulta de solo lectura de la API v2 en todos los núcleos y obtén una tabla fusionada con una columna de núcleo.

  Úsalo para preguntas entre clientes que los comandos de flota dedicados no cubren.

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

Higiene del parque

• fleet drift - Higiene del parque PRTG entre núcleos: versiones atrasadas respecto a tu núcleo más nuevo, licencias o mantenimiento que expiran, uso excesivo de sensores, sondas desconectadas, claves API rechazadas y servidores inaccesibles.

  Úsalo para la revisión semanal del parque en lugar de una hoja de cálculo mantenida a mano.

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

• fleet sync - Actualiza el espejo fuera de línea de cada núcleo registrado en una sola ejecución, cada uno en su propio almacén aislado.

  Ejecútalo antes de búsquedas fuera de línea o análisis entre clientes, o nocturnamente desde cron.

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

Acciones seguras entre núcleos

• fleet ack - Reconoce sensores caídos coincidentes en todos los núcleos a la vez con un mensaje de ticket; muestra vista previa por núcleo y envía solo con --yes (la clave API necesita el nivel de acceso Acknowledge).

  Úsalo para silenciar un incidente conocido que abarca varios clientes sin abrir cada núcleo.

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

• fleet pause - Pausa dispositivos, grupos, sensores o sondas coincidentes en todos los núcleos para una ventana de mantenimiento; muestra vista previa por núcleo y envía solo con --yes (nivel de acceso Write).

  Úsalo antes de noches de parches multi-cliente en lugar de pausar en la interfaz web de cada núcleo.

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

• fleet resume - Reanuda objetos coincidentes en todos los núcleos después del mantenimiento y opcionalmente dispara un escaneo inmediato; muestra vista previa por núcleo y envía solo con --yes (nivel de acceso Write).

  Úsalo para cerrar una ventana de mantenimiento entre clientes y confirmar que todo vuelve a estar verde.

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

Referencia de Comandos

ai - Gestionar ai

• prtg-cli ai aistatus - Devuelve si el servicio PRTG AI Agent está registrado con el Administrador de Control de Servicios de Windows y si está en ejecución.
• prtg-cli ai analyze-aiincidents - Analiza las alarmas actualmente activas con IA y devuelve incidentes potenciales. Este endpoint es experimental.

autodiscoveries - Gestionar autodescubrimientos

• prtg-cli autodiscoveries - Devuelve una lista de todos los autodescubrimientos en ejecución.

autodiscoverytasks - Gestionar tareas de autodescubrimiento

• prtg-cli autodiscoverytasks delete-auto-discovery-task - Elimina una tarea de autodescubrimiento dada. Este endpoint es experimental.
• prtg-cli autodiscoverytasks get-auto-discovery-task - Devuelve una tarea de autodescubrimiento por el ID de tarea dado. Este endpoint es experimental.
• prtg-cli autodiscoverytasks list-auto-discovery-task-overview - Devuelve una lista de resumen de todas las tareas de autodescubrimiento. Este endpoint es experimental.
• prtg-cli autodiscoverytasks modify-auto-discovery-task - Parchea una tarea de autodescubrimiento. Este endpoint es experimental.
• prtg-cli autodiscoverytasks start-auto-discovery-task - Inicia una tarea de autodescubrimiento por el ID de tarea dado. Este endpoint es experimental.

channels - Gestionar canales

• prtg-cli channels channels - Devuelve una lista de canales. Este endpoint es experimental.
• prtg-cli channels get - Devuelve las métricas y la configuración de un canal.
• prtg-cli channels list - Devuelve una lista de canales. ⚠ Obsoleto a partir de PRTG 24.3.
• prtg-cli channels list-measurements - Obtén una lista de las últimas mediciones con referencias a los canales correspondientes. ⚠ Obsoleto a partir de PRTG 24.3.

core - Registrar núcleos PRTG para --core y los comandos de flota

• prtg-cli core add <name> --server <host[:port]> [--tag a,b] [--insecure-tls] - Registra (o actualiza) un núcleo; su clave va en PRTG_FLEET_KEYS como <name>=<key>, nunca en disco; --insecure-tls omite las comprobaciones de certificado solo para ese núcleo.
• prtg-cli core list - Lista los núcleos registrados y si cada variable de entorno de clave está establecida (key_set).
• prtg-cli core remove <name> - Elimina un núcleo y borra su espejo y caché local.

devices - Gestionar dispositivos

• prtg-cli devices create-sensor - Crea un nuevo sensor en un dispositivo. Especifica un tipo de sensor como 'ping', 'http' o 'paessler.snmp.traffic_sensor'.
• prtg-cli devices delete - Elimina un dispositivo con todos los sensores y canales hijos. Este endpoint es experimental.
• prtg-cli devices get - Devuelve las métricas y la configuración de un dispositivo.
• prtg-cli devices get-icons - Devuelve una lista de iconos de dispositivos.
• prtg-cli devices get-templates-experimental - Devuelve una lista de plantillas de dispositivos. Este endpoint es experimental.
• prtg-cli devices list - Devuelve una lista de dispositivos. ⚠ Obsoleto a partir de PRTG 24.3.
• prtg-cli devices list-experimental - Devuelve una lista de dispositivos. Este endpoint es experimental.
• prtg-cli devices metascan - Ejecuta un meta-escaneo en un dispositivo dado para un tipo de sensor dado. Algunos sensores usan un meta-escaneo para recuperar información importante.
• prtg-cli devices metascan-result - Recupera el progreso/resultado del meta-escaneo. Este endpoint aún no soporta todos los tipos de sensores.
• prtg-cli devices multi-pause - Pausa todos los dispositivos que coinciden con un filtro.
• prtg-cli devices multi-resume - Reanuda todos los dispositivos que coinciden con un filtro.
• prtg-cli devices multi-scan-now - Dispara un escaneo de todos los dispositivos que coinciden con un filtro.
• prtg-cli devices trigger-autodiscovery - Dispara el autodescubrimiento para un dispositivo dado. Este endpoint es experimental.
• prtg-cli devices update - Edita un dispositivo.

groups - Gestionar grupos

• prtg-cli groups create-device-for - Crea un nuevo dispositivo en un grupo. Este endpoint es experimental.
• prtg-cli groups create-for - Crea un nuevo grupo en un grupo. Este endpoint es experimental.
• prtg-cli groups delete - Elimina un grupo con todos los grupos y dispositivos hijos. Este endpoint es experimental.
• prtg-cli groups get - Devuelve las métricas y la configuración de un grupo.
• prtg-cli groups list - Obtén una lista de todos los grupos que coinciden con un filtro. ⚠ Obsoleto a partir de PRTG 24.3.
• prtg-cli groups list-experimental - Devuelve una lista de grupos. Este endpoint es experimental.
• prtg-cli groups multi-pause - Pausa todos los grupos que coinciden con un filtro.
• prtg-cli groups multi-resume - Reanuda todos los grupos que coinciden con un filtro.
• prtg-cli groups multi-scan-now - Dispara un escaneo de todos los grupos que coinciden con un filtro.
• prtg-cli groups trigger-autodiscovery - Dispara el autodescubrimiento para un grupo dado. Este endpoint es experimental.
• prtg-cli groups update - Edita un grupo.

health - Gestionar salud

• prtg-cli health - Devuelve el estado del servidor de aplicaciones PRTG.

libraries - Gestionar librerías

• prtg-cli libraries - Devuelve una lista de todas las librerías que coinciden con un filtro. ⚠ Obsoleto a partir de PRTG 24.3.

lookup-definitions - Gestionar definiciones de búsqueda

• prtg-cli lookup-definitions get-overview - Devuelve una definición de búsqueda. ⚠ Obsoleto a partir de PRTG 24.3.100: Este endpoint aún funciona, pero será reemplazado.
• prtg-cli lookup-definitions list - Devuelve una lista de definiciones de búsqueda. ⚠ Obsoleto a partir de PRTG 24.3.

objects - Gestionar objetos

• prtg-cli objects count - Devuelve una lista de cuántos objetos de cada tipo existen.
• prtg-cli objects list - Obtén una lista de todas las sondas, grupos, dispositivos y sensores que coinciden con un filtro. ⚠ Obsoleto a partir de PRTG 24.3.
• prtg-cli objects multi-delete - Elimina múltiples objetos según el filtro especificado. Todos los hijos también serán eliminados. Este endpoint es experimental.
• prtg-cli objects objects - Devuelve una lista de todas las sondas, grupos, dispositivos, sensores y canales que coinciden con un filtro.

probe-network - Información de red de la sonda

• prtg-cli probe-network <id> - Devuelve la información de red de una sonda.

probes - Gestionar sondas

• prtg-cli probes create-auto-discovery-task - Crea una nueva tarea de autodescubrimiento en una sonda. Este endpoint es experimental.
• prtg-cli probes create-device-for - Crea un nuevo dispositivo en una sonda. Este endpoint es experimental.
• prtg-cli probes create-group-for - Crea un nuevo grupo en una sonda. Este endpoint es experimental.
• prtg-cli probes delete - Elimina una sonda con todos los grupos y dispositivos hijos. Este endpoint es experimental.
• prtg-cli probes get - Devuelve las métricas y la configuración de una sonda.
• prtg-cli probes list - Obtén una lista de todas las sondas que coinciden con un filtro. ⚠ Obsoleto a partir de PRTG 24.3.
• prtg-cli probes list-experimental - Devuelve una lista de sondas. Este endpoint es experimental.
• prtg-cli probes multi-pause - Pausa todas las sondas que coinciden con un filtro.
• prtg-cli probes multi-resume - Reanuda todas las sondas que coinciden con un filtro.
• prtg-cli probes multi-scan-now - Dispara un escaneo de todas las sondas que coinciden con un filtro.
• prtg-cli probes update - Edita una sonda.

schemas - Gestionar esquemas

• prtg-cli schemas get - Devuelve un esquema OAS para usar en otros endpoints. ⚠ Obsoleto a partir de PRTG 24.3.
• prtg-cli schemas get-create-by-parent-id - Devuelve un esquema OAS para usar en endpoints POST.
• prtg-cli schemas get-kinds-for-parent - Devuelve una lista de todos los tipos de objetos que puedes crear en un objeto padre dado. Este endpoint es experimental.
• prtg-cli schemas get-read-by-object-id - Devuelve un esquema OAS para usar en endpoints GET para un objeto específico.
• prtg-cli schemas get-update-by-object-id - Devuelve un esquema OAS para usar en endpoints PATCH para un objeto específico.

schedules - Gestionar horarios

• prtg-cli schedules list - Devuelve una lista de todos los horarios. ⚠ Obsoleto a partir de PRTG 24.3.

sensors - Gestionar sensores

• prtg-cli sensors add - Añade un nuevo sensor a un dispositivo existente. Debes especificar una plantilla de sensor o proporcionar tipos de sensores.
• prtg-cli sensors delete - Elimina un sensor y su(s) canal(es).
• prtg-cli sensors get - Devuelve las métricas y la configuración de un sensor.
• prtg-cli sensors list - Devuelve una lista de sensores. ⚠ Obsoleto a partir de PRTG 24.3.
• prtg-cli sensors list-experimental - Devuelve una lista de sensores. Este endpoint es experimental.
• prtg-cli sensors multi-pause - Pausa todos los sensores que coinciden con un filtro.
• prtg-cli sensors multi-resume - Reanuda todos los sensores que coinciden con un filtro.
• prtg-cli sensors multi-scan-now - Dispara un escaneo de todos los sensores que coinciden con un filtro.
• prtg-cli sensors pause - Pausa un sensor con un mensaje.
• prtg-cli sensors replace - Reemplaza un sensor con otro de un tipo diferente (por ejemplo, reemplaza un sensor http por un sensor ping).
• prtg-cli sensors resume - Reanuda un sensor.
• prtg-cli sensors scan-now - Dispara un escaneo inmediato de un sensor.
• prtg-cli sensors set - Edita la configuración de un sensor.
• prtg-cli sensors set-custom - Escribe datos personalizados en un sensor.
• prtg-cli sensors simulate-error - Simula un error en un sensor.
• prtg-cli sensors toggle-maintenance - Cambia el estado de mantenimiento para sensores de dispositivo o grupo. No soportado para sensores de sonda.
• prtg-cli sensors update - Edita un sensor.

status - Gestionar estado

• prtg-cli status - Devuelve el estado del servidor principal de PRTG.

tickets - Gestionar tickets

• prtg-cli tickets create - Crea un nuevo ticket en el sistema de tickets integrado. Este endpoint es experimental.
• prtg-cli tickets list - Devuelve una lista de todos los tickets. Este endpoint es experimental.
• prtg-cli tickets messages - Devuelve una lista de todos los mensajes de un ticket. Este endpoint es experimental.

users - Gestionar usuarios

• prtg-cli users get - Recupera el usuario actualmente conectado.
• prtg-cli users list - Lista todos los usuarios.
• prtg-cli users permissions - Devuelve una lista de permisos del usuario.

value - Gestionar valor

• prtg-cli value - Devuelve el valor sin procesar de un sensor.

Flag Global Obligatorio

Muchos comandos en esta skill documentan --agent. Este flag es obligatorio para que los comandos de flota y otros comandos de núcleo único funcionen cuando el agente está gestionando un contexto con múltiples clientes. Sin --agent, el CLI rechazará la ejecución. Siempre pasa --agent al final de la línea de comandos.

Variables de Entorno

Configura estas variables de entorno antes de invocar cualquier comando:

Variable	Descripción	Ejemplo
PRTG_FLEET_KEYS	Claves API para todos los núcleos registrados. CRUCIAL.	client1=abc123 client2=def456
PRTG_FLEET_DIR	Directorio para espejos fuera de línea (por defecto ~/.prtg-fleet).	~/.prtg-fleet

PRTG_FLEET_KEYS se debe pasar como variable de entorno, no en un archivo env.

Múltiples claves separadas por espacio.

Nota sobre la Salida de Errores

fleet alarms, fleet status y otros comandos de flota siempre escriben cualquier entrada problemática como filas con un campo error relleno. El código de salida es:

• 0 cuando al menos un núcleo tuvo éxito (algunas filas pueden contener errores).
• >0 cuando cada núcleo falló o una acción de escritura enviada falló.

Después de ejecutar un comando de flota, examina si las filas contienen error o failed. No confíes únicamente en el código de salida.

Soporte de Modo Sin Conexión

El comando fleet sync descarga listas de sensores, dispositivos, grupos, sondas y objetos en un almacén aislado por núcleo dentro de PRTG_FLEET_DIR. Estos espejos fuera de línea luego son leídos por fleet alarms, fleet handoff, fleet silenced y fleet drift solo cuando están disponibles (el CLI retrocede a llamadas activas a la API cuando falta el espejo o está desactualizado).

Para actualizar todos los espejos:

prtg-cli fleet sync --resources sensors,devices,groups,probes,objects --agent

Consejos de Seguridad

1. Claves API: Nunca escribas PRTG_FLEET_KEYS en un archivo de shell o repositorio. Pásala directamente al entorno del agente o usa el gestor de secretos de tu plataforma.
2. TLS: Por defecto prtg-cli verifica certificados. Usa --insecure-tls solo en núcleos de desarrollo o de prueba (configurado por núcleo en core add).
3. Acciones de escritura: fleet ack, fleet pause y fleet resume siempre muestran vista previa primero sin --yes. Audita la vista previa antes de confirmar.
4. Permisos: La clave de cada núcleo necesita el nivel de acceso mínimo para la acción. Acknowledge para reconocer, Write para pausar/reanudar, Read para comandos de solo lectura.

Instalación MCP (Opcional)

Para usar prtg-mcp (que expone estas capacidades a través del Protocolo de Contexto de Modelo de Anthropic) en lugar de la línea de comandos directa, consulta mcp-install.md para instrucciones de instalación del cliente.

Para soporte, informes de errores o sugerencias: usa los issues de GitHub en el repositorio del paquete.