Routes d'événements

Vous pouvez acheminer les événements vers votre destination en configurant des filtres pour un déclencheur Eventarc. La configuration du déclencheur varie en fonction du type d'événement. La route d'événement que vous sélectionnez dépend également du type d'événement.

Types d'événement

  • Événements directs depuis un fournisseur Google intégré : Eventarc peut acheminer des événements directs, tels qu'une mise à jour d'un objet dans un bucket Cloud Storage ou une mise à jour d'un modèle Firebase Remote Config. Consultez la liste des événements directs compatibles.

  • Cloud Audit Logs et Eventarc — Les événements sont acheminés lorsqu'un journal d'audit est produit, correspondant aux critères de filtrage du déclencheur Eventarc, ce qui vous permet de capturer des événements spécifiques et d'agir en conséquence. Consultez la liste des événements de journaux d'audit compatibles.

  • Pub/Sub et Eventarc — Les événements sont acheminés lorsqu'un message est publié dans un sujet Pub/Sub spécifié par les critères de filtrage ("type=google.cloud.pubsub.topic.v1.messagePublished") du déclencheur Eventarc. Vous pouvez intégrer Eventarc à tout service capable de publier des messages à l'aide de Pub/Sub.

  • Envoi direct via Pub/Sub — Au lieu d'utiliser Eventarc, vous pouvez utiliser Pub/Sub pour envoyer directement des messages à votre service. Cela s'applique aux applications ou aux services disposant d'une intégration directe à Pub/Sub. Pour en savoir plus, consultez la section Déclencher à partir d'un envoi Pub/Sub.

Sélectionner une route d'événement

Pour déterminer la meilleure façon d'acheminer vos événements vers une destination, posez-vous les questions suivantes:

  1. Eventarc accepte-t-il les événements directs pour l'événement que vous souhaitez acheminer ? Si oui, créez un déclencheur Eventarc pour acheminer cet événement direct. Dans le cas contraire, posez-vous la question suivante (2).

    Pour l'événement que vous souhaitez acheminer, si les options des journaux directs et d'audit sont compatibles, nous vous recommandons de créer un déclencheur pour acheminer l'événement direct. Les événements directs offrent les avantages suivants par rapport aux événements de journaux d'audit:

    • Amélioration de la réactivité des déclencheurs et de la latence de diffusion des événements
    • Formats d'événements fortement typés qui sont plus prévisibles et visibles
    • Compatibilité avec le filtrage sur les ID de collection (composants de nom de ressource)
    • L'activation de Cloud Audit Logs n'entraîne aucun coût supplémentaire

  2. Votre service ou application Google est-il compatible avec Cloud Audit Logging, Pub/Sub, ou les deux ?

  3. Si Cloud Audit Logs et Pub/Sub sont tous deux compatibles, lequel fournit les informations dont vous avez besoin ? Par exemple, Cloud Build peut générer à la fois des journaux d'audit et des messages Pub/Sub. Toutefois, Pub/Sub peut fournir des notifications d'état de la compilation (réussite ou échec) tandis que les journaux d'audit Cloud Build peuvent fournir des informations sur les opérations de création et de suppression de build. Dans certains cas, l'impact sur le contenu et la latence des journaux d'audit et des messages Pub/Sub est comparable, et vous pouvez choisir indifféremment l'un ou l'autre. Vous devez ensuite passer à la question suivante (4).

  4. Si vous utilisez Pub/Sub, y a-t-il un avantage à recevoir des événements via Eventarc et un format CloudEvents commun ? Par exemple, existe-t-il plusieurs sources d'événements ? Même si vous connaissez peut-être mieux l'envoi direct de messages Pub/Sub, vous souhaiterez peut-être bénéficier de l'efficacité et de la facilité d'utilisation d'un mécanisme et d'un format de distribution standards.

Étapes suivantes