Veeam AIops

Veeam AIops

免責事項：コミュニティによって保守されているオープンソースプロジェクトです。Veeam Software とは提携しておらず、同社の推奨や後援を受けていません。「Veeam」はその所有者の商標です。MIT ライセンスで提供されています。

組み込みのガバナンスハーネスを備えた、AI による Veeam Backup & Replication の運用ツールです。統合監査ログ、ポリシーエンジン、トークン／暴走予算ガード、取り消しトークンの記録、リスクレベルの説明機能を備えています。自己完結型で、httpx と MCP SDK 以外の外部依存関係はありません。Veeam のすべての操作を網羅しているわけではありません。

検証状況：テストスイートはモックベースです。このパッケージは、実稼働中の Veeam B&R サーバーに対してまだ検証されていません。docs/VERIFICATION.mdを参照してください。

動作する機能

• CLI（veeam-aiops ...）：init、overview、job list/get/start/stop/retry/enable/disable、restore list-points/start、repository list/get/state、session list/get/log/stop、backup list/objects/usage/ranking、diagnose job-failures/repo-capacity、infra servers/proxies、secret set/list/rm/migrate/rotate-password、doctor、mcp。
• MCP サーバー（veeam-aiops mcp または veeam-aiops-mcp）：27 個のツール（読み取り 19 個、書き込み 8 個）。すべてに付属の @governed_tool ハーネスが適用されています。
• 診断／RCA（読み取り専用）：diagnose job-failures は最近のジョブセッションをトリアージし、Failed／Warning の実行をすべて検出して、考えられる原因（リポジトリの容量不足、ソース／ゲストに到達不能、認証情報／VSS の失敗、再試行上限への到達）を分類します。セッション結果と一致したエラー部分文字列を根拠として示します。diagnose repo-capacity は、空き容量がしきい値未満（15% 未満で警告、10% 未満で重大）になっているリポジトリを検出します。どちらも、各検出の原因となった測定値を示し、深刻度の高い順に並べます。
• 暗号化された認証情報：パスワードは暗号化ストア ~/.veeam-aiops/secrets.enc（Fernet + scrypt）に保存され、ディスク上に平文で保存されることはありません。MCP／CI では VEEAM_AIOPS_MASTER_PASSWORD から、CLI では対話型プロンプトからマスターパスワードを指定してロックを解除します。
• 可逆性：明確な逆操作がある書き込み操作（ジョブの開始／停止／再試行、有効化／無効化）では、逆操作の取り消し記述子を記録します。取り消し不可能な VM 復元には逆操作がないことを明示し、リスクレベル high を付与します。
• 非同期セッション：Veeam のジョブと復元はセッションとして実行されます。session list／session get／session log で進行状況をポーリングできます（暴走予算ガードにより、ポーリングループの暴走を防ぎます）。

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

このツールは Veeam Backup & Replication の読み取り操作と書き込み操作を正確かつ効率的に実行し、そのすべてを記録します。書き込み操作を許可するかどうかは判断しません。その判断はエージェント、または接続に使用する Veeam アカウントの権限に委ねられます。そのアカウントに VBR サーバー上で読み取り専用または制限付きのロールを付与すると、実際に権限を管理するサーバー側で書き込み操作が拒否されます。

そのため、読み取り専用スイッチも、設定が必要なポリシーファイルや承認ゲートもありません。このツールが保証するのは、何も見えないところで実行されないことです。MCP と CLI のどちらからの呼び出しもすべて ~/.veeam-aiops/audit.db に監査行として記録され、可逆的な書き込み操作では実行前の状態を取得し、逆操作も記録します。

各ツールは risk_level を宣言します。テストにより、ドキュメント内の [READ]／[WRITE] タグと一致することが確認されます。この値は説明用のレベルとして監査行に記録されるため、レビュー担当者は行をひと目見るだけで、リスクの高い復元操作かどうかを確認できます。これはラベルであり、実行を制限するゲートではありません。

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

クイックスタート

Claude Code プラグインとして

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

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

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

OpenClaw プラグインとして

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

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

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

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

uv tool install veeam-aiops
veeam-aiops init        # interactive wizard: connection details + encrypted password
veeam-aiops doctor      # verify config, encrypted store, connectivity

init は ~/.veeam-aiops/config.yaml（秘密情報ではない接続情報）を書き込み、ログインパスワードを 暗号化 して ~/.veeam-aiops/secrets.enc に保存します。生成される設定の例：

targets:
  - name: vbr-lab
    host: 10.0.0.20
    username: "DOMAIN\\backup-admin"
    port: 9419
    verify_ssl: false          # self-signed lab certs only
    timeout: 30                # seconds per request; raise for large estates

大規模な VBR インストール環境では、/jobs と /sessions エンドポイントの処理に、ほかの API よりもはるかに長い時間がかかることがあります。稼働中の 13.1 環境では、リポジトリが 3 秒未満で応答する一方、単一レコードの /jobs クエリは 120 秒以内に応答しませんでした。timeout を設定すると、これらのエンドポイントにより長い時間を割り当てられます。遅いエンドポイントが速くなるわけではありません。延長した時間を超えてもタイムアウトする場合、ボトルネックはこのクライアントではなくエンドポイントにあります。同じことは /backups/{id}/backupFiles にも当てはまります。このエンドポイントは backup ranking がバックアップごとに 1 回読み込みます。123 個のバックアップがある 13.1 環境でランキングを完了するには timeout: 300 が必要でした。タイムアウトしたバックアップは、黙って除外されるのではなく、このアドバイスとともにフラグが付けられます（timedOut）。環境全体の一部をすぐに調べたい場合は、ランキングの対象を絞り込んでください（--backup、--repository）。

対話形式ではない使用（MCP サーバー、CI、cron）では、プロンプトなしでストアのロックを解除できるよう、マスターパスワードをエクスポートしてください。

export VEEAM_AIOPS_MASTER_PASSWORD='your-master-password'

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

シークレットの管理

veeam-aiops secret set vbr-lab            # prompts hidden for the password
veeam-aiops secret list                   # names only, values never shown
veeam-aiops secret rm vbr-lab
veeam-aiops secret rotate-password        # re-encrypt under a new master password
veeam-aiops secret migrate                # import a legacy plaintext .env, then deletes it

古い ~/.veeam-aiops/.env（レガシーな VEEAM_<TARGET>_PASSWORD 変数）から移行しますか？veeam-aiops secret migrate を実行してください。古い .env は .env.migrated に名前が変更されます。移行をスムーズに進められるよう、非推奨の警告付きで、平文の環境変数も引き続きフォールバックとして使用されます。

監査と安全性

すべての操作は、~/.veeam-aiops/ 配下のローカル SQLite 監査データベースに記録されます（VEEAM_AIOPS_HOME で保存場所を変更できます）。このハーネスは記録を行いますが、認可は行いません。MCP と CLI のどちらから呼び出しても、すべての呼び出しが監査ログに記録されます。トークン／暴走予算ガードは安全対策の最後の砦であり（認可ゲートではありません）、停止しないエージェントが無制限に呼び出しを続けるのを防ぎます。また、各行には処理を制限しない、リスクレベルの説明が記載されます。破壊的な CLI コマンド（job stop、restore start）には二重確認が必要で、--dry-run をサポートしています。API が返すテキストには、プロンプトインジェクションを除去するサニタイザーが適用されます。

貢献と機能リクエスト

対象範囲は意図的に絞っています。必要なデバイス、アクション、機能がありませんか？ github.com/AIops-tools/Veeam-AIops で issue を作成するか、プルリクエストをお送りください。機能リクエスト、貢献、コメントを歓迎します。

ライセンス：MIT。