Spring との違い
Actuator は Spring Boot Actuator に従っています。パス、プロパティ、メディアタイプ、JSON は同じです。このページでは、そうでない箇所とその理由を列挙します。
使う理由
Actuator はまだ新しく、最初の部分は、ロードバランサー、Kubernetes、運用担当者が最もよく尋ねるもの (ヘルス、情報、マッピング) をカバーしています。その他の違いは Dart から来ています。JMX がなく、サーブレットコンテナがなく、説明すべき java のランタイムがありません。
例
両者で同じ設定:
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 層が記録したリクエスト (リクエスト属性) に一致する | ベースパスとマッピングに正確に従う |