Documentation

Your Cameras. Anywhere. Instantly.

TheRelay Dashboard Overview

TheRelay Dashboard

The TheRelay Dashboard is your central hub for managing all aspects of your RTSP streaming infrastructure. Monitor camera streams in real-time, manage agents, create tokens, and access configuration settings.

Main Features

  • Real-time camera stream monitoring
  • Agent management and status
  • Token and access control management
  • Performance metrics and analytics
  • Stream endpoint configuration
  • Comprehensive activity logging

Dashboard Sections

  • Overview - At-a-glance system status
  • Cameras - View and manage streams
  • Agents - Monitor publishing agents
  • Tokens - Access control management
  • Settings - Account and security config
  • Logs - Activity and event history

Overview Dashboard

The Overview dashboard provides a quick status of your entire TheRelay deployment.

Status Indicators

  • System Health: Overall connectivity and performance
  • Active Agents: Number of connected agents reporting streams
  • Active Cameras: Total streams currently being published
  • Cloud Endpoints: Available access methods (WebRTC, RTSP, HLS, RTMP, SRT)
  • Total Bandwidth: Combined bitrate of all active streams

Quick Actions

From the Overview, you can quickly:

  • View all agents at a glance with status
  • See cameras grouped by agent
  • Access stream endpoints directly
  • Create new tokens for access control
  • Launch agent configuration wizards

Recent Activity

View recent events on your account:

  • New camera additions
  • Agent connections and disconnections
  • Stream availability changes
  • Token creation and revocation
  • Access patterns and usage

Cameras View

The Cameras section displays all your published camera streams with detailed status and control options.

Camera List

For each camera, you can see:

  • Camera Name: User-defined friendly name
  • Agent: Which agent is publishing the stream
  • Status: Connected/Offline/Error status with uptime
  • Bitrate: Current stream bitrate
  • Resolution: Video resolution and frame rate
  • Duration: How long stream has been active

Camera Controls

Click on any camera to access:

  • Live Preview: Watch the stream in dashboard
  • Stream Endpoints: Get WebRTC/RTSP/HLS/RTMP/SRT URLs
  • Configuration: Edit camera settings
  • Tokens: Create tokens for this camera
  • Metrics: View detailed performance data
  • History: Review connection history and logs

Stream Search and Filter

  • Search by camera name or IP address
  • Filter by agent
  • Filter by status (online/offline)
  • Sort by name, status, or bitrate

Metrics and Performance Monitoring

TheRelay Dashboard provides detailed performance metrics for all your streams.

Stream Metrics

  • Bitrate: Current encoding bitrate
  • Frame Rate: Frames per second
  • Resolution: Video resolution
  • Codec: Video compression format
  • Connections: Number of active viewers

Agent Metrics

  • CPU Usage: Agent process CPU consumption
  • Memory Usage: Agent RAM consumption
  • Network I/O: Incoming and outgoing bandwidth
  • Reconnections: How many times agent reconnected to cloud
  • Error Count: Number of failures or issues

Health Indicators

Dashboard shows health status with color coding:

  • Green: All systems operational
  • Yellow: Minor issues or degraded performance
  • Red: Critical issue or offline
  • Click for details on what issues detected
TheRelay dashboard showing live streams with ingress and egress metrics
TheRelay Dashboard - Monitor streams with real-time metrics

Agents Management

Manage all your TheRelay Agents from the Agents section of the dashboard.

Agent List

View all installed agents with:

  • Agent name and ID
  • Connection status and uptime
  • Operating system (Windows/Linux)
  • Number of streams published
  • Last check-in time
  • Software version

Agent Details

Click an agent to see:

  • Detailed status and connection logs
  • Cameras published by this agent
  • Performance metrics (CPU, memory, network)
  • Recent reconnection events
  • Configuration options and settings

Agent Actions

  • Restart agent service
  • Download configuration files
  • Update agent software
  • Review and update camera list
  • Configure security settings
  • Remove agent from account

Dashboard Settings

Configure your TheRelay account and preferences from the Settings section.

Account Settings

  • Account name and contact information
  • Email and notification preferences
  • Two-factor authentication setup
  • Password management
  • Billing and subscription information

Security Settings

  • API key management
  • Session management
  • Access logs and audit trail
  • IP whitelist configuration
  • Single sign-on (SSO) setup if available

Integration Settings

  • VMS integrations (HikCentral, etc.)
  • Third-party API connections
  • Webhook configurations
  • ONVIF discovery settings

Common Dashboard Tasks

Adding a New Camera

  1. Go to Cameras section
  2. Click "+ Add Camera"
  3. Select agent to publish from
  4. Enter camera name and RTSP URL
  5. Enter camera credentials
  6. Click Save and verify connection

Creating an Access Token

  1. Navigate to Tokens section
  2. Click "Create Access Token"
  3. Select camera or scope
  4. Set optional expiration
  5. Generate and copy token
  6. Share token with authorized users

Getting Stream Endpoint

  1. Click on a camera in Cameras view
  2. Look for "Stream Endpoints" section
  3. Copy desired protocol endpoint (WebRTC, RTSP, HLS, etc.)
  4. Use endpoint with appropriate access token

Monitoring Stream Health

  1. Go to Cameras section
  2. Review status indicators for each camera
  3. Click camera for detailed metrics
  4. Check reconnection logs and errors
  5. Set up alerts for offline cameras if available