isolate

/actuator/isolates は、アプリケーションの isolate と、それぞれがどれだけ働いているかを表示します。JSON になったタスクマネージャーです。Spring Boot にこのようなエンドポイントはありません。

使う理由

遅いサーバーは、計算しているか、待っているかのどちらかです。どちらなのかは行が教えます。計算している isolate は遅れて動き (lagMicros)、働いています (busy)。データベースを待っている isolate は、実行中のリクエストがいくつあっても、どちらでもありません。サーバーの isolate のプール があれば、このエンドポイントは isolate が仕事を分け合っているかどうか、タスク用の isolate が止まっていないかどうかも示します。

例

# lib/resources/application.properties
management.endpoints.web.exposure.include=health,isolates
$ curl localhost:8080/actuator/isolates
{"isolate": "main",
 "isolates": [
  {"name": "main", "kind": "main", "busy": 0.02, "lagMicros": 180,
   "maxLagMicros": 2100, "active": 3, "memory": 96468992,
   "details": {"requests": 18250}},
  {"name": "isolate-1", "kind": "server", "busy": 0.03, "lagMicros": 210,
   "maxLagMicros": 1900, "active": 2, "details": {"requests": 18102}}]}

列挙されるもの

キー 内容
isolate このリクエストに応答した isolate の名前
isolates アプリケーションが知っている isolate ごとに一行

行は isolateLoads Bean のものです (isolate の負荷 を参照)。

行のフィールド 意味
name isolate の名前。ログと同じです
kind main、server、task、engine、tracked、またはソース独自の言葉
busy 働いていた時間の割合。0 から 1 まで
lagMicros イベントループがタイマーをどれだけ遅れて実行したか。直近の数秒間の平均で、単位はマイクロ秒
maxLagMicros その時間の中で最も長い遅れ
active 今取り組んでいるもの: 実行中のリクエスト、実行中のタスク
memory プロセスの常駐メモリー (バイト)。isolate はこれを共有するので、main の行にだけあります
details 一つのソースが追加するもの: requests (その isolate が受け取ったすべて)、refused (サーバーがいっぱいだったため 503 で応答したもの)、タスク用の isolate の tasks と queued

ソースが計測できない数値は省かれます。

計測は最初のリクエストで始まる

誰も問い合わせない間は、何も計測されません。最初のリクエストが計測を始めるので、その応答にはまだ busy も遅れもありません。数秒後にもう一度問い合わせてください。最後のリクエストから 30 秒後に、計測は自動的に止まります。

そのため、10 秒ごとに問い合わせるモニターは 2 回目のリクエストから数値を受け取り、誰も見ていないアプリケーションには何のコストもかかりません。

busy と遅れはプログラムの内側からの推定であり、プロセッサー時間ではありません。それらでわかること、わからないことは isolate の負荷 にあります。

isolate のプールがある場合

リクエストはどの isolate にも届きます。このエンドポイントへのリクエストも同じです。どの isolate が受け取っても、応答は同じです。

公開

このエンドポイントはデフォルトで有効ですが、health 以外のすべてのエンドポイントと同じく、HTTP では公開されません。management.endpoints.web.exposure.include に isolates を追加するか、* を使ってください。

management.endpoints.web.exposure.include=health,isolates

行はサーバーにどれだけ負荷がかかっているかを示します。これは、サーバーを過負荷にしたい人にとって知る価値のある情報です。エンドポイントを保護してください (セキュリティ を参照)。management.endpoint.isolates.access=none で無効にできます。

このエンドポイントは spring_boot_starter_actuator の Bean isolatesEndpoint です。アプリケーションが IsolatesEndpoint を宣言すると、身を引きます。問い合わせは primaryIsolate Bean (ハンドラー isolates.loads) を通じて行われます。最初の isolate に問い合わせる を参照してください。

Spring (Java) との対応

Spring Boot Actuator に対応するものはありません。JVM のスレッドは Bean を共有するからです。最も近いのは threaddump エンドポイントです。

関連項目