💬
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