The triage method
Purpose: Systematic approach to diagnosing any analytics issue.
Who this page is for
| Audience | Why it matters to you |
|---|---|
| Everyone | Essential methodology |
The Triage Method
Use this 5-step process to diagnose any analytics issue.
Step 1: Confirm the problem
Be specific.
Don't say: "Data is broken" Do say: "Visitor count is 0 for [date range], was 50K yesterday"
Document:
- What metric/dimension is affected?
- When did this start? (exact date/time if possible)
- How much traffic affected? (all or partial)
- Which properties/segments affected? (all or specific)
Step 2: Check the AEP Debugger
See what's actually being sent.
- Open AEP Debugger in browser
- Navigate to the affected page
- Inspect the hits:
- Is page name correct? - Are props/eVars populated? - Are events firing? - Are multiple hits being sent?
Finding:
- If Debugger shows correct data β problem is downstream (processing, storage)
- If Debugger shows wrong data β problem is in implementation
Step 3: Check real-time reports
See if Adobe received the data.
- In Analytics: Tools β Real-Time Report
- Select the affected metric
- Wait 30 seconds for data
- Do you see traffic?
Finding:
- If real-time shows data β problem is in processing/reporting
- If real-time is empty β problem is in collection/transmission
Step 4: Check processing rules
Did a rule modify or delete the data?
- Admin β Report Suite Settings β Processing Rules
- Review each rule:
- What condition triggers it? - What does it do? - Could it affect this metric?
Finding:
- If a rule matches β it may be deleting/modifying data
- Try disabling the rule (temporarily) and re-send data
Step 5: Check Workspace
Confirm whether data landed.
- Build simple report: metric by date
- Filter to the date range in question
- Do you see the data?
Finding:
- If Workspace shows data β the issue is data quality (wrong segment, wrong grouping)
- If Workspace shows 0 β data did not reach report suite
Triage flowchart
Problem identified
β
AEP Debugger: See data being sent?
ββ No β Fix implementation
ββ Yes
β
Real-time report: Adobe received it?
ββ No β Check network, datastream config
ββ Yes
β
Processing rules: Any rules modify it?
ββ Yes β Review rule logic
ββ No
β
Workspace: Does data show?
ββ No β Report suite issue, contact Adobe Support
ββ Yes
β
Data quality issue (segment, filter, grouping wrong)
---
Next: No data arriving