Analytics & Monitoring
Monitor tunnel performance, analyze traffic, and debug requests
Overview
NGSRV provides comprehensive analytics and monitoring tools to help you understand tunnel usage, debug issues, and ensure security compliance.
Available Tools
- • Global Analytics - Team-wide metrics and trends
- • Request Logs - Individual HTTP request inspection
- • Audit Logs - Security policy actions and blocks
- • CLI Dashboard - Real-time local analytics (localhost:4040)
- • Full Capture Mode - Complete request/response bodies (paid feature)
Global Analytics Dashboard
Access comprehensive analytics across all your tunnels at Dashboard → Analytics
Key Metrics
Total Requests
Number of HTTP requests across all tunnels
Bandwidth Usage
Total data transferred (upload + download)
Active Tunnels
Currently running tunnel sessions
Average Response Time
Mean latency for requests
Features
- Time Range Selection - View last hour, day, week, or custom range
- Tunnel Filtering - Drill down to specific tunnel or view all
- Historical Sessions - Access data from closed tunnels
- Visual Charts - Bandwidth and request graphs over time
Request Logs
View and search individual HTTP requests at Dashboard → Request Logs
Default Data Captured
• HTTP Method (GET, POST, PUT, DELETE, etc.)
• Request Path (/api/users, /webhook, etc.)
• Status Code (200, 404, 500, etc.)
• Response Time (milliseconds)
• Request Headers (selected headers only)
• Timestamp
• Client IP Address
Filtering & Search
- Filter by tunnel/session
- Filter by HTTP method
- Filter by status code
- Search by path
- Time range selection
Expandable Detail View
Click any request to see full details:
• Complete request headers
• Response headers
• Timing breakdown
• Request/response bodies (if Full Capture enabled)
• Security policy actions
Full Capture Mode
Full Capture is a paid feature that logs complete request and response bodies for advanced debugging.
⚠️ Requirements
- • Available on Pro or Pay-as-you-go plans only
- • Requires team owner consent
- • Team-wide setting (affects all tunnels)
- • Bodies limited to 1MB each
- • Retained according to plan data retention policy
What Gets Captured
Request Body: Complete POST/PUT/PATCH payload
Response Body: Full API response content
Truncation: Bodies exceeding 1MB are truncated with indicator
Use Cases
- Webhook Debugging - See exact JSON payload from Stripe/GitHub/Twilio
- API Development - Debug request/response data formats
- Error Investigation - Analyze malformed requests causing 400/500 errors
- Integration Testing - Verify third-party API responses
Enabling Full Capture
- Upgrade to a paid plan
- Go to Dashboard → Teams
- Select your team
- Toggle "Enable Full Capture"
- Confirm data capture consent
Audit Logs
Track security policy actions and compliance events at Dashboard → Audit Logs
What Gets Logged
• Security policy blocks (IP, geo, time-based, etc.)
• Rate limit violations
• WAF rule triggers
• Authentication failures
Audit Log Details
Each audit log entry includes:
- Timestamp
- Policy type and name
- Action taken (blocked/allowed/logged)
- Client IP address
- Request path
- Reason for action
- Tunnel/session ID
Use Cases
- Security Monitoring - Track blocked attack attempts
- Compliance Reporting - Generate access reports for auditors
- Policy Tuning - Identify false positives in security rules
- Incident Response - Investigate security events
CLI Dashboard (localhost:4040)
When running a tunnel, NGSRV provides a real-time local dashboard accessible at http://localhost:4040
Features
• Real-time Request Log - See requests as they happen
• Request Details - Headers, body, response time
• Traffic Charts - Requests per minute visualization
• Status Summary - 2xx, 4xx, 5xx breakdown
• Tunnel Info - Public URL, uptime, total requests
Use Cases
- Local Debugging - Watch requests in real-time while developing
- Webhook Testing - Verify webhook payloads immediately
- Performance Monitoring - Check response times locally
Quick Access
After starting a tunnel, open http://localhost:4040 in your browser to access the live dashboard.
Best Practices
✅ Regular Monitoring
Check analytics weekly to understand usage patterns and identify issues.
✅ Use Full Capture Sparingly
Enable only when debugging, disable afterward to save costs and storage.
⚠️ Review Audit Logs
Check audit logs for blocked requests to ensure policies aren't too strict.
💡 Export Data
Export logs for long-term storage or integration with external tools.