Create event-driven architectures with Eventarc

You can use Eventarc and Firestore to build event-driven architectures. Firestore triggers for Eventarc generate events from changes to a particular documents in your database. The trigger can route events to a supported destination:

Eventarc offers a standardized solution to manage the flow of state changes, called events, between decoupled microservices. When triggered, Eventarc routes these events to various destinations while managing delivery, security, authorization, observability, and error-handling for you.

Limitations

Note the following limitations for Firestore triggers for Eventarc:

  • Ordering is not guaranteed. Rapid changes can trigger events in an unexpected order.
  • Events are delivered at least once.

    Make sure your event handler is idempotent and avoid producing unexpected results or side effects when an event is delivered more than once. Refer to Building idempotent functions to learn more.

  • A trigger is associated with a single database. You cannot create a trigger that matches multiple databases.

  • Deleting a database does not automatically delete any triggers for that database. The trigger stops delivering events but continues to exist until you delete the trigger. If the database is recreated, any associated triggers will also need to be deleted and recreated to restore event delivery.

Eventarc and Firestore locations

Eventarc does not support multi-regions for Firestore event triggers, but you can still create triggers for Firestore databases in multi-region locations. Eventarc maps Firestore multi-region locations to the following Eventarc regions:

Firestore multi-region Eventarc region
nam5 us-central1
eur3 europe-west4

Differences between Cloud Run functions 2nd gen and 1st gen

Cloud Run functions (2nd gen) uses Eventarc events for all runtimes. Previously, Cloud Run functions (1st gen) used Eventarc events for only some runtimes. Eventarc events introduce the following differences from Cloud Run functions (1st gen).

  • The Firestore triggers for Eventarc support additional destinations besides Cloud Run functions. You can route CloudEvents to a number of destinations including, but not limited to Cloud Run, GKE, and Workflows.

  • Firestore triggers for Eventarc retrieve the trigger definition at the start of a database write operation and uses that definition to decide if Firestore should emit an event. The write operation does not take into account any changes to trigger definition that might happen as it runs.

    Cloud Run functions (1st gen) retrieves the trigger definition during the evaluation of the database write, and changes to the trigger during evaluation can affect if Firestore emits an event or not.

Datastore mode and Native mode event interoperability

Eventarc supports event triggers for both Datastore mode and Native mode. These event triggers are interoperable with both database types. A Firestore in Native mode database can receive Datastore events, and a Firestore in Datastore mode database can receive Native mode events.

Event interoperability lets you share Eventarc code across Firestore databases of different types.

Event conversions

If you apply a Native mode event trigger to a Datastore mode database, Eventarc makes the following conversions:

  • The namespace of the entity is stored in the event's PartitionId attribute.
  • Embedded entities are converted to Native mode map types.

What's next