Skip to content

Commit d5c1c05

Browse files
author
markzegarelli
authored
Merge pull request #1691 from segmentio/DOC-192_data-res-ga
DOC-192 update doc and screens
2 parents 6d4a826 + 8b85f5d commit d5c1c05

File tree

4 files changed

+34
-28
lines changed

4 files changed

+34
-28
lines changed

src/_data/products.yml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,3 +114,11 @@ items:
114114
team: false
115115
business: true
116116
add-on: true
117+
- product_display_name: Data Residency
118+
slug: data-residency
119+
plan-note: "Data residency is available to customers on the Business Tier plan."
120+
plans:
121+
free: false
122+
team: false
123+
business: true
124+
add-on: false

src/connections/data-residency.md

Lines changed: 26 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,22 @@
11
---
22
title: Data Residency
3-
beta: true
43
---
4+
{% include content/plan-grid.md name="data-residency" %}
55

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.
116

12-
## Enable Local Data Ingest and Storage
137

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.
158

16-
![enable](images/enable-regional-ingest.png)
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.
1710

18-
## Local Data Ingest
11+
## Regional Data Ingestion
1912

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.
2114

2215
### Client-side sources
2316

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.
2518

26-
![ingest region](images/regional-ingest.png)
19+
![ingestion region](images/regional-ingest.png)
2720

2821
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.
2922

@@ -36,16 +29,21 @@ When you send data from a server-side or project source, you can use the `host`
3629
3. Singapore — `in.ap1.segmentapis.com/v1`
3730
4. Sydney — `in.au1.segmentapis.com/v1`
3831

39-
## Local Data Storage
32+
## Regional Data Storage
4033

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.
4235

4336
> 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"}.
4543
4644
### Pre-requisites
4745

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:
4947

5048
1. Create an S3 bucket in your preferred region
5149
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
142140
}
143141
```
144142

145-
### Local Data Storage configuration
143+
### Regional Data Storage configuration
146144

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.
148146

149147
![local storage](images/regional-data-source.png)
150148

151-
To complete the configuration of Local Data Storage:
149+
To complete the configuration of Regional Data Storage:
152150

153151
1. Enter the name of the S3 Bucket you created in the Pre-requisites section
154152
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:
158156
6. Identify the Source in the source-level archive retention periods list
159157
7. Set the Retention for this source to the suggested value of `7 days`* and click **Save**
160158

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.
162160

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"}.
164162

165-
### Deletion from Local Data Storage
163+
### Deletion from Regional Data Storage
166164

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:
168166
- block ongoing data collection for that user
169167
- delete all historical data about them from Segment's systems, connected S3 buckets and warehouses, and supported downstream partners
170168

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.
172170

173171
> note "Business Plan Customers"
174172
> 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.
175173
176-
### Replays from Local Data Storage
174+
### Replays from Regional Data Storage
177175

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:
179177
- Source ID
180178
- Date Range
181179
- Destination
@@ -184,4 +182,4 @@ Segment will initiate Replay jobs and update status as they progress.
184182

185183
### Debugging and support
186184

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.
1.82 KB
Loading
-60 KB
Loading

0 commit comments

Comments
 (0)