mirror of
https://github.com/LCTT/TranslateProject.git
synced 2025-01-01 21:50:13 +08:00
240 lines
13 KiB
Markdown
240 lines
13 KiB
Markdown
translation by strugglingyouth
|
||
|
||
How to collect NGINX metrics - Part 2
|
||
================================================================================
|
||
|
||
|
||
### How to get the NGINX metrics you need ###
|
||
|
||
How you go about capturing metrics depends on which version of NGINX you are using, as well as which metrics you wish to access. (See [the companion article][1] for an in-depth exploration of NGINX metrics.) Free, open-source NGINX and the commercial product NGINX Plus both have status modules that report metrics, and NGINX can also be configured to report certain metrics in its logs:
|
||
|
||
注：表格
|
||
<table>
|
||
<colgroup>
|
||
<col style="text-align: left;">
|
||
<col style="text-align: center;">
|
||
<col style="text-align: center;">
|
||
<col style="text-align: center;"> </colgroup>
|
||
<thead>
|
||
<tr>
|
||
<th rowspan="2" style="text-align: left;">Metric</th>
|
||
<th colspan="3" style="text-align: center;">Availability</th>
|
||
</tr>
|
||
<tr>
|
||
<th style="text-align: center;"><a href="https://www.datadoghq.com/blog/how-to-collect-nginx-metrics/#open-source">NGINX (open-source)</a></th>
|
||
<th style="text-align: center;"><a href="https://www.datadoghq.com/blog/how-to-collect-nginx-metrics/#plus">NGINX Plus</a></th>
|
||
<th style="text-align: center;"><a href="https://www.datadoghq.com/blog/how-to-collect-nginx-metrics/#logs">NGINX logs</a></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td style="text-align: left;">accepts / accepted</td>
|
||
<td style="text-align: center;">x</td>
|
||
<td style="text-align: center;">x</td>
|
||
<td style="text-align: center;"></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">handled</td>
|
||
<td style="text-align: center;">x</td>
|
||
<td style="text-align: center;">x</td>
|
||
<td style="text-align: center;"></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">dropped</td>
|
||
<td style="text-align: center;">x</td>
|
||
<td style="text-align: center;">x</td>
|
||
<td style="text-align: center;"></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">active</td>
|
||
<td style="text-align: center;">x</td>
|
||
<td style="text-align: center;">x</td>
|
||
<td style="text-align: center;"></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">requests / total</td>
|
||
<td style="text-align: center;">x</td>
|
||
<td style="text-align: center;">x</td>
|
||
<td style="text-align: center;"></td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">4xx codes</td>
|
||
<td style="text-align: center;"></td>
|
||
<td style="text-align: center;">x</td>
|
||
<td style="text-align: center;">x</td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">5xx codes</td>
|
||
<td style="text-align: center;"></td>
|
||
<td style="text-align: center;">x</td>
|
||
<td style="text-align: center;">x</td>
|
||
</tr>
|
||
<tr>
|
||
<td style="text-align: left;">request time</td>
|
||
<td style="text-align: center;"></td>
|
||
<td style="text-align: center;"></td>
|
||
<td style="text-align: center;">x</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
#### Metrics collection: NGINX (open-source) ####
|
||
|
||
Open-source NGINX exposes several basic metrics about server activity on a simple status page, provided that you have the HTTP [stub status module][2] enabled. To check if the module is already enabled, run:
|
||
|
||
nginx -V 2>&1 | grep -o with-http_stub_status_module
|
||
|
||
The status module is enabled if you see with-http_stub_status_module as output in the terminal.
|
||
|
||
If that command returns no output, you will need to enable the status module. You can use the --with-http_stub_status_module configuration parameter when [building NGINX from source][3]:
|
||
|
||
./configure \
|
||
… \
|
||
--with-http_stub_status_module
|
||
make
|
||
sudo make install
|
||
|
||
After verifying the module is enabled or enabling it yourself, you will also need to modify your NGINX configuration to set up a locally accessible URL (e.g., /nginx_status) for the status page:
|
||
|
||
server {
|
||
location /nginx_status {
|
||
stub_status on;
|
||
|
||
access_log off;
|
||
allow 127.0.0.1;
|
||
deny all;
|
||
}
|
||
}
|
||
|
||
Note: The server blocks of the NGINX config are usually found not in the master configuration file (e.g., /etc/nginx/nginx.conf) but in supplemental configuration files that are referenced by the master config. To find the relevant configuration files, first locate the master config by running:
|
||
|
||
nginx -t
|
||
|
||
Open the master configuration file listed, and look for lines beginning with include near the end of the http block, such as:
|
||
|
||
include /etc/nginx/conf.d/*.conf;
|
||
|
||
In one of the referenced config files you should find the main server block, which you can modify as above to configure NGINX metrics reporting. After changing any configurations, reload the configs by executing:
|
||
|
||
nginx -s reload
|
||
|
||
Now you can view the status page to see your metrics:
|
||
|
||
Active connections: 24
|
||
server accepts handled requests
|
||
1156958 1156958 4491319
|
||
Reading: 0 Writing: 18 Waiting : 6
|
||
|
||
Note that if you are trying to access the status page from a remote machine, you will need to whitelist the remote machine’s IP address in your status configuration, just as 127.0.0.1 is whitelisted in the configuration snippet above.
|
||
|
||
The NGINX status page is an easy way to get a quick snapshot of your metrics, but for continuous monitoring you will need to automatically record that data at regular intervals. Parsers for the NGINX status page already exist for monitoring tools such as [Nagios][4] and [Datadog][5], as well as for the statistics collection daemon [collectD][6].
|
||
|
||
#### Metrics collection: NGINX Plus ####
|
||
|
||
The commercial NGINX Plus provides [many more metrics][7] through its ngx_http_status_module than are available in open-source NGINX. Among the additional metrics exposed by NGINX Plus are bytes streamed, as well as information about upstream systems and caches. NGINX Plus also reports counts of all HTTP status code types (1xx, 2xx, 3xx, 4xx, 5xx). A sample NGINX Plus status board is available [here][8].
|
||
|
||
|
||
|
||
*Note: the “Active” connections on the NGINX Plus status dashboard are defined slightly differently than the Active state connections in the metrics collected via the open-source NGINX stub status module. In NGINX Plus metrics, Active connections do not include connections in the Waiting state (aka Idle connections).*
|
||
|
||
NGINX Plus also reports [metrics in JSON format][9] for easy integration with other monitoring systems. With NGINX Plus, you can see the metrics and health status [for a given upstream grouping of servers][10], or drill down to get a count of just the response codes [from a single server][11] in that upstream:
|
||
|
||
{"1xx":0,"2xx":3483032,"3xx":0,"4xx":23,"5xx":0,"total":3483055}
|
||
|
||
To enable the NGINX Plus metrics dashboard, you can add a status server block inside the http block of your NGINX configuration. ([See the section above][12] on collecting metrics from open-source NGINX for instructions on locating the relevant config files.) For example, to set up a status dashboard at http://your.ip.address:8080/status.html and a JSON interface at http://your.ip.address:8080/status, you would add the following server block:
|
||
|
||
server {
|
||
listen 8080;
|
||
root /usr/share/nginx/html;
|
||
|
||
location /status {
|
||
status;
|
||
}
|
||
|
||
location = /status.html {
|
||
}
|
||
}
|
||
|
||
The status pages should be live once you reload your NGINX configuration:
|
||
|
||
nginx -s reload
|
||
|
||
The official NGINX Plus docs have [more details][13] on how to configure the expanded status module.
|
||
|
||
#### Metrics collection: NGINX logs ####
|
||
|
||
NGINX’s [log module][14] writes configurable access logs to a destination of your choosing. You can customize the format of your logs and the data they contain by [adding or subtracting variables][15]. The simplest way to capture detailed logs is to add the following line in the server block of your config file (see [the section][16] on collecting metrics from open-source NGINX for instructions on locating your config files):
|
||
|
||
access_log logs/host.access.log combined;
|
||
|
||
After changing any NGINX configurations, reload the configs by executing:
|
||
|
||
nginx -s reload
|
||
|
||
The “combined” log format, included by default, captures [a number of key data points][17], such as the actual HTTP request and the corresponding response code. In the example logs below, NGINX logged a 200 (success) status code for a request for /index.html and a 404 (not found) error for the nonexistent /fail.
|
||
|
||
127.0.0.1 - - [19/Feb/2015:12:10:46 -0500] "GET /index.html HTTP/1.1" 200 612 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.111 Safari 537.36"
|
||
|
||
127.0.0.1 - - [19/Feb/2015:12:11:05 -0500] "GET /fail HTTP/1.1" 404 570 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.111 Safari/537.36"
|
||
|
||
You can log request processing time as well by adding a new log format to the http block of your NGINX config file:
|
||
|
||
log_format nginx '$remote_addr - $remote_user [$time_local] '
|
||
'"$request" $status $body_bytes_sent $request_time '
|
||
'"$http_referer" "$http_user_agent"';
|
||
|
||
And by adding or modifying the access_log line in the server block of your config file:
|
||
|
||
access_log logs/host.access.log nginx;
|
||
|
||
After reloading the updated configs (by running nginx -s reload), your access logs will include response times, as seen below. The units are seconds, with millisecond resolution. In this instance, the server received a request for /big.pdf, returning a 206 (success) status code after sending 33973115 bytes. Processing the request took 0.202 seconds (202 milliseconds):
|
||
|
||
127.0.0.1 - - [19/Feb/2015:15:50:36 -0500] "GET /big.pdf HTTP/1.1" 206 33973115 0.202 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.111 Safari/537.36"
|
||
|
||
You can use a variety of tools and services to parse and analyze NGINX logs. For instance, [rsyslog][18] can monitor your logs and pass them to any number of log-analytics services; you can use a free, open-source tool such as [logstash][19] to collect and analyze logs; or you can use a unified logging layer such as [Fluentd][20] to collect and parse your NGINX logs.
|
||
|
||
### Conclusion ###
|
||
|
||
Which NGINX metrics you monitor will depend on the tools available to you, and whether the insight provided by a given metric justifies the overhead of monitoring that metric. For instance, is measuring error rates important enough to your organization to justify investing in NGINX Plus or implementing a system to capture and analyze logs?
|
||
|
||
At Datadog, we have built integrations with both NGINX and NGINX Plus so that you can begin collecting and monitoring metrics from all your web servers with a minimum of setup. Learn how to monitor NGINX with Datadog [in this post][21], and get started right away with a [free trial of Datadog][22].
|
||
|
||
----------
|
||
|
||
Source Markdown for this post is available [on GitHub][23]. Questions, corrections, additions, etc.? Please [let us know][24].
|
||
|
||
--------------------------------------------------------------------------------
|
||
|
||
via: https://www.datadoghq.com/blog/how-to-collect-nginx-metrics/
|
||
|
||
作者：K Young
|
||
译者：[译者ID](https://github.com/译者ID)
|
||
校对：[校对者ID](https://github.com/校对者ID)
|
||
|
||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创翻译，[Linux中国](https://linux.cn/) 荣誉推出
|
||
|
||
[1]:https://www.datadoghq.com/blog/how-to-monitor-nginx/
|
||
[2]:http://nginx.org/en/docs/http/ngx_http_stub_status_module.html
|
||
[3]:http://wiki.nginx.org/InstallOptions
|
||
[4]:https://exchange.nagios.org/directory/Plugins/Web-Servers/nginx
|
||
[5]:http://docs.datadoghq.com/integrations/nginx/
|
||
[6]:https://collectd.org/wiki/index.php/Plugin:nginx
|
||
[7]:http://nginx.org/en/docs/http/ngx_http_status_module.html#data
|
||
[8]:http://demo.nginx.com/status.html
|
||
[9]:http://demo.nginx.com/status
|
||
[10]:http://demo.nginx.com/status/upstreams/demoupstreams
|
||
[11]:http://demo.nginx.com/status/upstreams/demoupstreams/0/responses
|
||
[12]:https://www.datadoghq.com/blog/how-to-collect-nginx-metrics/#open-source
|
||
[13]:http://nginx.org/en/docs/http/ngx_http_status_module.html#example
|
||
[14]:http://nginx.org/en/docs/http/ngx_http_log_module.html
|
||
[15]:http://nginx.org/en/docs/http/ngx_http_log_module.html#log_format
|
||
[16]:https://www.datadoghq.com/blog/how-to-collect-nginx-metrics/#open-source
|
||
[17]:http://nginx.org/en/docs/http/ngx_http_log_module.html#log_format
|
||
[18]:http://www.rsyslog.com/
|
||
[19]:https://www.elastic.co/products/logstash
|
||
[20]:http://www.fluentd.org/
|
||
[21]:https://www.datadoghq.com/blog/how-to-monitor-nginx-with-datadog/
|
||
[22]:https://www.datadoghq.com/blog/how-to-collect-nginx-metrics/#sign-up
|
||
[23]:https://github.com/DataDog/the-monitor/blob/master/nginx/how_to_collect_nginx_metrics.md
|
||
[24]:https://github.com/DataDog/the-monitor/issues
|