Spring Boot のモニター

Spring Boot センサーのサポートするオペレーティングシステムは、ホストエージェントの要件と一致しており、各ホストエージェントのサポートするオペレーティングシステムセクション（ サポートするオペレーティングシステム Linux など）で確認することができます。

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

サポート方針の詳細については、 センサーのサポート戦略を参照してください。

この技術のために、インスタナはトレースをサポートしています。 詳しくは、 インスツルメンテッド・フレームワークとライブラリを参照のこと。

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

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

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

Spring Boot 2.2.x 以降の場合は、 application.properties ファイルで以下のプロパティを設定し、JMX を有効にする：

spring.jmx.enabled=true
 

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

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

management.endpoints.enabled-by-default=false
 

MBeansを公開するには、 application.properties ファイルで以下のエンドポイントを有効にする：

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

Instana は Spring Boot 管理 MBean org.springframework.boot:type=Endpoint,name=Metrics からメトリクスをクエリします。 セキュリティで保護されたアクチュエータ・エンドポイントの認証やクレデンシャルを設定する必要はありません。

Spring Boot 3.x の場合、 application.properties ファイルに以下のディレクティブがあることを確認する：

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

Spring Boot 2 以降の場合、 Spring Boot Actuator は、 マイクロメーターの依存関係管理と自動設定を提供します。 Spring Boot のバージョンによって、 JVMダッシュボードで利用できる マイクロメーター・メトリクスが異なります。

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

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

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

management.endpoints.web.exposure.exclude=*
 

アプリケーションの設定プロパティを Instana UI に表示する前に、 application.properties ファイルにさらに変更を加える必要があります。 そうでない場合、これらのプロパティは微妙な値のため、 ****** として表示される。 詳細については、 Sanitize Sensitive Valuesを参照してください。

値を常にクリアテキストで表示するには、 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 は build-info.properties ファイルから Spring Boot アプリケーションの名前を取得します。 このファイルは、例えば 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 Plugin Documentation を参照してください。

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

希望の health-interval パラメータを設定するには、値を秒単位で設定する：

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

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

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

各センサーについて、健康シグネチャのキュレーションされた知識ベースは、入ってくるメトリクスに対して継続的に評価され、ユーザーの影響に依存する問題やインシデントを提起するために使用される。

組み込みイベントは、 エンティティの正常性シグネチャの失敗に基づいて問題またはインシデントをトリガーし、 カスタム イベントは、選択したエンティティの個々のメトリックのしきい値に基づいて問題またはインシデントをトリガーします。

Spring Boot センサーの内蔵イベントの詳細については、 内蔵イベントリファレンスを参照。

モニタリングの問題タイプ： springboot_actuator_not_configured

Spring Boot アクチュエーターを設定するには、 Spring Boot アクチュエーターの設定を参照してください。

モニタリングの問題タイプ： springboot_jmx_not_enabled

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