1 files changed, 77 insertions, 0 deletions
diff --git a/glances/amps/nginx/__init__.py b/glances/amps/nginx/__init__.py
new file mode 100644
index 00000000..770c4aca
--- /dev/null
+++ b/glances/amps/nginx/__init__.py
@@ -0,0 +1,77 @@
+# -*- coding: utf-8 -*-
+#
+# This file is part of Glances.
+#
+# SPDX-FileCopyrightText: 2022 Nicolas Hennion <nicolas@nicolargo.com>
+#
+# SPDX-License-Identifier: LGPL-3.0-only
+#
+
+r"""
+Nginx AMP
+=========
+
+Monitor the Nginx process using the status page.
+
+How to read the stats
+---------------------
+
+Active connections – Number of all open connections. This doesn't mean number of users.
+A single user, for a single page-view can open many concurrent connections to your server.
+Server accepts handled requests – This shows three values.
+    First is total accepted connections.
+    Second is total handled connections. Usually first 2 values are same.
+    Third value is number of and handles requests. This is usually greater than second value.
+    Dividing third-value by second-one will give you number of requests per connection handled
+    by Nginx. In above example, 10993/7368, 1.49 requests per connections.
+Reading – nginx reads request header
+Writing – nginx reads request body, processes request, or writes response to a client
+Waiting – keep-alive connections, actually it is active – (reading + writing).
+This value depends on keepalive-timeout. Do not confuse non-zero waiting value for poor
+performance. It can be ignored.
+
+Source reference: https://easyengine.io/tutorials/nginx/status-page/
+
+Configuration file example
+--------------------------
+
+[amp_nginx]
+# Nginx status page should be enable (https://easyengine.io/tutorials/nginx/status-page/)
+enable=true
+regex=\/usr\/sbin\/nginx
+refresh=60
+one_line=false
+status_url=http://localhost/nginx_status
+"""
+
+import requests
+
+from glances.logger import logger
+from glances.amps.amp import GlancesAmp
+
+
+class Amp(GlancesAmp):
+    """Glances' Nginx AMP."""
+
+    NAME = 'Nginx'
+    VERSION = '1.0'
+    DESCRIPTION = 'Get Nginx stats from status-page'
+    AUTHOR = 'Nicolargo'
+    EMAIL = 'contact@nicolargo.com'
+
+    # def __init__(self, args=None):
+    #     """Init the AMP."""
+    #     super(Amp, self).__init__(args=args)
+
+    def update(self, process_list):
+        """Update the AMP"""
+        # Get the Nginx status
+        logger.debug('{}: Update stats using status URL {}'.format(self.NAME, self.get('status_url')))
+        res = requests.get(self.get('status_url'))
+        if res.ok:
+            # u'Active connections: 1 \nserver accepts handled requests\n 1 1 1 \nReading: 0 Writing: 1 Waiting: 0 \n'
+            self.set_result(res.text.rstrip())
+        else:
+            logger.debug('{}: Can not grab status URL {} ({})'.format(self.NAME, self.get('status_url'), res.reason))
+
+        return self.result()