# Live Events

> Real-time event debugger - see events flowing through your pipeline as they happen

Source: https://docs.graph8.com/developers/live-events/

Live Events is graph8's real-time event debugger. After installing the [SDK](https://docs.graph8.com/developers/sdk/), open Live Events to see events arriving instantly - verify your integration works in seconds.

## Opening Live Events

Go to **Connections > Live Events** in your graph8 dashboard. Events appear as they arrive.

## What You See

Each event shows:

| Field | Description |
|-------|-------------|
| **Timestamp** | When the event arrived |
| **Type** | `page`, `track`, or `identify` |
| **Event name** | For track events (e.g., "signup", "purchase") |
| **Source** | Which stream/site sent it |
| **Destination status** | Delivery status per destination |
| **Function results** | Output from any functions that processed it |

Click any event to expand the full JSON payload.

## Filtering

Filter events by:
- **Stream** - show events from a specific site/source
- **Destination** - show events going to a specific destination
- **Event type** - page views, track events, identify calls
- **Date range** - historical events within a time window

## Verifying Your SDK Installation

After adding the [JavaScript SDK](https://docs.graph8.com/developers/sdk/) to your app:

1. Open **Connections > Live Events**
2. Load your app in a browser
3. You should see a `page` event appear within seconds
4. Click a button that calls `g8.track()` - see the event arrive
5. Call `g8.identify()` - see the identify event with user traits

If events don't appear:
- Check that your **write key** matches the stream's browser key
- Check that your **domain** is in the stream's allowed domains list
- Open browser DevTools Network tab and look for requests to `t.graph8.com`

## Debugging Functions

When [Functions](https://docs.graph8.com/developers/functions/) process an event, Live Events shows:
- The original event (before function)
- Function log output (`ctx.log` messages)
- The transformed event (after function)
- Whether the function dropped the event

## Debugging Destinations

For each event, Live Events shows delivery status per [Destination](https://docs.graph8.com/developers/destinations/):
- ✅ Delivered successfully
- ⏳ Pending delivery
- ❌ Delivery failed (with error details)

> **Tip: First-time setup?**
> The recommended workflow: install the [SDK](https://docs.graph8.com/developers/sdk/), open Live Events, verify events arrive, then add [Destinations](https://docs.graph8.com/developers/destinations/) and [Functions](https://docs.graph8.com/developers/functions/).
