PRTG Network Monitor Claude Code 技能
前置条件：安装 CLI
此技能驱动 prtg-cli 二进制程序。在调用此技能的任何命令之前，您必须验证 CLI 是否已安装。 如果缺失，请先安装：
- macOS / Linux:
bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/prtg/install.sh) - Windows (PowerShell):
iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/prtg/install.ps1 | iex - 验证：
prtg-cli --version - 确保
~/.local/bin(macOS / Linux) 或%LOCALAPPDATA%\Programs\msp-skills(Windows) 已添加到$PATH。
安装程序会将 prtg-cli 和 prtg-mcp 二进制程序下载到 ~/.local/bin (macOS / Linux) 或 %LOCALAPPDATA%\Programs\msp-skills (Windows)。它不会向您的代理注册技能，也不会写入任何 MCP 客户端配置 - 请参阅 mcp-install.md 了解如何进行连接。
如果安装后 --version 报告“命令未找到”，则运行时无法在 $PATH 中找到二进制目录。在验证成功之前，不要继续执行技能命令。
使用 core add 注册每个客户的 PRTG 核心一次，然后运行 fleet alarms、fleet status、fleet handoff 或 fleet drift 来同时查看所有核心，以及 fleet ack、fleet pause 和 fleet resume 在预览后跨核心执行操作。每个 v2 操作也是一个类型化命令，您可以通过 --core 将其指向一个核心。
何时使用此 CLI
当代理需要 PRTG 监控数据或操作时，特别是在跨多个 PRTG 核心（每个 MSP 客户一个）的场景下，使用此 CLI：当前警报、班次交接、维护暂停、确认和资产运行状况。它还暴露了单个核心的每个 PRTG API v2 操作。当某些核心失败时（这些行会带有错误信息），fleet 命令以退出码 0 退出，仅当所有核心都失败或发送的操作失败时才以非零退出码退出；请读取每一行的 error、action 和 failed 字段。ack、pause 和 resume 在添加 --yes 之前仅执行预览。
反触发条件
请勿将本 CLI 用于以下场景：
- 请勿将其用于不支持 API v2 的 PRTG 集群或 PRTG Hosted Monitor 安装（Paessler 文档称 API v2 在集群上不受支持）；请使用 PRTG Web 界面或旧版 v1 HTTP API。
- 请勿将其用于编辑通知触发器、读取事件日志或工单；API v2 尚不暴露这些功能。
- 请勿将其用于配置 PRTG 服务器本身（安装、升级、核心设置）。
已知限制
fleet alarms、fleet handoff、fleet silenced和fleet drift读取 PRTG 的类型化列表端点（/sensors/alarms、/sensors、/devices、/groups、/probes）。Paessler 标记它们已弃用，转而使用/experimental/*，但仍然提供服务且未指定移除版本；它们也可以在早于 24.3 版本的核心上工作。sync读取相同的列表。- Fleet 命令已在模拟核心上验证，而非真实的 PRTG 安装。
- PRTG API v2 在 PRTG 集群上不可用；Hosted Monitor 的支持因版本而异。
独特功能
跨所有核心的统一视图
-
fleet alarms- 在一个列表中查看所有客户 PRTG 核心上的所有宕机、警告和异常传感器：最差状态优先（宕机、警告、异常、已确认），然后高优先级，最后最旧。在班次开始时或被问及哪些客户发生故障时使用此命令。
prtg-cli fleet alarms --status down --unacked --agent -
fleet status- 每个客户核心一行，包含可达性和按状态划分的传感器计数，最差状态优先。在深入检查一个核心之前，用它快速了解所有客户的健康状况。
prtg-cli fleet status --agent -
fleet handoff- 自某个时间点以来所有核心上的变化：新警报、恢复、以及新的确认或暂停及其操作者和原因。用于班次交接和“昨晚发生了什么”之类的问题。
prtg-cli fleet handoff --since 12h --agent -
fleet silenced- 所有核心上被暂停或确认的所有内容，包含操作者、时间、截至时间和原因，标记那些搁置过久的无限期事项。在维护窗口之后以及每周运行状况审查中使用，以捕获被静音的停机。
prtg-cli fleet silenced --indefinite --older-than 7d --agent -
fleet exec- 在每个核心上运行任何只读型 API v2 查询，并获取一个带有 core 列的合并表格。用于专用 fleet 命令未涵盖的跨客户问题。
prtg-cli fleet exec /experimental/probes --agent
资产运行状况
-
fleet drift- 跨核心的 PRTG 资产运行状况：相对于最新核心的版本差异、即将过期的许可证或维护、传感器过度使用、断开的探针、被拒绝的 API 密钥以及无法访问的服务器。用于每周资产审查，替代手工维护的电子表格。
prtg-cli fleet drift --within 30d --agent -
fleet sync- 在一次运行中刷新所有注册核心的离线镜像，每个核心进入其独立的隔离存储。在跨客户进行离线搜索或分析之前运行，或从 cron 每晚运行。
prtg-cli fleet sync --resources sensors,devices --agent
跨核心的安全操作
-
fleet ack- 使用工单消息一次性确认所有核心上匹配的宕机传感器；按核心预览，仅在添加--yes时发送（API 密钥需要 Acknowledge 访问级别）。用于静默一个影响多个客户的已知事件，而无需打开每个核心。
prtg-cli fleet ack --filter 'name = "Ping"' --message 'TKT-4411 ISP 中断' --duration 2h -
fleet pause- 在所有核心上暂停匹配的设备、组、传感器或探针以进行维护窗口；按核心预览，仅在添加--yes时发送（需要 Write 访问级别）。在多客户补丁夜之前使用，而不是在每个核心的 Web UI 中逐一暂停。
prtg-cli fleet pause --kind device --filter 'name = "fw01"' --duration 2h --message '补丁夜' -
fleet resume- 在维护后恢复所有核心上的匹配对象，并可选地触发立即扫描；按核心预览，仅在添加--yes时发送（需要 Write 访问级别）。用于跨客户关闭维护窗口，并确认一切恢复正常。
prtg-cli fleet resume --kind device --filter 'name = "fw01"' --scan
命令参考
ai - 管理 AI
prtg-cli ai aistatus- 返回 PRTG AI 代理服务是否已在 Windows 服务控制管理器中注册以及是否正在运行prtg-cli ai analyze-aiincidents- 使用 AI 分析当前活动的警报并返回潜在的事件。此端点为实验性功能。
autodiscoveries - 管理自动发现
prtg-cli autodiscoveries- 返回所有正在运行的自动发现的列表。
autodiscoverytasks - 管理自动发现任务
prtg-cli autodiscoverytasks delete-auto-discovery-task- 删除给定的自动发现任务 此端点为实验性功能。prtg-cli autodiscoverytasks get-auto-discovery-task- 根据给定的任务 ID 返回自动发现任务 此端点为实验性功能。prtg-cli autodiscoverytasks list-auto-discovery-task-overview- 返回所有自动发现任务的概览列表。此端点为实验性功能。prtg-cli autodiscoverytasks modify-auto-discovery-task- 修补自动发现任务 此端点为实验性功能。prtg-cli autodiscoverytasks start-auto-discovery-task- 根据给定的任务 ID 启动自动发现任务 此端点为实验性功能。
channels - 管理通道
prtg-cli channels channels- 返回通道列表。此端点为实验性功能。prtg-cli channels get- 返回通道的指标和设置。prtg-cli channels list- 返回通道列表。⚠ 自 PRTG 24.3 起已弃用。prtg-cli channels list-measurements- 获取最后测量值的列表，并附有对应通道的引用。⚠ 自 PRTG 24.3 起已弃用。
core - 为 --core 和 fleet 命令注册 PRTG 核心
prtg-cli core add <name> --server <host[:port]> [--tag a,b] [--insecure-tls]- 注册（或更新）一个核心；其密钥存储在PRTG_FLEET_KEYS环境变量中作为<name>=<key>，绝不会保存在磁盘上；--insecure-tls仅跳过该核心的证书检查。prtg-cli core list- 列出已注册的核心以及每个密钥环境变量是否已设置 (key_set)。prtg-cli core remove <name>- 移除一个核心并删除其本地镜像和缓存。
devices - 管理设备
prtg-cli devices create-sensor- 在设备中创建新传感器。指定传感器类型，如 'ping'、'http' 或 'paessler.snmp.traffic_sensor'。prtg-cli devices delete- 删除一个设备及其所有子传感器和通道。此端点为实验性功能。prtg-cli devices get- 返回设备的指标和设置。prtg-cli devices get-icons- 返回设备图标的列表。prtg-cli devices get-templates-experimental- 返回设备模板的列表。此端点为实验性功能。prtg-cli devices list- 返回设备列表。⚠ 自 PRTG 24.3 起已弃用。prtg-cli devices list-experimental- 返回设备列表。此端点为实验性功能。prtg-cli devices metascan- 对给定设备执行给定传感器类型的元扫描 某些传感器使用元扫描来检索重要的prtg-cli devices metascan-result- 检索元扫描进度/结果 此端点尚不支持所有传感器类型。prtg-cli devices multi-pause- 暂停所有匹配过滤条件的设备。prtg-cli devices multi-resume- 恢复所有匹配过滤条件的设备。prtg-cli devices multi-scan-now- 触发对所有匹配过滤条件的设备的扫描。prtg-cli devices trigger-autodiscovery- 触发给定设备的自动发现 此端点为实验性功能。prtg-cli devices update- 编辑设备。
groups - 管理组
prtg-cli groups create-device-for- 在组中创建新设备。此端点为实验性功能。prtg-cli groups create-for- 在组中创建新组。此端点为实验性功能。prtg-cli groups delete- 删除一个组及其所有子组和设备。此端点为实验性功能。prtg-cli groups get- 返回组的指标和设置。prtg-cli groups list- 获取所有匹配过滤条件的组的列表。⚠ 自 PRTG 24.3 起已弃用。prtg-cli groups list-experimental- 返回组列表。此端点为实验性功能。prtg-cli groups multi-pause- 暂停所有匹配过滤条件的组。prtg-cli groups multi-resume- 恢复所有匹配过滤条件的组。prtg-cli groups multi-scan-now- 触发对所有匹配过滤条件的组的扫描。prtg-cli groups trigger-autodiscovery- 触发给定组的自动发现 此端点为实验性功能。prtg-cli groups update- 编辑组。
health - 管理运行状况
prtg-cli health- 返回 PRTG 应用服务器的状态。
libraries - 管理库
prtg-cli libraries- 返回所有匹配过滤条件的库的列表。⚠ 自 PRTG 24.3 起已弃用。
lookup-definitions - 管理查找定义
prtg-cli lookup-definitions get-overview- 返回一个查找定义。⚠ 自 PRTG 24.3.100 起已弃用：此端点仍可工作，但将被替换。prtg-cli lookup-definitions list- 返回查找定义的列表。⚠ 自 PRTG 24.3 起已弃用。
objects - 管理对象
prtg-cli objects count- 返回每种对象的数量列表。prtg-cli objects list- 获取所有匹配过滤条件的探针、组、设备和传感器的列表。⚠ 自 PRTG 24.3 起已弃用。prtg-cli objects multi-delete- 基于指定的过滤条件删除多个对象。所有子对象也将被删除。此端点为实验性功能。prtg-cli objects objects- 返回所有匹配过滤条件的探针、组、设备、传感器和通道的列表。
probe-network - 探针网络信息
prtg-cli probe-network <id>- 返回探针的网络信息。
probes - 管理探针
prtg-cli probes create-auto-discovery-task- 在探针上创建新的自动发现任务 此端点为实验性功能。prtg-cli probes create-device-for- 在探针上创建新设备。此端点为实验性功能。prtg-cli probes create-group-for- 在探针中创建新组。此端点为实验性功能。prtg-cli probes delete- 删除一个探针及其所有子组和设备。此端点为实验性功能。prtg-cli probes get- 返回探针的指标和设置。prtg-cli probes list- 获取所有匹配过滤条件的探针的列表。⚠ 自 PRTG 24.3 起已弃用。prtg-cli probes list-experimental- 返回探针列表。此端点为实验性功能。prtg-cli probes multi-pause- 暂停所有匹配过滤条件的探针。prtg-cli probes multi-resume- 恢复所有匹配过滤条件的探针。prtg-cli probes multi-scan-now- 触发对所有匹配过滤条件的探针的扫描。prtg-cli probes update- 编辑探针。
schemas - 管理模式
prtg-cli schemas get- 返回一个 OAS 模式以在其他端点中使用。⚠ 自 PRTG 24.3 起已弃用。prtg-cli schemas get-create-by-parent-id- 返回用于POST端点的 OAS 模式。prtg-cli schemas get-kinds-for-parent- 返回可以在给定父对象上创建的所有对象类型的列表。此端点为实验性功能。prtg-cli schemas get-read-by-object-id- 返回用于特定对象的GET端点的 OAS 模式。prtg-cli schemas get-update-by-object-id- 返回用于PAT
…
[截断以进行翻译]