Getting Started with Atra-RMS

The Overview page is your command center in Atra RMS, offering a birds-eye view of your fleet and activity. From the navigation panel on the left, you can manage your Devices, VPN, Organizations, Users, and Roles. The panel also includes quick-access buttons to download the Atra VPN Client, view the Docs, or switch between light and dark modes via the theme toggle. For a cleaner view, you can collapse the panel using the icon at its top-right corner.
Device, VPN Tunnels & Organization Summary Cards
The six summary cards at the top display metrics for your organization and its immediate child organizations (1 level below).
Card Breakdown
1. Online Devices
Displays: Number of devices currently online
Scope: Your organization + direct child organizations only
2. Offline Devices
Displays: Number of devices currently offline
Common Reasons: Device powered off, network issues, or maintenance
Action: Click through to Device List to investigate specific offline devices
Scope: Your organization + direct child organizations only
3. All Devices
Displays: Total registered devices under your management
Calculation: Online + Offline devices
Scope: Your organization + direct child organizations only
4. Active VPN
Displays: Number of active VPN Tunnels currently running
Scope: Your organization + direct child organizations only
5. Total VPN
Displays: Number of total VPN Tunnels
Calculation: Running + Exited 
Scope: Your organization + direct child organizations only
4. Child Organizations
Displays: Count of immediate child organizations
Example: If your Level 1 org has 3 direct children, this shows "3"
Note: Does not count grandchild organizations (Level 3)
💡 Tip: Use these cards for quick health checks. A sudden spike in offline devices may indicate network issues requiring investigation.
Welcome Card & Key Action
Located on the right side of the summary section, this card provides quick access to the most common initial action.
Components
Welcome Message
Brief introduction to Atra RMS platform
Displayed on every login to orient new users
REGISTER DEVICE Button (Orange)
Purpose: Fast-track device registration
Action: Navigates directly to Device Registration form
Shortcut: Bypasses Devices menu navigation
When to Use: Registering new Gateways to your fleet
Device Statistics Charts
All Devices Bar Chart (Right Side)
This chart provides a visual breakdown of your online and offline device fleet by model type.
Chart Elements:
X-Axis: Device model names (e.g., AG-702-LT-EU-V48, AG-207-LT-EU)
Y-Axis: Total device count
Bar Values: Displays the total count of online and offline devices above each bar. Numbers in the green section indicate the online device count, while numbers in the red section indicate the offline device count.
Scope: Your organization + direct child organizations
Use Cases:
Activity Status: View ratios of Online vs. Offline devices across your entire fleet.
Device Status Activity (Left side)
This list provides a snapshot of the most recent connectivity events, highlighting exactly how long ago a device moved to its current Online or Offline state.
Card Elements:
Device Name: The specific identifier/name of the device.
Organization: The organization or child organization the device belongs to.
Status: A color-coded indicator showing the current state (Online/Green or Offline/Red).
Status Changed Time: Displays the relative or absolute time the device last switched status (e.g., "Online since 1 hour ago" or "Offline since 6 hours ago").
Time Filters: Quick-toggle options to filter events within the last 1, 6, 12, or 24 hours.
Scope: Your organization + direct child organizations.
Use Cases:
Connectivity Troubleshooting: Identify devices that have recently dropped offline to prioritize immediate maintenance or remote restarts.
Stability Monitoring: Observe if specific organizations are experiencing frequent "flapping" (devices repeatedly cycling between online and offline).
Deployment Validation: Confirm that newly installed devices have successfully reached an "Online" status within the expected timeframe.
Map Functionality
The interactive map displays geographic locations of your device fleet.
Location Data Sources
Devices appear on the map only when location data is available from:
GPS Service (Automatic)
Device fetches GPS coordinates
Manual Entry
The User sets fixed coordinates
Stored in cloud only (not on device)
Useful for stationary installations without GPS
⚠️ Important: If neither source is active, the device will not appear on the map, even if online.
Device Status Indicators
Online Device Icon:
Gateway symbol with Wi-Fi icon
Green dot indicator
Hover to see Serial Number
Offline Device Icon:
Gateway symbol with warning/alert icon
Hover to see Serial Number
Map Navigation
Zoom Controls:
Plus (+) Button: Zoom in for detailed view
Minus (-) Button: Zoom out for broader overview
Location: Top-left corner of map
Mouse Wheel: Alternative zoom method (if supported)
Pan/Drag:
Click and hold to drag map
Reposition view to focus on specific regions
💡 Pro Tip: Use the map for quick visual confirmation that devices are deployed in expected locations.
Currently Connected Users (Right side)
This card displays a view of all users currently connected to the VPN tunnel via the Atra VPN Client.
Card Elements:
User Name: The identity of the user currently connected.
Organization: The name of the organization with which the user is associated.
VPN Tunnel Name: The name of the VPN tunnel to which the user is connected.
Connected Time: The specific timestamp when the user established the connection to the VPN tunnel.
Scope: Your organization + direct child organizations.
Use Cases:
Gain instant visibility into how many users are actively working via VPN at any given moment.
See which VPN tunnels are most heavily utilized by tracking the distribution of active users across available tunnels.
Note: This card will only be displayed if a user is connected; otherwise, the map will be shown in full width.
Recent Activity Tables
Recently Registered Devices
This table shows the last 10 devices added to your system, providing a quick view of new devices onboarding.
Column
Information
Name
Custom device identifier
Model
Gateway model name
Organization
Assigned organizational name
Registered By
User who registered the device
Registered On
Date and time of registration
Key Action:
Click device Name → Opens full Device Detail Page for monitoring
Common Uses:
Verify recent device additions were processed correctly
Identify who registered devices
Recently Added Child Organizations
This list shows the last 5 child organizations created.
Column
Information
Name
Child organization identifier
Created On
Date and time of creation
Common Uses:
Verify that new organizations were created correctly
Device Count by Organization (Treemap)
The treemap provides an intuitive visual representation of device distribution across your organizational hierarchy.
Understanding the Treemap
Visual Encoding:
Rectangle Size: Proportional to number of devices in that organization
Larger Rectangle: More devices assigned
Smaller Rectangle: Fewer devices assigned
Data Display:
Organization Label: Name visible inside each rectangle
Hover Tooltip: Shows exact device count
Color: Each organization has a distinct color
Important Scope Note
⚠️ Critical Understanding:
Each rectangle shows ONLY devices registered directly to that specific organization. It does NOT include devices from child organizations below it.
Example:
ATREYO (Level 1): 50 devices registered directly
DEMO_1 (Level 2 child): 30 devices registered directly
Treemap shows: ATREYO = 50, DEMO_1 = 30 (NOT 80)