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
1
Select Time Range
Use the interval dropdown to choose your analysis period:
- Last 7 days
- Last 30 days
- Last 90 days
- Custom date range
2
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.
3
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
4
Apply Grouping (Optional)
Group events by custom properties to segment your analysis:
- Customer ID: See per-customer usage
- Custom properties: Analyze by user role, plan type, region, etc.
- Feature IDs: Compare usage across features
Using Group By for Segmentation
Grouping reveals insights by breaking down events by dimensions:1
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
2
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.
3
Filter to Specific Group
Use the group filter dropdown to focus on a single value:
- Only shows data for the selected group
- Useful for drilling down into specific segments
- Clear the filter to see all groups again
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
1
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
2
Navigate Pages
Use the pagination controls to browse through events:
- First/Last page buttons
- Previous/Next page arrows
- Current page indicator shows your position
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:1
Open Customer Page
Navigate to Customers and select a customer.
2
Scroll to Analytics Section
The customer detail page includes a dedicated analytics section showing only that customer’s events.
3
Analyze Customer Usage
Use the same filtering and grouping tools, but scoped to the customer:
- See which features they use most
- Identify usage trends over time
- Understand their engagement patterns
Common Analytics Workflows
Tracking Feature Adoption
1
Filter to Feature Events
Select events related to a specific feature (e.g.,
feature_used, api_call).2
Group by Customer
Set Group By to
customer_id to see which customers use the feature.3
Analyze Over Time
Use a 30 or 90-day interval to see adoption trends.
Comparing Plan Usage
1
Set Up Grouping
Group events by
plan or plan_id property (requires sending this with events).2
Select Relevant Events
Choose events that indicate product usage.
3
Identify Patterns
Look for differences in usage between plan types to inform pricing strategy.
Finding Inactive Customers
1
Set Long Time Range
Use a 30 or 90-day interval.
2
Review Customer List
In the events table, note which customer IDs are absent or have low event counts.
3
Take Action
Reach out to inactive customers or review their subscription status.
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