Monitoring AIops

Monitoring AIops

免責事項：コミュニティが保守するオープンソースプロジェクトです。SolarWinds、Paessler、Zabbix、またはいかなる監視ベンダーとも提携、推奨、支援関係にありません。 SolarWinds、Orion、SWQL、THWACK、PRTG、Paessler、Zabbix は、それぞれの所有者の商標です。MIT ライセンスで提供されています。

1 つのサーバーで、3 つの NOC プラットフォームにわたるネットワーク／インフラ監視をガバナンス付きで実行できます。対象は SolarWinds Orion（SWIS REST + SWQL、ポート 17774、レガシーの 17778 への自動フォールバック付き、HTTP Basic 認証）、Paessler PRTG（Web API、ポート 443/8080、API トークン）、Zabbix 6.x/7.x（/api_jsonrpc.php の JSON-RPC 2.0、API トークン）です。ガバナンスハーネスを内蔵しており、統合監査ログ、ポリシーエンジン、トークン／暴走予算ガード、取り消しトークンの記録、監査証跡上のリスク階層ラベルを備えています。1 つの設定で複数の NOC に対応でき、各ターゲットにはそれぞれの platform を指定します。

このツールの機能

NOC オペレーターが繰り返し確認する質問に答え、その後に行われる書き込みをガードします。

• 定型 SWQL クエリライブラリ — よくある THWACK の質問を、名前付きの検証済みクエリとして収録しています（nodes_down、flapping_interfaces、muted_report、high_cpu_nodes、volumes_full、unmanaged_scheduled）。さらに、それ以外の用途向けに、検証済みの読み取り専用 SWQL パススルー（SELECT のみ）も用意しています。
• アクティブアラートの重複排除／集約 — SolarWinds、PRTG、Zabbix 全体で、インターフェースのフラッピングやノード停止による大量発生を、ほぼ同一のアラートが並ぶ状態にせず、件数をまとめた 1 件のエントリーに集約します（Zabbix の問題については、深刻度 0〜5 のスケールを標準レベルに対応付けます）。
• SolarWinds + PRTG + Zabbix の 3 製品すべてをカバー — 1 つの MCP サーバーで 3 つの NOC すべてに対応します。このすべてをカバーする趣味の MCP ツールは、ほかにありません。
• ガバナンス付き書き込み — ミュート／ミュート解除、メンテナンスウィンドウ（再実行可能な削除による取り消し機能を備えた Zabbix の maintenance.create を含む）、管理対象外への設定／再管理、ノードの削除、PRTG センサーの一時停止／再開に対応します。それぞれが監査され、リスク階層に分類されます。破壊的な操作にはドライラン + 二重確認が必要です。抑制とメンテナンスの書き込みには時間制限があり、終了時刻または継続時間の指定が必要です。

このツールが判断すること／しないこと

読み取りと書き込みを含む NOC 運用を正確かつ効率的に実行し、そのすべてを記録します。書き込みの実行可否を判断することはありません。その判断はエージェント、または接続先のアカウント権限に委ねられます。読み取り専用の監視権限を持つ SolarWinds／PRTG／Zabbix アカウントを与えた場合、書き込みは実際に権限を管理するサーバー側で失敗します。

そのため、読み取り専用スイッチも、ポリシーファイルも、設定が必要な承認ゲートもありません。このツールが保証するのは、何も記録されずに終わることがないという点です。MCP 経由でも CLI 経由でも、すべての呼び出しが ~/.monitoring-aiops/audit.db に監査行として記録されます。破壊的な書き込みでは、実行前の状態も取得し、可能な場合は逆操作を記録します。

各ツールは risk_level を宣言します。テストによって [READ]／[WRITE] のドキュメントタグとの整合性が保たれ、説明的な階層として監査行に記録されます。これにより、レビュー担当者は、ある行が高リスクのノード削除を示すものだと一目で確認できます。これはラベルであり、ゲートではありません。

小型モデルやローカルモデルを実行していますか？ agent-guardrails.md をご覧ください。このツールが代わりに適用するガードレール（プロンプトの予算を使って繰り返し指示する必要はありません）と、残りの指示に使えるすぐに利用可能なシステムプロンプトを記載しています。

機能マトリックス（42 個の MCP ツール）

グループ	プラットフォーム	ツール	数	読み取り／書き込み
SWQL	SolarWinds	swql_library, swql_canned, swql_query	3	読み取り
アラート	すべて	active_alerts（重複排除／集約）	1	読み取り
	すべて	alert_acknowledge	1	書き込み（低）
SolarWinds の状態	SolarWinds	node_status, nodes_list, interface_status, volume_status, application_status, topn, noc_rollup	7	読み取り
SolarWinds の書き込み	SolarWinds	list_events, list_unmanaged, list_muted	3	読み取り
	SolarWinds	mute_alerts, unmute_alerts, schedule_maintenance, remanage_node	4	書き込み（中）
	SolarWinds	unmanage_node, remove_node	2	書き込み（高）
PRTG の読み取り	PRTG	prtg_sensors, prtg_sensor_details, prtg_devices, prtg_groups, prtg_history, prtg_system_status, prtg_alarms	7	読み取り
PRTG の書き込み	PRTG	pause_sensor, resume_sensor, schedule_maintenance_prtg	3	書き込み（中）
Zabbix の読み取り	Zabbix	zabbix_problems, zabbix_hosts, zabbix_hostgroups, zabbix_triggers, zabbix_events, zabbix_item_history, zabbix_maintenances	7	読み取り
Zabbix の書き込み	Zabbix	zabbix_create_maintenance	1	書き込み（中）
	Zabbix	zabbix_delete_maintenance	1	書き込み（高）
取り消し	すべて	undo_list, undo_apply	2	取り消し

CLI では便利な機能の一部を利用できます。42 個すべてのツールは MCP サーバーから利用できます。

クイックスタート

Claude Code プラグインとして

1 回のインストールで、エージェントにスキルと MCP サーバーの両方を導入できます。

/plugin marketplace add AIops-tools/marketplace
/plugin install monitoring-aiops@aiops-tools

MCP サーバーは uv で取得され、このプラグインが宣言する パッケージバージョンに固定されます。そのため、監査ログの各行から、記録を書き込んだ コードをたどることができます。認証情報は引き続き monitoring-aiops init で設定します。 詳細は以下をご覧ください。

OpenClaw プラグインとして

同じバンドルが ClawHub で公開されており、1 回の インストールでスキルと MCP サーバーをまとめて導入できます。

openclaw plugins install clawhub:@zw008/monitoring-aiops
openclaw skills info monitoring-aiops          # expect: Visible to model: yes

その後、OpenClaw ゲートウェイを再起動してプラグインを読み込んでください。MCP サーバーは uv で取得され、このリリースの正確なバージョンに固定されるため、 uvx が PATH 上にある必要があります。uvx がない場合もスキルはインストールされますが、 Visible to model: no と表示されます。認証情報は以下と同じ方法で設定します。

CLI またはスタンドアロン MCP サーバーとして

uv tool install monitoring-aiops          # or: pipx install monitoring-aiops
monitoring-aiops init                     # wizard: pick platform (solarwinds/prtg/zabbix) + store the secret (encrypted)
monitoring-aiops doctor                   # verify config, secrets, connectivity
monitoring-aiops overview                 # NOC summary: platform + active/unacked alerts + top rollup
monitoring-aiops swql library             # list the canned SWQL queries
monitoring-aiops swql canned nodes_down   # run a named canned query

MCP サーバーとして実行する場合（stdio）：

export MONITORING_AIOPS_MASTER_PASSWORD=...   # unlock secrets non-interactively
monitoring-aiops mcp

そのパスワードの保存先：エクスポートした変数は、このシェルが起動するすべての プロセスから読み取り可能で、シェル履歴にも記録されます。共有ホストや長期間稼働する ホストでは、対話型プロンプトを使うか、必要なコマンドの実行中だけシークレットマネージャーから 注入することをおすすめします。

ガバナンス

すべての MCP ツールは、同梱の @governed_tool ハーネスを経由します。

• 監査 — すべての呼び出し（パラメーター、結果、ステータス、所要時間、リスク階層、 承認者、理由）が ~/.monitoring-aiops/audit.db に記録されます（MONITORING_AIOPS_HOME で 保存先を変更できます）。
• 予算／暴走防止ガード — トークン数と呼び出し回数の予算により、短い間隔でのポーリングや 再試行が続くループでサーキットブレーカーが作動します。これは安全のためのバックストップであり、 認可機能ではありません。
• リスク階層のラベル付け — 各ツールで宣言された risk_level は、説明用の階層として 監査ログの行に記録されます（ラベルであり、ゲートではありません）。 MONITORING_AUDIT_APPROVED_BY／MONITORING_AUDIT_RATIONALE は任意の監査注釈です。 設定されている場合に記録され、必須ではありません。
• 取り消し記録 — 元に戻せる書き込みでは、逆操作の記述子が記録されます （mute_alerts→unmute、unmanage_node→remanage、pause_sensor→resume、 zabbix_create_maintenance→そのメンテナンス ID の削除）。

対応範囲と制限事項

• プラットフォーム：SolarWinds Orion（SWIS REST + SWQL）、Paessler PRTG（ウェブ API）、および Zabbix 6.x/7.x（JSON-RPC 2.0。6.4+/7.x では Bearer ヘッダーで API トークンを使用し、6.0 では従来の auth フィールドにフォールバックします）。
• Zabbix の対応範囲：問題／トリガー／ホスト／ホストグループ／イベント、範囲を限定したアイテム履歴、メンテナンス期間（作成／削除）、およびクロスプラットフォームの alert_acknowledge によるイベント確認。テンプレート／ディスカバリー／ユーザーの CRUD と trend.get は対象外です。必要な場合はイシューを作成してください。
• **検証状況。**動作は、モックした SWIS/PRTG/Zabbix の応答に対してテストスイートで検証していますが、実稼働の NOC では実行していません（docs/VERIFICATION.md を参照）。**PRTG には API を利用できる無償の永続的な 100 センサー Freeware エディションがあり、Zabbix は完全なオープンソースです（Docker-compose アプライアンスを使えば、10 分で実環境の動作確認ができます）。そのため、これらが最も手軽に実環境で確認できます。SolarWinds は 30 日間のトライアルのみです。トライアル終了後、このツールはモックのみで動作し、これが最大の検証上の課題です。**最も手早く実環境で確認するには、monitoring-aiops doctor を実行します（SolarWinds の場合は SWQL クエリ、PRTG の場合は /api/status.json、Zabbix の場合は認証なしの apiinfo.version と、認証済みのホスト数を確認します）。

必要な機能がありませんか？

別の定型クエリ、プラットフォームの方言の修正、またはまだない機能が必要ですか？イシューまたは PR を作成してください。フィードバックやコントリビューションを歓迎します。