CredVault
Dashboard

System Monitoring

Monitor your CredVault platform's health and performance. Track metrics, get alerts, and troubleshoot issues.

Dashboard Overview

The monitoring dashboard shows:

  • System Status - Overall platform health (green/yellow/red)
  • Resource Usage - CPU, memory, disk utilization
  • Database Performance - Query times, connection count
  • Active Sessions - Users currently online
  • Error Rates - Failed requests and errors

Key Metrics

Performance Metrics

  • API Response Time - Average time to respond to requests (target: <200ms)
  • Database Query Time - Average query duration (target: <500ms)
  • Throughput - Requests per second your system handles
  • Error Rate - Percentage of failed requests (target: <0.1%)

Resource Metrics

  • CPU Usage - Processor utilization percentage
  • Memory Usage - RAM utilization percentage
  • Disk Usage - Storage space used
  • Network I/O - Data sent and received

Business Metrics

  • Active Users - Users currently using the platform
  • Total Queries - Queries executed
  • Data Transferred - Total data processed
  • Workspace Count - Active Coder workspaces

Viewing Metrics

Time Ranges

Select how far back to look:

  • Last Hour - Recent activity
  • Last 24 Hours - Daily trend
  • Last 7 Days - Weekly pattern
  • Last 30 Days - Monthly overview
  • Custom - Choose specific date range

Metric Details

Click any metric to see:

  • Detailed graph with historical data
  • Peak and average values
  • Comparison to previous period
  • Anomalies and spikes

Setting Alerts

Create an Alert

  1. Click New Alert
  2. Select metric (e.g., "Error Rate")
  3. Set threshold (e.g., ">5%")
  4. Choose notification method:
    • Email
    • Slack
    • PagerDuty
    • SMS

Alert Examples

  • Alert when error rate exceeds 1%
  • Alert when database response time > 1 second
  • Alert when CPU usage > 80%
  • Alert when disk usage > 90%

Managing Alerts

  • Pause alerts during maintenance
  • Adjust thresholds based on your needs
  • View alert history
  • Test alert notifications

Logs and Events

Event Timeline

See what happened and when:

  • User logins/logouts
  • Database operations
  • API calls and errors
  • Configuration changes
  • Performance issues

Filter Events

Find specific events:

Timestamp: Last 24 hours
Event Type: Errors only
Resource: Database cluster
Status: Failed

Export Logs

Download logs for analysis:

  • CSV format for spreadsheets
  • JSON format for tools
  • Custom time ranges

Troubleshooting

High CPU Usage

  1. Check what's running:
    • Active queries
    • Background jobs
    • User sessions
  2. If sustained:
    • Check for runaway queries
    • Review notebook execution
    • Look for loops/recursion
  3. Solutions:
    • Optimize slow queries
    • Cancel long-running processes
    • Scale resources if needed

High Memory Usage

  1. Identify memory consumers:
    • Large datasets in memory
    • Too many open connections
    • Memory leaks in code
  2. Solutions:
    • Process data in chunks
    • Close unused connections
    • Restart services if needed

Slow Queries

  1. Check query metrics:
    • Query execution time
    • Number of scanned rows
    • Index usage
  2. Optimize:
    • Add indexes on frequently searched columns
    • Simplify complex queries
    • Use projections to fetch only needed fields

Connection Issues

  1. Check connection count:
    • Current connections
    • Max allowed connections
    • Connection pool status
  2. If at limit:
    • Close unused connections
    • Increase connection limit
    • Use connection pooling

Best Practices

Regular Monitoring

  • Check dashboard daily
  • Review weekly trends
  • Compare month-to-month

Set Appropriate Thresholds

Don't set alerts too sensitive (will alert constantly) or too loose (will miss issues)

Response Procedures

When alerted:

  1. Check what changed
  2. Verify it's actually a problem
  3. Take action (optimize, scale, etc.)
  4. Verify resolution

Capacity Planning

Use historical data to:

  • Predict when you'll need more resources
  • Plan scaling in advance
  • Budget for growth

Advanced Features

Custom Metrics

Log custom metrics from your applications:

from credvault import metrics

metrics.gauge('custom_metric_name', value=100)
metrics.counter('events', increment=5)

Dashboards

Create custom dashboards with:

  • Selected metrics
  • Custom time ranges
  • Specific alerts
  • Team-specific data

Reports

Generate automated reports:

  • Daily summary
  • Weekly trends
  • Monthly insights
  • Emailed automatically