Servosity/prtg

Skill do Claude Code para PRTG Network Monitor

Pré-requisitos: Instalar a CLI

Esta skill utiliza o binário prtg-cli. Você deve verificar se a CLI está instalada antes de invocar qualquer comando desta skill. Se estiver faltando, instale-a primeiro:

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. Verifique: prtg-cli --version
4. Certifique-se de que ~/.local/bin (macOS / Linux) ou %LOCALAPPDATA%\Programs\msp-skills (Windows) está no $PATH.

O instalador baixa os binários prtg-cli e prtg-mcp para ~/.local/bin (macOS / Linux) ou %LOCALAPPDATA%\Programs\msp-skills (Windows). Ele não registra a skill com seu agente e não escreve configuração de cliente MCP - veja mcp-install.md para essa configuração.

Se --version relatar "comando não encontrado" após a instalação, o runtime não consegue ver o diretório do binário no $PATH. Não prossiga com os comandos da skill até que a verificação seja bem-sucedida.

Registre cada núcleo PRTG do cliente uma vez com 'core add', depois execute 'fleet alarms', 'fleet status', 'fleet handoff' ou 'fleet drift' para ver todos os núcleos de uma vez, e 'fleet ack', 'fleet pause' e 'fleet resume' para agir sobre eles com uma prévia primeiro. Cada operação v2 também é um comando tipado que você pode direcionar a um núcleo com --core.

Quando Usar Esta CLI

Use esta CLI quando um agente precisar de dados ou ações de monitoramento do PRTG, especialmente em vários núcleos PRTG (um por cliente MSP) registrados com 'core add': alarmes atuais, handoffs de turno, pausas de manutenção, reconhecimentos e higiene do ambiente. Ela também expõe cada operação da API v2 do PRTG para um único núcleo. Comandos de frota saem com código 0 quando alguns núcleos falham (essas linhas carregam um erro) e saem com código diferente de zero apenas quando todos os núcleos falham ou uma ação enviada falha; leia os campos error, action e failed de cada linha. ack, pause e resume apenas mostram prévia até que --yes seja adicionado.

Anti-acionadores

Não use esta CLI para:

• Não use para clusters PRTG ou instalações do PRTG Hosted Monitor sem API v2 (a Paessler documenta a API v2 como não suportada em clusters); use a interface web do PRTG ou a API HTTP legada v1.
• Não use para editar acionadores de notificação, ler o log de eventos ou tickets; a API v2 ainda não os expõe.
• Não use para configurar o próprio servidor PRTG (instalações, atualizações, configurações do núcleo).

Limitações conhecidas

• fleet alarms, fleet handoff, fleet silenced e fleet drift leem os endpoints de lista tipada do PRTG (/sensors/alarms, /sensors, /devices, /groups, /probes). A Paessler os marca como obsoletos em favor de /experimental/*, mas ainda os serve sem uma versão de remoção; eles também funcionam em núcleos mais antigos que 24.3. sync lê as mesmas listas.
• Os comandos de frota foram verificados contra núcleos simulados, não uma instalação PRTG ao vivo.
• A API v2 do PRTG não está disponível em clusters PRTG; o suporte ao Hosted Monitor varia por versão.

Capacidades Únicas

Uma visão em todos os núcleos

• fleet alarms - Veja todos os sensores com status down, warning e unusual em todos os núcleos PRTG dos seus clientes em uma única lista: pior estado primeiro (down, warning, unusual, acknowledged), depois maior prioridade, depois mais antigo.

  Use no início de um turno ou quando perguntado o que está quebrado entre os clientes.

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

• fleet status - Uma linha por núcleo de cliente com acessibilidade e contagens de sensores por estado, pior primeiro.

  Use para uma rápida verificação de saúde entre todos os clientes antes de detalhar um.

  prtg-cli fleet status --agent
  

• fleet handoff - O que mudou em todos os núcleos desde um ponto no tempo: novos alarmes, recuperações e novos reconhecimentos ou pausas com quem e por quê.

  Use para handoffs de turno e perguntas 'o que aconteceu durante a noite'.

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

• fleet silenced - Tudo que alguém pausou ou reconheceu em todos os núcleos, com quem, quando, até quando e por quê, sinalizando os indefinidos que ficaram por muito tempo.

  Use após janelas de manutenção e em revisões semanais de higiene para capturar interrupções silenciadas.

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

• fleet exec - Execute qualquer consulta de API v2 somente leitura em todos os núcleos e obtenha uma tabela mesclada com uma coluna de núcleo.

  Use para perguntas entre clientes que os comandos de frota dedicados não cobrem.

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

Higiene do ambiente

• fleet drift - Higiene do ambiente PRTG entre núcleos: versões atrás do seu núcleo mais recente, licenças ou manutenção expirando, uso excessivo de sensores, probes desconectados, chaves de API rejeitadas e servidores inacessíveis.

  Use para a revisão semanal do ambiente em vez de uma planilha mantida manualmente.

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

• fleet sync - Atualize o espelho offline de cada núcleo registrado em uma única execução, cada um em seu próprio armazenamento isolado.

  Execute antes de pesquisas offline ou análises entre clientes, ou noturnamente a partir do cron.

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

Ações seguras entre núcleos

• fleet ack - Reconheça sensores down correspondentes em todos os núcleos de uma vez com uma mensagem de ticket; mostra prévia por núcleo e envia apenas com --yes (a chave de API precisa do nível de acesso Acknowledge).

  Use para silenciar um incidente conhecido que abrange vários clientes sem abrir cada núcleo.

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

• fleet pause - Pause dispositivos, grupos, sensores ou probes correspondentes em todos os núcleos para uma janela de manutenção; mostra prévia por núcleo e envia apenas com --yes (nível de acesso Write).

  Use antes de noites de patch com vários clientes em vez de pausar na interface web de cada núcleo.

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

• fleet resume - Retome objetos correspondentes em todos os núcleos após a manutenção e opcionalmente acione uma varredura imediata; mostra prévia por núcleo e envia apenas com --yes (nível de acesso Write).

  Use para fechar uma janela de manutenção entre clientes e confirmar que tudo volta ao verde.

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

Referência de Comandos

ai - Gerenciar ai

• prtg-cli ai aistatus - Retorna se o serviço PRTG AI Agent está registrado no Windows Service Control Manager e se está em execução.
• prtg-cli ai analyze-aiincidents - Analisa os alarmes atualmente ativos com IA e retorna incidentes potenciais. Este endpoint é experimental.

autodiscoveries - Gerenciar autodiscoveries

• prtg-cli autodiscoveries - Retorna uma lista de todas as autodescobertas em execução.

autodiscoverytasks - Gerenciar autodiscoverytasks

• prtg-cli autodiscoverytasks delete-auto-discovery-task - Exclui uma tarefa de autodescoberta fornecida. Este endpoint é experimental.
• prtg-cli autodiscoverytasks get-auto-discovery-task - Retorna a tarefa de autodescoberta pelo ID da tarefa fornecido. Este endpoint é experimental.
• prtg-cli autodiscoverytasks list-auto-discovery-task-overview - Retorna uma lista de visão geral de todas as tarefas de autodescoberta. Este endpoint é experimental.
• prtg-cli autodiscoverytasks modify-auto-discovery-task - Altera uma tarefa de autodescoberta. Este endpoint é experimental.
• prtg-cli autodiscoverytasks start-auto-discovery-task - Inicia uma tarefa de autodescoberta pelo ID da tarefa fornecido. Este endpoint é experimental.

channels - Gerenciar canais

• prtg-cli channels channels - Retorna uma lista de canais. Este endpoint é experimental.
• prtg-cli channels get - Retorna as métricas e configurações de um canal.
• prtg-cli channels list - Retorna uma lista de canais. ⚠ Obsoleto desde PRTG 24.3.
• prtg-cli channels list-measurements - Obtenha uma lista das últimas medições com referências aos canais correspondentes. ⚠ Obsoleto desde PRTG 24.3.

core - Registrar núcleos PRTG para --core e os comandos de frota

• prtg-cli core add <name> --server <host[:port]> [--tag a,b] [--insecure-tls] - Registra (ou atualiza) um núcleo; sua chave vai para PRTG_FLEET_KEYS como <name>=<key>, nunca em disco; --insecure-tls ignora verificações de certificado apenas para esse núcleo.
• prtg-cli core list - Lista os núcleos registrados e se cada variável de ambiente de chave está definida (key_set).
• prtg-cli core remove <name> - Remove um núcleo e exclui seu espelho e cache locais.

devices - Gerenciar dispositivos

• prtg-cli devices create-sensor - Cria um novo sensor em um dispositivo. Especifique um tipo de sensor como 'ping', 'http' ou 'paessler.snmp.traffic_sensor'.
• prtg-cli devices delete - Exclui um dispositivo com todos os sensores e canais filhos. Este endpoint é experimental.
• prtg-cli devices get - Retorna as métricas e configurações de um dispositivo.
• prtg-cli devices get-icons - Retorna uma lista de ícones de dispositivos.
• prtg-cli devices get-templates-experimental - Retorna uma lista de modelos de dispositivos. Este endpoint é experimental.
• prtg-cli devices list - Retorna uma lista de dispositivos. ⚠ Obsoleto desde PRTG 24.3.
• prtg-cli devices list-experimental - Retorna uma lista de dispositivos. Este endpoint é experimental.
• prtg-cli devices metascan - Executa uma metavarredura em um dispositivo fornecido para um determinado tipo de sensor. Alguns sensores usam uma metavarredura para recuperar informações importantes.
• prtg-cli devices metascan-result - Recupera o progresso/resultado da metavarredura. Este endpoint ainda não suporta todos os tipos de sensor.
• prtg-cli devices multi-pause - Pausa todos os dispositivos que correspondem a um filtro.
• prtg-cli devices multi-resume - Retoma todos os dispositivos que correspondem a um filtro.
• prtg-cli devices multi-scan-now - Aciona uma varredura de todos os dispositivos que correspondem a um filtro.
• prtg-cli devices trigger-autodiscovery - Aciona a autodescoberta para um dispositivo fornecido. Este endpoint é experimental.
• prtg-cli devices update - Edita um dispositivo.

groups - Gerenciar grupos

• prtg-cli groups create-device-for - Cria um novo dispositivo em um grupo. Este endpoint é experimental.
• prtg-cli groups create-for - Cria um novo grupo dentro de um grupo. Este endpoint é experimental.
• prtg-cli groups delete - Exclui um grupo com todos os grupos e dispositivos filhos. Este endpoint é experimental.
• prtg-cli groups get - Retorna as métricas e configurações de um grupo.
• prtg-cli groups list - Obtenha uma lista de todos os grupos que correspondem a um filtro. ⚠ Obsoleto desde PRTG 24.3.
• prtg-cli groups list-experimental - Retorna uma lista de grupos. Este endpoint é experimental.
• prtg-cli groups multi-pause - Pausa todos os grupos que correspondem a um filtro.
• prtg-cli groups multi-resume - Retoma todos os grupos que correspondem a um filtro.
• prtg-cli groups multi-scan-now - Aciona uma varredura de todos os grupos que correspondem a um filtro.
• prtg-cli groups trigger-autodiscovery - Aciona a autodescoberta para um grupo fornecido. Este endpoint é experimental.
• prtg-cli groups update - Edita um grupo.

health - Gerenciar saúde

• prtg-cli health - Retorna o status do servidor de aplicação PRTG.

libraries - Gerenciar bibliotecas

• prtg-cli libraries - Retorna uma lista de todas as bibliotecas que correspondem a um filtro. ⚠ Obsoleto desde PRTG 24.3.

lookup-definitions - Gerenciar definições de lookup

• prtg-cli lookup-definitions get-overview - Retorna uma definição de lookup. ⚠ Obsoleto desde PRTG 24.3.100: Este endpoint ainda funciona, mas será substituído.
• prtg-cli lookup-definitions list - Retorna uma lista de definições de lookup. ⚠ Obsoleto desde PRTG 24.3.

objects - Gerenciar objetos

• prtg-cli objects count - Retorna uma lista de quantos objetos de cada tipo existem.
• prtg-cli objects list - Obtenha uma lista de todas as probes, grupos, dispositivos e sensores que correspondem a um filtro. ⚠ Obsoleto desde PRTG 24.3.
• prtg-cli objects multi-delete - Exclui vários objetos com base no filtro especificado. Todos os filhos também serão excluídos. Este endpoint é experimental.
• prtg-cli objects objects - Retorna uma lista de todas as probes, grupos, dispositivos, sensores e canais que correspondem a um filtro.

probe-network - Informações de rede da probe

• prtg-cli probe-network <id> - Retorna as informações de rede de uma probe.

probes - Gerenciar probes

• prtg-cli probes create-auto-discovery-task - Cria uma nova tarefa de autodescoberta em uma probe. Este endpoint é experimental.
• prtg-cli probes create-device-for - Cria um novo dispositivo em uma probe. Este endpoint é experimental.
• prtg-cli probes create-group-for - Cria um novo grupo em uma probe. Este endpoint é experimental.
• prtg-cli probes delete - Exclui uma probe com todos os grupos e dispositivos filhos. Este endpoint é experimental.
• prtg-cli probes get - Retorna as métricas e configurações de uma probe.
• prtg-cli probes list - Obtenha uma lista de todas as probes que correspondem a um filtro. ⚠ Obsoleto desde PRTG 24.3.
• prtg-cli probes list-experimental - Retorna uma lista de probes. Este endpoint é experimental.
• prtg-cli probes multi-pause - Pausa todas as probes que correspondem a um filtro.
• prtg-cli probes multi-resume - Retoma todas as probes que correspondem a um filtro.
• prtg-cli probes multi-scan-now - Aciona uma varredura de todas as probes que correspondem a um filtro.
• prtg-cli probes update - Edita uma probe.

schemas - Gerenciar schemas

• prtg-cli schemas get - Retorna um schema OAS para usar em outros endpoints. ⚠ Obsoleto desde PRTG 24.3.
• prtg-cli schemas get-create-by-parent-id - Retorna um schema OAS para uso em endpoints POST.
• prtg-cli schemas get-kinds-for-parent - Retorna uma lista de todos os tipos de objeto que você pode criar em um objeto pai fornecido. Este endpoint é experimental.
• prtg-cli schemas get-read-by-object-id - Retorna um schema OAS para uso em endpoints GET para um objeto específico.
• prtg-cli schemas get-update-by-object-id - Retorna um schema OAS para uso em endpoints PATCH para um objeto específico.
• prtg-cli schemas list - Retorna uma lista de schemas OAS. ⚠ Obsoleto desde PRTG 24.3.

sensors - Gerenciar sensores

• prtg-cli sensors clone - Clona um sensor.
• prtg-cli sensors delete - Exclui um sensor. Este endpoint é experimental.
• prtg-cli sensors get - Retorna as métricas e configurações de um sensor.
• prtg-cli sensors get-channel-list - Retorna a lista de canais de um sensor.
• prtg-cli sensors get-history - Retorna os dados históricos de um sensor.
• prtg-cli sensors get-log - Retorna as entradas de log de um sensor.
• prtg-cli sensors get-tree - Retorna a árvore de objetos de sensor.
• prtg-cli sensors list - Retorna uma lista de sensores. ⚠ Obsoleto desde PRTG 24.3.
• prtg-cli sensors list-alarms - Retorna uma lista de sensores atualmente no estado 'Alarme'. ⚠ Obsoleto desde PRTG 24.3.
• prtg-cli sensors list-changed - Retorna uma lista de sensores alterados desde um determinado timestamp. ⚠ Obsoleto desde PRTG 24.3.
• prtg-cli sensors list-experimental - Retorna uma lista de sensores. Este endpoint é experimental.
• prtg-cli sensors list-sensor-kinds - Retorna tipos de sensor que podem ser adicionados a um dispositivo específico.
• prtg-cli sensors multi-pause - Pausa todos os sensores que correspondem a um filtro.
• prtg-cli sensors multi-resume - Retoma todos os sensores que correspondem a um filtro.
• prtg-cli sensors multi-scan-now - Aciona uma varredura de todos os sensores que correspondem a um filtro.
• prtg-cli sensors pause - Pausa um único sensor.
• prtg-cli sensors reload - Recarrega um sensor.
• prtg-cli sensors resume - Retoma um único sensor.
• prtg-cli sensors scan-now - Aciona uma varredura de um único sensor.
• prtg-cli sensors set-channel-property - Define uma propriedade de canal.
• prtg-cli sensors simulate-error - Simula um erro.
• prtg-cli sensors simulate-value - Simula um valor.
• prtg-cli sensors update - Edita um sensor.