Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

EU endpoint changes requested from team #6266

Closed
wants to merge 2 commits into from
Closed
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
18 changes: 10 additions & 8 deletions src/guides/regional-segment.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,19 +30,21 @@ Regional Data Ingestion enables you to send data to Segment from both Device-mod
{% include content/eu-cloud-event-sources.html %}

### Client-side sources
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. Segment's EU instance only supports data ingestion from Dublin, Ireland with the `events.eu1.segmentapis.com/` endpoint. If you are using the Segment EU endpoint with an Analytics-C# source, you must manually append `v1` to the URL. For instance, `events.eu1.segmentapis.com/v1`.
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.

> info ""
> For workspaces that use the EU West Data Processing region, the Dublin Ingestion region is preselected for all sources.
- If you have a US workspace and but want to use the ap-southeast-1 (Singapore) endpoint, use the edge proxy endpoint: in.ap1.segmentapis.com
- If you have a US workspace and but want to use the ap-southeast-2 (Sydney) endpoint, use the edge proxy endpoint: in.au1.segmentapis.com
- If you are using the Segment EU endpoint with an Analytics-C# source, you must manually append `v1` to the URL. For instance, `in.eu2.segmentapis.com/v1`.
Copy link

@vbatanov vbatanov Apr 2, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this is only for Segment EU endpoint , I think this for any endpoint if we using Analytics-C#

- If you're in the *US West* data processing region, you can select from: Dublin, Singapore, Oregon, and Sydney.
- If you're in the *EU West* data processing region, Segment's EU instance only supports data ingestion from Dublin with the `in.eu2.segmentapis.com` endpoint.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The in.eu2.segmentapis.com is EU proxy for US workspaces.
I think we should rephrase , so it will be easy to read and to cover all the case, something like this:
EU workspaces - supports data ingestion from Dublin with default endpoint events.eu1.segmentapis.com

US workspaces - supports data ingestion from Oregon (Default), Dublin, Singapore and Sydney.

  • if you want to use the eu-west-1 (Dublin) endpoint, use the edge proxy endpoint: in.eu2.segmentapis.com
  • if you want to use the ap-southeast-1 (Singapore) endpoint, use the edge proxy endpoint: in.ap1.segmentapis.com
  • if you want to use the ap-southeast-2 (Sydney) endpoint, use the edge proxy endpoint: in.au1.segmentapis.com

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@vbatanov @cmastr seems the current docs aren't accounting for all these intricacies -- should we be redoing this PR?

- For workspaces that use the EU West Data Processing region, the Dublin Ingestion region is preselected for all sources.

To set your Data Ingestion Region:

1. Go to your source.
2. Select the **Settings** tab.
3. Click **Regional Settings**.
4. Choose your **Data Ingestion Region**.
- If you're in the *US West* data processing region, you can select from: Dublin, Singapore, Oregon, and Sydney.
- If you're in the *EU West* data processing region, Segment's EU instance only supports data ingestion from Dublin with the `events.eu1.segmentapis.com/` endpoint.

All regions are configured on a **per-source** basis. You'll need to configure the region for each source separately if you don't want to use the default region.

Expand All @@ -51,15 +53,15 @@ All Segment client-side SDKs read this setting and update themselves automatical
### Server-side and project sources
When you send data from a server-side or project source, you can use the `host` configuration parameter to send data to the desired region:
1. Oregon (Default) — `https://events.segmentapis.com/v1`
2. Dublin — `https://events.eu1.segmentapis.com/`
2. Dublin — `https://in.eu2.segmentapis.com`
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think those examples only for us or eu data processing region not for proxy


> success ""
> If you are using the Segment EU endpoint with an Analytics-C# source, you must manually append `v1` to the URL. For instance, `events.eu1.segmentapis.com/v1`.
> If you are using the Segment EU endpoint with an Analytics-C# source, you must manually append `v1` to the URL. For instance, `in.eu2.segmentapis.com`.

Here is an example of how to set the host:

```json
Analytics.Initialize("<YOUR WRITEKEY HERE>", new Config().SetHost("https://events.eu1.segmentapis.com (https://events.eu1.segmentapis.com/)"));
Analytics.Initialize("<YOUR WRITEKEY HERE>", new Config().SetHost("https://events.eu1.segmentapis.com (https://in.eu2.segmentapis.com)"));
```

## Create a new workspace with a different region
Expand Down