シンプルなUP/DOWNヘルスチェックレスポンス

UPまたはDOWNステータスのみの最小限のヘルスチェックレスポンスを設計します。バイナリの健全/異常シグナルのみが必要な基本的なロードバランサーヘルスチェックに最適です。

Simple Format

詳細な説明

シンプルなヘルスチェックレスポンス

最もシンプルなヘルスチェックレスポンスは、サービスが稼働しているかどうかを示すstatusフィールドのみを返します。

レスポンス形式

{
  "status": "UP"
}

サービスが異常な場合:

{
  "status": "DOWN"
}

HTTPステータスコード

HTTPステータスコードが主要な状態シグナルを伝えます:

ステータス HTTPコード 意味
UP 200 OK サービスは健全
DOWN 503 Service Unavailable サービスは異常

シンプル形式を使用するタイミング

シンプルなレスポンスは以下の場合に最適です:

  • ロードバランサーがHTTPステータスコードのみをチェックする場合(例:AWS ALB、Nginx upstream)
  • 最小限の処理オーバーヘッドで軽量なエンドポイントが必要な場合
  • ヘルスチェックが高頻度(1-5秒ごと)で実行される場合
  • 内部コンポーネントの詳細を外部に公開する必要がない場合

実装例

app.get('/health', (req, res) => {
  const isHealthy = checkBasicHealth();
  res.status(isHealthy ? 200 : 503).json({
    status: isHealthy ? 'UP' : 'DOWN'
  });
});

ほとんどのクラウドロードバランサーやリバースプロキシはHTTPステータスコードのみを必要とするため、外部ヘルスチェックには最も効率的なオプションです。

ユースケース

AWS ALB、GCPロードバランサー、またはNginx upstream設定でのロードバランサーヘルスチェック。ルーティング判断に200/503ステータスコードのみが重要な場合。

試してみる — Health Check Endpoint Designer

フルツールを開く