AstraNetmon

Getting Started

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

Overview

AstraNetmon is a comprehensive network monitoring platform that provides real-time insights into your infrastructure's performance, connectivity, and health. This guide will help you get started with deploying your first monitoring agent and exploring the platform's features.

ℹ️

Before you begin: Make sure you have an active AstraNetmon account. If you don't have one yet, you can sign up at the homepage.

Quick Start Checklist

1.
Create your account and log in to the dashboard
2.
Download the agent for your operating system
3.
Install and configure the agent with your API key
4.
View metrics in the dashboard
5.
Configure alerts and integrations (optional)

Step 1: Access the Dashboard

Login

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

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

If you have multi-factor authentication (MFA) enabled, you'll need to enter your verification code after entering your password.

Dashboard Overview

Once logged in, you'll see the main dashboard with:

  • Agent status overview
  • Real-time metrics graphs
  • Recent speed test results
  • Connection health indicators
  • Alert notifications

Step 2: Get Your Agent API Key

Before installing an agent, you'll need your unique 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 send data to your account. Don't share it publicly or commit it to version control.

Step 3: Install Your First Agent

Choose the installation guide for your operating system:

🪟 Windows

Install as a Windows Service

🐧 Linux

Install with systemd service

🍎 macOS

Install with launchd

Quick Example: Linux Installation

Here's a quick example for Ubuntu/Debian systems:

bash
# Download the agent
wget https://your-domain.com/downloads/astra-netmon-agent-linux

# Make it executable
chmod +x astra-netmon-agent-linux

# Create configuration
cat > config.toml << 'EOF'
api_url = "https://your-domain.astraid.io/api/agent"
api_key = "YOUR_AGENT_API_KEY_HERE"
poll_interval = 60
EOF

# Run the agent
./astra-netmon-agent-linux

For detailed installation instructions including service setup, see the Agent Installation Guide.

Step 4: Verify Agent Connection

After installing and starting your agent:

  1. Return to the AstraNetmon dashboard
  2. Navigate to Dashboard → Agents
  3. You should see your new agent listed with a green "Online" status
  4. Click on the agent name to view detailed metrics
✅

Agent is online! You should start seeing metrics within 1-2 minutes of the agent starting.

Troubleshooting Connection Issues

If your agent doesn't appear online:

  • Check that the API key is correct in the configuration file
  • Verify the API URL is pointing to the correct domain
  • Ensure the agent has internet access and can reach the API endpoint
  • Check agent logs for error messages
  • See the Troubleshooting Guide for more help

Step 5: Explore Features

Real-Time Monitoring

View live metrics for your agents:

  • CPU usage percentage
  • Memory utilization
  • Disk space usage
  • Network traffic (RX/TX)

Learn more in the Monitoring Guide.

Speed Tests

Configure automated internet speed testing:

  • Download/upload speed measurements
  • Ping and jitter metrics
  • Historical speed data and trends

Learn more in the Speed Testing Guide.

Service Tests

Monitor HTTP/HTTPS endpoints:

  • Uptime monitoring
  • Response time tracking
  • Status code validation
  • Custom health checks

Learn more in the Service Testing Guide.

Alerts & Notifications

Set up alerts when things go wrong:

  • Agent offline notifications
  • Custom threshold alerts
  • Email notifications
  • Webhook integrations (Slack, Discord, Teams, etc.)

Learn more in the Alerts & Webhooks Guide.

PDF Reports

Generate comprehensive monitoring reports:

  • Custom date ranges
  • Statistical analysis
  • Speed test summaries
  • Service uptime reports

Learn more in the PDF Reports Guide.

Step 6: Configure Alerts (Optional)

Stay informed when issues occur:

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

For advanced webhook integrations with Slack, Discord, Teams, and other services, see the Webhook Integrations Guide.

Next Steps

Recommended Reading

→ Advanced Agent Configuration→ Real-Time Monitoring Guide→ API Documentation→ User Management→ Alerts & Webhooks→ Troubleshooting Guide

Need Help?

If you run into any issues or have questions: