Application Real-Time Monitoring Service:Micrometer を使用した Java アプリケーションのモニタリング

仕組み

Micrometer は、JVM ベースのアプリケーション向けのメトリック収集ライブラリです。Spring Boot Actuator と組み合わせると、Prometheus テキスト形式で HTTP エンドポイント上にアプリケーションおよび JVM のメトリックを公開します。Alibaba Cloud 上にアプリケーションをデプロイ後、ARMS インテグレーションセンターがこのエンドポイントをスクレイプし、データを Managed Service for Prometheus に格納します。

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

• Spring Boot 2.x を使用して構築された Java アプリケーション

• Container Service for Kubernetes (ACK) または Elastic Compute Service (ECS) 上にアプリケーションがデプロイ済み（またはデプロイ準備完了）であること

手順 1：依存関係の追加と Prometheus エンドポイントの公開

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
    <version>x.y.z</version>
</dependency>

<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-registry-prometheus</artifactId>
    <version>x.y.z</version>
</dependency>

management.server.port=8080
management.endpoints.web.exposure.include=xxx, prometheus

management:
  server:
    port: 8080
  endpoints:
    web:
      exposure:
        include: xxx, prometheus

<dependency>
    <groupId>io.github.mweirauch</groupId>
    <artifactId>micrometer-jvm-extras</artifactId>
    <version>0.2.2</version>
</dependency>

@Bean
public MeterBinder processMemoryMetrics() {
    return new ProcessMemoryMetrics();
}

@Bean
public MeterBinder processThreadMetrics() {
    return new ProcessThreadMetrics();
}

手順 2：ローカルでのメトリックの検証

依存関係を追加し、プロパティを構成した後、アプリケーションを起動して、Prometheus エンドポイントからメトリックが正常に返されるかを検証します。

以下のコマンドを実行します。

curl http://localhost:8080/actuator/prometheus

8080 は、management.server.port で構成したポート番号に置き換えてください。成功した応答には、Prometheus テキスト形式のメトリックが含まれます。

# HELP jvm_memory_used_bytes 使用中のメモリ量
# TYPE jvm_memory_used_bytes gauge
jvm_memory_used_bytes{area="heap",id="G1 Eden Space",} 2.5165824E7
...

エンドポイントから 404 エラーが返された場合は、以下の点を確認してください。

• spring-boot-starter-actuator 依存関係がクラスパス上にあること

• management.endpoints.web.exposure.include プロパティに prometheus が含まれていること

• リクエストで指定したポート番号が management.server.port と一致していること

手順 3：Managed Service for Prometheus へのデプロイと接続

アプリケーションを ACK クラスターまたは ECS インスタンスにデプロイし、ARMS コンソールで Micrometer の統合を構成します。

1. ARMS コンソール にログインします。

2. 左側ナビゲーションウィンドウで、インテグレーションセンター をクリックします。

3. Micrometer コンポーネントを検索します。

   

4. Micrometer パネルの 統合の開始 タブで、以下のパラメーターを構成し、OK をクリックします。

   パラメーター	説明
   環境タイプの選択	アプリケーションが実行される環境です。有効な値： Kubernetes 環境、ECS(VPC)。
   Kubernetes クラスターの選択	アプリケーションが実行される ACK クラスターです。Kubernetes 環境 を選択した場合のみ表示されます。
   ラベル	Micrometer がデプロイされている Pod のラベルです。アプリケーションを識別できる意味のあるラベルを指定してください。
   サービスポート	アプリケーションのポート番号です。デフォルトのポート番号が自動的に入力されます。
   メトリック収集パス	メトリックを公開するエンドポイントです。デフォルトのエンドポイントが自動的に入力されます。
   HTTPS を使用したデータ収集	このスイッチをオンにすると、HTTP ではなく HTTPS 経由でメトリックをスクレイプします。
   メトリックスクレイプ間隔（単位：秒）	メトリックを収集する頻度（秒単位）です。デフォルト値： 30。

手順 4：ダッシュボードの表示

1. ARMS コンソール にログインします。

2. 左側ナビゲーションウィンドウで、統合管理 をクリックします。

3. 統合済み環境 タブで、ご利用の環境名をクリックします。

   

4. コンポーネント管理 タブの アドオンタイプ セクションで、MicroMeter をクリックし、ダッシュボード をクリックします。

   

5. ダッシュボード名をクリックして開きます。

   

手順 5：アラート機能の設定

1. コンポーネント管理 タブの アドオンタイプ セクションで、MicroMeter をクリックし、アラートルール をクリックして、デフォルトのアラートルールを表示します。

2. 要件に応じてカスタムアラートルールを作成します。詳細については、「」をご参照ください。

関連トピック