Creating Observability Apps

Step-by-step guide to creating and configuring apps.

Create RUM App (Frontend)

Step 1: Basic Info

1. Dashboard → Observability → Apps → Create
2. Name: My Website
3. Type: Frontend (RUM)
4. Description: (optional) Production website monitoring

Step 2: Domain Whitelist

Add allowed domains (required for CORS):

example.com
www.example.com
*.example.com  # Wildcard for subdomains

Important: Include all domains where RUM SDK will run.

Step 3: Quotas

Configure monthly limits:

• Sessions: 10,000 (adjust based on traffic)
• Events: 100,000
• Replay Storage: 1GB
• Session Replay: Enabled/Disabled

Step 4: Copy API Key

⚠️ Save immediately - shown only once!

rum_1234567890abcdef1234567890abcdef

Step 5: Install SDK

import { StatusRadarRUM } from '@statusradar/rum';

const rum = new StatusRadarRUM({
  apiKey: 'rum_1234567890abcdef',
  appId: 'app_xyz',
  endpoint: 'https://rum.statusradar.dev/v1/ingest'
});

rum.start();

Create OTLP App (Backend)

Step 1: Basic Info

1. Dashboard → Observability → Apps → Create
2. Name: My API
3. Type: Backend (OTLP)
4. Description: Production API tracing

Step 2: Quotas

Configure limits:

• Spans: 100,000/month
• Logs: 1GB/month
• Metrics: Unlimited (retention-based)

Step 3: Copy Token

Save token securely:

otlp_1234567890abcdef1234567890abcdef

Step 4: Configure SDK

Node.js:

const { OTLPTraceExporter } = require('@opentelemetry/exporter-trace-otlp-http');

const exporter = new OTLPTraceExporter({
  url: 'https://otlp.statusradar.dev/v1/traces',
  headers: {
    'X-App-Token': 'otlp_1234567890abcdef'
  }
});

App Settings

General

• Name: Update app name
• Description: Add details
• Environment: production, staging, development
• Tags: Add custom tags for organization

Security

• Rotate API Token: Generate new token (old token revoked)
• Domain Whitelist (RUM): Update allowed domains
• IP Whitelist: (Optional) Restrict by IP

Quotas

• Monthly Limits: Adjust quotas
• Overage Handling:
  • Block requests (default)
  • Use top-up balance
  • Send alerts

Notifications

Configure quota alerts:

• 80% usage warning
• 100% quota exceeded
• Top-up balance low

Channels: Email, Slack, Telegram, Webhooks

Managing Multiple Apps

Organization

Use naming conventions:

[Product] - [Environment] - [Type]
MyApp - Production - Frontend
MyApp - Production - Backend
MyApp - Staging - Frontend

Filtering

Dashboard filters:

• By environment
• By type (RUM/OTLP)
• By tags
• By usage level

Bulk Operations

• Export app list (CSV)
• Bulk quota updates
• Batch token rotation

Deleting Apps

Settings → Danger Zone → Delete App

⚠️ Warning: This will:

• Revoke API token immediately
• Delete all collected data (traces, logs, sessions)
• Remove from dashboard
• Cannot be undone

Confirm by typing app name.

Next Steps

• Quotas - Monitor usage
• Domains - Configure CORS
• RUM Quickstart - Install RUM SDK
• OTLP Overview - Setup OTLP