Spring Boot のモニター

Spring Boot センサーの対応OSは、各ホストエージェントの要件と一致しています。これについては、各ホストエージェントの「対応 OS 」セクション（例： Linux ）で確認できます。

以下の表は、最新のサポート対象バージョンとサポート方針を示しています：

サポートポリシーに関する詳細については、 「センサーのサポート戦略」 を参照してください。

この技術において、 Instana はトレース機能をサポートしています。 詳細については、 「計測用フレームワークとライブラリ」 を参照してください。

Spring Boot アクチュエータを設定するには、ファイル pom.xml に以下の依存関係を追加してください：

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
 

Spring Boot アクチュエーターは、実行中の Spring Boot アプリケーションの運用エンドポイントを生成し、公開します。

Spring Boot、 2.2.x 以降では、次のプロパティを `.conf` ファイル application.properties に設定して、 JMX を有効にします

spring.jmx.enabled=true
 

JMX を有効にすると、 Spring Boot アプリケーションのデータやリソースがマネージド・ビーン（MBean）として公開されます。

ファイル application.properties 内で以下の設定によりエンドポイントが無効化されている場合、センサーは Spring Boot アプリケーションからメトリクスを収集するためにMBeansに依存しているため、 Spring Boot 管理用MBeansを公開する必要があります：

management.endpoints.enabled-by-default=false
 

MBean を公開するには、ファイル application.properties 内で以下のエンドポイントを有効にしてください：

management.endpoint.info.enabled=true
management.endpoint.health.enabled=true
management.endpoint.metrics.enabled=true
management.endpoint.env.enabled=true
 

Instana Spring Bootorg.springframework.boot:type=Endpoint,name=Metrics管理MBeanからメトリクスを取得します。 セキュリティ保護されたアクチュエータエンドポイントについては、認証や認証情報の設定を行う必要はありません。

Spring Boot 3.x については、ファイル application.properties 内に以下のディレクティブが記述されていることを確認してください：

management.endpoints.jmx.exposure.include=env,health,info,metrics
 

Spring Boot 2以降では、 Spring Boot Actuatorが Micrometer の依存関係管理と自動設定を提供します。 Spring Boot のバージョンに応じて、 JVM ダッシュボードではさまざまな Micrometer のメトリクスが利用可能です。

HTTP から特定のエンドポイントを除外するには、次のディレクティブを使用します：

management.endpoints.web.exposure.exclude=health,info
 

HTTP からすべてのエンドポイントを除外するには、次のディレクティブを使用します：

management.endpoints.web.exposure.exclude=*
 

Instana のUIにアプリケーションの設定プロパティを表示するには、まずファイル application.properties にさらに変更を加える必要があります。 それ以外の場合、これらのプロパティーは、機密値が原因で ****** として表示されます。 詳細については、 「機密値のサニタイズ」 を参照してください。

値を常に平文で表示するには、 application.properties ファイルで以下の構成を使用します。

management.endpoint.env.show-values=ALWAYS
 

Instana 以下のソースから Spring Boot インスタンスの名前を抽出します：

• spring.application.name プロパティ：アプリケーションの設定でこのプロパティが定義されている場合、その値がアプリケーション名として使用されます。 Spring Boot 3 で、 Spring Boot アプリケーションの名前を指定するには、ファイル application.properties 内のプロパティ spring.application.name を次のように設定します

  spring.application.name=<Your_Application_Name>
   

• build-info.properties ファイル：が定義されていない spring.application.name 場合、 Instana は Spring Bootbuild-info.properties アプリケーションの名前をファイルから取得します。 このファイルは、例えば次のようにして生成できます spring-boot-maven-plugin：

  <plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
      <executable>true</executable>
    </configuration>
    <executions>
      <execution>
        <goals>
          <goal>build-info</goal>
        </goals>
        <configuration>
          <additionalProperties>
            <name>${project.artifactId}</name>
            <version>${project.version}</version>
          </additionalProperties>
        </configuration>
      </execution>
    </executions>
  </plugin>
   

  Actuator との連携に関する詳細については、 Spring Boot の「 Maven 」プラグインのドキュメントを参照してください。

デフォルトで、Instana は管理 MBean org.springframework.boot:type=Endpoint,name=Health を照会することにより、10 分ごとに Spring Boot アプリの正常性を照会します。

目的の health-interval パラメータを設定するには、秒単位で値を設定してください：

com.instana.plugin.springboot:
  health-interval: 30
 

次の例に示すように、agent configuration.yaml ファイル poll_rate 内のパラメータを使用して、 Instana が Spring Boot からデータやメトリクスを収集するためにポーリングを行う頻度を設定できます

com.instana.plugin.springboot:
  poll_rate: 1 # values are in seconds. Default value is 1 second.

Instana Spring Boot このセンサーは、エンドポイントおよび HTTP セッションから以下のメトリクスを収集します：

Instana Spring Boot センサーは、データソースから以下の監視データを収集します：

センサーごとに、ヘルス・シグネチャーのキュレートされた知識ベースが、着信メトリックに対して継続的に評価され、ユーザーの影響に依存する問題またはインシデントを発生させるために使用されます。

組み込みイベントは、エンティティのヘルスシグネチャの異常に基づいて課題やインシデントをトリガーし、 カスタムイベントは、選択されたエンティティの個々のメトリクスのしきい値に基づいて課題やインシデントをトリガーします。

Spring Boot センサーのビルド・イベントについて詳しくは、 組み込みイベントのリファレンスを参照してください。

監視対象の種類： springboot_actuator_not_configured

Spring Boot Actuator を構成するには、 Spring Boot Actuator の構成を参照してください。

監視対象の種類： springboot_jmx_not_enabled

JMX を有効にするには、 「 Spring Boot Actuator の設定」 を参照してください。