主要な概念

Application Alertsの設定について学ぶ前に、いくつかの主要な概念を簡単に確認しましょう。

CronおよびEvent Listenerのアラート

Catalyst CronおよびEvent Listenersに関連付けられたApplication Alertsは、Logsに関連付けられたアラートとは若干異なる動作をします。CronおよびEvent Listenersでは、これらのコンポーネントで発生する以下の特定のイベントの通知を受けるようにアラートを設定できます：

• Failure: CronまたはEvent Listenerの実行の失敗、および関連するCronまたはEvent Functionのトリガーの失敗を示します
• Code Exception: 関連するエンティティで発生した例外で、例外ハンドラの実行をトリガーしたことを示します
• Timeout: CronまたはEvent Listenerがタイムアウトが発生するまで実行を試みたことを示します

単一または複数のCronまたはEvent Listenerの実行で、これらの条件のいずれかまたはすべてが発生した場合に通知を受けるようにアラートを関連付けることができます。たとえば、プロジェクトで設定された5つの異なるCronでFailure、Code Exception、またはTimeoutが発生した場合に通知する1つのアラートを設定できます。Catalystはこれら5つすべてのCronでこれらのイベントを監視し、設定された時間枠内のすべての発生について、まとめてアラートを送信します。

Logsのアラート

Logsに関連付けられたApplication Alertsを使用すると、検索クエリを提供してログ検索を自動化できます。クエリには、ログタイプ（AccessまたはApplication Logs）、検索が必要なFunctionsのログ、およびログ内で検索する特定のキーワードが含まれます。Application Logsを選択した場合、Info、Error、Severe、Warningのいずれかのログレベルも選択できます。Node.js Functionsの場合は、Uncaught ExceptionとUnhandled Rejectionの2つの追加レベルからも選択できます。

その後、アラートの条件と頻度を設定できます。これにより、Catalystは設定された頻度でログクエリ検索を自動的に実行し、条件に一致するすべての結果を取得します。Application Alertsは、これらの結果を受信者に通知するメールを送信します。

アラートに設定できる条件と頻度は、3つのコンポーネントすべてに関連付けられたアラートで同じです。

アラートの条件と頻度

条件設定では、アラートの障害イベントまたはログ検索結果のしきい値を指定できます。結果が設定されたしきい値に一致する場合、Catalystはアラートの送信を開始します。

条件を設定するには、次のいずれかの比較演算子を選択できます：より大きい、より小さい、等しい、以上。次に、しきい値を数値で指定します。たとえば、比較演算子を「より大きい」に選択し、しきい値を「5」に設定した場合、指定された障害イベントまたはログ検索結果が5件を超えた場合にCatalystがアラートを送信します。

アラート頻度では、設定されたアラートのメールを受信する頻度を指定できます。15分ごと、1時間ごと、12時間ごとなどの時間間隔に基づく頻度を選択するか、アラートを受信したい毎日の特定の時間を指定できます。

CronおよびEvent Listenerのアラート：

Catalystは、設定された頻度の時間枠内でアラート条件と基準に一致するすべてのインスタンスを取得し、毎回メールを送信します。たとえば、以下のようにCronアラートを設定すると仮定します：

• アラート条件: Failure、Timeout
• 条件: 10以上
• アラート頻度: 30分ごと

これにより、Catalystはアラート設定時から30分ごとに、関連するCron実行で発生した障害とタイムアウトイベントを取得します。直近30分の時間枠で障害とタイムアウトのインスタンスが合計10以上の場合、アラートがトリガーされます。障害やタイムアウトがない場合、またはインスタンスが10未満の場合、アラートは送信されません。

Logsのアラート：

Catalystは、設定された頻度でログクエリ検索を実行します。たとえば、以下のようにLogsアラートを設定すると仮定します：

• クエリ: Advanced I/O FunctionのApplication Logs、キーワード - “server”、ログレベル - Warning
• 条件: 5より大きい
• アラート頻度: 1時間ごと

Catalystは1時間ごとにこのクエリでログ検索を実行します。直近1時間の時間枠で、指定されたFunctionの実行において_Warning_レベルでキーワード「server」を含む結果が5件を超える場合、Catalystはアラートを送信します。