25.3. Eclipse MicroProfile Health を使用したサーバー状態の監視

JBoss EAP には、microprofile-health-smallrye サブシステムを使用して Eclipse MicroProfile Health 機能を提供する SmallRye Health コンポーネントが含まれています。このサブシステムは、JBoss EAP インスタンスが想定どおりに応答しているかどうかを判断するために使用され、デフォルトで有効になっています。

ヘルスチェックは管理 CLI を使用して確認できます。以下のコマンドは、サーバーの現在の状態を取得します。

/subsystem=microprofile-health-smallrye:check
{
    "outcome" => "success",
    "result" => {
        "outcome" => "UP",
        "checks" => []
    }
}

ヘルスチェックは自動的に JBoss EAP の health コンテキストにデプロイされます。そのため、管理 CLI を使用した確認だけでなく、HTTP エンドポイントを使用して現在のヘルス状態を取得することもできます。管理インターフェースからアクセスできる /health エンドポイントのデフォルトアドレスは http://127.0.0.1:9990/health です。

HTTP エンドポイントを使用して、サーバーの現在のヘルス状態を取得するには、以下の URL を使用します。

http://HOST:PORT/health

このコンテキストにアクセスすると、サーバーの状態を示すヘルスチェックが JSON 形式で表示されます。

HTTP エンドポイントの認証の有効化

health コンテキストを設定すると、このコンテキストへのアクセスにユーザーの認証を必要とすることができます。以下の手順は、このエンドポイントで認証を有効にします。

health エンドポイントにアクセスしようとすると、認証プロンプトが表示されるようになります。