For the complete documentation index, see llms.txt. This page is also available as Markdown.

ヘルスとステータスエンドポイント

Keeper EPMには、サービスの生存確認、プラグインのステータス、システム全体のヘルスを確認する組み込みHTTPエンドポイントがあります。ロードバランサー、アップタイムプローブ、SIEMエージェント、カスタム自動化など既存の監視ツールと組み合わせて、管理対象の各マシンでエージェントが稼働し、想定どおりに動作していることを確認できます。

これらのエンドポイントは、ローカルのKeeperPrivilegeManagerサービスが https://localhost:6889 (HTTPS) または http://localhost:6888 (HTTP) で応答し、localhostにのみバインドされます。コントロールプレーンがネットワーク上に公開されることはありません。

公開エンドポイント

これらのエンドポイントは認証を必要とせず、マシン上の任意のプロセスから呼び出せます。監視システム、ロードバランサーのプローブ、基本的な自動化に適しています。

サービスの生存確認

GET /health

サービスが稼働中であれば 200 OK が返されます。このエンドポイントはすべてのミドルウェアをバイパスするため、もっとも軽量な確認手段であり、高頻度の生存確認プローブ向けに適しています。

レスポンス:

{
  "status": "healthy",
  "timestamp": "2026-06-30T10:30:00Z",
  "version": "1.0.0"
}

例:

curl -k https://localhost:6889/health

サービス情報

基本的なサービス識別情報が返されます。想定したポートで正しいサービスが応答しているかを確認するスモークテストに使えます。

レスポンス:

システムステータス

プラグイン数やジョブ数を含む、サービス全体の集約ステータスが返されます。エージェントが単に稼働しているだけでなく、正常に全体が機能しているかを1回の呼び出しで把握したい場合に使います。

レスポンス:

例:

特権エンドポイント

これらのエンドポイントは、プラグインや監視の詳細データを返し、プラグイン階層または管理用階層の認可が必要です。Keeper EPMが起動したプロセス、または昇格したコンテキスト (Windowsでは管理者、Linux/macOSでは sudo) から呼び出す必要があります。

プラグインステータス

サービスが認識しているすべてのプラグインのステータス (プロセスID、最終起動時刻を含む) が返されます。停止、失敗、欠落しているプラグインを特定するときに使います。

認可: プラグイン

レスポンス:

プラグインヘルスの詳細

監視対象の各プラグインについて、ヘルスステータス (Healthy、Unhealthy、Starting、Stopping、Failed)、プロセスID、稼働時間を含む詳細なヘルス情報が返されます。プロセスの存在ではなく、プラグインのヘルスに基づいてアラートを出したい場合に使います。

認可: プラグイン

レスポンス:

プラグイン監視サービスのステータス

プラグイン監視サービス自体のステータスが返されます。設定されたチェック間隔、最終チェック時刻、現在監視中のプラグインが含まれます。

認可: プラグイン

レスポンス:

サービスとプラグインヘルスの動作

上記のエンドポイントに加え、Keeper EPMには組み込みの自己監視と自動復旧があります。

  • プラグイン監視ループ: サービスはデフォルトで30秒ごとにプラグインプロセスの存在と応答性を確認します。間隔は PluginMonitoring.CheckIntervalMinutes 設定で変更できます。

  • プラグインの自動再起動: 自動再起動が構成されているプラグインは、監視ループが失敗または無応答を検出したときに自動的に再起動されます。

  • サービスの自動復旧: KeeperPrivilegeManagerサービスは、オペレーティングシステムにより障害時に再起動するよう構成されています。Windowsではサービスコントロールマネージャー (15秒の遅延、最大10回)、Linuxではsystemd (Restart=on-failure、15秒の遅延)、macOSではlaunchdです。

このため、一時的なプラグイン障害は多くの場合、管理者の介入なしに解消されます。一方で /api/plugins 上で「Running」と表示されるプラグインが、直近で再起動されている可能性もあります。インシデント調査では lastStartTime フィールドをログデータと照合してください。詳しくはログの確認をご参照ください。

基本的な生存確認: 監視システムから1〜5分ごとに GET /health をポーリングします。200 以外の応答でアラートを出します。

運用上のヘルス: 5分ごとに GET /api/system/status をポーリングします。plugins.runningplugins.total より小さい場合、またはレスポンスを解析できない場合にアラートを出します。

プラグイン単位のアラート: 特権コンテキスト (Keeper EPMが起動したジョブ、または昇格したスケジュールタスク) から5〜15分ごとに GET /api/monitoring/plugins をポーリングします。Healthy 以外のステータスを報告するプラグインがあればアラートを出します。

ロードバランサーのプローブ: GET /health のみを使用します。このエンドポイントはミドルウェアをバイパスし、高頻度かつ低オーバーヘッドのプローブ向けに設計されています。

認証に関する注記

公開エンドポイント (/health//api/system/status) は認証を必要とせず、一般ユーザーの権限で実行したプロセスを含め、マシン上の任意のプロセスから呼び出せます。

特権エンドポイントはプロセスベースの認証を使用します。呼び出しが成功するのは、呼び出し元プロセスが以下のいずれかである場合です。

  • Keeper EPMが起動し、内部のプロセス登録簿で追跡しているプロセス

  • 管理者権限で実行されているプロセス (Windowsでは管理者として実行、Linux/macOSでは sudo)

管理者権限のないターミナルから実行した curl は、特権エンドポイントから 401 Unauthorized を受け取ります。その場で確認する場合は、ターミナルを管理者として実行するか、sudo を使用してください。

最終更新