Real-Time Monitoring

Monitor CPU, memory, disk, and network metrics across all your agents in real-time

Overview

AstraNetmon provides comprehensive real-time monitoring of your infrastructure. Each agent continuously collects system metrics and sends them to the platform for analysis and visualization.

Monitored Metrics

CPU Usage

Track CPU utilization across all cores:

  • Overall CPU percentage
  • Per-core breakdown
  • Historical trends
  • Peak usage indicators

The dashboard displays CPU usage as a percentage (0-100%) with color-coded indicators:

  • Green: 0-70% (Normal)
  • Yellow: 71-85% (Warning)
  • Red: 86-100% (Critical)

Memory Usage

Monitor RAM utilization:

  • Total memory available
  • Used memory (percentage and absolute)
  • Free memory
  • Memory trends over time

Disk Usage

Track storage utilization:

  • Per-volume/partition monitoring
  • Used vs. available space
  • Growth rate analysis
  • Low disk space warnings

Network Traffic

Monitor network activity:

  • Bytes received (RX)
  • Bytes transmitted (TX)
  • Real-time bandwidth graphs
  • Peak bandwidth tracking

Viewing Metrics

Dashboard Overview

The main dashboard provides a high-level view of all agents:

  1. Navigate to Dashboard after logging in
  2. View the agent list with current status indicators
  3. See aggregate metrics across all agents
  4. Click on any agent to view detailed metrics

Agent Detail View

Click on an agent hostname to view detailed metrics:

  • Real-time metric graphs (auto-updating every 30 seconds)
  • Current values displayed prominently
  • Historical data with customizable time ranges
  • Comparison with previous periods

Time Range Selection

View metrics for different time periods:

  • Last Hour: See minute-by-minute data
  • Last 24 Hours: Hourly aggregates
  • Last 7 Days: Daily trends
  • Last 30 Days: Monthly patterns (Professional+)
  • Custom Range: Select specific dates (Enterprise)
ℹ️

Data retention varies by plan: 7 days (Starter), 90 days (Professional), 365 days (Enterprise)

Polling Interval

Agents collect and send metrics at regular intervals. The default polling interval is 60 seconds.

Adjusting Poll Interval

You can configure the polling interval in the agent configuration file:

toml
# Collect metrics every 30 seconds
poll_interval = 30

# Or every 5 minutes
poll_interval = 300
⚠️

Plan limits apply: Starter plan minimum is 30 minutes (1800s), Professional is 15 minutes (900s), Enterprise is 1 second.

After changing the configuration, restart the agent:

bash
# Linux
sudo systemctl restart astranetmon-agent

# Windows
Restart-Service "AstraNetmon Agent"

# macOS
sudo launchctl unload /Library/LaunchDaemons/com.astranetmon.agent.plist
sudo launchctl load /Library/LaunchDaemons/com.astranetmon.agent.plist

Understanding Agent Status

Online

Agent has sent metrics within the last 5 minutes

Offline

No metrics received for more than 5 minutes

Common causes:

  • Agent service stopped
  • Network connectivity issues
  • Server shutdown or restart
  • Configuration errors

Export Metrics

Via Dashboard

Export metrics directly from the web interface:

  1. Navigate to the agent detail page
  2. Select your desired time range
  3. Click Export or Download CSV
  4. Choose the metrics to include
  5. Download the CSV file

Via API

Programmatically access metrics using the API:

bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://your-domain.com/api/v1/metrics?agent_id=agent-123&limit=1000"

See the API Documentation for more details.

Best Practices

  • Monitor critical systems first: Deploy agents on production servers before non-critical systems
  • Set appropriate poll intervals: Balance data granularity with network bandwidth
  • Review metrics regularly: Check dashboard weekly to identify trends
  • Configure alerts: Set up notifications for offline agents
  • Use custom time ranges: Analyze specific incidents or events
  • Export historical data: Keep records for compliance or analysis

Troubleshooting

Metrics Not Appearing

  • Verify agent is running and status is "Online"
  • Check agent logs for errors
  • Confirm API key is correct in configuration
  • Ensure network connectivity to the API endpoint

Gaps in Metric Data

  • Check for network interruptions during that time
  • Review agent logs for errors or restarts
  • Verify server wasn't offline or rebooting

Inaccurate Metrics

  • Ensure agent has proper permissions to read system metrics
  • Update to the latest agent version
  • Check for OS-specific metric calculation differences

Next Steps