Event Debugging

Monitor and debug events in real-time as they flow through SignalSmith.

Live Event Stream

View events as they arrive:

1. Navigate to Events > Live
2. Events appear in real-time as they are received
3. Each event shows: type, name, user ID, timestamp, and status

Filtering

Filter the live stream to find specific events:

• By event type — Track, identify, page, group
• By event name — Filter to a specific event (e.g., “Order Completed”)
• By user ID — See all events from a specific user
• By write key — See events from a specific source

Event Detail View

Click on any event to see:

• Full event payload (properties, context, traits)
• Contract validation result (pass/fail with details)
• Forwarding delivery status for each active rule
• Consent evaluation result

Test Events

Send test events without a full application setup:

1. Navigate to Events > Test
2. Select a write key
3. Compose a test event payload
4. Click Send
5. Watch it appear in the live stream

Common Issues

Events Not Appearing

• Check write key — Ensure the correct write key is used in the Authorization header
• Check format — Events must include type field (track/identify/page/group)
• Check timestamp — Events with timestamps far in the future or past may be dropped

Contract Violations

• Check required fields — Ensure all required properties are present
• Check types — Verify property types match the contract definition
• Check policy — If the contract policy is “reject”, non-conforming events are dropped

Forwarding Failures

• Check destination status — Verify the destination connection is active
• Check delivery log — View specific error messages in the forwarding rule’s deliveries tab
• Check consent — Events may be filtered by consent management