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 の負荷 を参照)。
- アプリケーションの最初の isolate である
main。プロセスのメモリーを持ちます。 - Web サーバーのプールの isolate である
isolate-1、…。 - タスクエグゼキューター の isolate である
task-1、…。存在している間だけです。 - アプリケーションが
IsolateLoads.trackで自分で表示するものと、独自のIsolateLoadSourceBean の行。
| 行のフィールド | 意味 |
|---|---|
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 が受け取っても、応答は同じです。
- エンドポイントは、すべての isolate を知っているアプリケーションの最初の isolate に問い合わせます。最初の isolate は他の isolate に数値を問い合わせ、すべての行を応答します。
isolateはリクエストを受け取った isolate の名前です。知っている isolate の名前ではありません。リクエストごとに変わりますが、行はそれに左右されません。- 他の isolate の行は、その問い合わせの時点の新しさです。1 秒以内に応答しない 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 エンドポイントです。