Kubernetesのプローブ3種の使い分けと落とし穴

Kubernetesのプローブ3種の使い分けと落とし穴

Kubernetes にアプリを載せると、コンテナが落ちたときに自動で立ち上げ直してくれます。

ただし、何も設定しなければ、Kubernetes はコンテナの中のプロセスが動いているかどうかしか見ていません。

プロセスは生きているのに応答が止まっている状態や、起動の途中でまだリクエストを受けられない状態は、そのままでは見分けられないのです。

その見分けを担うのがプローブで、liveness・readiness・startup の 3 種類があります。

3 つは名前が似ていますが、失敗したときに Kubernetes が取る動きがそれぞれ違うので、そこを押さえると使い分けにも説明がつきます。

私も DevOps を学んでいる途中なので、Kubernetes の公式ドキュメントと、Google Cloud・AWS が公開しているベストプラクティスをもとに整理しました。

コンテナと Kubernetes そのものの全体像は、先に次の記事でまとめています。

コンテナとKubernetes入門|DevOpsの土台

プローブはkubeletがコンテナを定期的に診断する仕組み

プローブは、各ノードで動くエージェントの kubelet が、コンテナに対して定期的に行う診断です。

kubelet はコンテナの中でコマンドを実行するか、コンテナへネットワーク越しにリクエストを送って結果を確かめます。

結果に応じて、Kubernetes は具合の悪いコンテナを再起動したり、準備のできていないコンテナへトラフィックを送るのを止めたりします。

診断の結果は成功・失敗・不明の 3 つで、不明のときは kubelet は何もせずに次の診断を待つ決まりです。

プローブを設定していないコンテナは、kubelet が常に成功として扱います。

仕組みの説明は、公式ドキュメントの Liveness, Readiness, and Startup Probes にまとまっています。

クラスタの外から利用者と同じ道でサービスを叩く外形監視とは、見ている場所も結果の使い道も違います。

プローブの結果は、人に知らせるためというより、再起動や振り分けといった Kubernetes 自身の動きに使われるものです。

失敗したときの動きは3種類で違う

公式ドキュメントの説明を、失敗したときの動きでそろえると次のようになります。

プローブ確かめること失敗したとき診断する期間
liveness再起動すべき状態かkubelet がコンテナを止め、再起動ポリシーに従って扱う起動後、定期的に
readinessリクエストを受けられるかPod の Ready を false にし、Service の振り分け先から外す起動後、コンテナが動いている間ずっと
startup起動が終わったかkubelet がコンテナを止め、再起動ポリシーに従って扱う起動時だけ(成功したら終わり)

startup プローブを設定すると、それが成功するまで liveness と readiness は実行されません。

readiness が失敗すると、EndpointSlice コントローラーが、その Pod に合うすべての Service の EndpointSlice から Pod の IP アドレスを外します。

このときコンテナは止められず、kubelet は診断を続けます。

3 つの違いを一言でまとめると、止めて立ち上げ直すか、振り分けから外すかの違いです。

確かめ方は4つから選ぶ

どのプローブでも、確かめ方は次の 4 つから 1 つだけを選びます。

  • httpGet は Pod の IP アドレスの指定したポートとパスへ HTTP GET を送り、ステータスコードが 200 以上 400 未満なら成功
  • tcpSocket は指定したポートへ TCP で接続し、ポートが開いていれば成功
  • grpc は gRPC のヘルスチェックを呼び、応答が SERVING なら成功
  • exec はコンテナの中でコマンドを実行し、終了コードが 0 なら成功

Google Cloud のブログでは、HTTP サーバーではないアプリでも、プローブに答えるための軽い HTTP サーバーをアプリの中に置けると紹介されています。

起動待ちと使い分けを決める

プローブの使い分けは、アプリの起動にかかる時間と、どんな故障を再起動で直したいかで決まります。

起動が遅いアプリはstartupプローブで待つ

各プローブには、診断の間隔や失敗の許容回数を決める項目があります。

2026 年 10 月に参照した公式ドキュメントでは、既定値は次のとおりでした。

項目意味既定値
initialDelaySecondsコンテナの起動から最初の診断までの秒数0 秒
periodSeconds診断の間隔10 秒
timeoutSeconds1 回の診断のタイムアウト1 秒
successThreshold失敗のあと成功とみなすまでの連続成功回数(liveness と startup は 1 だけ)1 回
failureThreshold失敗とみなすまでの連続失敗回数3 回

公式ドキュメントは、起動に「initialDelaySeconds + failureThreshold × periodSeconds」より長くかかるコンテナには、startup プローブを足すよう勧めています。

既定値のままなら、0 + 3 × 10 で 30 秒が目安です。

startup プローブには liveness と同じ確かめ先を指定し、failureThreshold を起動の最悪時間をまかなえるだけ大きくします。

公式の手順の例では failureThreshold を 30、periodSeconds を 10 にしていて、起動に最大 300 秒(5 分)まで待てます。

startup が一度成功すると liveness が引き継ぐので、デッドロックへ素早く反応できる liveness の設定はそのまま残せます。

300 秒たっても成功しなければ、コンテナは止められ、再起動ポリシーに従って扱われる仕組みです。

手順は Configure Liveness, Readiness and Startup Probes に載っています。

2018 年の Google Cloud のブログは startup プローブに触れておらず、liveness の initialDelaySeconds に起動時間の p99 を入れるよう勧めていました。

Kubernetes best practices: Setting up health checks with readiness and liveness probes がその記事です。

Readiness vs liveliness probes: How to set them up and when to use them in your Kubernetes cluster | Google Cloud Blog

AWS の EKS ベストプラクティスガイドは、起動時間が読めないときに startup プローブを使い、10 秒で起動すると分かっているなら initialDelaySeconds で足りるとしています。

Amazon EKS Best Practices Guide の Running highly-available applications の Health checks and self-healing の節に書かれています。

3つを並べた設定例

公式ドキュメントの設定項目の説明に載っている例から、プローブの部分を抜き出すと次のようになります。

手元のクラスタでは実行しておらず、書式と値は公式の例のままです。

# 略(apiVersion・metadata・コンテナ名・image)
    ports:
    - containerPort: 8080
    startupProbe:
      httpGet:
        path: /healthz
        port: 8080
      failureThreshold: 30
      periodSeconds: 10
    livenessProbe:
      httpGet:
        path: /healthz
        port: 8080
      initialDelaySeconds: 10
      periodSeconds: 5
      timeoutSeconds: 3
      failureThreshold: 3
    readinessProbe:
      httpGet:
        path: /ready
        port: 8080
      periodSeconds: 5

この例では、liveness と startup が同じ /healthz を見て、readiness だけが /ready という別のパスを見ています。

livenessは再起動で直る故障だけに使う

liveness が向いているのは、プロセスは動いているのに処理が進まない、デッドロックのような状態です。

公式ドキュメントは、具合が悪くなったときに自分で落ちるプロセスなら、liveness は必ずしも要らないとしています。

落ちたコンテナは、liveness が無くても kubelet が再起動ポリシーに従って扱うからです。

よく使われる形として、readiness と同じ軽い HTTP のエンドポイントを使い、liveness の failureThreshold だけを大きくする方法も紹介されています。

こうしておくと、強制的に止められる前に、しばらく not-ready として振り分けから外れる時間ができます。

readinessはトラフィックの入口を開け閉めする

readiness を設定した Pod は、トラフィックを受けずに起動し、診断が成功してから受け始めます。

起動直後だけでなく、一時的な故障や過負荷から戻るまで振り分けを止める用途にも使えます。

AWS のガイドは、ディスクの I/O が激しい間だけ応答できなくなる例を挙げ、Pod を作り直しても解決しない場面で readiness が効くとしています。

公式ドキュメントは、readiness 専用のエンドポイントを用意して、メンテナンスのためにコンテナが自分から振り分けを外れる使い方にも触れていました。

readiness には、デプロイの速さに関わる副作用もあります。

AWS のガイドによると、新しいレプリカは readiness が成功するまでトラフィックを受けないので、その間は古いレプリカが受け続け、Deployment の更新に時間がかかるようになります。

ローリングアップデートなどのデプロイ戦略は、次の記事で整理しました。

ブルーグリーンとカナリアリリース|デプロイ戦略の使い分け

一方で、Pod を削除するときに新しいリクエストを止めるだけなら、readiness は必ずしも要りません。

Pod が削除されると、EndpointSlice の該当エンドポイントの ready が false になり、ロードバランサーは通常のトラフィックにその Pod を使わなくなるからです。

プローブが障害を広げる落とし穴

プローブは自動で直す仕組みなので、設定を誤ると、直すつもりの動きが障害を大きくします。

livenessに外部の依存先を入れない

公式ドキュメントは、liveness の実装を誤ると連鎖的な障害につながると注意しています。

高い負荷の下でコンテナが再起動され、処理できる量が減り、残った Pod にさらに負荷が寄るという流れです。

AWS のガイドは、すべての Pod が同時に liveness に失敗する状況を作らないよう求めています。

データベースのような Pod の外の要素に liveness を依存させると、データベースが応答しないだけで全 Pod のコンテナが再起動の対象になるからです。

再起動されたコンテナも同じ理由で失敗し続け、AWS のガイドはコントロールプレーンにも余計な負荷が掛かると注意しています。

liveness が見るのは、そのコンテナ自身が再起動で直る状態かどうかだけにとどめておきます。

失敗が呼び出しの連鎖で広がる仕組みは、リトライとタイムアウトの記事でも扱っています。

リトライとタイムアウトの設計|カスケード障害を防ぐ

readinessに依存先を入れるかは資料で書き方が違う

readiness に依存先を含めるかどうかは、参照した資料で書き方が分かれていました。

Kubernetes の公式ドキュメントは、バックエンドへの強い依存があるアプリでは、readiness で必要なバックエンドが使えるかも確かめる形を紹介しています。

エラーしか返せない Pod へトラフィックを送らずに済む、というのがその理由です。

AWS のガイドは、データベースのような Pod の外の資源に readiness を依存させないよう勧めています。

全レプリカが同じ基準で確かめているので、データベースに届かなくなると全 Pod の readiness が同時に失敗し、どの Pod にもトラフィックが届かなくなるからです。

どちらを取るにしても、依存先が落ちたときに全 Pod が一斉に外れてよいかは、先に決めておく必要があります。

タイムアウトとexecの負荷を見落とさない

timeoutSeconds の既定は 1 秒なので、負荷が高くて応答が 1 秒を超えると、その回の診断はタイムアウトします。

liveness でこれが failureThreshold の回数だけ続けば、混んでいるだけのコンテナも再起動されてしまいます。

exec は実行のたびに複数のプロセスを作るので、Pod の密度が高く間隔の短いクラスタではノードの CPU に負担が掛かると、公式ドキュメントは注意しています。

AWS のガイドも、exec のコマンドが timeoutSeconds より前に終わらないとノードに defunct のプロセスが溜まり、ノードの障害につながると書いていました。

HTTP の診断では、kubelet は応答の本文を 10KiB までしか読みません。

成否はステータスコードだけで決まりますが、本文が 10KiB を超えるエンドポイントでは kubelet が途中で接続を閉じるので、connection reset や broken pipe のエラーがアプリのログに出ることがあります。

公式ドキュメントは、短い応答を返す専用のエンドポイントを用意するよう強く勧めています。

失敗の跡はイベントと再起動回数に残る

liveness や startup の失敗で再起動が続くと、コンテナは CrashLoopBackOff の状態になります。

kubelet は再起動の間隔を 10 秒、20 秒、40 秒と延ばしていき、上限は既定で 300 秒です。

コンテナが 10 分間問題なく動けば、この間隔は元に戻ります。

再起動の間隔と CrashLoopBackOff については、公式ドキュメントの Pod Lifecycle に説明がありました。

原因を探すときは、kubectl describe pod で Pod のイベントを見ると、「Liveness probe failed」のような失敗の記録と、コンテナを止めた記録が並びます。

kubectl get pod の RESTARTS の列でも、再起動の回数を確かめられます。

最後に

Kubernetes のプローブは liveness・readiness・startup の 3 種類で、失敗したときの動きがそれぞれ違います。

liveness と startup はコンテナを止めて立ち上げ直し、readiness は Service の振り分け先から外すだけです。

起動の遅いアプリには startup プローブで待つ時間を与え、liveness にはコンテナ自身が再起動で直る状態だけを見させます。

プローブを書く前に、失敗したら何が起きてほしいかを決めておくと、どのプローブに何を確かめさせるかも決まります。

以上です。

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

CAPTCHA