Accessing Analytics
There are two ways to access analytics:- Global Analytics: Navigate to the Analytics tab in the main sidebar to see organization-wide usage
- Customer Analytics: View customer-specific usage from any customer detail page
Analytics requires ClickHouse to be enabled in your organization. Usage events are tracked via the Autumn SDK or API.
Understanding the Analytics View
The analytics page is divided into two main sections:Usage Chart
Visual representation of events over time:- Bar chart showing event volume by date
- Customizable time intervals (day, week, month)
- Group by properties for segmented analysis
- Filter by event name or feature
Events Table
Raw event data with detailed information:- Event names and timestamps
- Customer IDs and properties
- Custom event metadata
- Pagination for large datasets
Filtering Analytics Data
Select Time Range
Use the interval dropdown to choose your analysis period:
- Last 7 days
- Last 30 days
- Last 90 days
- Custom date range
Choose Events to Display
Click the event dropdown to select which events to analyze:
- Select specific events by name
- Choose feature-related events
- View all events (may be limited for performance)
If no events are selected, the chart will be empty. Select at least one event to see data.
Set Bin Size
Control how data is grouped over time:
- Day: Show daily usage patterns
- Week: Identify weekly trends
- Month: Track monthly growth
- Hour: Analyze intraday patterns
Using Group By for Segmentation
Grouping reveals insights by breaking down events by dimensions:Select Group By Property
Click the Group By dropdown to choose a property:
- Properties are extracted from your event data
- Common properties include: customer_id, plan, region, device_type
- Only properties that exist in your events are available
View Grouped Chart
The usage chart now shows separate bars for each group:
- Different colors represent different values
- Legend shows all groups
- Hover over bars to see specific values
If there are too many unique values (more than 10), the chart shows only the top 10 by volume, and a warning message appears.
Understanding Event Properties
Events can include custom properties that provide context:- Standard properties: customer_id, timestamp, event_name
- Custom properties: Any additional data you send with events
- Nested properties: Support for complex object structures
Working with the Events Table
The raw events table shows individual event records:Table Features
- Pagination: Navigate large datasets with page controls
- Sorting: Click column headers to sort (where enabled)
- Property columns: All event properties displayed as columns
- Row details: Click rows for more information
Adjusting Table View
Change Page Size
Use the page size dropdown to show more or fewer events per page:
- 100, 500, or 1000 events
- Larger page sizes load more slowly but reduce pagination
The events table shows total event count at the top. Use this to understand the scope of your data.
Customer-Specific Analytics
View analytics for individual customers:Scroll to Analytics Section
The customer detail page includes a dedicated analytics section showing only that customer’s events.
Common Analytics Workflows
Tracking Feature Adoption
Filter to Feature Events
Select events related to a specific feature (e.g.,
feature_used, api_call).Comparing Plan Usage
Finding Inactive Customers
Review Customer List
In the events table, note which customer IDs are absent or have low event counts.
Performance Considerations
Analytics queries can be resource-intensive. The dashboard implements several optimizations:
- Event data is cached for faster repeat queries
- Large result sets are paginated
- Charts are limited to prevent performance issues
Understanding Data Freshness
Analytics data updates in near real-time:- Events appear within seconds of being tracked
- Charts refresh when you change filters
- No manual refresh required
Empty States
If you see “No events found”:- No events tracked yet: Start sending events from your application
- Filters too restrictive: Widen your date range or select different events
- ClickHouse disabled: Contact support to enable analytics
The dashboard shows an empty state with a link to documentation when no analytics events exist.
Advanced Analytics Features
Property Extraction
The dashboard automatically detects custom properties in your events and makes them available for grouping and filtering.Top Events
When you open the event selector, events are sorted by frequency, showing your most common events first.Data Truncation Warning
If a grouping has too many unique values (>10), you’ll see a toast notification. The chart shows only the top 10 by volume to maintain performance.Best Practices
Analytics data is stored in ClickHouse, a high-performance analytics database designed for fast queries on large datasets.
Exporting Data
While the dashboard doesn’t have a direct export button, you can:- Use the API to fetch raw event data
- Query ClickHouse directly if you have access
- Take screenshots of charts for reports
- Copy event data from the table view
Next Steps
- Learn how to send events from your application using the Autumn SDK
- Set up custom properties for richer analytics
- Create automated reports using the API
- Monitor feature usage to inform product development