Eventarc トリガーのフィルタを構成することで、イベントを宛先に転送できます。トリガーの構成はイベントの種類によって異なります。選択するイベントルートもイベントの種類によって異なります。
イベントの種類
統合された Google プロバイダからの直接イベント - Eventarc は、Cloud Storage バケット内のオブジェクトの更新や Firebase Remote Config テンプレートの更新などの直接イベントを転送できます。サポートされている直接イベントのリストをご覧ください。
Cloud Audit Logs と Eventarc - Eventarc トリガーのフィルタ条件に一致する監査ログが作成されると、イベントが転送されます。これにより、特定のイベントをキャプチャして処理できます。サポートされている監査ログイベントのリストをご覧ください。
Pub/Sub と Eventarc - Eventarc トリガーのフィルタ条件(
"type=google.cloud.pubsub.topic.v1.messagePublished"
)で指定された Pub/Sub トピックにメッセージが公開されると、イベントが転送されます。Eventarc は、Pub/Sub を使用してメッセージをパブリッシュできるサービスと統合可能です。Pub/Sub に直接 push - Eventarc を使用する代わりに、Pub/Sub を使用してサービスに直接メッセージを push できます。これは、Pub/Sub と直接統合されているアプリケーションやサービスに適用されます。詳細については、Pub/Sub の push からのトリガーをご覧ください。
イベントルートを選択する
イベントを宛先に転送する最適な方法を判断するには、次の点を考慮してください。
Eventarc が、ルーティングするイベントの直接イベントをサポートしているか。サポートしている場合は、Eventarc トリガーを作成して、その直接イベントをルーティングします。そうでない場合は、次のシナリオ(#2)を検討します。
ルーティングするイベントに対して、直接と監査ログの両方のオプションがサポートされている場合は、直接イベントをルーティングするトリガーを作成することをおすすめします。直接イベントには、監査ログイベントと比べて次のような利点があります。
- トリガーの応答性とイベント配信のレイテンシが改善される
- イベント形式が厳密に決められているので、予測しやすく見つけやすい
- コレクション ID(リソース名コンポーネント)でフィルタリングが可能
- Cloud Audit Logs を有効にしても追加料金が発生しない
Google サービスまたはアプリケーションが Cloud Audit Logs、Pub/Sub、またはその両方をサポートしているか。
Cloud Audit Logs と Pub/Sub の両方がサポートされている場合、必要な情報を提供するのはどちらか。たとえば、Cloud Build は監査ログと Pub/Sub メッセージの両方を生成できますが、Pub/Sub はビルドのステータス通知(成功または失敗)を提供します。Cloud Build 監査ログはビルドの作成と削除のオペレーションに関する情報を提供します。監査ログと Pub/Sub メッセージの両方のコンテンツとレイテンシの影響が同等の場合は、どちらを選択しても構いません。その場合は、次のこと(#4)を検討します。
Pub/Sub を使用している場合、Eventarc と共通の CloudEvents 形式を使用してイベントを受信するメリットはあるか。たとえば、複数のイベントソースがあるかどうか。Pub/Sub メッセージを直接 push する方法に慣れていても、標準的な配信メカニズムと形式を使用した方法が効率的で、便利な場合があります。
次のステップ
- Eventarc トリガーの作成方法を学習する。
- Cloud Audit Logs のイベント フィルタを決定する。
- Cloud Audit Logs を使用して Cloud Storage イベントを受信する方法を学習する。