Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions src/guides/usage-and-billing/mtus-and-throughput.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,11 @@ An event is a data collection triggered in response to a user action: a [Track c

This is in contrast to "Objects" which represent a single thing that persists over time and can be updated. Objects have "traits" (instead of properties) which record information about that object, and which can change over time. For example a "user" object could have a trait of "email" which doesn't change often, but could also have a [computed trait](/docs/personas/computed-traits/) like `logged_in_last_7_days` that changes between `true` and `false` based on how much they use your site.

## How is object throughput calculated?

[Object Cloud Sources](/docs/connections/sources/about-cloud-sources/#object-cloud-app-sources) retrieve records from integration partners on a scheduled basis. Segment processes these records before writing them out to connected [Storage Destinations](/docs/connections/storage/). Segment counts one object for each record retrieved from a Cloud Source. The number of objects ingested during a billing period has a direct impact on [throughput](#what-is-throughput), which is calculated as `(objects ingested + API calls received) / MTU allowance`.

Depending on the capabilities of the partner's API, Segment may need to retrieve all available records and then deduplicate them prior to writing them out to a connected storage destination. In such cases, all retrieved records are still counted as ingested objects, even if the same records are retrieved multiple times in a given billing period. If you experience overages due to high object throughput, contact [friends@segment.com](mailto:friends@segment.com) to request a less frequent sync cadence.

## MTUs, object throughput, and Cloud sources

Expand Down