💬

AWS App Runner のヘルスチェック設計 〜TCP vs HTTP、どちらを選ぶべきか〜

に公開

AWS App Runner を運用する中で、ヘルスチェックの設計について検討する機会がありました。本記事では、TCP と HTTP ヘルスチェックの違いと、プロダクション環境での推奨設定について解説します。


ヘルスチェックとは

App Runner のヘルスチェックは、アプリケーションの健全性を監視し、問題が発生した際に自動的に復旧させる仕組みです。

ヘルスチェックが失敗すると:

  • 新しいインスタンスが起動される
  • 問題のあるインスタンスへのトラフィックが停止される
  • 自動的にサービスが復旧する

つまり、ヘルスチェックの精度がサービスの可用性に直結します。


TCP vs HTTP ヘルスチェック

App Runner では 2種類のヘルスチェックを選択できます。

TCP ヘルスチェック

App Runner → ポートに接続 → 接続できればOK

メリット:

  • 設定が簡単(エンドポイント実装不要)
  • オーバーヘッドが少ない

デメリット:

  • アプリケーションの状態を確認できない
  • 依存サービスの障害を検知できない

HTTP ヘルスチェック

App Runner → GET /health → ステータスコードで判定

メリット:

  • アプリケーションの状態を確認できる
  • 依存サービスの健全性もチェック可能
  • カスタムロジックを実装できる

デメリット:

  • エンドポイントの実装が必要
  • わずかなオーバーヘッドがある

なぜ HTTP ヘルスチェックを推奨するのか

ケース1: アプリは起動しているが、DBに接続できない

┌─────────────┐     ┌─────────────┐
│   App       │ ──X──│  Database   │
│ (起動済み)   │     │ (障害発生)   │
└─────────────┘     └─────────────┘
ヘルスチェック 結果 実際の状態
TCP ✅ 成功(ポートは開いている) ❌ リクエストはエラー
HTTP ❌ 失敗(DB接続エラーを検知) ❌ リクエストはエラー

TCP の場合: ヘルスチェックは通るが、ユーザーリクエストはエラーになる

ケース2: アプリがデッドロック状態

┌─────────────┐
│   App       │
│ (デッドロック)│
└─────────────┘
ヘルスチェック 結果
TCP ✅ 成功(ポートは開いている)
HTTP ❌ 失敗(タイムアウト)

実装例

FastAPI

from fastapi import FastAPI, HTTPException
import logging

logger = logging.getLogger(__name__)
app = FastAPI()

@app.get("/health")
async def health_check():
    """ヘルスチェック用エンドポイント"""
    try:
        # 依存サービスの接続確認
        check_database_connection()
        check_cache_connection()

        return {"status": "healthy"}
    except Exception as e:
        logger.error(f"Health check failed: {e}")
        raise HTTPException(
            status_code=503,
            detail={"status": "unhealthy", "error": str(e)}
        )

def check_database_connection():
    """DB接続確認(軽量なクエリ)"""
    # db.execute("SELECT 1")
    pass

def check_cache_connection():
    """キャッシュ接続確認"""
    # redis.ping()
    pass

Flask

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/health')
def health_check():
    try:
        # 依存サービスの確認
        check_dependencies()
        return jsonify({"status": "healthy"}), 200
    except Exception as e:
        return jsonify({"status": "unhealthy", "error": str(e)}), 503

Express.js

app.get('/health', async (req, res) => {
  try {
    // 依存サービスの確認
    await checkDatabase();
    res.json({ status: 'healthy' });
  } catch (error) {
    res.status(503).json({ status: 'unhealthy', error: error.message });
  }
});

App Runner の設定

AWS CLI

aws apprunner update-service \
  --service-arn "{service_arn}" \
  --health-check-configuration '{
    "Protocol": "HTTP",
    "Path": "/health",
    "Interval": 10,
    "Timeout": 5,
    "HealthyThreshold": 1,
    "UnhealthyThreshold": 3
  }'

設定パラメータ

パラメータ 推奨値 説明
Protocol HTTP HTTPリクエストで確認
Path /health ヘルスチェック用パス
Interval 10秒 チェック間隔
Timeout 5秒 タイムアウト時間
HealthyThreshold 1 正常判定の連続成功回数
UnhealthyThreshold 3 異常判定の連続失敗回数

/health エンドポイント設計のポイント

1. 軽量に保つ

ヘルスチェックは頻繁に実行されるため、重い処理は避ける。

# ❌ Bad: 重いクエリ
def health_check():
    result = db.execute("SELECT COUNT(*) FROM large_table")
    return {"status": "healthy", "count": result}

# ✅ Good: 軽量なクエリ
def health_check():
    db.execute("SELECT 1")
    return {"status": "healthy"}

2. タイムアウトを考慮

依存サービスへの接続にはタイムアウトを設定する。

client = SomeClient(
    timeout=3  # ヘルスチェックのタイムアウト(5秒)より短く
)

3. 必要な依存のみチェック

すべての依存サービスをチェックする必要はない。サービスの動作に必須なものだけをチェックする。

# ✅ 必須の依存のみチェック
def health_check():
    check_primary_database()  # 必須
    # check_analytics_service()  # 必須ではない
    return {"status": "healthy"}

4. ログを出力

ヘルスチェック失敗時は原因を特定できるようにログを出力する。

except Exception as e:
    logger.error(f"Health check failed: {e}")
    raise HTTPException(status_code=503, ...)

監視との組み合わせ

ヘルスチェックはあくまで「自動復旧」のための仕組みです。監視・アラートと組み合わせることで、より堅牢な運用が可能になります。

┌─────────────────────────────────────────────────┐
│  監視システム(CloudWatch, Datadog等)           │
│  - ヘルスチェック失敗回数の監視                  │
│  - レスポンスタイムの監視                        │
│  - エラーレートの監視                            │
└─────────────────────────────────────────────────┘
                      │
                      ▼ アラート
                 ┌─────────┐
                 │  Slack  │
                 └─────────┘

まとめ

観点 TCP HTTP
実装コスト 低い やや高い
検知精度 低い 高い
依存サービス確認 不可 可能
プロダクション推奨 ❌ ✅

プロダクション環境では HTTP ヘルスチェックを推奨します。

TCPヘルスチェックは「コンテナが起動しているか」しか確認できません。アプリケーションの実際の健全性を確認するには、HTTP ヘルスチェックが必要です。

少しの実装コストで、サービスの可用性と障害検知精度が大きく向上します。

Discussion