You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: pages/docs/tracking-methods/warehouse-connectors.mdx
+65-8
Original file line number
Diff line number
Diff line change
@@ -647,16 +647,69 @@ We recommend that customer filter such events and refresh such events when they
647
647
648
648
We add couple of hidden properties `$warehouse_import_id` and `$warehouse_type` on every event ingested through warehouse connectors. You can add filters and breakdowns on that property in any Mixpanel report. You can find the Warehouse import ID of a sync in Sync History tab shown as `Mixpanel Import Id`.
649
649
650
-
### How do updates & deletes from Mirror syncs affect my event quota usage?
651
650
652
-
On an [Events billing plan](/docs/pricing) your event quota is consumed by:
651
+
## Billing FAQ
653
652
654
-
-**Monthly Event Volume:** The number of events in all of your projects at the end of each month. Updating an existing event using Mirror will not affect your monthly event volume. Deleting an existing event using Mirror will decrease your monthly event volume by one.
655
-
-**Mirror updates and deletes:** Updates and deletes from Mirror are counted separately from event volume. Each update or deletion is counted as one event towards billing for the month they were triggered on, even if the record being updated is for a previous month. You can see a breakdown of your event quota consumption by "event volume" vs "updates and deletes" on your [organization billing page](https://mixpanel.com/report/settings/%23org%2F%24org_id%24%2Fplan).
653
+
### What actions impact billing for warehouse connectors?
656
654
657
-
You can see how much of your quota is being consumed by each warehouse connector in the detailed [data usage view](https://mixpanel.com/report/settings/%23org%2F%24org_id%24%2Fplan%2Fdetail%2Fevents) for your organization.
655
+
Billing varies by operation type and connector mode. The tables below explain how each action affects your monthly event volume:
658
656
659
-
On an [MTU billing plan](/docs/pricing/legacy-mtu-billing) updates and deletes from Mirror do not impact [MTU calculations](/docs/pricing/legacy-mtu-billing#mtu-calculation), however updates and deletes are counted as events for the purposes of the [MTU guardrail](/docs/pricing/legacy-mtu-billing#mtu-guardrail) computation.
|**New events (current calendar month)**| One time | ✅ | ✅ |
662
+
|| Append | ✅ | ✅ |
663
+
|| Mirror | ✅ | ✅ |
664
+
|**Historical events (backfills)**| One time | ✅ | ❌ |
665
+
|| Append | ❌ | ❌ |
666
+
|| Mirror | ✅ | ❌ |
667
+
|**Updates & deletes**| One time | ❌ | ❌ |
668
+
|| Append | ❌ | ❌ |
669
+
|| Mirror | ✅ | ✅ |
670
+
671
+
**Note on Updates**: If you already have an event in Mixpanel, for example, Event A with properties a,b,c,d but want to:
672
+
673
+
-**Update the value** of property d, or
674
+
-**Add a new property** or column e with a non-NULL value
675
+
676
+
This will count as an update event for each row in the sync.
677
+
678
+
If your warehouse workflow **drops and recreates tables**, Mirror will treat this as a full delete and re-insert, with each row counted as a billable event. Mirror looks at the data already ingested into Mixpanel and uses warehouse-specific logic to identify changes made within your warehouse platform. In the case of a full table delete, Mixpanel will register each deleted row as a billable event, and the same applies when the table is recreated.
679
+
680
+
If instead your workflow updates existing tables—by appending, updating, or deleting specific rows or columns—only the affected rows will be billed, as shown in the table above.
681
+
682
+
**Note on Deletes**: If you delete events using [Mixpanel UI](https://docs.mixpanel.com/docs/data-governance/data-clean-up), those deletes are not counted towards billable events. Only Deletes coming from warehouse using mirror are billable.
683
+
684
+
**Note on Backfills**: You can also backfill using `Append` mode if you create a new sync. But for a ongoing sync you cannot backfill for older days with in the existing sync once the `insert_time` has moved past.
|**Set/update profile properties**| Standard | Full sync | ✅ | ❌ |
692
+
|| Standard | Append | ✅ | ❌ |
693
+
|| History | Mirror | ✅ | ✅ |
694
+
|**Remove profile properties**| Standard | Full sync | ❌ | ❌ |
695
+
|| Standard | Append | ❌ | ❌ |
696
+
|| History | Mirror | ✅ | ✅ |
697
+
698
+
699
+
You can monitor these different operations in your billing page, where they'll appear as separate line items: Events - Updates, Events - Deletes, User - Updates, and User - Deletes.
700
+
701
+
### When should I use Mirror vs. Append mode?
702
+
703
+
**Use Mirror mode when:**
704
+
- You want to maintain an exact replica of your warehouse data in Mixpanel
705
+
- You want to automatically sync updates and deletes from your warehouse
706
+
- You need to track the history of user profile changes over time (with History mode)
707
+
708
+
**Use Append mode when:**
709
+
- You only need to add new data without updating existing records
710
+
- You have a workflow that frequently drops and recreates tables
711
+
712
+
For large-scale changes that might significantly impact billing, we recommend consulting with your Account Manager before proceeding.
660
713
661
714
### What will be the cost impact of this on my DWH?
662
715
@@ -675,6 +728,10 @@ There are 3 aspects of DWH cost: network egress, storage, and compute.
675
728
* Append: All Append syncs run a query filtered on `insert_time_column > [last-run-time]`, the compute cost is the cost of this query. Partitioning or clustering based on `insert_time_column` will greatly improve the performance of this query.
676
729
* Full: Full syncs are always a full table scan of the source table to export it.
677
730
678
-
### How can I get help setting up a warehouse connector?
731
+
### Will I be charged for failed imports or errors?
732
+
733
+
No, you will only be charged for events that are successfully imported into Mixpanel. Events that fail validation or encounter errors during the import process will not count toward your billable data points.
734
+
735
+
### How can I monitor my data usage with warehouse connectors?
679
736
680
-
[Reach out](https://mixpanel.com/contact-us/sales/) to our team — we’re happy to walk you through the setup. If you bring a data engineer who has credentials to access your warehouse, it takes < 10 minutes to get up and running.
737
+
You can track your data usage in Mixpanel by navigating to Organization Settings > Usage and viewing the "Data Points" section. Use the "Data Source" filter to specifically view warehouse connector imports.
0 commit comments