# Events Overview (/docs/events/overview)



The Events page (`/project/{projectId}/events`) is your live view of SDK
events flowing from your app. It renders a 3D globe in the background
with recent events plotted by geo, plus a sidebar with event-type filters
and a live event feed.

## Requirements [#requirements]

The page requires the **App Machina SDK** layer to be installed on the
project and at least one SDK app created. Without a layer + recent
events, you'll see an empty state that links you to Browse Layers or
the existing layer settings.

## Where data comes from [#where-data-comes-from]

Every event is read from the SDK event store, written by the
[SDK + ingest pipeline](/docs/sdk/architecture). Real-time updates come
in via a realtime subscription scoped to the project's `app_id` set.

## What's on the page [#whats-on-the-page]

* A 3D globe (background) showing up to 50 recent event pins, auto-expired
  after \~5 minutes.
* A live indicator in the top right with today's event count.
* A sidebar with:
  * [Event-type filters](/docs/events/feed) (auto-discovered from the
    current event set).
  * A recent [event feed](/docs/events/feed) with inline property drill-down.
* A **Clear** button that hides everything below a chosen cutoff (local
  UI state — doesn't touch the server).

## Refresh cadence [#refresh-cadence]

* The list is fetched as an initial page of 100 recent events.
* A realtime subscription appends new events as they land.
* No aggregation jobs run — this page only reads raw event rows.

## Privacy [#privacy]

Events display `app_user_id` as-is from `sdk_events`. For the Partner
API, PII fields (email, phone, IP) and PII-looking property keys are
redacted unless the caller holds the `events:read+pii` scope — see the
[Partner API events reference](/docs/api/reference/telemetry/events).