Создание приложений Observability

Пошаговое руководство по созданию и настройке приложений.

Создание RUM-приложения (Frontend)

Шаг 1: Базовая информация

1. Dashboard → Observability → Apps → Create
2. Name: My Website
3. Type: Frontend (RUM)
4. Description: (опционально) Production website monitoring

Шаг 2: Whitelist доменов

Добавьте разрешённые домены (обязательно для CORS):

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

Важно: укажите все домены, на которых будет работать RUM SDK.

Шаг 3: Квоты

Настройте месячные лимиты:

• Sessions: 10 000 (подберите под трафик)
• Events: 100 000
• Replay Storage: 1GB
• Session Replay: включено/выключено

Шаг 4: Скопируйте API Key

⚠️ Сохраните сразу — показывается только один раз!

rum_1234567890abcdef1234567890abcdef

Шаг 5: Установите 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();

Создание OTLP-приложения (Backend)

Шаг 1: Базовая информация

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

Шаг 2: Квоты

Настройте лимиты:

• Spans: 100 000/мес.
• Logs: 1GB/мес.
• Metrics: без лимита (по хранению)

Шаг 3: Скопируйте токен

Сохраните токен в надёжном месте:

otlp_1234567890abcdef1234567890abcdef

Шаг 4: Настройте 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'
  }
});

Настройки приложения

Общие

• Name: обновить имя приложения
• Description: добавить описание
• Environment: production, staging, development
• Tags: добавить пользовательские теги для организации

Безопасность

• Rotate API Token: сгенерировать новый токен (старый отзывается)
• Domain Whitelist (RUM): обновить разрешённые домены
• IP Whitelist: (опционально) ограничение по IP

Квоты

• Monthly Limits: настроить квоты
• Overage Handling:
  • блокировать запросы (по умолчанию)
  • использовать баланс пополнений
  • отправлять оповещения

Уведомления

Настройте оповещения по квотам:

• предупреждение при 80% использования
• превышение квоты на 100%
• низкий баланс пополнений

Каналы: Email, Slack, Telegram, Webhooks

Управление несколькими приложениями

Организация

Используйте соглашения об именовании:

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

Фильтрация

Фильтры панели:

• по окружению
• по типу (RUM/OTLP)
• по тегам
• по уровню использования

Массовые операции

• Экспорт списка приложений (CSV)
• Массовое обновление квот
• Пакетная ротация токенов

Удаление приложений

Settings → Danger Zone → Delete App

⚠️ Внимание: это приведёт к:

• немедленному отзыву API-токена
• удалению всех собранных данных (трассы, логи, сессии)
• удалению из панели
• отменить невозможно

Подтвердите, введя имя приложения.

Следующие шаги

• Квоты — мониторинг использования
• Домены — настройка CORS
• Быстрый старт RUM — установка RUM SDK
• Обзор OTLP — настройка OTLP