AstraNetmon

Getting Started

Learn how to set up AstraNetmon and start monitoring your network in minutes

Overview

AstraNetmon is a network monitoring platform that provides real-time visibility into your fleet's latency, jitter, packet loss, uptime, and ISP health. This guide walks you through deploying your first agent and exploring the platform's features.

ℹ️

Before you begin: Make sure you have an active AstraNetmon account. Contact support@astraid.io or request a demo on the homepage to get access.

Quick Start Checklist

1.
Log in to your dashboard

Navigate to your organization's subdomain

2.
Create a site & enrollment key

Dashboard → Sites → (your site) → Enrollment Keys

3.
Run the one-line installer

Paste the curl/PowerShell command with your --key on any device

4.
Verify the agent is online

It should appear in Dashboard → Agents within seconds

5.
Configure alerts (optional)

Set up email or webhook notifications

Step 1: Access the Dashboard

Login

Navigate to your AstraNetmon dashboard and log in with your credentials.

url
https://your-org.astraid.io/login
ℹ️

If your organization has MFA enabled, you'll be prompted for a verification code after entering your password.

Dashboard Overview

Once logged in, the main dashboard shows:

  • Fleet health summary with online/offline agent counts
  • Real-time latency, jitter, and packet loss graphs
  • Alert notifications
  • Nova AI assistant for natural-language fleet analysis

Step 2: Get Your Agent API Key

  1. Navigate to Dashboard → Settings → Agents
  2. Find the Agent API Key section
  3. Click Show Key to reveal your API key
  4. Copy the key — you'll need it during agent installation
⚠️

Keep your API key secure. This key allows agents to report data to your account. Don't share it publicly or commit it to version control.

Step 3: Download & Install the Agent

The fastest path is the one-line installer. Grab a site enrollment key from Sites → (your site) → Enrollment Keys, then run one command on the device:

bash
# Linux / macOS
curl -fsSL https://get.astraid.io/install.sh | sudo sh -s -- --key enroll_xxxxxxxx
powershell
# Windows (elevated PowerShell)
iwr https://get.astraid.io/install.ps1 -useb | iex; Install-AstraAgent -Key enroll_xxxxxxxx

The agent self-registers, self-updates, and starts reporting within seconds. The Settings → Agents page shows the same command pre-filled with your values. For manual installs, version pinning, or a step-by-step walkthrough, see the Agent Installation Guide.

🪟 Windows

Install as a Windows Service

🐧 Linux

Install with systemd service

🍎 macOS

Install with launchd

Step 4: Verify Agent Connection

  1. Return to the AstraNetmon dashboard
  2. Navigate to Dashboard → Agents
  3. Your new agent should appear with a green "Online" status
  4. Click the agent name to view live latency, jitter, and packet loss
✅

Agent is online! Metrics start flowing within 1–2 minutes of the agent starting.

Troubleshooting Connection Issues

  • Verify the API key in config.toml matches the one in your dashboard
  • Check that api_base_url points to your tenant subdomain
  • Ensure the agent has outbound internet access on port 443
  • Review agent logs for error messages
  • See the Troubleshooting Guide for more help

Step 5: Explore Features

Fleet Health Monitoring

Each agent continuously reports:

  • Latency, jitter, and packet loss to configurable targets
  • Active network adapter (Ethernet, Wi-Fi, VPN)
  • Public IP and ISP detection
  • Uptime and agent online/offline status

Learn more in the Monitoring Guide.

Nova AI Assistant

Nova is your always-on network analyst. From any agent page or the main dashboard you can:

  • Ask natural-language questions about your fleet
  • Identify anomalies and degraded sites
  • Get plain-language explanations of what's happening and what to do

Reports (Enterprise)

The Report Builder generates nine report types including:

  • Performance Summary
  • SLA Compliance
  • Anomaly Detection
  • Uptime Analysis
  • ISP Analysis
  • Agent Comparison

Reports export to PDF. Scheduled email delivery is available on Professional and Enterprise plans. Full report generation requires Enterprise.

Alerts & Notifications

Get notified when things go wrong:

  • Agent offline / online notifications
  • Threshold-based alerts
  • Email notifications
  • Webhook integrations (Slack, Discord, Teams, etc.)

Learn more in the Alerts & Webhooks Guide.

Step 6: Configure Alerts (Optional)

  1. Navigate to Dashboard → Settings → Alerts
  2. Enable agent status notifications
  3. Add email recipients or configure a webhook URL
  4. Save your settings

For integration examples with Slack, Discord, Teams, and other services, see the Webhook Integrations Guide.

Next Steps

Recommended Reading

→ Agent Installation Guide→ Network Monitoring Guide→ API Documentation→ Alerts & Webhooks→ Webhook Integrations→ Troubleshooting Guide

Need Help?