Skip to content

Commit fff5f4c

Browse files
authored
Merge pull request #4005 from segmentio/lizkane222-patch-1
Create section : Frequently asked questions
2 parents 2495803 + 063cef6 commit fff5f4c

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

src/segment-app/iam/audit-trail.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,3 +54,22 @@ To forward Audit Trail events to an event streams source:
5454
1. Navigate to **Settings > Workspace Settings > Audit Forwarding**.
5555
2. Select or create an [event streams source](/docs/connections/sources/#event-streams-sources) to which you'll forward workspace events.
5656
3. Toggle the setting to **On** and click **Save Changes**.
57+
58+
When you forward audit events to a source, Segment passes those events through its entire processing pipeline. This ensures that tracking plans, filters, and other features work with the audit events, and also ensures you can send those events to multiple downstream destinations.
59+
60+
## Frequently asked questions
61+
62+
### Engage
63+
64+
### Why am I getting alerts about an audience/computed trait sync failure, but when I look at the specific audience/computed trait it shows a successful sync?
65+
66+
An audience/computed trait Run or a Sync may fail on its first attempt, but Engage will retry up to 5 times before considering it a hard failure and display on that audience/compute trait's Overview page. As long as the runs/syncs within the specific Audience's Overview page say they are successful, then these can be safely ignored.
67+
68+
**How things work internally:**
69+
Segment Engage scheduler fetches audiences/traits from compute service and then handles the logic of generating tasks. These compute/sync tasks get scheduled and executed by another worker. Essentially, these tasks are a list of steps to be executed. Each task has a series of steps that are marked as complete by saving a timestamp for the completion. If the worker is disrupted, it picks up at the latest step, which has no completed_at timestamp. In some cases, the step may fail or the entire task may fail (for example, due to timeout or the worker disruption as there are many moving parts). In either case, these failures will be retried.
70+
71+
These tasks are a part of internal Segment process, and there are systems in place to retry failed tasks. In most cases, it is not necessary to track these failures, as long as there are no actual computation or sync failures.
72+
73+
The Audit Trail logic, however, is configured to notify you about every task failure, even if it then later succeeds.
74+
75+
If you would like to avoid receiving the notifications for transient failures, **[reach out to support](https://segment.com/help/contact/)**, to request enabling a setting to reduce the number of notifications your workspace receives.

0 commit comments

Comments
 (0)