Loading
Salesforce から送信されるメールは、承認済ドメインからのみとなります続きを読む

Anypoint API Manager: API Analytics の API アラートの変更点と API Key Metrics チャート

公開日: Sep 5, 2025
説明

概要

エンタープライズのお客様に必要な、監視、分析、トラブルシューティングのニーズをサポートするために、API Manager のアラートおよびメトリクスエクスペリエンスは Anypoint Monitoring をサポートする最新のテクノロジースタックに移行します。新しいエクスペリエンスはシンプルで、堅牢で信頼性の高いテクノロジーで支えられています。このドキュメントでは、API アラート、API Key Metrics チャート、および Mule API の API Analytics で必要な変更と影響について説明します。

* 新規のお客様は自動的に Anypoint Monitoring による アラート、Analytics、および Key Metrics を活用してオンボーディングされます。

 

API Manager の機能

Mule API の場合 *既存のお客様

Flex API の場合

APIアラート 

新しいエクスペリエンスの提供

既存のエクスペリエンスへの変更なし 

API Key Metrics 

新しいエクスペリエンスの提供

既存のエクスペリエンスへの変更なし 

API Analytics 

既存の分析エクスペリエンスを Anypoint Monitoring に置き換えることで新しいエクスペリエンスを提供

該当なし

 

この移行は、API Manager とその基盤となる API に次のような影響を与えます。

解決策

API アラート

API アラートの変更は当面延期となりました。アラートで最新のテクノロジースタックを活用するために、API Manager から Anypoint Monitoring にアラートを移行することを強くお勧めします。

 

変更による影響: 
今後も保持する API Manager の API アラートは Anypoint Monitoring で再作成される必要があります。

すべてのお客様にアラートを再作成することをお勧めします。アラートが作成されたら、従来のアラートを削除してください。詳細は、「Anypoint Monitoring と API Manager の違い」を参照してください。

 

変更の詳細については、「Anypoint Monitoring での API アラートの作成または移行」を参照してください。

Anypoint Monitoring での API アラートの作成または移行

従来のテクノロジースタックで作成された API アラートはサポートされなくなります。しかし、API Manager にはアラートエクスペリエンスが引き続き存在し、Anypoint Monitoring の新しい基本 API アラートも API Manager に表示されます。メトリクスを評価し、API アラートを正常に移行するためには、Anypoint Monitoring エージェントが必要です。  

 

  • API アラートの比較

  • Anypoint Monitoring への API アラートの追加

 

移行が完了すると、API Manager の Mule API アラートエクスペリエンスの UI は API Manager の Flex Gateway アラートエクスペリエンスと同様になります。

Anypoint Monitoring と API Manager の違い

 

  • アラートの評価: Anypoint Monitoring は、設定可能な 5 ～ 20 分のルックバック期間を使用して 1 分ごとに API アラートを評価しますが、API Manager では任意のルックバック期間を使用できます。

  • アラートの制限: Anypoint Monitoring では、サブスクリプションのプランに基づいて API アラート数が制限されます。比較については、API アラートの制限 (API Manager) および Anypoint Monitoring アラートの制限を参照してください。

Anypoint Monitoring への API アラートの追加

API Manager に API アラートがある場合、次のいずれかの方法で Anypoint Monitoring をサポートするアラートシステムに移行できます。

  • Anypoint Platform UI からの API アラートの複製

  • API アラートの自動移行の準備

 

重要: API Manager からの自動移行の前に Anypoint Monitoring で作成された API アラートは、Anypoint Monitoring への API アラートの自動移行とほぼ同時に Anypoint Monitoring と API Manager の両方に表示されます。

Anypoint Monitoring UI からの API アラートの作成

 

Anypoint Monitoring で API Manager API アラートを複製するには 

 

  1. API アラートを使用する場合、CloudHub デプロイメントでは Anypoint Monitoring エージェントが有効になっているか、ハイブリッドデプロイメントでは Anypoint Monitoring エージェントがインストールされていることを確認します。詳細は、「Anypoint Monitoring Agent の設定」を参照してください。  

 

  1. API Manager から、無効な API アラートや無効な API アラートを削除します。詳細は、API Manager のドキュメント「API アラートの表示と削除」を参照してください。

  2. 「Anypoint Monitoring の基本アラートのセットアップ」の手順に従い、Anypoint Monitoring で API アラートを複製します。

  3. Anypoint Monitoring で再作成した API Manager API アラートを無効にします。
    これらのアラートを無効にすることは非常に重要です。API アラートを無効にすると、通知の重複が回避され、有効な API アラートの Anypoint Monitoring への自動移行が行われなくなります。

 

  1. API アラートで Anypoint Monitoring の使用を開始します。

API アラートの自動移行の準備

 

アラートの手動移行期間が終了すると、API Manager に残っている有効な API アラートは自動的に Anypoint Monitoring に移行されます。これらの API アラートは、API Manager と Anypoint Monitoring の両方に表示されます。

 

API Manager UI のアラート設定パラメーターは、Anypoint Monitoring のアラート設定パラメーターよりも広範です。そのため、移行ツールは Anypoint Monitoring の制限に準拠していない有効な API アラートの API アラート設定を調整する必要があります。詳細は、「API アラート移行アルゴリズム」を参照してください。

  1. 自動的に移行する API アラートがある場合は、CloudHub デプロイメントで Anypoint Monitoring エージェントが有効になっているか、ハイブリッドデプロイメントで Anypoint Monitoring エージェントがインストールされていることを確認します。詳細は、「Anypoint Monitoring Agent の設定」を参照してください。

  2. 自動的に移行する API Manager API アラートが有効になっていることを確認します。詳細は、API Manager ドキュメントの「API アラートの編集、有効化、無効化」を参照してください。

  3. Anypoint Monitoring API アラートでサポートされていない API Manager アラート設定がある場合は、次のいずれかのガイドラインに従ってください。

    • 移行アルゴリズムに従ってアラート設定を移行ツールが調整できるようにします。

    • Anypoint Monitoring の制限に従って API Manager アラートを再設定します。  


または、移行前に Anypoint Monitoring でアラートを手動で再作成し、API Manager でアラートを無効にすることもできます。  

 

Mule API アラートの従来のエクスペリエンス (API Manager 内)



新しいエクスペリエンス (API Manager 内)

 

 

 

API Key Metrics チャート

 

API Manager の API Summary で Mule API Key Metrics チャートへのアクセス権を保持するには、Anypoint Monitoring エージェントを有効化またはインストールする必要があります。このエージェントをインストールしないと、 Key Metrics チャートにアクセスできなくなります。

Anypoint Monitoring Agent をインストールする期限は 2025 年 6 月 2 日です。

この要件は、CloudHub およびハイブリッドデプロイメントに適用されます。Flex Gateway および CloudHub 2.0 デプロイメントの場合、変更は必要ありません。この変更についての詳細は、「API Manager の Mule API Key Metrics」を参照してください。

Anypoint Monitoring Agent の設定

 

API アラートで設定された総計値の評価と API アラートの自動移行には、Anypoint Monitoring エージェントが必要です。エージェントは、CloudHub 2.0 および Flex Gateway のデプロイメントですでに有効になっています。ただし、Cloudhub またはハイブリッドデプロイメントの API アラートを作成または移行する場合、Anypoint Monitoring エージェントがまだ Cloudhub デプロイメントで有効になっていないか、ハイブリッドデプロイメントでインストールされていない場合は、次のアクションを実行する必要があります。

 

  1. CloudHub（CloudHub 2.0 以外）デプロイメントの API アラートが API Manager にある場合、Anypoint Monitoring エージェントを有効にする必要があります。エージェントがすでに有効になっている場合、アクションは不要です。「CloudHub デプロイメントの監視のセットアップ」を参照してください。

  2. ハイブリッドデプロイメントの API アラートが API Manager にある場合、Anypoint Monitoring エージェントをインストールする必要があります。エージェントがすでにインストールされている場合は、アクションは不要です。
    詳細は、「ハイブリッドデプロイメントの Monitoring のセットアップ」を参照してください。     



API Manager の Mule API Key Metrics

 

API Manager で使用できるメトリクスは API Key Metrics のみです。ミュールアプリケーションの CloudHub (CloudHub 2.0 以外) およびハイブリッドデプロイメントの場合、API Manager の Key Metrics には Anypoint Monitoring エージェントをインストールする必要があります。

 

Key Metrics:

  • Total Requests (合計要求数)

  • Total Policy Violations (ポリシー違反総数)

  • Total Errors (総エラー数)

  • Average Response Time (平均応答時間)

 

詳細は、 「Anypoint Monitoring エージェントを介した重要なメトリクスへのアクセス」とナレッジ記事「Legacy API Manager Mule API Analytics | Key Metrics Charts Experience End of Life」を参照してください。

 

Mule API Key Metrics の従来のエクスペリエンス (Inside API Manager)



Mule API Key Metrics の新しいエクスペリエンス (Inside API Manager)

 

 

Mule API Analytics

API Manager の Mule API Analytics ダッシュボードは Anypoint Monitoring ダッシュボードに置き換えられます。

API Analytics の変更は、2025 年 6 月 2 日に実装されます。


この変更の影響: 

  • Mule アプリケーションと API のメトリクスを表示するには、Anypoint Monitoring ダッシュボードに移行します。

  • Analytics イベントエクスポート API は、API Manager 分析レポートから未加工のイベントデータをクエリおよび抽出できなくなります。

    Anypoint Monitoring Archive API、Anypoint Monitoring Metrics API、Mule API Analytics イベント転送が、Analytics イベントエクスポート API の代替として機能します。

この移行についての詳細は、「Anypoint Monitoring とサポートされる API の使用」を参照してください。

Anypoint Monitoring とメトリクスでサポートされる API の使用

API Manager の Mule API Analytics ダッシュボードは Anypoint Monitoring ダッシュボードに置き換えられます。API Manager の API Analytics イベント API の代替も提供されます。

 

  • Anypoint Monitoring および Anypoint Platform UI の使用

  • Anypoint Monitoring API の使用

Anypoint Monitoring および Anypoint Platform UI の使用

Anypoint Monitoring の Anypoint Insights とカスタムダッシュボードは、API Manager の Mule API Analytics ダッシュボードの主な代替機能として使用します。Anypoint Monitoring の使用方法については、Anypoint Monitoring のマニュアルを参照してください。

 

Mule API Analytics イベント データを Mule API Analytics 機能に依存せずにエクスポートまたは転送するには、次の方法も使用できます。

 

Anypoint Monitoring API の使用

API Manager 向け Mule API Analytics Event API は、API Manager チャートから未加工イベントデータをクエリおよび抽出できなくなります。これは、2025 年 6 月 2 日から有効になります。
 

Anypoint Monitoring でダッシュボードに移行する場合、その API も使用できます。  

 

廃止される API

置換 API および

Analytics Events Export API (別名 API Analytics Events Export API)

  • API Manager からの API 関連イベントデータのエクスポートをサポート

  • 要求、応答、結果を個別に取得し、これらのイベントに関するデータを集計しない

  • 30 日間のデータを提供

  • Mule API ゲートウェイで取得された未加工イベントデータを抽出

Anypoint Monitoring Metrics API
(すべてのサブスクリプションプランで使用可能、Anypoint Platform へのログインが必要)

  • Anypoint Insights が公開するアクセスメトリクスを提供 

  • Anypoint Monitoring Query Language (AMQL) を使用して、メトリクスデータにアクセスするための柔軟で安全なクエリを作成


Anypoint Monitoring Archive API
(Titanium プランでのみ使用可能)

  • 特定の API および Mule アプリケーションデプロイメントの監視イベントをエクスポート 

  • 返されたイベントデータを 1 分間隔で集計

  • 使用可能なサブスクリプションプランを Titanium (コアベース) および Advanced (使用量ベース) に制限

  • 90 日間のデータを提供

 

メトリクスおよびアーカイブ API では、API イベントエクスポート API で使用できる多くの重要な項目がサポートされていますが、その他の項目はまだサポートされていません。詳細は、下記付録「API 項目の比較」を参照してください。

 

付録

API 項目の比較

API Manager の Analytics Events Export API のほとんどの項目は、Anypoint Monitoring Metrics API および Anypoint Monitoring Archive API で使用できます。一部の Archive API 項目は、Anypoint Monitoring ドキュメントに記載されている未加工データ プロパティで有効化されます。

 

Analytics Events Export API
(廃止予定)

Anypoint Monitoring Metrics API

Anypoint Monitoring Archive API 

Client IP

"events"."remote_host"

"events"."remote_host"

API ID

"commons"."api_id"

"commons"."api_id"

API Name

"events"."api_name"

"events"."api_name"

API Version ID

"events"."api_version_id" または "commons"."api_version_id"

"events"."api_version_id" または "commons"."api_version_id"

API Version Name

"events"."api_version"

"events"."api_version"

Runtime Host

"commons"."public_ip"

"commons"."public_ip"

Application

"events"."client_id"

"events"."client_id"

Application Name

該当なし

"events"."client_app"
(注意: Raw データ項目)

Message ID

該当なし

該当なし

Timestamp

"time"

"events"."_time"

Request Size

"events"."request_size.min
|request_size.max
|request_size.count"

"events"."request_size"

Response Size

"events"."response_size.min
|response_size.max
|response_size.count"

"events"."response_size"

Request Outcome

"events"."request_disposition"

"events"."request_disposition"

Verb

"events"."method"

"events"."method"

Resource Path

"events"."path"

"events"."path"

Status Code

"events"."status_code"

"events"."status_code"

User Agent Name

該当なし

"events"."user_agent"
(注意: Raw データ項目)

User Agent Version

該当なし

Browser

該当なし

該当なし

OS Family

該当なし

該当なし

OS Version

該当なし

該当なし

OS Major Version

該当なし

該当なし

OS Minor Version

該当なし

該当なし

Hardware Platform

該当なし

該当なし

Timezone

該当なし

該当なし

City

該当なし

該当なし

Country

"events"."country"

"events"."country"

Continent

該当なし

該当なし

Postal Code

該当なし

該当なし

Violated Policy Name

"events"."policy_name"

"events"."policy_name"

Response Time

"events"."response_time.min
|response_time.max
|response_time.count"

"events"."response_time"

該当なし

該当なし

"events"."api_instance_label"
(注意: Raw データ項目)

該当なし

"events"."flow_id"

"events"."flow_id"

該当なし

"commons"."app_id

"commons"."app_id

 

API アラート移行アルゴリズム 

 

API Manager と Anypoint Monitoring の API アラートには異なる制限があります。有効な API Manager アラート設定を Anypoint Monitoring に移行するには、設定を Anypoint Monitoring の制限に準拠する必要があります。 

 

推奨: 移行ツールによって生成される設定結果を回避するには、手動で API アラートを Anypoint Monitoring に移行するか、自動移行の前に API Manager でより望ましい結果になるようにアラートを再設定できます。

 

Anypoint Monitoring ではアラート通知のデータが 5、10、15、または 20 分単位で集計されますが、API Manager では任意の分数、時間数、日数単位で集計できます。 

 

API Manager アラート設定

Anypoint Monitoring アラート設定

アラートをトリガーする設定は、Anypoint Monitoring で許可されるよりも広範です。


柔軟な期間設定: イベントを評価する連続する期間  (日、時間、分) を任意の数で設定できます。 

例:
2 連続 4-時間 の期間 

アラートをトリガーする設定は、API Manager で許可されているよりも制限されています。

1 分間のみ一定の連続回数で許可: 連続する 1 分の期間を 5、10、15、または 20 期間から選択できます。この期間ごとにイベントが評価されます。

例:
2 連続の 分期間



移行ツールは、Anypoint Monitoring のデータ集計制限に合わせてアラート設定を調整するアルゴリズムを使用します。

 

評価期間

連続期間設定

Anypoint Monitoring アラートの調整

1 分

連続する期間の数: 

次と等しい (=) 5、10、15、または 20

調整は必要ありません。新しい Anypoint Monitoring アラートは、API Manager のアラート設定と一致します。

連続する期間の数: 

次と等しくない (≠) 5、10、15、または 20 

移行ツールは、連続する期間数を 5、10、15、または 20 の最も近い倍数に設定します。


たとえば、API Manager で設定した値が 11 である場合、移行ツールは Anypoint Monitoring でこの数値を 10 に設定します。

> 1 分

連続する期間の数: 

次と等しい (=) 5、10、15、または 20

移行ツールは、アラート条件の設定済み出現数を、次の方法で最も近い整数に変更します。
(条件を満たした回数)➗(評価期間)

例 1 を参照してください。

連続する期間の数: 

次と等しくない (≠) 5、10、15、または 20 

移行ツールは、アラート条件の設定済み出現数を、次の方法で最も近い整数に変更します。  
(条件を満たした回数)➗(評価期間)

また、移行ツールは、連続する期間数をサポートされる最も近い期間の値 (5、10、15、または 20) に調整します。

例 2 を参照してください。



評価期間が 1 分を超える API アラートの移行例

 

評価期間が (>) 1 分以上である API Manager のアラートの場合、移行ツールの動作はアラートに設定された連続する評価期間の数によって異なります。

 

例 1: 評価期間が 1 分を超え、連続する期間が (=) 5、10、15、または 20 の場合  

 

  • API Manager に次の API アラートの設定があるとします。

    5 分 10 連続の期間にアラート条件が 100 回発生する

 

移行ツールは API アラート設定を 20/10 に変換します。これにより、Anypoint Monitoring のアラートが次のように設定されます。

  • アラート条件が 20 回発生する 

  • 1 分 10 連続の各期間に

 

  • API Manager に次の API アラートの設定があるとします。

    11 分 10 連続の期間にアラート条件が 100 回発生する

    移行ツールはこれらの設定を 100/11 (= ~9) に変換します。これにより、Anypoint Monitoring でアラートが次のように設定されます。

  • アラート条件が 9 回発生する 

  • 1 分 10 連続の各期間に

 

例 2: 評価期間が 1 分を超え、連続する期間が (≠) 5、10、15、20 以外の場合

  • API Manager に次の API アラートの設定があるとします。

    5 分 11 連続の期間にアラート条件が 100 回発生する

 

移行ツールはこれらの設定を 100/5 に変換します。これにより、Anypoint Monitoring のアラートが次のように設定されます。

  • アラート条件が 20 回発生する 

  • 1 分 10 連続の各期間に

 

  • API Manager に次の API アラートの設定があるとします。

    11 分 8 連続の期間にアラート条件が 100 回発生する

 

移行ツールはこれらの設定を 100/11 (= ~9) に変換します。これにより、Anypoint Monitoring のアラートが次のように設定されます。

  • アラート条件が 9 回発生する 

  • 1 分 10 連続の各期間に

ナレッジ記事番号

004634029

 
読み込み中
Salesforce Help | Article