Skip to main content

Events Explorer

The Events Explorer tab allows you to analyze your event log data in real-time, supporting a variety of queries against the data you send us by when you use our SDKs or integrations.

info

NOTE: Events Explorer is a sampled dataset - it trades off quantity and exact correctness to make your data available closer to real time. It is useful for measuring trends, comparing day over day or week over week, or getting a high level look at your events. It cannot give you all data for a specific user (The (Users Tab)[/users] can though!), nor can it give you a completely accurate count or export of a specific event.

Events Explorer Use Cases

We built Events Explorer with two primary use cases in mind:

  1. Diagnosing Product Performance: As you accelerate your product development velocity, Events Explorer enables you to monitor and interactively analyze how your product is performing in real-time. Product performance issues can range from app crashes to seemingly innocuous bugs that impact app-wide usage. Compared to pre-aggregated graphs that limit root cause analyses, Events Explorer allows you to dive deep into arbitrary product data for real-time, ad-hoc analyses.
  2. Exploratory Analyses: As you experiment with more product features, Events Explorer enables you to investigate product usage patterns that can point to further improvements and new product hypotheses. For example, we've been using the Events Explorer over the last couple of weeks to better understand customer onboarding patterns on Statsig.

How to use Events Explorer

  1. When you first land on the Events Explorer tab from the left hand navigation bar, you'll see a Table view of the top 20 events that you're logging, ordered by volume.
  2. To dive deeper into any of these events, you may want to start by looking at samples of this event. You can do this by switching to the Samples view from the Results View dropdown. In the Filters section, select eventName from the dropdown, enter the name of the event you want to explore, and hit Run Query. This will generate a sample of the most recent events with the columns that you've selected.
  3. Suppose you want to see the trend for this event over the last week. Switch to the Time Series view, set the Group By field to eventName, the Aggregation field to count, set the Time Range to Past 1 week, and hit Run Query to see how this event is trending over time.
  4. Suppose you want to chart the sum or average of a property for this event. Select Sum or Average from the Aggregation dropdown, and select the property to aggregate from the dropdown next to it. Hit Run Query to see the Time Series view of the aggregation. You can further breakdown this aggregation by setting the Group By column to the dimension you want to see (e.g. country in the last screenshot below).

Time series view: Screen Shot 2022-06-02 at 9 26 13 AM

Samples view: Screen Shot 2022-06-02 at 9 30 51 AM

Table view: Screen Shot 2022-06-02 at 9 30 34 AM

Annotations

If you click on Edit Data Settings at the top of the page, you will get a dialog that allows you to configure up to five Feature Gates and Experiments. Once you add some and Save, any future events that happen in your product will get annotated with these Feature Gates and Experiments - we will evaluate the selected Feature Gates and Experiments for each row, and add the results of those evaluations in the exposures column in Events Explorer. This allows you to quickly filter and group by experiment groups, and see how your events and metrics are changing in real-time.

Notes

Events Explorer uses sampled data over a 14-day rolling window. Whenever you aggregate data (count, average, sum), we use the inverse of the sampling rate for a given row as the weight, to provide approximate values of the aggregation.