キューイベント

用語セクションで説明したように、イベントリスナールールが設定されたイベントが発生すると、そのイベントは処理のためにキューに入れられます。イベントは、そのイベントリスナーに固有のキューに追加されます。これは、イベントリスナーがリッスンするよう設定されているコンポーネント内のイベント、またはカスタムイベントリスナーのURLの呼び出しのいずれかです。

プロセスは以下のように説明できます:

1. イベントリスナーがコンポーネントまたはカスタムイベントをリッスンする
2. イベントが発生する
3. イベントがキューイベントにプッシュされる
4. イベントリスナーのルールがトリガーされる
5. ルールが関連付けられたイベント関数またはCircuitを呼び出し、実行のためにイベントデータを渡す
6. イベント関数またはターゲットCircuitが実行される
7. 関数またはCircuitの実行が成功または失敗する
8. イベントがキューから削除され、処理済みまたは失敗イベントとして分類される

コンポーネントイベントリスナーのキューイベント

Event ListenersページのQueued Eventsセクションから、任意の時点でキューにあるイベントを確認できます。イベントリスナーのタイルにも、統計として現在キューにあるイベント数が表示されます。

キューイベントセクションには、開始時刻、ソース、アクション、ルールによって関連付けられたイベント関数またはCircuitに渡されるJSON形式のデータなど、イベントのさまざまな詳細が表示されます。Format JSONボタンをクリックしてフォーマットされたデータを表示できます。

最初のドロップダウンリストを使用して、特定のコンポーネントに基づいてこのページに表示されるキューイベントをフィルタリングできます。検索バーを使用して、イベント時刻、ルール名、アクション、またはコンポーネント名に基づいてイベントを検索することもできます。より正確な検索結果を得るには、イベントデータからのキーワードを使用して検索できます。

各コンポーネントに関連する特定のアクションに基づいてフィルタリングすることで、キューイベントのリストをさらに絞り込むことができます。

時間ベースのドロップダウンリストから、過去15分間や30分間など、開始時刻に基づいてイベントをフィルタリングすることもできます。

カスタムイベントリスナーのキューイベント

コンポーネントイベントリスナーのキューイベントと同様に、カスタムイベントリスナーのページからQueued Eventsをクリックして、カスタムイベントリスナーで処理のためにキューに入れられたイベントを確認できます。

ページには、カスタムイベントリスナーが作成された日付、説明、作成者などの詳細が表示されます。さらに、カスタムイベントのProduce URLを表示およびコピーできます。

キューイベントセクションには、ソース、アクション、ルールによって関連付けられたイベント関数またはCircuitに渡されるJSON形式のイベントデータなど、イベントのその他の詳細も表示されます。Format JSONボタンをクリックしてフォーマットされたデータを表示できます。

Component Event Listenersと同様に、キュー内のイベントをフィルタリングおよび検索できます。

イベントの表示に遅延がある場合は、Refreshをクリックして更新されたリストを表示できます。

これらのイベントが処理された後、キューから削除されます。

キュー内のイベントの一時停止

Catalystでは、キュー内の任意のイベントを1回あたり最大5分間一時停止できます。キューを一時停止すると、処理を一時的に停止し、エラーが発生した場合にコードの修正を行うことができます。

その後、一時停止したキューを手動で再開するか、5分間のタイマーが切れたときにキューが自動的に再開されるのを待つことができます。

1. 右端のPause Queueボタンをクリックしてキューを一時停止できます。
   

2. Yes, Proceedをクリックします。
   

キューが一時停止している間も、キュー内の結果を検索およびフィルタリングできます。キューが自動的に再開されるまでの残り時間がQueued Eventsページの上部に表示されます。

キューからのイベントの削除

キューが一時停止している間、キューからイベントを削除できます。これにより、キューからイベントが完全に削除され、処理が終了します。関連付けられたイベント関数またはCircuitがトリガーされている場合、それも直ちに終了されます。

キューから1つ以上のイベントを削除するには:

1. キューが一時停止しているときに、チェックボックスを使用してイベントまたは複数のイベントを選択し、Remove Eventをクリックします。
   

   すべてのイベントを選択して一括削除することもできます。Remove Allをクリックしてください。

   
   

2. 確認するにはYes, Proceedをクリックします。
   

キューの再開

一時停止したキューを手動で再開するには:

1. Resume Queueをクリックします。
   

2. 確認するにはYes, Proceedをクリックします。
   

キュー内のイベントの強制終了

現在処理中のキュー内の特定のイベントは、イベントリスナーのインデックスページのIn Progressセクションに表示されます。このセクションには、ルール名、Execution ID、処理の日時、JSON形式のイベントデータなど、イベントの詳細が表示されます。

In Progressセクションからイベントを強制終了すると、そのイベントは突然終了され、キューから削除されます。関連付けられた関数またはCircuitの実行も直ちに終了されます。

進行中のイベントを強制終了するには:

1. In Progressセクションの右端にある強制終了アイコンをクリックします。
   

2. 確認するにはYes, Proceedをクリックします。
   

イベントリスナーのキューの無効化

イベントリスナーが作成されると、Catalystはそのイベントリスナーに関連するイベントを処理するためのキューを自動的に作成して有効にします。そのキュー内のイベントを処理したくない場合は、このキューを無効にできます。必要に応じていつでもキューを再度有効にできます。

1. コンポーネントイベントリスナーまたはカスタムイベントリスナーのページの右上にある省略記号アイコンをクリックし、Disable Queueをクリックします。
   

2. 確認するにはYes, Proceedをクリックします。
   

キューの無効ステータスがイベントリスナー名の近くに表示されます。Queued Eventsボタンも無効になります。

キューの無効ステータスはEvent Listenersページにも表示されます。

同じ省略記号アイコンをクリックし、Enableをクリックすると、無効なキューを有効にできます。

有効になったキューはイベントをキャプチャして処理します。

有効になったキューはイベントをキャプチャして処理します。