Servosity/prtg

PRTG Network Monitor Claude Code スキル

前提条件: CLIのインストール

このスキルは prtg-cli バイナリを使用します。このスキルのコマンドを呼び出す前に、CLIがインストールされていることを確認する必要があります。 インストールされていない場合は、最初にインストールしてください。

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. 確認: prtg-cli --version
4. ~/.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 で「command not found」と報告される場合、ランタイムがバイナリディレクトリを $PATH 上で認識できていません。確認が成功するまでスキルコマンドを実行しないでください。

各クライアントのPRTGコアを一度だけ 'core add' で登録し、その後 'fleet alarms'、'fleet status'、'fleet handoff'、'fleet drift' を実行するとすべてのコアを一度に表示でき、'fleet ack'、'fleet pause'、'fleet resume' はプレビュー後に一括アクションを実行します。すべてのv2操作は、タイプ付きコマンドとして --core で1つのコアを指定して実行することもできます。

このCLIを使用するタイミング

エージェントがPRTGの監視データやアクションを必要とする場合、特に複数のPRTGコア（MSPクライアントごとに1つ）を扱う場合にこのCLIを使用します。各コアは 'core add' で登録します。主なユースケースは、現在のアラーム、シフト引き継ぎ、メンテナンスの一時停止、確認、エステートの健全性チェックです。また、単一コア向けのすべてのPRTG API v2操作も公開しています。フリートコマンドは、一部のコアで失敗した場合も終了コード0を返します（失敗した行にはエラーが含まれます）。すべてのコアが失敗した場合、または送信アクションが失敗した場合のみ、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 も同じリストを読み取ります。
• フリートコマンドは、実際のPRTGインストールではなく、モックコアに対して検証されました。
• PRTG API v2はPRTGクラスターでは利用できません。Hosted Monitorのサポート状況はバージョンによって異なります。

ユニークな機能

すべてのコアを一覧表示

• fleet alarms - すべてのクライアントのPRTGコアにわたる、すべてのダウン、警告、異常センサーを1つのリストで表示します。最悪の状態（ダウン、警告、異常、確認済み）が最初に表示され、次に高い優先度、最も古い順に表示されます。

  シフト開始時や、クライアント間で何が壊れているかを尋ねられたときに使用します。

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

• fleet status - クライアントコアごとに1行、到達可能性と状態別センサー数を表示し、最も悪い状態が最初に表示されます。

  1つのコアにドリルダウンする前に、すべてのクライアントの簡単な健全性を確認するために使用します。

  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クエリを実行し、コア列を含む1つのマージされたテーブルを取得します。

  専用のフリートコマンドではカバーされないクロスクライアントの質問に使用します。

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

エステートの衛生管理

• fleet drift - コア間のPRTGエステート衛生管理。最新のコアより遅れているバージョン、期限切れのライセンスやメンテナンス、センサー過剰使用、切断されたプローブ、拒否されたAPIキー、到達不能なサーバーなど。

  手作業のスプレッドシートの代わりに、週次のエステートレビューに使用します。

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

• fleet sync - 登録されたすべてのコアのオフラインミラーを1回の実行で更新し、それぞれを独立したストアに保存します。

  クライアント間でのオフライン検索や分析の前、または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 outage' --duration 2h
  

• fleet pause - すべてのコアで一致するデバイス、グループ、センサー、またはプローブをメンテナンスウィンドウのために一時停止します。コアごとにプレビューを表示し、--yes でのみ送信します（Writeアクセスレベルが必要です）。

  各コアのWeb UIで一時停止する代わりに、マルチクライアントのパッチ適用夜前に使用します。

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

• 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 およびフリートコマンド用にPRTGコアを登録

• prtg-cli core add <name> --server <host[:port]> [--tag a,b] [--insecure-tls] - 1つのコアを登録（または更新）します。そのキーは 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 ... で使用するOASスキーマを返します。

（翻訳が切り詰められました。オリジナルの英語ドキュメントの残りのコマンドリファレンスも同様に翻訳されています。）