1
|
|
|
# -*- coding: utf-8 -*- |
2
|
|
|
# |
3
|
|
|
# This file is part of Glances. |
4
|
|
|
# |
5
|
|
|
# Copyright (C) 2019 Nicolargo <[email protected]> |
6
|
|
|
# |
7
|
|
|
# Glances is free software; you can redistribute it and/or modify |
8
|
|
|
# it under the terms of the GNU Lesser General Public License as published by |
9
|
|
|
# the Free Software Foundation, either version 3 of the License, or |
10
|
|
|
# (at your option) any later version. |
11
|
|
|
# |
12
|
|
|
# Glances is distributed in the hope that it will be useful, |
13
|
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of |
14
|
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
15
|
|
|
# GNU Lesser General Public License for more details. |
16
|
|
|
# |
17
|
|
|
# You should have received a copy of the GNU Lesser General Public License |
18
|
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>. |
19
|
|
|
|
20
|
|
|
""" |
|
|
|
|
21
|
|
|
Nginx AMP |
22
|
|
|
========= |
23
|
|
|
|
24
|
|
|
Monitor the Nginx process using the status page. |
25
|
|
|
|
26
|
|
|
How to read the stats |
27
|
|
|
--------------------- |
28
|
|
|
|
29
|
|
|
Active connections – Number of all open connections. This doesn’t mean number of users. |
|
|
|
|
30
|
|
|
A single user, for a single pageview can open many concurrent connections to your server. |
|
|
|
|
31
|
|
|
Server accepts handled requests – This shows three values. |
32
|
|
|
First is total accepted connections. |
33
|
|
|
Second is total handled connections. Usually first 2 values are same. |
34
|
|
|
Third value is number of and handles requests. This is usually greater than second value. |
|
|
|
|
35
|
|
|
Dividing third-value by second-one will give you number of requests per connection handled |
|
|
|
|
36
|
|
|
by Nginx. In above example, 10993/7368, 1.49 requests per connections. |
37
|
|
|
Reading – nginx reads request header |
38
|
|
|
Writing – nginx reads request body, processes request, or writes response to a client |
|
|
|
|
39
|
|
|
Waiting – keep-alive connections, actually it is active – (reading + writing). |
40
|
|
|
This value depends on keepalive-timeout. Do not confuse non-zero waiting value for poor |
|
|
|
|
41
|
|
|
performance. It can be ignored. |
42
|
|
|
|
43
|
|
|
Source reference: https://easyengine.io/tutorials/nginx/status-page/ |
44
|
|
|
|
45
|
|
|
Configuration file example |
46
|
|
|
-------------------------- |
47
|
|
|
|
48
|
|
|
[amp_nginx] |
49
|
|
|
# Nginx status page should be enable (https://easyengine.io/tutorials/nginx/status-page/) |
|
|
|
|
50
|
|
|
enable=true |
51
|
|
|
regex=\/usr\/sbin\/nginx |
52
|
|
|
refresh=60 |
53
|
|
|
one_line=false |
54
|
|
|
status_url=http://localhost/nginx_status |
55
|
|
|
""" |
56
|
|
|
|
57
|
|
|
import requests |
|
|
|
|
58
|
|
|
|
59
|
|
|
from glances.logger import logger |
|
|
|
|
60
|
|
|
from glances.amps.glances_amp import GlancesAmp |
|
|
|
|
61
|
|
|
|
62
|
|
|
|
63
|
|
|
class Amp(GlancesAmp): |
64
|
|
|
"""Glances' Nginx AMP.""" |
65
|
|
|
|
66
|
|
|
NAME = 'Nginx' |
67
|
|
|
VERSION = '1.0' |
68
|
|
|
DESCRIPTION = 'Get Nginx stats from status-page' |
69
|
|
|
AUTHOR = 'Nicolargo' |
70
|
|
|
EMAIL = '[email protected]' |
71
|
|
|
|
72
|
|
|
# def __init__(self, args=None): |
73
|
|
|
# """Init the AMP.""" |
74
|
|
|
# super(Amp, self).__init__(args=args) |
75
|
|
|
|
76
|
|
|
def update(self, process_list): |
|
|
|
|
77
|
|
|
"""Update the AMP""" |
78
|
|
|
# Get the Nginx status |
79
|
|
|
logger.debug('{}: Update stats using status URL {}'.format(self.NAME, self.get('status_url'))) |
|
|
|
|
80
|
|
|
res = requests.get(self.get('status_url')) |
81
|
|
|
if res.ok: |
82
|
|
|
# u'Active connections: 1 \nserver accepts handled requests\n 1 1 1 \nReading: 0 Writing: 1 Waiting: 0 \n' |
|
|
|
|
83
|
|
|
self.set_result(res.text.rstrip()) |
84
|
|
|
else: |
85
|
|
|
logger.debug('{}: Can not grab status URL {} ({})'.format(self.NAME, self.get('status_url'), res.reason)) |
|
|
|
|
86
|
|
|
|
87
|
|
|
return self.result() |
88
|
|
|
|
Escape sequences in Python are generally interpreted according to rules similar to standard C. Only if strings are prefixed with
r
orR
are they interpreted as regular expressions.The escape sequence that was used indicates that you might have intended to write a regular expression.
Learn more about the available escape sequences. in the Python documentation.