Nginx Proxy GuardNginx Proxy Guard

Monitoring & Analytics

Track system health and traffic flow in real time.

Dashboard

Real-Time Monitoring

  • 24-Hour Request Statistics: Hourly request count chart
  • Bandwidth Monitoring: Inbound/outbound traffic
  • Security Event Summary: WAF, bot blocking, and geo-restriction events

Interactive World Map

  • GeoIP-based traffic visualization
  • Request count by country
  • Real-time updates

System Health Status

ItemDescription
API StatusBackend API server status
DB StatusPostgreSQL connection status
Nginx StatusReverse proxy status
CPU UsageSystem CPU usage
Memory UsageSystem memory usage
Disk UsageStorage usage

Docker Container Status

Monitor the status of all Docker containers in real time.

  • Container status (Running, Stopped, Restarting)
  • Resource usage (CPU, memory)
  • Uptime information

Health Status History

  • Track changes in system health status
  • Detect anomalies
  • Trigger alerts

Log Viewer

The Logs menu (/logs) is organized into these tabs:

TabDescription
Access LogsHTTP request/response records (with GeoIP attached)
WAF EventsModSecurity block/detection events
Bot FilterBot filter block logs
Exploit BlocksRequests caught by exploit block rules
System LogsContainer/system event logs
Admin AuditAdministrator activity audit log
Raw FilesDirect access to raw Nginx log files

Nginx error logs are not a separate tab; view them via the raw files in the Raw Files tab.

Unified Log Viewer (Access Logs / WAF Events)

GeoIP Information Display

GeoIP information is automatically attached to each log entry.

  • Country: Country code and name
  • ASN: Autonomous System Number
  • Organization: ISP or organization name

Advanced Filtering

You can filter logs by a variety of conditions.

FilterDescription
HostSpecific proxy host
IP AddressClient IP
Status CodeHTTP response code (200, 404, 500, etc.)
CountryGeoIP country code
URIRequest path
MethodHTTP method (GET, POST, etc.)
User-AgentClient User-Agent

Autocomplete

Autocomplete is provided during filter input to support fast searches.

  • Host autocomplete
  • IP address autocomplete
  • User-Agent autocomplete
  • Country autocomplete
  • URI autocomplete
  • HTTP method autocomplete

Exclusion Filters

You can exclude specific patterns from log queries.

  • Exclude static resources (CSS, JS, images)
  • Exclude monitoring/probe requests
  • Exclude specific IP ranges

Visualization Charts

  • Request Trend: Hourly request count graph
  • Top IP: IPs sending the most requests
  • Top Country: Request distribution by country
  • Status Code Distribution: Ratio by HTTP status code

Log Export

  • Export in CSV format
  • Specify a date range
  • Export with filters applied

Audit Log

Track administrator activity to support security and compliance.

Tracked Items

  • Administrator Activity: Login, logout, configuration changes
  • API Token Usage: API call records per token
  • Configuration Change History: Track all configuration changes
  • Per-Resource History: Changes to resources such as proxy hosts and certificates

Log Information

FieldDescription
TimeWhen the event occurred
UserWho performed the action
ActionType of action performed
ResourceTarget resource
IP AddressClient IP
User-AgentClient information
DetailsBefore/after data

Filtering

  • Filter by action type
  • Filter by resource type
  • Filter by user
  • Filter by date range

System Logs

Manage Docker container and system event logs.

Log Sources

  • api: Go backend logs
  • db: PostgreSQL logs
  • ui: React frontend logs
  • nginx: Nginx process logs

Log Levels

  • DEBUG
  • INFO
  • WARNING
  • ERROR
  • CRITICAL

Pattern-Based Exclusion

You can exclude specific patterns to reduce noise.

Log Statistics

  • Log count by source
  • Log distribution by level
  • Log trend by time period

Raw Log File Management

You can access raw Nginx log files directly.

Features

  • Log File List: View all log files
  • View Log File: Check contents directly in the web UI
  • Download Log File: Download for analysis
  • Delete Log File: Clean up unnecessary logs
  • Log Rotation: Run manual log rotation

Rotation Settings

OptionDescriptionDefault
Retention PeriodNumber of days to retain logs7 days
Maximum SizeMaximum size per file100MB
CompressionCompress rotated filesEnabled

Log Retention Policy

You can set a retention period for each log type.

Log TypeDefault Retention Period
Access Log1095 days (3 years)
WAF Log90 days
Error Log30 days
System Log30 days
Audit Log1095 days (3 years)

Automatic Cleanup

  • Automatically delete logs that exceed the configured retention period
  • Efficient management based on monthly partitions
  • Manual cleanup option provided

Security and system health are surfaced through the dashboard cards, the log tabs, and the expiry indicators on the Certificates screen. (There is no outbound notification feature such as email or webhooks.)