What is counted as an event?
AllMinimumChameleon8 months ago
Hi there,
I saw in the documentation that you are charged for every 'event' above the first 400 for any given user. But it's unclear to me what an event exactly is. I'm under the impression that each time Terra receives data from Garmin, Fitbit, etc, it's counted as an event.
If I look at the payload history and the analytics tab, I'm seeing a very high amount of events, which will exceed the 400 per user per month limit easily, even though we have no influence on this.
Can you explain how these events are counted and if there is any way we can limit them?
Vanessaadmin8 months ago
Hi there!
Great question and totally understandable. An “event” in Terra is simply one processed payload of new data sent to your backend (like a daily sleep payload, an activity payload or a daily payload, or a user’s authentication status which should only occur once after authentication).
We send webhooks as this guarantees data freshness without you having to poll data manually or limit the amount of data you get - whenever there is a new activity being sent from the data source (e.g. Garmin) to the cloud, Terra sends an update to you! The frequency with which data is being sent to you depends on the provider. We usually observe that the amount of events being received is very stable and consistent across a user, making it very predictable how many events you'll receive each month.
Are you currently testing with your own device or observing these event counts on production? Happy for us to have a look at your usage and help you understand the numbers you are seeing, just ping us a message on our private support channel (right upper corner on the dashboard) - most of our starter projects never run into overage. :)