> ## Documentation Index
> Fetch the complete documentation index at: https://cloud-docs.mentra.glass/llms.txt
> Use this file to discover all available pages before exploring further.

# App Uptime Model

> Application health monitoring and performance tracking

## Overview

The AppUptime model tracks the availability and performance of third-party applications. It stores time-series data for monitoring app health and response times.

## Schema Structure

```typescript theme={null}
{
  packageName: string,      // App identifier
  timestamp: Date,          // Measurement time
  health: 'healthy' | 'degraded' | 'offline',
  onlineStatus: boolean,    // Simple up/down status
  responseTimeMs: number | null  // Response latency
}
```

## Field Purposes

### packageName (string)

Identifies which app this metric belongs to:

* Links to App model via package name
* Enables per-app monitoring dashboards
* Used for alerting on specific apps

### timestamp (Date)

When this measurement was taken:

* Time-series data point
* Enables historical analysis
* Used for uptime percentage calculations

### health (enum)

Overall app health status:

* **healthy**: App responding normally
* **degraded**: Slow responses or partial failures
* **offline**: App not responding at all

### onlineStatus (boolean)

Simple binary availability:

* Quick dashboard indicators
* Uptime percentage calculations
* Triggering alerts

### responseTimeMs (number | null)

Webhook response latency:

* Performance monitoring
* SLA tracking
* Null when app is offline

## Usage Patterns

### Health Monitoring

```typescript theme={null}
// Check recent app health
const recentHealth = await AppUptime.find({
  packageName: 'com.translator.app',
  timestamp: { $gte: new Date(Date.now() - 24*60*60*1000) }
}).sort({ timestamp: -1 });
```

### Uptime Calculation

```typescript theme={null}
// Calculate uptime percentage
const total = await AppUptime.countDocuments({ packageName });
const online = await AppUptime.countDocuments({ 
  packageName, 
  onlineStatus: true 
});
const uptimePercent = (online / total) * 100;
```

### Performance Tracking

```typescript theme={null}
// Average response time
const avgResponse = await AppUptime.aggregate([
  { $match: { packageName, responseTimeMs: { $ne: null } } },
  { $group: { 
    _id: null, 
    avgMs: { $avg: '$responseTimeMs' } 
  }}
]);
```

## Data Collection

Uptime records are created by:

1. **Periodic health checks**: Every 5 minutes
2. **Webhook failures**: When app doesn't respond
3. **User reports**: Manual health updates

## Retention

* Keep high-resolution data for 7 days
* Aggregate to hourly for 30 days
* Monthly summaries retained indefinitely

## Indexes

* **packageName**: Filter by app
* **timestamp**: Time-based queries
* Compound index on both for efficient queries