
# isolate

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

## 使う理由

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

## 例

```properties
# lib/resources/application.properties
management.endpoints.web.exposure.include=health,isolates
```

```console
$ curl localhost:8080/actuator/isolates
```

```json
{"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 の負荷](../spring-core-dart/isolates/load.md) を参照)。

- アプリケーションの最初の isolate である `main`。プロセスのメモリーを持ちます。
- Web サーバーのプールの isolate である `isolate-1`、…。
- [タスクエグゼキューター](../spring-core-dart/isolates/task-executor.md) の isolate である `task-1`、…。存在している間だけです。
- アプリケーションが `IsolateLoads.track` で自分で表示するものと、独自の `IsolateLoadSource` Bean の行。

| 行のフィールド | 意味 |
|---|---|
| `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 の負荷](../spring-core-dart/isolates/load.md#遅れと-busy-の計測方法) にあります。

## isolate のプールがある場合

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

- エンドポイントは、すべての isolate を知っているアプリケーションの最初の isolate に問い合わせます。最初の isolate は他の isolate に数値を問い合わせ、すべての行を応答します。
- **`isolate` はリクエストを受け取った isolate の名前です**。知っている isolate の名前ではありません。リクエストごとに変わりますが、行はそれに左右されません。
- 他の isolate の行は、その問い合わせの時点の新しさです。1 秒以内に応答しない isolate は、最後の行のままになります。

## 公開

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

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

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

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

## Spring (Java) との対応

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

## 関連項目

- [エンドポイント](endpoints.md)
- [毎秒のリクエスト数](qps.md)
- [セキュリティ](security.md)
- [isolate の負荷](../spring-core-dart/isolates/load.md)
- [最初の isolate に問い合わせる](../spring-core-dart/isolates/primary-isolate.md)
- [isolate のプール](../spring-boot-starter-web/server/isolates.md)
- [Flutter アプリのタスクマネージャー](../spring-boot-starter-flutter/isolates.md)
