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: src/connections/data-residency.md
+26-28Lines changed: 26 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,29 +1,22 @@
1
1
---
2
2
title: Data Residency
3
-
beta: true
4
3
---
4
+
{% include content/plan-grid.md name="data-residency" %}
5
5
6
-
> info ""
7
-
> **Note**: Data residency is in public beta, and its use is governed by the [(1) Segment First Access and Beta Terms and Conditions](https://segment.com/legal/first-access-beta-preview/) and [(2) Segment Acceptable Use Policy](https://segment.com/legal/acceptable-use-policy/).
8
-
9
-
10
-
Segment offers customers the option to lead on data residency by providing regional infrastructure across Europe, Middle East, Africa and Asia Pacific. The default region for all customers is in Oregon, United States. The regional infrastructure has the same [rate limits and SLA](/docs/connections/rate-limits/) as the default region.
11
6
12
-
## Enable Local Data Ingest and Storage
13
7
14
-
This feature is in Public Preview. You can enable Local Data Ingest and Storage from the Regional Settings tab within your Workspace settings. Enabling the feature here makes the feature available to both client-side and server-side sources.
15
8
16
-

9
+
Segment offers customers the option to lead on data residency by providing regional infrastructure across Europe, Middle East, Africa and Asia Pacific. The default region for all customers is in Oregon, United States. The regional infrastructure has the same [rate limits and SLA](/docs/connections/rate-limits/) as the default region.
17
10
18
-
## Local Data Ingest
11
+
## Regional Data Ingestion
19
12
20
-
Local Data Ingest enables you to send data to Segment from both Client-side and Server-side sources through locally hosted API ingest points. The regional infrastructure can fail-over across locations within a region, but never across regions.
13
+
Regional Data Ingestion enables you to send data to Segment from both Device-mode and Cloud-mode sources through regionally hosted API ingest points. The regional infrastructure can fail-over across locations within a region, but never across regions.
21
14
22
15
### Client-side sources
23
16
24
-
You can configure Segment's client-side SDKs for Javascript, iOS, Android, and React Native sources to send data to a regional host after you've updated the Ingest Region in that source's settings.
17
+
You can configure Segment's client-side SDKs for Javascript, iOS, Android, and React Native sources to send data to a regional host after you've updated the Data Ingestion Region in that source's settings.
25
18
26
-

19
+

27
20
28
21
All regions are configured on a **per-source** basis. You'll need to configure the region for each source separately if you do not want to use the default region (Oregon). All Segment client-side SDKs read this setting and update themselves automatically to send data to new endpoints when the app is reloaded. You do not need to change code when you switch regions.
29
22
@@ -36,16 +29,21 @@ When you send data from a server-side or project source, you can use the `host`
36
29
3. Singapore — `in.ap1.segmentapis.com/v1`
37
30
4. Sydney — `in.au1.segmentapis.com/v1`
38
31
39
-
## Local Data Storage
32
+
## Regional Data Storage
40
33
41
-
Local Data Storage allows you to preserve your raw events in Amazon S3 buckets hosted regionally. These buckets are hosted by you, in your desired region.
34
+
Regional Data Storage allows you to preserve your raw events in Amazon S3 buckets hosted regionally. These buckets are hosted by you, in your desired region.
42
35
43
36
> note ""
44
-
> Configure Local Data Storage on new sources instead of enabling on an existing source to avoid deletion of historical data and a change in retention policy. Historical data that is expired due to a retention policy cannot be replayed at a time in the future. Historical data cannot be migrated from the US to your regional buckets.
37
+
> Configure Regional Data Storage on new sources instead of enabling on an existing source to avoid deletion of historical data and a change in retention policy. Historical data that is expired due to a retention policy cannot be replayed at a time in the future. Historical data cannot be migrated from the US to your regional buckets.
38
+
39
+
You can enable Regional Data Storage from the Regional Settings tab within your Workspace settings. Enabling the feature here makes the feature available to both client-side and server-side sources.
40
+
41
+
> info ""
42
+
> **Note**: Regional Data Storage is a Beta feature, and its use is governed by the [(1) Segment First Access and Beta Terms and Conditions](https://segment.com/legal/first-access-beta-preview/){:target="_blank"} and [(2) Segment Acceptable Use Policy](https://segment.com/legal/acceptable-use-policy/){:target="_blank"}.
45
43
46
44
### Pre-requisites
47
45
48
-
To begin with Local Data Storage, complete the following steps in your AWS account:
46
+
To begin with Regional Data Storage, complete the following steps in your AWS account:
49
47
50
48
1. Create an S3 bucket in your preferred region
51
49
2. Create a folder named `segment-logs` in the new bucket
@@ -142,13 +140,13 @@ To begin with Local Data Storage, complete the following steps in your AWS accou
142
140
}
143
141
```
144
142
145
-
### Local Data Storage configuration
143
+
### Regional Data Storage configuration
146
144
147
-
After you configure the policy and roles, as defined above, navigate to the Regional Settings tab of the Settings page of the source for which you want to store data regionally, and find the Local Data Storage section.
145
+
After you configure the policy and roles, as defined above, navigate to the Regional Settings tab of the Settings page of the source for which you want to store data regionally, and find the Regional Data Storage section.
148
146
149
147

150
148
151
-
To complete the configuration of Local Data Storage:
149
+
To complete the configuration of Regional Data Storage:
152
150
153
151
1. Enter the name of the S3 Bucket you created in the Pre-requisites section
154
152
2. Add a regional label to help locate the bucket from AWS at a later date. For example, `us-west2-294048959147` or `country-REGION-AWS_ACCOUNT`
@@ -158,24 +156,24 @@ To complete the configuration of Local Data Storage:
158
156
6. Identify the Source in the source-level archive retention periods list
159
157
7. Set the Retention for this source to the suggested value of `7 days`* and click **Save**
160
158
161
-
The Local Data Storage bucket will take roughly one hour to receive data.
159
+
The Regional Data Storage bucket will take around one hour to receive data.
162
160
163
-
* The data retention can be set to any value available in the portal. If you require less than 7 days of data stored in the Segment-owned Archives, please reach out to support.
161
+
\* The data retention can be set to any value available in the portal. If you require less than 7 days of data stored in the Segment-owned Archives, please contact [Segment Support](https://segment.com/help/contact){:target="_blank"}.
164
162
165
-
### Deletion from Local Data Storage
163
+
### Deletion from Regional Data Storage
166
164
167
-
Local Data Storage offers the same ability to delete end-user data when they revoke or alter their consent to have data collected, as long as they can be identified by a `userId`. For example, if an end-user invokes their Right to Object or Right to Erasure under the GDPR or CCPA, you can use these features to:
165
+
Regional Data Storage offers the same ability to delete end-user data when they revoke or alter their consent to have data collected, as long as they can be identified by a `userId`. For example, if an end-user invokes their Right to Object or Right to Erasure under the GDPR or CCPA, you can use these features to:
168
166
- block ongoing data collection for that user
169
167
- delete all historical data about them from Segment's systems, connected S3 buckets and warehouses, and supported downstream partners
170
168
171
-
Contact [Segment Support](https://segment.com/help/contact/) to initiate a deletion and provide a valid `userId` for each user to be deleted. Deletion requests are run within the region, and have a 30 day SLA, but requires that the raw data is accessible to Segment in an unaltered state. Deletion from Local Data Storage is not available from the [Privacy Portal](/docs/privacy/user-deletion-and-suppression/#deletion-requests) or through the API.
169
+
Contact [Segment Support](https://segment.com/help/contact/){:target="_blank"} to initiate a deletion and provide a valid `userId` for each user to be deleted. Deletion requests are run within the region, and have a 30 day SLA, but requires that the raw data is accessible to Segment in an unaltered state. Deletion from Regional Data Storage is not available from the [Privacy Portal](/docs/privacy/user-deletion-and-suppression/#deletion-requests) or through the API.
172
170
173
171
> note "Business Plan Customers"
174
172
> If you use this feature to delete data, you cannot Replay the deleted data at the same time. For standard Replay requests, you must wait for any pending deletions to complete. You cannot submit new deletions requests for the period of time that Segment replays data for you.
175
173
176
-
### Replays from Local Data Storage
174
+
### Replays from Regional Data Storage
177
175
178
-
Local Data Storage supports [Replays](/docs/guides/what-is-replay/#replays-for-tooling-changes) to both existing and new tools. To request a Replay, [contact Segment](https://segment.com/help/contact/) with the following:
176
+
Regional Data Storage supports [Replays](/docs/guides/what-is-replay/#replays-for-tooling-changes) to both existing and new tools. To request a Replay, [contact Segment](https://segment.com/help/contact/){:target="_blank"} with the following:
179
177
- Source ID
180
178
- Date Range
181
179
- Destination
@@ -184,4 +182,4 @@ Segment will initiate Replay jobs and update status as they progress.
184
182
185
183
### Debugging and support
186
184
187
-
The Segment Customer Success and Support Engineering teams do not have access to customer hosted regional buckets used for Local Data Storage and cannot provide event level debug support.
185
+
The Segment Customer Success and Support Engineering teams do not have access to customer hosted regional buckets used for Regional Data Storage and cannot provide event level debug support.
0 commit comments