
# Spring との違い

Actuator は Spring Boot Actuator に従っています。パス、プロパティ、メディアタイプ、JSON は同じです。このページでは、そうでない箇所とその理由を列挙します。

## 使う理由

Actuator はまだ新しく、最初の部分は、ロードバランサー、Kubernetes、運用担当者が最もよく尋ねるもの (ヘルス、情報、マッピング) をカバーしています。その他の違いは Dart から来ています。JMX がなく、サーブレットコンテナがなく、説明すべき `java` のランタイムがありません。

## 例

両者で同じ設定:

```properties
management.endpoints.web.exposure.include=health,info
management.endpoint.health.show-details=when-authorized
management.endpoint.health.probes.enabled=true
```

## 違い

| Spring Boot | ここでは | 理由 |
|---|---|---|
| 約 20 個のエンドポイント (`beans`、`env`、`conditions`、`loggers`、`metrics`、`startup`、`logfile`...) | `health`、`info`、`mappings`。その他は後で。独自のものが三つ: `jsonschemas`、`isolates`、`qps` | 最初の部分 |
| 読み取り、書き込み、削除の操作 | 読み取り操作のみ | |
| HTTP と JMX | HTTP のみ | Dart には JMX がない |
| 別のポートのための `management.server.port` | メインのサーバーのみ。そのため追加のパスは `server:` だけ。管理用の CORS 設定はない | まだ実装されていない |
| `HealthIndicator` と `ReactiveHealthIndicator` | 一つの `HealthIndicator`。その `health()` は `Future` を返せる | Dart の `Future` |
| 例外を投げたインジケーターはリクエストを失敗させる | エラーを詳細とする `DOWN` | |
| グループの一部は、メンバーでなくてもパスで見つかる | メンバーである場合にだけ、グループを通して見つかる | |
| `HealthComponent`、`CompositeHealth`、`SystemHealth` (Spring Boot 3) | Spring Boot 4 の名前: `HealthDescriptor`、`CompositeHealthDescriptor`、`SystemHealthDescriptor` | |
| Java の `File` によるディスク容量 | `df` (Linux、macOS) または .NET の `DriveInfo` (Windows)。どちらもない場所 (iOS、Web) では `UNKNOWN` | `dart:io` にディスクの API がない |
| `java`、`process`、`ssl` の情報コントリビューター | `java` の代わりに `dart`。`process` も `ssl` もない。`os` の値は Dart のもの | |
| Maven や Gradle のプラグインが書く `classpath:META-INF/build-info.properties` | アプリケーションのためにジェネレーターが書く `resources:build-info.properties` (名前とバージョン。時刻なし) | ビルドプラグインがない |
| プラグインが書く `classpath:git.properties` | 自分か CI が書く `resources:git.properties` | |
| Spring MVC または WebFlux の形の `mappings` | WebFlux の形 (`dispatcherHandlers`)。`descriptor` は Dart のシグネチャ。ナビゲーションスターターが `screens` を追加する | Web スターターはサーブレットコンテナではない |
| `management.endpoint.<id>.enabled` (Boot 2 と 3) または `.access` (Boot 3.4 以降) | 両方を読む。`access` が優先される | どちらの世代の設定も動く |
| `EndpointRequest` はパスパターンに一致する | Actuator の Web 層が記録したリクエスト (リクエスト属性) に一致する | ベースパスとマッピングに正確に従う |

## 関連項目

- [spring_boot_actuator](index.md)
- [すべてのプロパティ](properties.md)
- [spring_boot_dart の違い](../spring-boot-dart/differences.md)
