# Exploring the Dashboard The Trailonix dashboard provides a comprehensive overview of your application's logging activity, subscription usage, and alert status. It's your central command center for monitoring application health and staying on top of critical events. ## Dashboard Overview Navigate to **"Dashboard"** in the Logging section to access your main overview. The dashboard is organized into several key sections that give you both high-level insights and actionable information about your logging activity. ## Log Events Chart The **Log Events** chart shows your logging volume over the last 7 days, helping you understand patterns and identify unusual activity. ### Understanding the Chart - **Y-axis**: Number of log events per day - **X-axis**: Date range (last 7 days) - **Blue line**: Daily log event volume **What to Look For:** - **Sudden spikes**: May indicate errors, increased traffic, or new features generating more logs - **Unexpected drops**: Could signal application issues, reduced usage, or logging problems - **Pattern changes**: Different usage patterns that might require attention - **Weekend vs weekday patterns**: Normal variations in application usage **Example Analysis:** If you see a spike from 2,000 events to 8,500 events, investigate: - Were there any deployments that day? - Did any error conditions occur? - Was there increased user activity? - Are you logging new event types? > **💡 Pro Tip:** Use this chart to validate that your logging is working correctly. No activity might mean your application isn't sending logs to Trailonix. ## Top Event Types The **Top Event Types** pie chart breaks down your most frequent event types over the last 7 days, showing you what your application is logging most often. ### Reading the Chart - **Percentages**: Show the relative frequency of each event type - **Color coding**: Each event type gets a unique color for easy identification - **Legend**: Lists all event types with their corresponding colors **Common Types of Events You Might See:** - **User authentication events** - Login attempts, successes, failures, logouts - **System maintenance events** - Cleanup processes, scheduled tasks, resets - **Business process events** - Orders, payments, user actions, workflows - **Error and warning events** - System errors, validation failures, timeouts - **Integration events** - API calls, webhooks, third-party service interactions - **Security events** - Permission checks, suspicious activity, access attempts ### What This Tells You **High-Frequency Events:** - **System events** (cleanups, resets) are normal and expected - **User events** (login/logout) indicate application usage - **Error events** appearing frequently may need attention **Event Type Analysis:** - **Balanced distribution**: Indicates healthy, varied application activity - **Single event dominating**: May indicate an issue or missing event types - **Missing expected events**: Could mean certain features aren't logging properly > **📊 Dashboard Strategy:** If you see event types you don't recognize, review your application code to ensure you're using consistent event type naming as outlined in the [Event Types Strategy Guide](/guides/event-types). ## Subscription Limits The **Subscription Limits** section shows your current usage against your plan limits, helping you monitor consumption and plan for upgrades. ### Current Plan Information Your dashboard shows: **"Your current subscription plan is: Professional"** ### Usage Tracking **Tenants: 3 / 10** - You're using 3 tenants out of your 10 allowed - **Progress bar**: Visual indicator of usage (blue fill shows current usage) - **Good capacity**: Room for 7 more application environments **Alert Rules: 12 / 100** - You have 12 alert rules configured out of 100 allowed - **Moderate usage**: Good monitoring coverage with room to grow - **Recommendation**: Consider adding more rules for comprehensive monitoring **Premium Alerts: 1,247 / 15000** - You've used 1,247 premium alerts (SMS or critical email alerts) - **Comfortable usage**: Well within your generous allowance - **Cost tracking**: Premium alerts are the main usage-based cost **Daily Logs: 18,432 / 500000** - Today you've logged 18,432 events out of 500,000 daily limit - **Normal usage**: Healthy activity level with plenty of headroom - **Monitoring**: This resets daily, so track patterns over time **Monthly Overage: 0** - No overage charges this month - **Cost control**: Shows you're staying within your plan limits - **Clean billing**: No unexpected charges ### Understanding the Progress Bars Each limit shows a progress bar with different visual indicators: - **Blue fill (< 75% usage)**: Safe usage level with plenty of capacity - **Yellow fill (75-89% usage)**: Approaching limits, consider planning ahead - **Red fill (90%+ usage)**: Near capacity, take action soon - **Gray background**: Remaining capacity available **When to Take Action:** - **Yellow (75-89% usage)**: Start planning for upgrades or usage optimization - **Red (90%+ usage)**: Take immediate action to avoid hitting limits - **At limit**: May impact functionality or incur overage charges ## Recent Alerts The **Recent Alerts** section shows alerts triggered over the last 7 days, helping you stay on top of issues and system events. ### Alert Information **Example Alert:** - **Alert Name**: `syslog_critical` - **Triggered**: `6/25/25, 2:07 AM` - **Recent activity**: Shows the most recent alert that fired ### What This Section Shows **When You Have Alerts:** - **Alert rule names**: Identifies which rule triggered - **Timestamp**: When the alert fired - **Quick access**: See recent activity at a glance **When You See "No Recent Alerts":** - **Quiet period**: No alerts have fired recently - **Good sign**: May indicate stable application performance - **Check alert setup**: Ensure your alert rules are configured correctly ### Alert Analysis **Recent Alert Activity Indicates:** - **System issues**: Critical alerts often indicate problems needing attention - **Monitoring effectiveness**: Alerts are working and catching issues - **Response needed**: Recent alerts may require investigation or action **No Recent Alerts Could Mean:** - **Stable system**: Everything is running smoothly - **Alert rules need adjustment**: Thresholds might be too high - **Missing coverage**: Important events might not have alert rules > **🚨 Action Item:** Click on recent alerts to see details and determine if any action is needed. ## Recently Suppressed Alerts The **Recently Suppressed Alerts** section shows alerts that were triggered but not sent due to suppression rules. ### Understanding Suppression **When You See "No Recent Suppressions":** - **No repeated alerts**: Alert rules haven't triggered multiple times within suppression windows - **Effective thresholds**: Your alert thresholds may be well-tuned - **Clean alerting**: Not experiencing alert fatigue **When You See Suppressed Alerts:** - **Alert rule name**: Which rule was suppressed - **Suppression period**: Why the alert wasn't sent - **Pattern analysis**: Multiple suppressions might indicate issues ### Why Alerts Get Suppressed **Suppression Purpose:** - **Reduce noise**: Prevents flooding from repeated alerts - **Focus attention**: Ensures you see unique issues, not duplicates - **Cost control**: Suppressed alerts don't count toward premium limits **Common Suppression Scenarios:** - **Intermittent issues**: Problem occurs repeatedly but isn't persistent - **Batch processing**: Regular system events that occasionally trigger alerts - **Configuration tuning**: Alert thresholds need adjustment ## Dashboard Best Practices ### Daily Monitoring Routine **Quick Health Check:** 1. **Log Events Chart**: Verify normal logging activity 2. **Subscription Limits**: Check usage levels 3. **Recent Alerts**: Review any new alerts 4. **Top Event Types**: Ensure expected application activity ### Weekly Analysis **Trend Review:** 1. **Compare weekly patterns** in the log events chart 2. **Analyze event type distribution** changes 3. **Review alert patterns** and suppression trends 4. **Plan capacity** based on usage growth ### Monthly Planning **Subscription Management:** 1. **Review usage trends** against plan limits 2. **Plan for growth** if approaching limits 3. **Optimize alert rules** based on suppression patterns 4. **Consider plan adjustments** if needed ## Troubleshooting Common Dashboard Issues ### "No Log Events Showing" **Possible Causes:** - Application not sending logs to Trailonix - Incorrect API key configuration - Network connectivity issues - Tenant selection issues **Solutions:** - Verify API key is correct and active - Check application logging configuration - Test log sending with a simple API call - Confirm tenant selection in dashboard ### "Unexpected Event Types" **Possible Causes:** - Inconsistent event type naming in application - Multiple developers using different conventions - Legacy code with old event types **Solutions:** - Review [Event Types Strategy Guide](/guides/event-types) - Audit application code for event type usage - Implement constants for event type names - Standardize naming across team ### "Too Many Premium Alerts" **Possible Causes:** - Alert rules set to "Critical" unnecessarily - SMS alerts configured when email would suffice - Alert thresholds too sensitive **Solutions:** - Review alert urgency settings (use Batch when possible) - Replace SMS with email alerts where appropriate - Adjust alert thresholds to reduce false positives - Increase suppression periods for non-critical alerts ### "Missing Expected Alerts" **Possible Causes:** - Alert rules not configured for important events - Event types not matching actual log events - Alert thresholds set too high - Suppression periods too long **Solutions:** - Review alert rule configuration - Verify event type names match exactly - Lower alert thresholds for testing - Check suppression settings - Test alerts with known conditions ## Dashboard Customization Tips ### Optimizing Your View **Focus Areas:** - **Monitor most critical metrics** for your application - **Set up alerts** for key business and system events - **Review patterns regularly** to understand normal vs abnormal activity - **Use subscription limits** to plan capacity and costs **Time Range Considerations:** - **7-day view**: Good for short-term pattern analysis - **Look for weekly cycles**: Business vs weekend usage patterns - **Identify growth trends**: Increasing log volume over time ### Integration with Workflows **Development Workflow:** - Check dashboard after deployments - Monitor for new event types from feature releases - Verify alert rules work with new functionality **Operations Workflow:** - Daily dashboard review for issues - Weekly pattern analysis for trends - Monthly usage review for planning **Team Communication:** - Share dashboard insights in team meetings - Use alert data for incident reviews - Reference usage patterns for capacity planning ## What's Next? Now that you understand the dashboard, you can: - **[Set up more alert rules](/guides/setting-up-alerts)** to improve monitoring coverage - **[Review your event types strategy](/guides/event-types)** to ensure consistent logging - **[Explore the logs section](/guides/logs)** to investigate specific events and patterns - **[Check your subscription settings](/guides/subscription)** to optimize your plan and usage --- **📊 Ready to optimize your monitoring?** Use the insights from your dashboard to create better alert rules and improve your application's logging strategy. The dashboard is your window into application health—make it work for you!