graphql-engine/event-triggers.md

96 lines
4.7 KiB
Markdown
Raw Normal View History

# Event triggers on Postgres
Trigger webhooks on database events using Hasura GraphQL Engine's **event triggers**.
![Event triggers demo](assets/event-triggers.gif)
## Highlights
* **Build reactive & async apps/features**: Trigger asynchronous serverless or cloud functions to reduce infrastructure costs and simplify DevOps for developers.
* **Atomic & Reliable**: Using native Postgres triggers, every relevant action on the database is captured as an event. Even if Hasura is down or being updated, events will be captured and delivered as soon as possible with an *atleast-one* guarantee. You can even configure delivery policies like `max_retries` and `retry_interval`.
* **Scalable**: The event-triggers system is horizontally scalable - if you need to handle more events, just throw more resources at it!
* **Works with existing, live databases**: Point it to an existing Postgres database to instantly listen to changes in your data and invoke webhooks.
2018-09-07 16:11:01 +03:00
* **Ready for observability & monitoring]**: Generated events are automatically instrumented with an event-id and structured logs emitted by Hasura make it easy for you to use your favourite tools to run an event-driven backend in production ([watch](https://youtu.be/WOPA52r3bzU) an overview using [Honeycomb](honeycomb.io)).
## Quickstart:
### One-click deployment on Heroku
The fastest way to try event triggers out is via Heroku.
1. Click on the following button to deploy GraphQL Engine on Heroku with the free Postgres add-on:
[![Deploy to Heroku](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/hasura/graphql-engine-heroku)
2. Open the Hasura console
Visit `https://<app-name>.herokuapp.com` (*replace \<app-name\> with your app name*) to open the admin console.
3. Configure your first event trigger and webhook
Create a table, configure the db update you want to use as a trigger and instantly invoke a webhook by adding a new row in your table. Follow this [simple guide](https://docs.hasura.io/1.0/graphql/manual/getting-started/first-graphql-query.html).
### Other deployment methods
For Docker-based deployment and advanced configuration options, see [deployment guides](https://docs.hasura.io/1.0/graphql/manual/getting-started/index.html).
### Quickstart demo
[Create an event-trigger and webhook in 60 seconds](https://youtu.be/EaTUVWnDCvA) (*30 seconds*)
### Serverless boilerplates
2018-09-07 16:11:01 +03:00
Use one of our serverless boilerplates to deploy a webhook that can capture database events - https://github.com/hasura/cloud-functions-boilerplates. Serverless/cloud-function platforms covered by boilerplates:
2018-09-07 16:11:01 +03:00
* [AWS Lambda](https://github.com/hasura/cloud-functions-boilerplates/tree/master/aws-lambda)
* [Google Cloud Functions](https://github.com/hasura/cloud-functions-boilerplates/tree/master/google-cloud-functions)
* [Azure Functions](https://github.com/hasura/cloud-functions-boilerplates/tree/master/azure-functions)
* [Zeit Serverless Docker](https://github.com/hasura/cloud-functions-boilerplates/tree/master/zeit-serverless)
## Architecture
![Event triggers architecture](assets/event-triggers-arch.png)
## Demos & Tutorials: Building reactive & async apps/features
### Notifications
Trigger push notifications and emails based on database events. Try the demo and tutorial below to see how browser push notifications are triggered when the user inserts some data:
* [Watch demo](https://www.youtube.com/watch?v=nuSHkzE2-zo)
* [Try it out](https://shahidh.in/hasura-web-push-notifs/)
* [Tutorial](https://github.com/shahidhk/hasura-web-push-notifs)
<!--
### Async business logic
Convert complex, long-running business logic to be event-driven, asynchronous and resilient to failure. Try this demo and tutorial below to see how an image processing job is run asynchronously to convert an image to a black-and-white version:
* [Watch demo](https://some-youtube-demo.com) (*10:00 mins*)
* [Try it out](https://shahidh.in/hasura-web-push-notifs/)
* [Tutorial](https://github.com/shahidhk/hasura-web-push-notifs)
-->
### Data transformation (ETL)
Transform and load data into external data-stores. Check out this demo and tutorial below to see how Postgres data is transformed to build and populate an Algolia index:
* [Watch demo](https://youtu.be/kWVEBWdEVAA)
* [Try it out](https://shahidh.in/hasura-serverless-etl)
* [Tutorial](https://github.com/shahidhk/hasura-serverless-etl)
2018-09-07 16:11:01 +03:00
### Building reactive UX for your async backend with realtime GraphQL
Propagate event driven and asynchronous information to UI clients easily with GraphQL subscriptions & live-queries.
![Reactive apps architecture](assets/reactive-apps-arch.png)
**Watch**: [Building a reactive app with an async backend](https://youtu.be/kTSOxRrtCeI) (*04:15 mins*)