From 0c31c80d11ccac774e6a8f19b562eac4162b6e09 Mon Sep 17 00:00:00 2001 From: pwseg Date: Fri, 20 Jun 2025 14:50:08 -0500 Subject: [PATCH 1/3] add new observability section --- .../journeys/event-triggered-journeys.md | 37 +++++++++++++++++++ 1 file changed, 37 insertions(+) diff --git a/src/engage/journeys/event-triggered-journeys.md b/src/engage/journeys/event-triggered-journeys.md index 94d1e5f579..ee201e32cf 100644 --- a/src/engage/journeys/event-triggered-journeys.md +++ b/src/engage/journeys/event-triggered-journeys.md @@ -123,6 +123,43 @@ Segment built Event-Triggered Journeys to respond instantly to events, offering - **Editing and versioning**: After you publish an event-triggered journey, you won't be able to edit it. To modify a journey, create a new journey. - **Real-time delivery**: Event-Triggered Journeys aim for an expected delivery time of under 5 minutes from the moment an event is performed to when the payload reaches the destination, assuming there is no delay step in the journey. However, external factors outside of Segment's control may occasionally introduce latency. +## Observability + +Segment provides built-in tools to help you understand how users move through your journeys. These features let you debug issues, verify behavior, and review step-by-step activity for individual users. + +### Profile Explorer: Journeys tab + +From the **Profile Explorer**, you can view the journeys a user entered. For Event-Triggered Journeys (V2), you’ll see the total number of times the user has entered each journey. V1 journeys display only the current step. + +To access Profile Explorer: + +1. Go to **Profiles** and open a user profile. +2. Click the **Journeys** tab. + +### Journey instance timeline + +When you need to understand how a specific user moved through a journey, the Journey Instance Timeline shows a detailed, step-by-step view of the user’s path. + +This view is useful for troubleshooting, testing, or verifying behavior after launch. You’ll see the exact sequence of events and timing for a single journey instance. Follow these steps to access the instance timeline: + +- **Option 1**: + 1. Open a user profile from the Profile Explorer. + 2. Click the **Journeys** tab, then click the name of the journey. +- **Option 2**: + 1. Go to **Engage > Journeys**, then open the **Overview** tab. + 2. Use the **Search for a profile** field to look up the user by email or ID. + 3. Select a journey instance to view its full timeline. + +### Profile activity + +Use the **Profile activity** tab on the journey overview page to see a high-level log of entries, exits, and transitions across all users. This is helpful for filtering activity by time, user, or step, especially when you want to confirm how different users have moved through a journey. + +Follow these steps to access Profile activity: + +1. Go to **Engage > Journeys**. +2. Select a journey and open the **Profile activity** tab. +3. Use the filters to narrow down the results by user, time range, event type, or step name. + ## Use Cases Event-Triggered Journeys can power a variety of real-time, personalized experiences. This section details some common scenarios to help you see how they might work in practice. From 9137dc368df6b02516d0003dc5cc4a90f0808b62 Mon Sep 17 00:00:00 2001 From: pwseg Date: Fri, 20 Jun 2025 14:51:54 -0500 Subject: [PATCH 2/3] some cleanup [netlify-build] --- src/engage/journeys/event-triggered-journeys.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/src/engage/journeys/event-triggered-journeys.md b/src/engage/journeys/event-triggered-journeys.md index ee201e32cf..6d41ee5e29 100644 --- a/src/engage/journeys/event-triggered-journeys.md +++ b/src/engage/journeys/event-triggered-journeys.md @@ -127,13 +127,13 @@ Segment built Event-Triggered Journeys to respond instantly to events, offering Segment provides built-in tools to help you understand how users move through your journeys. These features let you debug issues, verify behavior, and review step-by-step activity for individual users. -### Profile Explorer: Journeys tab +### Profile explorer: Journeys tab -From the **Profile Explorer**, you can view the journeys a user entered. For Event-Triggered Journeys (V2), you’ll see the total number of times the user has entered each journey. V1 journeys display only the current step. +From Profile explorer, you can view the journeys a user entered. For Event-Triggered Journeys (V2), you’ll see the total number of times the user has entered each journey; V1 journeys display only the current step. -To access Profile Explorer: +To access Profile explorer: -1. Go to **Profiles** and open a user profile. +1. From your Segment workspace, go to **Unify > Profile explorer** and open a user profile. 2. Click the **Journeys** tab. ### Journey instance timeline @@ -143,10 +143,10 @@ When you need to understand how a specific user moved through a journey, the Jou This view is useful for troubleshooting, testing, or verifying behavior after launch. You’ll see the exact sequence of events and timing for a single journey instance. Follow these steps to access the instance timeline: - **Option 1**: - 1. Open a user profile from the Profile Explorer. + 1. Open a user profile from the Profile explorer. 2. Click the **Journeys** tab, then click the name of the journey. - **Option 2**: - 1. Go to **Engage > Journeys**, then open the **Overview** tab. + 1. From your Segment workspace, go to **Engage > Journeys**, then open the **Overview** tab. 2. Use the **Search for a profile** field to look up the user by email or ID. 3. Select a journey instance to view its full timeline. @@ -157,7 +157,7 @@ Use the **Profile activity** tab on the journey overview page to see a high-leve Follow these steps to access Profile activity: 1. Go to **Engage > Journeys**. -2. Select a journey and open the **Profile activity** tab. +2. Select a journey and click the **Profile activity** tab. 3. Use the filters to narrow down the results by user, time range, event type, or step name. ## Use Cases From df3ba9278ce7491d8291a1546d60b876212943b5 Mon Sep 17 00:00:00 2001 From: pwseg <86626706+pwseg@users.noreply.github.com> Date: Fri, 20 Jun 2025 15:38:21 -0500 Subject: [PATCH 3/3] Update src/engage/journeys/event-triggered-journeys.md Co-authored-by: rchinn1 <93161299+rchinn1@users.noreply.github.com> --- src/engage/journeys/event-triggered-journeys.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/engage/journeys/event-triggered-journeys.md b/src/engage/journeys/event-triggered-journeys.md index 6d41ee5e29..4794aa568e 100644 --- a/src/engage/journeys/event-triggered-journeys.md +++ b/src/engage/journeys/event-triggered-journeys.md @@ -160,7 +160,7 @@ Follow these steps to access Profile activity: 2. Select a journey and click the **Profile activity** tab. 3. Use the filters to narrow down the results by user, time range, event type, or step name. -## Use Cases +## Use cases Event-Triggered Journeys can power a variety of real-time, personalized experiences. This section details some common scenarios to help you see how they might work in practice.