hunchentoot-stuck-connection-monitor

This Common Lisp library monitors Hunchentoot web server connections and logs connections that remain stuck in the same state for a long time. It helps prevent thread and socket leakage by detecting problematic connections that standard IO timeouts may miss, such as those in TLS mode or during slow request attacks.

Key Features

• Stuck Connection Detection — Identifies connections that haven't changed state for a configurable duration.
• Automatic or Manual Remediation — Offers options to manually or automatically shutdown stuck connection sockets to unblock threads.
• Hunchentoot Integration — Works as a mixin class that integrates with Hunchentoot's acceptor class precedence list.
• Health Monitoring — Provides a health check service for Hunchentoot to detect resource leaks beyond standard timeout mechanisms.

Philosophy

The project addresses edge cases in web server resource management where standard timeout mechanisms fail, providing a safety net for production deployments without interfering with legitimate long-lived connections like long polling endpoints.