Skip to content

Commit 906c331

Browse files
authored
Merge pull request #6657 from segmentio/lizkane222-patch-8
Update what-is-replay.md Replay considers and Engage section added
2 parents 2a0887d + 785d51f commit 906c331

File tree

1 file changed

+30
-6
lines changed

1 file changed

+30
-6
lines changed

src/guides/what-is-replay.md

Lines changed: 30 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,7 @@ title: Replay
33
plan: replay
44
---
55

6-
Replay takes an archived copy of your Segment data, and re-sends it to new or existing tools.
7-
8-
On the surface this doesn't sound like much, but this can grant huge benefits to mature data systems: By archiving and replaying data, you can avoid vendor lock-in, and protect your system against data loss.
6+
Replay takes an archived copy of your Segment data, and re-sends it to new or existing tools providing huge benefits to mature data systems. By archiving and replaying data, you can avoid vendor lock-in, and protect your system against data loss.
97

108
## Replays for tooling changes
119

@@ -37,14 +35,40 @@ Once a replay starts, you will not see replayed events in the Event Delivery tab
3735

3836
You can initiate replays for some or all events, but you can't apply conditional filters that exclude certain rows of data from being replayed. You can set up [destination filters](/docs/connections/destinations/destination-filters/) to conditionally filter replayed events.
3937

38+
The destination is not required to be enabled in order for a replay to be successful, including Destination Functions.
39+
- The destination must be connected to the source, but can remain disabled while the replay is running.
40+
- Destination filters are still considered when you run replays on disabled destinations.
41+
- There are a few exceptions for destinations that must be enabled for the replay to be successful : Amazon S3 and Google Cloud Source (GCS).
42+
4043
### Replay-eligible destinations
4144

4245
Replays are available for any destinations which support cloud-mode data (meaning data routed through Segment) and which also process timestamps. Destinations that are only available in device-mode (meaning where data is sent directly from the users' devices to the destination tool) cannot receive Replays.
4346

44-
Not all destinations support data deduplication, so you may need to delete, archive, or otherwise remove any old versions of the data before initiating a replay. [Contact us](https://segment.com/help/contact/) if you have questions or would like help.
47+
Not all destinations support data deduplication, so you may need to delete, archive, or remove any older versions of the data before initiating a replay. [contact Segment support](https://segment.com/help/contact/){:target="_blank"} if you have questions or want help.
4548

4649
### Replays & Destination Filters
4750

48-
Replays are subject to the [Destination Filters](/docs/connections/destinations/destination-filters/) you've configured on that destination. For example, if you request that Identify calls be included in the replay, but your destination has a Destination Filter that blocks Identify events, the filter would block all Identify events from making it to the destination. In this case, Segment would recommend that you avoid including Identify events in the replay if you know they'll be blocked by the destination filter.
51+
Replays are subject to the [Destination Filters](/docs/connections/destinations/destination-filters/) you've configured on that destination. For example, if you request that Identify calls be included in the replay, but your destination has a Destination Filter that blocks Identify events, the filter then blocks all Identify events from making it to the destination. In this case, Segment recommends that you avoid including Identify events in the replay if you know they'll be blocked by the destination filter.
52+
53+
When you request a replay, Segment asks you to provide a list of the events (type and/or name) that you want included in the replay. If you specify a list of events, then Segment only includes those specified events in the replay. If you need to exclude events in your replay, [contact Segment support](https://segment.com/help/contact/){:target="_blank"}. The Segment team can help you handle filtering you're unable to do in the replay.
54+
55+
### Replays & Engage
56+
57+
There are two types of replays with Engage.
58+
1. Replay a Profile Source's data into Engage Space, (sending a standard source's data into an Engage Space), which can be configured to send over a specified timeframe as well as the ability to specify all or only a specific subset of events by type or name.
59+
60+
2. Replay from an Engage Space to its connected destination, (sending data from an Engage Output Source to its connected destination), which includes all the computational data (Audiences, Computed Traits, Journeys) that destination is currently configured to receive, which can be configured to send over a specified timeframe as well as the ability to specify all or only a specific subset of events by type or name.
61+
62+
#### Nuances to Consider for Engage Replays
63+
64+
**1. Replay a Profile Source's data into Engage Space**
65+
- When a new Profile Source is connected to an Engage Space, the default option to replay the source's data seen over the past 30 days can be selected. To request a source's additional historical data be replayed to the Engage Space, contact Segment Support at [email protected] or [create a ticket](https://segment.com/docs/engage/[url](https://app.segment.com/goto-my-workspace/home?period=last-24-hours&v2=enabled&help=create-ticket)). Please see [this documentation](https://segment.com/docs/engage/quickstart/#step-3-connect-production-sources:~:text=Step%203%3A%20Connect,production%20sources.) on further details of this process and what to include in your support request.
66+
67+
**2. Replay from an Engage Space to its connected destination**
68+
- Since each instance of a destination is connected to its own Engage "Output" source, that source contains events for all of the computations that destination is connected to received data from, _the list of output sources can be found under Unify > Unify Settings > Debugger_. Because of this, it's not possible to replay only a specific computation's data to the destination, you should instead consider reaching out to [Segment support]([url](https://segment.com/help/contact/)) to request a resync of that computation to its destination instead. However, if you would like to replay all failed events seen by that destination, which will encompass all connected computations, that can be achieved with a replay.
69+
- Note: The replay will be sending historical data to the destination, potentially overwriting the destination with outdated data if more recent data has been sent from the computation to the destination. In this case, a resync of the computation might also be more advantageous to get the most up-to-date data resent to the destination.
70+
- Rate limits for replays are configurable and can be increased or decreased upon request. However, there are some destinations which have strict rate limits and cannot be configured to send data at a higher rate than what's stated within the table on [Rate limits on Engage Event Destinations](https://segment.com/docs/engage/using-engage-data/#rate-limits-on-engage-event-destinations).
4971

50-
When you request a replay, Segment asks you to provide a list of the events (type and/or name) that you want included in the replay. If you specify a list of events, then Segment only includes those specified events in the replay. If you need to exclude events in your replay, [reach out to Segment support](https://segment.com/help/contact/){:target="_blank"}. The Segment team can help you handle filtering you're unable to do in the replay.
72+
#### Engage : Replay versus Resync
73+
- **Replay** : A replay resends all events, specific events by type or name, or failed events over a specified period of time to the destination.
74+
- **Resync** : A resync sends events for a computation's (Audience, Computed Trait, Journey) entire current user base to its connected destination.

0 commit comments

Comments
 (0)