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

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

Every event is read from the SDK event store, written by the SDK + ingest pipeline. Real-time updates come in via a realtime subscription scoped to the project's app_id set.

What's 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 (auto-discovered from the current event set).
  • A recent event 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

• 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

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.