次の方法で共有

Micrometer を使用して、Spring Cloud Resilience4J サーキット ブレーカーのメトリックを収集する (プレビュー)

  • [アーティクル]

Note

Basic、Standard、Enterprise プランは、2025 年 3 月中旬以降非推奨になり、廃止期間は 3 年間です。 Azure Container Apps に移行することをお勧めします。 詳細については、「Azure Spring Apps の廃止のお知らせ」を参照してください。

Standard 従量課金と専用プランは、2024 年 9 月 30 日以降に非推奨になり、6 か月後に完全にシャットダウンされます。 Azure Container Apps に移行することをお勧めします。 詳細については、「Azure Spring Apps の Standard 従量課金および専用プランを Azure Container Apps に移行する」を参照してください。

この記事の適用対象:✅ Basic/Standard ✅ Enterprise

この記事では、Application Insights の java インプロセス エージェントを使用して、Spring Cloud Resilience4j サーキット ブレーカーのメトリックを収集する方法を示します。 この機能を使用すると、Micrometer を使用して Application Insights から Resilience4j サーキット ブレーカーのメトリックを監視できます。

spring-cloud-circuit-breaker-demo のデモでは、監視のしくみを示します。

前提条件

  • 開発用コンピューターにまだインストールされていない場合は、Git、Maven、Java をインストールします。

アプリをビルドして配置する

サンプル アプリケーションをビルドしてデプロイするには、次の手順を使用します。

  1. 次のコマンドを使い、デモ リポジトリをクローンしてビルドします。

    git clone https://github.com/spring-cloud-samples/spring-cloud-circuitbreaker-demo.git
cd spring-cloud-circuitbreaker-demo && mvn clean package -DskipTests

  1. 次のコマンドを使用して、Azure Spring Apps サービス インスタンスを作成します。

    az spring create \
    --resource-group ${resource-group-name} \
    --name ${Azure-Spring-Apps-instance-name}

  2. 次のコマンドを使って、エンドポイントを含むアプリケーションを作成します。

    az spring app create \
    --resource-group ${resource-group-name} \
    --service ${Azure-Spring-Apps-instance-name} \
    --name resilience4j \
    --assign-endpoint
az spring app create \
    --resource-group ${resource-group-name} \
    --service ${Azure-Spring-Apps-instance-name} \
    --name reactive-resilience4j \
    --assign-endpoint

  3. 次のコマンドを使って、アプリケーションをデプロイします。

    az spring app deploy \
    --resource-group ${resource-group-name} \
    --service ${Azure-Spring-Apps-instance-name} \
    --name resilience4j \
    --env resilience4j.circuitbreaker.instances.backendA.registerHealthIndicator=true \
    --artifact-path ./spring-cloud-circuitbreaker-demo-resilience4j/target/spring-cloud-circuitbreaker-demo-resilience4j-0.0.1-SNAPSHOT.jar
az spring app deploy \
    --resource-group ${resource-group-name} \
    --service ${Azure-Spring-Apps-instance-name} \
    --name reactive-resilience4j \
    --env resilience4j.circuitbreaker.instances.backendA.registerHealthIndicator=true \
    --artifact-path ./spring-cloud-circuitbreaker-demo-reactive-resilience4j/target/spring-cloud-circuitbreaker-demo-reactive-resilience4j-0.0.1-SNAPSHOT.jar

  1. 次のコマンドを使用して、Azure Spring Apps サービス インスタンスを作成します。

    Note

    Azure Spring Apps の Enterprise プラン インスタンスの作成に使われたことがないサブスクリプションの場合は、次のコマンドを実行する必要があります。

    az term accept \
    --publisher vmware-inc 
    --product azure-spring-cloud-vmware-tanzu-2 
    --plan asa-ent-hr-mtr

    az spring create \
    --resource-group ${resource-group-name} \
    --name ${Azure-Spring-Apps-instance-name} \
    --sku Enterprise

  2. 次のコマンドを使って、エンドポイントを含むアプリケーションを作成します。

    az spring app create \
    --resource-group ${resource-group-name} \
    --service ${Azure-Spring-Apps-instance-name} \
    --name resilience4j \
    --assign-endpoint
az spring app create \
    --resource-group ${resource-group-name} \
    --service ${Azure-Spring-Apps-instance-name} \
    --name reactive-resilience4j \
    --assign-endpoint

  3. 次のコマンドを使って、アプリケーションをデプロイします。

    az spring app deploy \
    --resource-group ${resource-group-name} \
    --service ${Azure-Spring-Apps-instance-name} \
    --name resilience4j \
    --env resilience4j.circuitbreaker.instances.backendA.registerHealthIndicator=true \
    --artifact-path ./spring-cloud-circuitbreaker-demo-resilience4j/target/spring-cloud-circuitbreaker-demo-resilience4j-0.0.1-SNAPSHOT.jar
az spring app deploy \
    --resource-group ${resource-group-name} \
    --service ${Azure-Spring-Apps-instance-name} \
    --name reactive-resilience4j \
    --env resilience4j.circuitbreaker.instances.backendA.registerHealthIndicator=true \
    --artifact-path ./spring-cloud-circuitbreaker-demo-reactive-resilience4j/target/spring-cloud-circuitbreaker-demo-reactive-resilience4j-0.0.1-SNAPSHOT.jar

Note

  • Resilience4j に必要な依存関係を含めます。

    <dependency>
    <groupId>io.github.resilience4j</groupId>
    <artifactId>resilience4j-micrometer</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-circuitbreaker-resilience4j</artifactId>
</dependency>

  • コードでは、CircuitBreakerFactory の API を使用する必要があります。これは、 Spring Cloud サーキット ブレーカー スターターを含めるときに自動的に作成される bean として実装されます。 詳細については、「Spring Cloud サーキット ブレーカー」を参照してください。

  • 次の 2 つの依存関係は、Resilient4j パッケージと競合しています。 絶対に含めないでください。

    <dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-sleuth</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-zipkin</artifactId>
</dependency>

ゲートウェイ アプリケーションから提供された URL に移動し、次のようにして spring-cloud-circuit-breaker-demo からエンドポイントにアクセスします。

/get
/delay/{seconds}
/fluxdelay/{seconds}

Azure portal で Resilence4j メトリックを見つける

  1. Azure Spring Apps インスタンスで、ナビゲーション ウィンドウの [Application Insights] を選択し、ページで [Application Insights] を選択します。

    Azure Spring Apps の Application Insights ページを示す Azure portal のスクリーンショット。Application Insights が強調表示されています。

    Note

    Application Insights を有効にしない場合は、Java In-Process エージェントを有効にできます。 詳しくは、「Azure Spring Apps で Application Insights Java インプロセス エージェントを使用する」の「Azure portal を使用した Application Insights の管理」をご覧ください。

  2. resilience4j メトリックのディメンション コレクションを有効にします。 詳しくは、「Application Insights のログベースのメトリックと事前に集計されたメトリック」の「カスタム メトリックのディメンションと事前集計」セクションをご覧ください。

  3. ナビゲーション ウィンドウで、[メトリック] を選択します。 [メトリック] ページには、この手順でグラフを定義するためのドロップダウン メニューとオプションが用意されています。 すべてのグラフについて、 メトリック名前空間 を azure.applicationinsights に設定します。

    Azure portal の Application Insights [メトリック] ページのスクリーンショット。[メトリック名前空間] メニューが開き、azure-applicationinsights オプションが強調表示されています。

  4. [メトリック] を [resilience4j_circuitbreaker_buffered_calls] に設定し、[集計] を [平均] に設定します。

    Azure portal の Application Insights [メトリック] ページのスクリーンショット。サーキット ブレーカー バッファー呼び出しと平均の集計が含まれたグラフが示されています。

  5. [メトリック] を [resilience4j_circuitbreaker_calls] に設定し、[集計] を [平均] に設定します。

    Azure portal の Application Insights [メトリック] ページのスクリーンショット。サーキット ブレーカー呼び出しと平均の集計が含まれたグラフが示されています。

  6. [メトリック] を [resilience4j_circuitbreaker_calls] に設定し、[集計] を [平均] に設定します。[フィルターの追加] を選択し、[名前] を [遅延] に設定します。

    Azure portal の Application Insights [メトリック] ページのスクリーンショット。サーキット ブレーカー呼び出し、平均の集計、待ち時間フィルターが含まれたグラフが示されています。

  7. [メトリック] を [resilience4j_circuitbreaker_calls] に設定し、[集計] を [平均] に設定します。[分割の適用] を選択し、[分割方法] を [種類] に設定します。

    Azure portal の Application Insights [メトリック] ページのスクリーンショット。サーキット ブレーカー呼び出し、平均の集計、分割が含まれたグラフが示されています。

  8. [メトリック] を [resilience4j_circuitbreaker_calls] に設定し、[集計] を [平均] に設定します。[メトリックの追加] を選択し、[メトリック] を [resilience4j_circuitbreaker_buffered_calls] に設定し、[集計] を [平均] に設定します。もう一度 [メトリックの追加] を選択し、[メトリック] を [resilience4j_circuitbreaker_slow_calls] に設定し、[集計] を [平均] に設定します。

    この手順で説明するグラフを含む Application Insights [メトリック] ページを示す Azure portal のスクリーンショット。

  1. Azure Spring Apps インスタンスで、ナビゲーション ウィンドウの [Application Insights] を選び、ページで既定の [Application Insights] を選びます。

    Azure Spring Apps の Application Insights ページを示す Azure portal のスクリーンショット。既定の Application Insights インスタンスが強調表示されています。

    Note

    使用できる既定の Application Insights がない場合は、Java In-Process エージェントを有効にできます。 詳しくは、「Azure Spring Apps で Application Insights Java インプロセス エージェントを使用する」の「Azure portal を使用した Application Insights の管理」をご覧ください。

  2. resilience4j メトリックのディメンション コレクションを有効にします。 詳しくは、「Application Insights のログベースのメトリックと事前に集計されたメトリック」の「カスタム メトリックのディメンションと事前集計」セクションをご覧ください。

  3. ナビゲーション ウィンドウで、[メトリック] を選択します。 [メトリック] ページには、この手順でグラフを定義するためのドロップダウン メニューとオプションが用意されています。 すべてのグラフについて、 メトリック名前空間 を azure.applicationinsights に設定します。

    Azure portal の Application Insights [メトリック] ページのスクリーンショット。[メトリック名前空間] メニューが開き、azure.applicationinsights が強調表示されています。

  4. [メトリック] を [resilience4j_circuitbreaker_buffered_calls] に設定し、[集計] を [平均] に設定します。

    Azure portal の Application Insights [メトリック] ページのスクリーンショット。サーキット ブレーカー バッファー呼び出しと平均の集計が含まれたグラフが示されています。

  5. [メトリック] を [resilience4j_circuitbreaker_calls] に設定し、[集計] を [平均] に設定します。

    Azure portal の Application Insights [メトリック] ページのスクリーンショット。サーキット ブレーカー呼び出しと平均の集計が含まれたグラフが示されています。

  6. [メトリック] を [resilience4j_circuitbreaker_calls] に設定し、[集計] を [平均] に設定します。[フィルターの追加] を選択し、[名前] を [遅延] に設定します。

    Azure portal の Application Insights [メトリック] ページのスクリーンショット。サーキット ブレーカー呼び出し、平均の集計、待ち時間フィルターが含まれたグラフが示されています。

  7. [メトリック] を [resilience4j_circuitbreaker_calls] に設定し、[集計] を [平均] に設定します。[分割の適用] を選択し、[分割方法] を [種類] に設定します。

    Azure portal の Application Insights [メトリック] ページのスクリーンショット。サーキット ブレーカー呼び出し、平均の集計、分割が含まれたグラフが示されています。

  8. [メトリック] を [resilience4j_circuitbreaker_calls] に設定し、[集計] を [平均] に設定します。[メトリックの追加] を選択し、[メトリック] を [resilience4j_circuitbreaker_buffered_calls] に設定し、[集計] を [平均] に設定します。もう一度 [メトリックの追加] を選択し、[メトリック] を [resilience4j_circuitbreaker_slow_calls] に設定し、[集計] を [平均] に設定します。

    この手順で説明するグラフを含む Application Insights [メトリック] ページを示す Azure portal のスクリーンショット。

次のステップ