Observability Apps Overview

Observability Apps centralize monitoring for your frontend and backend applications with RUM and OTLP support.

What are Observability Apps?

Apps represent your monitored applications (websites, APIs, services) and provide:

• Unified dashboard for all telemetry
• Quota management (sessions, events, spans, logs)
• Domain whitelisting (CORS security)
• API token authentication
• Usage tracking and alerts

App Types

Frontend Apps (RUM)

Monitor browser-based applications:

• Core Web Vitals (LCP, INP, CLS)
• Session replay
• JavaScript error tracking
• User interaction tracking
• Console logs and network requests

Use for: Websites, SPAs, PWAs, mobile web apps

Backend Apps (OTLP)

Monitor server-side applications:

• Distributed tracing
• Structured logs
• Custom metrics
• Multi-service correlation

Use for: APIs, microservices, background jobs, databases

Creating an App

1. Dashboard → Observability → Apps
2. Click "Create App"
3. Fill in details:
   • Name: My Application
   • Type: Frontend or Backend
   • Domains: (Frontend only) example.com, app.example.com
4. Click "Create"
5. Copy API Key (shown once)

App Dashboard

Dashboard → Observability → Apps → [Your App]

Sections:

• Overview: Usage stats, recent activity
• Sessions (RUM): User sessions with replay
• Events (RUM): Custom events timeline
• Traces (OTLP): Distributed traces
• Logs (OTLP): Structured logs
• Metrics (OTLP): Time-series metrics
• Errors: JavaScript and backend errors
• Usage: Quota consumption

Quotas

Each app has monthly quotas:

RUM Quotas

• Sessions: Unique user sessions (default: 10,000/month)
• Events: Total events captured (default: 100,000/month)
• Replay Storage: Session replay data (default: 1GB/month)

OTLP Quotas

• Spans: Trace spans (default: 100,000/month)
• Logs: Log storage (default: 1GB/month)
• Metrics: Unlimited with retention limits

Security

Domain Whitelisting (RUM)

Only accept data from authorized domains:

Settings → Domains → Add:

example.com
www.example.com
app.example.com

CORS enforced - requests from other domains blocked.

API Token

Authenticate all requests:

# RUM
https://rum.statusradar.dev/v1/ingest?api_key=YOUR_KEY

# OTLP
curl -H "X-App-Token: YOUR_KEY" \
  https://otlp.statusradar.dev/v1/traces

Rotate tokens: Settings → Security → Regenerate Token

Top-Ups

Purchase additional quota when plan limits exceeded:

Dashboard → Billing → Top-Ups

Available top-ups:

• RUM Sessions: +10,000 sessions
• RUM Events: +100,000 events
• Replay Storage: +5GB
• OTLP Spans: +100,000 spans
• OTLP Logs: +5GB

Auto-deducted from balance when quota exceeded.

Multi-Environment Setup

Create separate apps for each environment:

• My App - Production (OTLP)
• My App - Staging (OTLP)
• My Website - Production (RUM)
• My Website - Staging (RUM)

Benefits:

• Isolated quotas
• Environment-specific tokens
• Separate usage tracking
• Filtered dashboards

Next Steps

• Creating Apps - Detailed setup guide
• Quotas - Managing usage limits
• Domains - CORS configuration
• Top-Ups - Purchase additional quota