Skip to content

Commit dc3cc33

Browse files
authored
Create section : Frequently asked questions
Added relevant details for excessive notifications for audience/trait failures
1 parent 2ab9f88 commit dc3cc33

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

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

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,3 +102,18 @@ To forward Audit Trail events:
102102
3. Toggle the setting to **On** and click **Save Changes**.
103103

104104
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.
105+
106+
## Frequently asked questions
107+
### Engage
108+
### 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?
109+
110+
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.
111+
112+
**How things work internally:**
113+
Our 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 which is marked as complete by saving a timestamp for the completion. If the worker be disrupted, it picks up at the latest step which has no completed_at timestamp. In some cases, the step might fail or the entire task (for example, due to timeout or the worker disruption as there are many moving parts) - in either case, these failures will be retried.
114+
115+
These tasks are a part of internal Segment process, and there are systems in place which would retry failed tasks. In most cases, it is usually not necessary to track these failures, as long as there are no actual computation or sync failures.
116+
117+
The Audit Trail logic, however, is configured in the way that it simply notifies about every task failure, even if it then later succeeds.
118+
119+
If your team would like to avoid receiving the notifications for transient failures, please **[reach out to support](https://segment.com/help/contact/)**, who upon request can enable a setting that will reduce the number of notifications your workspace receives.

0 commit comments

Comments
 (0)