AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

trigger イベントを AWS EventBridge に送信する

MongoDB はAWS Eventbridge提携するイベントソースを提供しており、Atlas Function を呼び出す代わりに Atlas trigger イベントをイベントバスに送信できます。イベントを EventBridge に送信するには、任意の trigger タイプを構成できます。データベーストリガーは、非致命的なエラーによる trigger の停止を減らすために、カスタムエラー処理もサポートしています。

triggerイベントを EventBridge に送信するために必要なものはすべて、 Amazon Web ServicesアカウントIDです。 このガイドでは、 アカウントIDの検索、trigger の構成、triggerイベントソースとイベントバスの関連付け、カスタム エラー処理の設定について説明します。

注意

公式 AWS パートナー イベント ソース ガイド

このガイドは、SaaS パートナー ドキュメントからの Amazon の受信イベントを基にしています。

注意

EventBridge triggerイベントの個々のエントリは 1 MB より小さくなければなりません。

PutEventsエントリのサイズを縮小する方法については、「パフォーマンスの最適化」セクションを参照してください。

1

triggerイベントをAWS Eventbridgeに送信するには、イベントを受信するアカウントの AWS account ID が必要です。

  1. Amazon EventBridge コンソールを開き、ナビゲーション メニューの [Partner event sources] をクリックします。

  2. MongoDB提携するイベントソースを検索し、[ Set up ] をクリックします。

  3. MongoDB提携するイベントソースのページからCopy [] をクリックして、Amazon Web Services IDアカウント をクリップボードにコピーします。

2

AWS account ID を取得したら、データベースtriggerまたは予定されたtriggerを構成して、イベントを EventBridge に送信できます。

Atlas UIまたは App Services CLI を使用して trigger を構成できます。

Atlas UIで、次の設定で新しいデータベースtriggerまたは予定さtriggerたトリガー を作成し、構成します。

  1. イベントタイプとしてEventBridgeを選択します。

  2. EventBridge からコピーしたAWS Account IDを貼り付けます。

  3. trigger イベントを送信するAWS Regionを選択します。

    注意

    サポート対象の AWS リージョン

    サポートされているAmazon Web Servicesリージョンの完全なリストについては、 SaaS パートナーガイドからの Amazon の受信イベント を参照してください。

  4. (データベース trigger のみの任意) trigger エラーを処理する関数を構成します。

    詳細については、このページの「カスタム エラー処理」セクションを参照してください。

  5. 拡張JSONを有効にするには、 Advanced (Optional)セクションでEnable Extended JSON設定を切り替えます。

    デフォルトでは 、trigger はイベントオブジェクト内のBSON typesを標準のJSON型に変換します。

    拡張JSONを有効にすると、代わりにイベントオブジェクトが拡張JSON形式に直列化されることで、 BSON type 情報が保持されます。 これにより、読みやすさと相互運用性を犠牲にして、型情報が保持されます。

3

EventBridge コンソールに戻ります。

  1. ナビゲーション ペインでパートナーイベントソースを選択します。

  2. Partner event sourcesテーブルで、 Pending trigger ソースを検索及び選択し、 Associate with event busをクリックします。

  3. Associate with event bus画面で、他のアカウントと組織に必要なアクセス権限を定義し、 Associateをクリックします。

関連付けが確認されると、triggerイベントソースのステータスがPendingからActiveに変わり、イベントイベント名と一致するように更新されます。 その提携するイベントソースのイベントでtriggerするルールを作成できるようになりました。

詳細については、「 SaaS パートナー イベントでトリガーするルールの作成 」を参照してください。

注意

データベーストリガーのみがカスタムエラーハンドラーをサポートします

現在、データベーストリガーのみがカスタムエラー処理をサポートしています。 認証トリガーと予定されたトリガーは、現時点ではカスタムエラー処理をサポートしていません。

再試行が成功しない場合に trigger が失敗したときに実行するエラー ハンドラーを作成できます。 カスタムエラー処理を使用すると、 AWS Eventbridgeからのエラーがtriggerを一時停止するのに十分であるか、またはエラーを無視して他のイベントの処理を続行できるかどうかを判断できます。

一時停止されたデータベース trigger の詳細については、「 一時停止された trigger 」を参照してください。

App Services CLI を使用して、または App Services Admin APIを通じて Atlas UIに新しいエラー ハンドラーを作成できます。

この手順では、 Create a Triggerページで新しい関数を直接作成する方法について説明します。

Functionsページから関数を作成することもできます。 Atlas で関数を定義する方法の詳細については、「 関数の定義 」を参照してください。

UI 内の EventBridge カスタムエラー処理構成。
1

Create a TriggerページのConfigure Error Functionセクションから、 + NewFunctionを選択します。

また、ドロップダウンから関数がすでに定義されている場合は、既存の関数を選択することもできます。

2

Nameフィールドに関数の一意の識別名を入力します。 この名前は、アプリケーション内の他のすべての関数と異なる必要があります。

3

Functionセクションでは、関数エディターでJavaScriptコードを直接記述します。 関数エディターには、必要に応じて編集できるデフォルトの 関数 が含まれています。 関数の作成の詳細については、関数のドキュメント を参照してください。

4

Testing Console関数エディターの下の タブでは、テスト コンソールのコメントに示されているように、 パラメーターとerror changeEventパラメーターに例値を渡すことで関数をテストできます。

これらのパラメーターの詳細については、このページの「エラー ハンドラー パラメーター」セクションを参照してください。

テストを実行するには、 Runをクリックします。

5

カスタム エラー ハンドラーが満足できるものになったら、[ Save ] をクリックします。

デフォルトのエラー ハンドラーには、 errorとchangeEventの 2 つのパラメータがあります。

次の 2 つの属性を持つ。

  • code: エラーが発生した EventBridge put リクエストのコード。 エラー ハンドラーで使用されるエラー コードのリストについては、このページの「エラー コード」セクションを参照してください。

  • message: エラーが発生した EventBridge put リクエストからのフィルタリングされていないエラー メッセージ。

EventBridge によって行われたデータに対するリクエストされた変更。 変更イベントの種類とその構成の詳細については、「変更イベント タイプ 」を参照してください。

EventBridge からエラーを受信した場合、イベントプロセッサはエラーをDOCUMENT_TOO_LARGEまたはOTHERとして解析します。 この解析されたエラーは、 errorパラメーターを介してエラー ハンドラー関数に渡されます。

EventBridge trigger イベントのエントリが 1 MB を超えると、EventBridge はエラーをスローします。エラーには次のいずれかが含まれます。

エントリ サイズを縮小する方法の詳細については、「パフォーマンスの最適化 」を参照してください。

その他のすべてのエラーのデフォルトのバケット。

Tip

他のコードによるエラーのエラー処理の最適化

最も一般的なエラー メッセージに対して特別なエラー処理ケースを作成して、 OTHERコードでエラーのエラー処理を最適化できます。 どのエラーに特殊なケースが必要かを判断するには、 error.messageで表示される最も一般的なエラー メッセージを追跡することをお勧めします。

EventBridgetrigger エラー ハンドラーのtrigger trigger は、アプリケーション ログで表示できます。

Atlas UIのTriggersページから、 Logsタブを選択します。

すべてのログはデフォルトで表示されます。 エラー ハンドラーのログのみを表示するには、 Show errors onlyトグルをクリックします。

アプリケーションログの表示の詳細については、「アプリケーション ログの表示 」を参照してください。

trigger次のオブジェクトは、イベントを に送信し、エラーを処理するAWS Eventbridge を構成します。

"event_processors": { "AWS_EVENTBRIDGE": { "config": { "account_id": "012345678901", "region": "us-east-1" } }}, "error_handler": { "config": { "enabled": true, "function_name": "myErrorHandler.js" }}

EventBridge triggerイベントの個々のエントリは 1 MB より小さくなければなりません。

詳細については、 Amazon Web Services のドキュメント を参照してAmazon putEventsイベントエントリ サイズ を計算します。データベーストリガーを使用する場合、 プロジェクト式には指定されたフィールドのみを含めることができるため、 EventBridge にメッセージを送信する前にドキュメントサイズを縮小できます。プロジェクト式の詳細については、データベース trigger プロジェクト式 のドキュメントを参照してください。