Astra Netmon - Enterprise Network Monitoring Made Simple

Overview

AstraNetmon's alerting system keeps you informed about critical events in your infrastructure. Configure email notifications, webhook integrations, or both to receive real-time alerts.

Agent Status Notifications

Get notified when agents go offline or come back online - the most critical alert type for monitoring.

Enabling Status Notifications

Navigate to Dashboard → Settings → Alerts
Find the "Agent Status Notifications" section
Toggle Enable Status Notifications to ON
Add email recipients (optional - defaults to all tenant admins)
Click Save Settings

Email Recipients

Configure who receives email notifications:

No recipients: All tenant administrators receive emails
Specific recipients: Only listed email addresses receive alerts
Multiple recipients: Add as many email addresses as needed

ℹ️

Email recipients don't need to be AstraNetmon users - any valid email address works.

Email Format

Status notification emails include:

Agent hostname and ID
Previous and current status
Timestamp of the change
Organization name
Quick link to dashboard

Offline alerts are marked urgent with red styling and action required messaging.

Online alerts use green styling to indicate the issue is resolved.

Webhook Integrations

Send alerts to external services like Slack, Discord, Microsoft Teams, PagerDuty, or custom endpoints.

Creating a Webhook

Navigate to Dashboard → Settings → Alerts
Scroll to the "Webhooks" section
Click Add Webhook
Enter a descriptive name
Enter the webhook URL
Select which events to receive
Optionally enable webhook secret for signature verification
Click Create Webhook

⚠️

If you enable a webhook secret, it will only be shown once. Save it securely before closing the dialog.

Available Webhook Events

agent.status_changed - Agent goes online/offline

agent.registered - New agent connects for the first time

agent.deleted - Agent is removed from the system

speedtest.completed - Speed test finishes

traceroute.completed - Traceroute finishes

service_test.failed - HTTP/HTTPS service test fails

alert.triggered - Threshold alert fires

Managing Webhooks

After creating webhooks, you can:

Enable/Disable: Toggle webhooks on/off without deleting
View Failures: See failure count for troubleshooting
Delete: Remove webhooks you no longer need
Last Triggered: See when the webhook last fired

For detailed webhook integration examples (Slack, Discord, Teams, etc.), see the Webhook Integrations Guide.

API Keys for Integrations

Generate read-only API keys for custom integrations and third-party tools.

Creating an API Key

Navigate to Dashboard → Settings → Alerts
Scroll to "Read-Only API Keys"
Click Generate Key
Enter a descriptive name
Select permissions (e.g., read:agents, read:metrics)
Optionally set an expiration date
Click Generate Key

⚠️

CRITICAL: The full API key is only shown once. Copy it immediately and store it securely. If you lose it, you'll need to generate a new one.

Available Permissions

read:agents - View agent list and status
read:metrics - Access system metrics
read:speedtests - View speed test results
read:traceroutes - View traceroute results
read:service_tests - View service test results
read:reports - Access generated reports

Using API Keys

bash

# Example: Get all agents
curl -H "Authorization: Bearer astra_your_api_key_here" \
  https://your-domain.com/api/v1/agents

See the API Documentation for complete endpoint reference.

Plan-Specific Features

Feature	Starter	Professional	Enterprise
Agent Status Emails	✅	✅	✅
Webhooks	1 webhook	Unlimited	Unlimited
API Keys	1 key	5 keys	Unlimited
API Rate Limit	100 req/hour	1,000 req/hour	Unlimited

Best Practices

Start with email notifications: Enable agent status emails first
Use webhooks for automation: Integrate with ticketing systems or chat platforms
Test webhooks: Use webhook.site or similar to verify payload format
Enable signature verification: For production webhooks, always use secrets
Monitor webhook failures: Check dashboard for delivery issues
Rotate API keys: Periodically generate new keys and retire old ones
Use minimum permissions: Only grant necessary permissions to API keys

Troubleshooting

Not Receiving Emails

Check spam/junk folders
Verify email addresses are correct
Ensure agent status notifications are enabled
Confirm agents are actually changing status (restart one to test)

Webhook Not Firing

Check webhook is enabled
Verify correct events are subscribed
Test webhook URL with curl or Postman
Check webhook failure count in dashboard
Review webhook endpoint logs for errors

API Key Not Working

Verify key is enabled in dashboard
Check key hasn't expired
Ensure correct Authorization header format
Confirm required permissions are granted
Check you're not hitting rate limits

Alerts & Notifications