第1章 ヘルスチェックを使用してインスタンスステータスを追跡する


ヘルス REST エンドポイントを呼び出して、インスタンスの起動が完了し、リクエストを処理する準備ができているかどうかを確認します。

Red Hat build of Keycloak には、ヘルスチェックのサポートが組み込まれています。この章では、Red Hat build of Keycloak のヘルスチェックを有効にして使用する方法を説明します。Red Hat build of Keycloak ヘルスチェックは、デフォルトで管理ポート 9000 で公開されます。詳細は、管理インターフェイスの設定 を参照してください。

http-management-health-enabled オプションが false の場合、ヘルスエンドポイントは管理ポートに公開されず、メインの HTTP(S) ポートに残ります。このオプションが false の場合、プロキシーで /health への不要な外部トラフィックをブロックする必要があります。

1.1. Red Hat build of Keycloak のヘルスチェックエンドポイント

Red Hat build of Keycloak は、次の 4 つのヘルスエンドポイントを公開します。

  • /health/live
  • /health/ready
  • /health/started
  • /health

各エンドポイントの意味は、Quarkus SmallRye Health のドキュメント を参照してください。

これらのエンドポイントは、次のような JSON オブジェクトにより、成功した場合は HTTP ステータス 200 OK、失敗した場合は 503 Service Unavailable で応答します。

追加のチェックごとの情報を含まないエンドポイントの成功応答:

{
    "status": "UP",
    "checks": []
}
Copy to Clipboard Toggle word wrap

データベース接続に関する情報を含むエンドポイントの成功応答:

{
    "status": "UP",
    "checks": [
        {
            "name": "Keycloak cluster health check",
            "status": "UP"
        },
        {
            "name": "Keycloak database connections async health check",
            "status": "UP"
        }
    ]
}
Copy to Clipboard Toggle word wrap

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat