---
schema_version: "1"
id: cb54a5b6139aa289e2d82768690ffceab3b69c0a16ee5f55e3503a2791889a40
title: アラートの概念の確認
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/api-manager/latest/using-api-alerts.md
canonical_url: https://docs.mulesoft.com/jp/api-manager/latest/using-api-alerts
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 4f15ec319f3cc5ad98badc50ab834fff2f7adbc6d06430455e23fac06463b145
description: MuleSoft Documentation Site
release: 2.x
latest: true
---
# アラートの概念の確認

Anypoint Platform は、要求動作、パフォーマンスの問題、クライアントアプリケーションコントラクトに関するアクション、ランタイムイベントについて警告します。

プラットフォームは、次の 3 種類のアラートをサポートしています。

- API アラート
- コントラクトアラート
- ランタイムアラート

API アラートとコントラクトアラートは、Anypoint API Monitoring によって管理されます。 ランタイムアラートは、Anypoint Runtime Manager (Runtime Manager) によって管理されます。 新しい API Monitoring アラートの使用方法については、​[「Flex Gateway API アラートの使用」](https://docs.mulesoft.com/gateway/latest/use-api-alerts)​を参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">API Monitoring の代わりに API Manager で従来の Analytics ベースの API アラートをすでに使用しているお客様は、2024 年 11 月 30 日まで引き続きこの機能にアクセスできます。この機能は、新規クライアントでは使用できません。</td></tr></tbody></table>

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">API アラートは、Hyperforce デプロイメントでは使用できません。</td></tr></tbody></table>

## [](#api-アラート)API アラート

次のような異常な API 動作にフラグを付ける API アラートを追加および設定します。

- 60 秒を超える API 応答時間
- 30 秒間で 1000 件を超える API 要求

[「API アラートの追加」](https://docs.mulesoft.com/jp/api-manager/latest/add-api-alert-task)​を参照してください。

API Manager では、次の API アラートを API インスタンスに追加できます。

- **Policy Violation (ポリシー違反)**
    
    API を管理する 1 つ以上のポリシーで違反が発生する。
- **Request Count (要求数)**
    
    ユーザーが指定された期間で許可されている回数を超えて API にアクセスを要求する。
    
    1 ～ 999999999 の期間値を指定します。データのバーストを回避するために、期間は絶対時間 (分) 範囲ではなく、スライディングウィンドウとして実装されます。 [「スライディングウィンドウ」](https://www.techopedia.com/definition/869/sliding-window)​を参照してください。
- **Response Code (応答コード)**
    
    API が要求を受信したときに、400、401、403、404、408、500、502、503 のいずれかの HTTP コードを返す。
- **Response Time (応答時間)**
    
    API の応答時間が指定されたタイムアウト期間を超えている。

API アラートは、状態が変更されたときにみトリガーされます。新しく作成されたアラートで状態が定義されていないために、最初の状態の変更が検出されない可能性があります。

API アラートを設定するときに、アラートに関するメール通知を受信するビジネスグループユーザーを選択します。通知には、重要度レベルで指定されたようにアラートをトリガーするイベントに関する情報が含まれます。ユーザーは以下を受信します。

- 1 つは、アラートについて説明するメールです。
    
    `Your API, CesarDemoAPI - Basic:151 (Environment: "NewOne"), has received greater than 2 requests within 1 consecutive periods of 1 minute.`
- もう 1 つは、アラートがいつ解決されるかを通知するメールです。
    
    `Your API Version, jsonplaceholderapi - 1.0.development, is no longer in an alert state.The number of policy violations was not greater than 1 in the last 1 consecutive periods of 1 minute.`

アラートがトリガーされた後、API Manager は 2 つの通知メールの最初のセットを送信し、次のアラート期間が始まるまでアラートのリスンを停止します。この方法で反復する通知メールが防止されます。

注意: API アラートは ​`no-reply@mulesoft.com`​ から送信されます。これはカスタマイズできません。

アラートメールは、対応するスライディングウィンドウが完全に終了する前に送信できます。  
アラート条件はスライディングウィンドウに基づいて評価されますが、ウィンドウのすべてのメトリクスが取得される前に条件が満たされる可能性があります。たとえば、アラート条件が「5 分間のウィンドウでのエラー数 > 1」に設定されており、最初の 1 分間に 10 件のエラーが発生した場合、スライディングウィンドウが残り 4 分間メトリクスを累積し続けていても、アラートメールは最初の 1 分で送信されます。

## [](#コントラクトアラート)コントラクトアラート

API Manager は、コントラクトに関するアクションが発生したときに自動的にユーザーに通知します。たとえば、クライアントアプリケーションが API インスタンスへのアクセスを要求すると、API Manager は要求の状況が含まれる通知を送信します。設定によって、状況で示される内容 (要求の手動承認が保留中であることや要求が自動承認されたこと) が決まります。

次のアクションで、コントラクトアラートがトリガーされます。

<table class="tableblock frame-all grid-all stretch">
<caption class="title">Table 1. コントラクト</caption>
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 33.3333%;">
<col style="width: 33.3334%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">アクション</th>
<th class="tableblock halign-left valign-top">受信者</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクトが承認された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求アクセスが承認されたことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクトが自動承認された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">組織のシステム管理者、環境管理者、コントラクトマネージャー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求アクセスが自動承認されたことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクトが保留中</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">組織のシステム管理者、環境管理者、コントラクトマネージャー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求アクセスが保留中であることがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">保留中のコントラクトが拒否された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求アクセスが拒否されたことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">失効済みのコントラクトが復元された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求アクセスが復元されたことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">承認済みのコントラクトが失効した</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求アクセスが失効したことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクト層が変更された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクト層が変更されたことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求されたコントラクト層の変更が承認された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求された層の変更が承認されたことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求されたコントラクト層の変更が拒否された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求された層の変更が拒否されたことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクト層の変更が要求された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">組織のシステム管理者、環境管理者、コントラクトマネージャー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクト層の変更のレビューが保留中であることがユーザーに通知されます。</p></td>
</tr>
</tbody>
</table> <table class="tableblock frame-all grid-all stretch">
<caption class="title">Table 2. グループコントラクト</caption>
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 33.3333%;">
<col style="width: 33.3334%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">アクション</th>
<th class="tableblock halign-left valign-top">受信者</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクトが承認された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求アクセスが承認されたことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクトが自動承認された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">グループ管理者</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求アクセスが自動承認されたことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">承認済みのコントラクトが失効した</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求アクセスが失効したことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">失効済みのコントラクトが復元された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求アクセスが復元されたことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">保留中のコントラクトが拒否された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求アクセスが拒否されたことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクトが保留中</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">グループ管理者</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求アクセスが保留中であることがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクト層が変更された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクト層の変更のレビューが保留中であることがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求されたコントラクト層の変更が承認された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求された層の変更が承認されたことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求されたコントラクト層の変更が拒否された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クライアントアプリケーションオーナー</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要求された層の変更が拒否されたことがユーザーに通知されます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクト層の変更が要求された</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">グループ管理者</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">コントラクト層の変更のレビューが保留中であることがユーザーに通知されます。</p></td>
</tr>
</tbody>
</table>

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>コントラクトアラートは ​<code>no-reply@mulesoft.com</code>​ から送信されます。これはカスタマイズできません。</p>
</div>
</td>
</tr>
</tbody></table>

## [](#ランタイムアラート)ランタイムアラート

Runtime Manager のアラートは、API アラートやコントラクトアラートとは異なります。たとえば、Runtime Manager は、CPU 使用量、セキュアなデータゲートウェイの状況、デプロイメントの成功または失敗にフラグを付けます。​[「Runtime Manager アラート」](https://docs.mulesoft.com/jp/runtime-manager/alerts-on-runtime-manager)​を参照してください。

## [](#flex-gateway-のアラート)Flex Gateway のアラート

Flex Gateway のアラートは、API アラートやコントラクトアラートとは異なります。たとえば、Flex Gateway には​**アラートロジック**​オプションと、​**メール通知**​の件名やメッセージをカスタマイズする機能があります。詳細は、​[「Flex Gateway API アラートの使用」](https://docs.mulesoft.com/gateway/latest/use-api-alerts)​を参照してください。

## [](#アラートのレート制限)アラートのレート制限

Anypoint Platform では、アラートをトリガーする頻度とメール通知を送信する頻度を決定するレート制限が適用されます。

適用される制限についての詳細は、​[「アラートのレート制限」](https://docs.mulesoft.com/jp/runtime-manager/alerts-on-runtime-manager#rate-limits-on-alerts)​を参照してください。

## [](#関連情報)関連情報

- [API アラートの追加](https://docs.mulesoft.com/jp/api-manager/latest/add-api-alert-task)
- [API アラートのテスト](https://docs.mulesoft.com/jp/api-manager/latest/test-alert-task)
- [API アラートの表示と削除](https://docs.mulesoft.com/jp/api-manager/latest/view-delete-alerts-task)
- [API アラートの編集、有効化、無効化](https://docs.mulesoft.com/jp/api-manager/latest/edit-enable-disable-alerts-task)