mirror of https://github.com/LCTT/TranslateProject.git synced 2024-12-26 21:30:55 +08:00

@strugglingyouth 另外，也别忘记扩展名。

2015-07-31 13:57:30 +08:00

12 KiB

Raw Blame History

如何收集NGINX指标 - 第2部分

如何获取你所需要的NGINX指标

如何获取需要的指标取决于你正在使用的 NGINX 版本。（参见 the companion article 将深入探索NGINX指标。）免费，开源版的 NGINX 和商业版的 NGINX 都有指标度量的状态模块，NGINX 也可以在其日志中配置指标模块：

注：表格

Metric	Availability
Metric	NGINX (open-source)	NGINX Plus	NGINX logs
accepts / accepted	x	x
handled	x	x
dropped	x	x
active	x	x
requests / total	x	x
4xx codes		x	x
5xx codes		x	x
request time			x

指标收集：NGINX（开源版）

开源版的 NGINX 会显示几个与服务器状态有关的指标在状态页面上，只要你启用了 HTTP stub status module 。要检查模块是否被加载，运行以下命令：

nginx -V 2>&1 | grep -o with-http_stub_status_module

如果你看到 http_stub_status_module 被输出在终端，说明状态模块已启用。

如果该命令没有输出，你需要启用状态模块。你可以使用 --with-http_stub_status_module 参数去配置 building NGINX from source:

./configure \
… \
--with-http_stub_status_module
make
sudo make install

验证模块已经启用或你自己启用它后，你还需要修改 NGINX 配置文件为状态页面设置本地访问的 URL（例如，/ nginx_status）：

server {
    location /nginx_status {
        stub_status on;
 
        access_log off;
        allow 127.0.0.1;
        deny all;
    }
}

注：nginx 配置中的 server 块通常并不在主配置文件中（例如，/etc/nginx/nginx.conf），但主配置中会加载补充的配置文件。要找到主配置文件，首先运行以下命令：

nginx -t

打开主配置文件，在以 http 模块结尾的附近查找以 include 开头的行包，如：

include /etc/nginx/conf.d/*.conf;

在所包含的配置文件中，你应该会找到主服务器模块，你可以如上所示修改 NGINX 的指标报告。更改任何配置后，通过执行以下命令重新加载配置文件：

nginx -s reload

现在，你可以查看指标的状态页：

Active connections: 24 
server accepts handled requests
1156958 1156958 4491319
Reading: 0 Writing: 18 Waiting : 6

请注意，如果你正试图从远程计算机访问状态页面，则需要将远程计算机的 IP 地址添加到你的状态配置文件的白名单中，在上面的配置文件中 127.0.0.1 仅在白名单中。

nginx 的状态页面是一中查看指标快速又简单的方法，但当连续监测时，你需要每隔一段时间自动记录该数据。然后通过监控工具箱 Nagios 或者 Datadog，以及收集统计信息的服务 collectD 来分析已保存的 NGINX 状态信息。

指标收集: NGINX Plus

商业版的 NGINX Plus 通过 ngx_http_status_module 提供的可用指标比开源版 NGINX 更多 many more metrics 。NGINX Plus 附加了更多的字节流指标，以及负载均衡系统和高速缓存的信息。NGINX Plus 还报告所有的 HTTP 状态码类型（1XX，2XX，3XX，4XX，5XX）的计数。一个简单的 NGINX Plus 状态报告 here。

注： NGINX Plus 在状态仪表盘"Active”连接定义的收集指标的状态模块和开源 NGINX 的略有不同。在 NGINX Plus 指标中，活动连接不包括等待状态（又叫空闲连接）连接。

NGINX Plus 也集成了其他监控系统的报告 JSON格式指标。用 NGINX Plus 时，你可以看到负载均衡服务器组的指标和健康状况，或着再向下能取得的仅是响应代码计数从单个服务器在负载均衡服务器中： {"1xx":0,"2xx":3483032,"3xx":0,"4xx":23,"5xx":0,"total":3483055}

启动 NGINX Plus 指标仪表盘，你可以在 NGINX 配置文件的 http 块内添加状态 server 块。 (参见上一页查找相关的配置文件，收集开源 NGINX 版指标的说明。）例如，设立以下一个状态仪表盘在http：//your.ip.address：8080/status.html 和一个 JSON 接口 http：//your.ip.address：8080/status，可以添加以下 server block 来设定：

server {
    listen 8080;
    root /usr/share/nginx/html;
 
    location /status {
        status;
    }
 
    location = /status.html {
    }
}

一旦你重新加载 NGINX 配置，状态页就会被加载：

nginx -s reload

关于如何配置扩展状态模块，官方 NGINX Plus 文档有详细介绍。

指标收集：NGINX日志

NGINX 的日志模块写到配置可以自定义访问日志到指定文件。你可以自定义日志的格式和时间通过添加或移除变量。捕获日志的详细信息，最简单的方法是添加下面一行在你配置文件的server 块中（参见此节通过加载配置文件的信息来收集开源 NGINX 的指标）：

access_log logs/host.access.log combined;

更改 NGINX 配置文件后，必须要重新加载配置文件：

nginx -s reload

“combined” 的日志格式，只包含默认参数，包括一些关键数据，如实际的 HTTP 请求和相应的响应代码。在下面的示例日志中，NGINX 记录了200（成功）状态码当请求 /index.html 时和404（未找到）错误不存在的请求文件 /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"

你可以记录请求处理的时间通过添加一个新的日志格式在 NGINX 配置文件中的 http 块：

log_format nginx '$remote_addr - $remote_user [$time_local] '
                 '"$request" $status $body_bytes_sent $request_time '
                 '"$http_referer" "$http_user_agent"';

通过修改配置文件中 server 块的 access_log 行：

access_log logs/host.access.log nginx;

重新加载配置文件（运行 nginx -s reload）后，你的访问日志将包括响应时间，如下图所示。单位为秒，毫秒。在这种情况下，服务器接收 /big.pdf 的请求时，发送33973115字节后返回206（成功）状态码。处理请求用时0.202秒（202毫秒）：

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"

你可以使用各种工具和服务来收集和分析 NGINX 日志。例如，rsyslog 可以监视你的日志，并将其传递给多个日志分析服务;你也可以使用免费的开源工具，如logstash来收集和分析日志;或者你可以使用一个统一日志记录层，如Fluentd来收集和分析你的 NGINX 日志。

结论

监视 NGINX 的哪一项指标将取决于你提供的工具，以及是否由给定指标证明监控指标的开销。例如，通过收集和分析日志来定位问题是非常重要的在 NGINX Plus 或者运行的系统中。

在 Datadog 中，我们已经集成了 NGINX 和 NGINX Plus，这样你就可以以最小的设置来收集和监控所有 Web 服务器的指标。了解如何用 NGINX Datadog来监控在本文中，并开始使用免费的Datadog。

原文在这 on GitHub。问题，更正，补充等？请让我们知道。

via: https://www.datadoghq.com/blog/how-to-collect-nginx-metrics/

作者：K Young 译者：strugglingyouth 校对：校对者ID

本文由 LCTT 原创翻译，Linux中国荣誉推出

12 KiB Raw Blame History Unescape Escape