> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datalyr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Event Stream

> View real-time event feed with filtering and debugging tools

Event Stream shows a live feed of all events tracked by DATALYR, making it easy to debug tracking, verify conversions, and monitor user activity in real-time.

## What It Does

**Real-Time Event Feed:**

* All events as they happen
* Pageviews, custom events, conversions
* Event properties and metadata
* User attribution data

**Shows Per Event:**

* Event name and timestamp
* User email / visitor ID
* Event properties (parameters)
* Attribution (source, medium, campaign)
* Device and location
* Session information

## Key Features

### Live Feed

Events appear instantly as they happen:

**Auto-Refresh:**

* Updates every few seconds
* No manual refresh needed
* Newest events at top

**Event Cards:**

```
pageview - 2 seconds ago
Email: user@example.com
Page: /pricing
Referrer: google.com
Source: google | Medium: organic
```

Each card shows key information at a glance.

### Event Filtering

Filter events by:

**By Event Name:**

* pageview
* purchase
* signup
* Custom events

**By User:**

* Specific email address
* Visitor ID
* User ID

**By Property:**

* UTM parameters
* Custom properties
* Event values

**By Date:**

* Last hour
* Last 24 hours
* Last 7 days
* Custom range

### Event Details

Click any event to see full details:

**Event Data:**

* Event name and ID
* Timestamp (workspace timezone)
* Event properties (all parameters)

**User Data:**

* Email, visitor ID, user ID
* Device (browser, OS, type)
* Location (city, region, country)

**Attribution:**

* Source, medium, campaign
* Click IDs (fbclid, gclid, ttclid)
* Landing page
* Referrer

**Session:**

* Session ID
* Session start time
* Events in session
* Session source

### Event Search

Search events by any field:

```
Search: "purchase"
Shows: All purchase events

Search: "user@example.com"
Shows: All events from that email

Search: "utm_campaign=summer_sale"
Shows: Events from that campaign
```

Search is instant and case-insensitive.

### Export Events

Download events for analysis:

**CSV Export:**

* All visible events
* All properties included
* Ready for Excel/Sheets

**JSON Export:**

* Raw event data
* Full property structure
* For developers

## Use Cases

**Verify Tracking**

```
Install tracking script
Visit your site
Check Event Stream
Confirm pageview appears
```

**Debug Events**

```
Track custom event
View in Event Stream
Check all properties sent
Verify data structure
```

**Test Conversions**

```
Complete purchase on site
See purchase event in stream
Verify order_id and value
Check attribution data
```

**Monitor User Activity**

```
Watch events from specific user
See their navigation path
Debug reported issues
Understand user behavior
```

**Check Integration**

```
New Shopify order created
Event appears in stream
Verify order properties
Confirm attribution correct
```

## How It Works

### Event Processing

**Flow:**

```
1. Event tracked (website, SDK, integration)
2. Processed by DATALYR servers
3. Enriched with attribution
4. Appears in Event Stream (< 1 second)
5. Stored in database
```

Real-time processing ensures events appear immediately.

### Data Retention

**Event Stream Shows:**

* Last 7 days of events by default
* Up to 10,000 most recent events
* Filter to see older events

**Full History:**

* All events stored permanently
* Access via Reports and Customer Journeys
* Export for custom analysis

### Event Types

**Automatic Events:**

* pageview (every page load)
* session\_start (new sessions)
* session\_end (after 30min inactivity)

**Custom Events:**

* Any event you track with `track()`
* Custom properties included
* Full flexibility

**Integration Events:**

* Shopify orders (order\_paid, order\_fulfilled)
* Stripe payments (payment\_succeeded, subscription\_created)
* Platform conversions

## Best Practices

**Verify New Events:**

* Always test in Event Stream first
* Check property names match expectations
* Verify data types (string, number, boolean)

**Debug with Filters:**

* Filter by event name to focus
* Search by email when debugging specific user
* Use date range for historical investigation

**Check Attribution:**

* Verify UTM parameters captured
* Confirm click IDs present (for ads)
* Check source/medium assignment

**Monitor Conversions:**

* Watch purchase events
* Verify conversion values
* Check attribution data includes campaign info

**Use for Training:**

* Show team how tracking works
* Demonstrate event flow
* Explain attribution in real-time

## Limitations

**Recent Events Only:**

* Event Stream shows last 7 days
* Older events via Reports or Customer Journeys
* Not a full event database browser

**No Editing:**

* Events are read-only
* Cannot modify or delete events
* Cannot resend events

**Performance:**

* High-traffic sites may see delayed events
* Stream shows sample on very high volume
* All events still processed and stored

## Next Steps

<CardGroup cols={2}>
  <Card title="Customer Journeys" icon="route" href="/features/customer-journeys">
    View complete user timelines
  </Card>

  <Card title="Events Overview" icon="bolt" href="/understanding-data/events-overview">
    Learn about events
  </Card>

  <Card title="Properties and Metadata" icon="tags" href="/understanding-data/properties-and-metadata">
    Understand event properties
  </Card>

  <Card title="Dashboard" icon="gauge" href="/features/dashboard">
    View aggregated metrics
  </Card>
</CardGroup>
