アラートの概念の確認
Anypoint Platform は、要求動作、パフォーマンスの問題、クライアントアプリケーションコントラクトに関するアクション、ランタイムイベントについて警告します。プラットフォームでは、API アラート、コントラクトアラート、ランタイムアラートの 3 つのアラートタイプがサポートされています。API アラートとコントラクトアラートは、Anypoint API Manager (API Manager) によって管理されます。ランタイムアラートは、Anypoint Runtime Manager (Runtime Manager) によって管理されます。
API アラート
次のような異常な API 動作にフラグを付ける API アラートを追加および設定します。
-
60 秒を超える API 応答時間
-
30 秒間で 1000 件を超える API 要求
「API アラートの追加」を参照してください。
API Manager では、次の API アラートを API インスタンスに追加できます。
-
Policy Violation (ポリシー違反)
API を管理する 1 つ以上のポリシーで違反が発生する。
-
Request Count (要求数)
ユーザーが指定された期間で許可されている回数を超えて API にアクセスを要求する。
1 ～ 999999999 の期間値を指定します。データのバーストを回避するために、期間は絶対時間 (分) 範囲ではなく、スライディングウィンドウとして実装されます。 「スライディングウィンドウ」を参照してください。
-
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 から送信されます。これはカスタマイズできません。
コントラクトアラート
API Manager は、コントラクトに関するアクションが発生したときに自動的にユーザーに通知します。たとえば、クライアントアプリケーションが API インスタンスへのアクセスを要求すると、API Manager は要求の状況が含まれる通知を送信します。設定によって、状況で示される内容 (要求の手動承認が保留中であることや要求が自動承認されたこと) が決まります。
次のアクションで、コントラクトアラートがトリガーされます。
| アクション | 受信者 | 説明 |
|---|---|---|
コントラクトが承認された |
クライアントアプリケーションオーナー |
要求アクセスが承認されたことがユーザーに通知されます。 |
コントラクトが自動承認された |
組織のシステム管理者、環境管理者、コントラクトマネージャー |
要求アクセスが自動承認されたことがユーザーに通知されます。 |
コントラクトが保留中 |
組織のシステム管理者、環境管理者、コントラクトマネージャー |
要求アクセスが保留中であることがユーザーに通知されます。 |
保留中のコントラクトが拒否された |
クライアントアプリケーションオーナー |
要求アクセスが拒否されたことがユーザーに通知されます。 |
失効済みのコントラクトが復元された |
クライアントアプリケーションオーナー |
要求アクセスが復元されたことがユーザーに通知されます。 |
承認済みのコントラクトが失効した |
クライアントアプリケーションオーナー |
要求アクセスが失効したことがユーザーに通知されます。 |
コントラクト層が変更された |
クライアントアプリケーションオーナー |
コントラクト層が変更されたことがユーザーに通知されます。 |
要求されたコントラクト層の変更が承認された |
クライアントアプリケーションオーナー |
要求された層の変更が承認されたことがユーザーに通知されます。 |
要求されたコントラクト層の変更が拒否された |
クライアントアプリケーションオーナー |
要求された層の変更が拒否されたことがユーザーに通知されます。 |
コントラクト層の変更が要求された |
組織のシステム管理者、環境管理者、コントラクトマネージャー |
コントラクト層の変更のレビューが保留中であることがユーザーに通知されます。 |
| アクション | 受信者 | 説明 |
|---|---|---|
コントラクトが承認された |
クライアントアプリケーションオーナー |
要求アクセスが承認されたことがユーザーに通知されます。 |
コントラクトが自動承認された |
グループ管理者 |
要求アクセスが自動承認されたことがユーザーに通知されます。 |
承認済みのコントラクトが失効した |
クライアントアプリケーションオーナー |
要求アクセスが失効したことがユーザーに通知されます。 |
失効済みのコントラクトが復元された |
クライアントアプリケーションオーナー |
要求アクセスが復元されたことがユーザーに通知されます。 |
保留中のコントラクトが拒否された |
クライアントアプリケーションオーナー |
要求アクセスが拒否されたことがユーザーに通知されます。 |
コントラクトが保留中 |
グループ管理者 |
要求アクセスが保留中であることがユーザーに通知されます。 |
コントラクト層が変更された |
クライアントアプリケーションオーナー |
コントラクト層の変更のレビューが保留中であることがユーザーに通知されます。 |
要求されたコントラクト層の変更が承認された |
クライアントアプリケーションオーナー |
要求された層の変更が承認されたことがユーザーに通知されます。 |
要求されたコントラクト層の変更が拒否された |
クライアントアプリケーションオーナー |
要求された層の変更が拒否されたことがユーザーに通知されます。 |
コントラクト層の変更が要求された |
グループ管理者 |
コントラクト層の変更のレビューが保留中であることがユーザーに通知されます。 |
|
コントラクトアラートは |
ランタイムアラート
Runtime Manager のアラートは、API アラートやコントラクトアラートとは異なります。たとえば、Runtime Manager は、CPU 使用量、セキュアなデータゲートウェイの状況、デプロイメントの成功または失敗にフラグを付けます。「Runtime Manager アラート」を参照してください。
Flex Gateway のアラート
Flex Gateway のアラートは、API アラートやコントラクトアラートとは異なります。たとえば、Flex Gateway にはアラートロジックオプションと、メール通知の件名やメッセージをカスタマイズする機能があります。詳細は、「Flex Gateway API アラートの使用」を参照してください。
アラートのレート制限
Anypoint Platform では、アラートをトリガーする頻度とメール通知を送信する頻度を決定するレート制限が適用されます。
適用される制限についての詳細は、「アラートのレート制限」を参照してください。