文档

接入Nginx监控数据

更新时间:

Nginx中的自建状态页可用于监控Nginx,生成监控指标。您可以将Nginx中的监控指标接入到全栈可观测应用中,进行可视化展示。

前提条件

  • 已创建全栈可观测实例。具体操作,请参见创建实例

  • 确保用于安装Logtail的服务器可连接Nginx服务器。

步骤一:配置Nginx Status模块

  1. 执行以下命令确认Nginx已具备Status功能

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

    如果回显信息为with-http_stub_status_module,表示支持Status功能。

  2. 配置Nginx Status模块。

    在Nginx配置文件(默认为/etc/nginx/nginx.conf)中配置Status模块,配置示例如下所示。更多信息,请参见Nginx Status

         location /private/nginx_status {
           stub_status on;
           access_log   off;
           allow 192.0.2.1;
           deny all;
         }                       
    • /private/nginx_status表示Nginx Status模块的URI,请根据实际情况替换。

    • allow 192.0.2.1表示只允许IP地址为192.0.2.1的服务器访问Nginx Status模块,请根据实际情况替换。

  3. 执行如下命令验证安装Logtail的服务器具备Nginx Status模块访问权限。

    $curl http://192.0.2.1/private/nginx_status

    如果回显信息如下所示,则表示已完成Nginx Status模块配置。

    Active connections: 1
    server accepts handled requests
    2507455 2507455 2512972
    Reading: 0 Writing: 1 Waiting: 0                       

步骤二:创建Logtail采集配置

  1. 登录日志服务控制台

  2. 日志应用区域的智能运维页签下,单击全栈可观测

  3. SLS全栈可观测页面,单击目标实例。

  4. 在左侧导航栏中,单击全栈监控

    首次在该实例中使用全栈监控时,还需单击立即开启

  5. 在左侧导航栏中,单击数据接入,然后在数据接入配置页面,找到中间件监控区域下的NGINX

    首次创建目标监控项的接入配置时,打开创建开关,可进入配置页面。如果您已创建过接入配置,则单击创建图标,可进入配置页面。

  6. 机器组配置页面,配置机器组。

    1. 根据实际需求,选择使用场景和安装环境。

      重要

      无论是否已有机器组,都必须根据实际需求正确选择使用场景和安装环境,这将影响后续的页面配置。

    2. 确认目标机器组已在应用机器组区域,单击下一步

      已有机器组

      源机器组列表选择目标机器组。

      image

      没有可用机器组

      单击创建机器组,在创建机器组面板设置相关参数。机器组标识分为IP地址用户自定义标识,更多信息请参见创建用户自定义标识机器组(推荐)创建IP地址机器组

      重要

      创建机器组后立刻应用,可能因为连接未生效,导致心跳为FAIL,您可单击重试。如果还未解决,请参见Logtail机器组无心跳进行排查。

  7. 数据源设置中,配置如下参数,然后单击完成

    参数名称

    说明

    配置名称

    自定义设置Logtail采集配置的名称。

    集群名称

    自定义设置Nginx集群的名称。

    设置该参数后,日志服务会为通过该Logtail采集配置采集到的Nginx监控数据添加cluster=集群名称的标签。

    重要

    请确保该集群名称唯一,否则可能出现数据冲突。

    服务器列表

    设置Nginx服务器信息,具体配置项如下:

    • 地址:Nginx服务器的地址,可以为服务器IP地址、主机名、域名。

    • 端口:Nginx服务器的端口号。

    • Path:Nginx Status模块的URI,例如/private/nginx_status。如何配置Nginx Status模块,请参见配置Nginx Status模块

    您可以根据业务需求,添加多台Nginx服务器信息。

    自定义标签

    为采集到的Nginx监控数据添加自定义标签,该标签为键值对形式。

    设置该参数后,日志服务会为通过该Logtail采集配置采集到的Nginx监控数据添加标签。

    自定义Telegraf配置

    日志服务基于开源指标采集工具Telegraf采集Nginx监控数据,如果上述默认参数不满足您的采集需求,您可以使用自定义Telegraf配置功能,进行个性化配置。相关的配置示例,请参见Configuration

    支持采集的指标列表,请参见Metrics

    设置完成后,日志服务将自动生成Metricstore等资产。更多信息,请参见资产说明

后续步骤

接入Nginx监控数据后,全栈可观测应用会自动生成专属仪表盘。您可以通过仪表盘分析监控数据。具体操作,请参见查看仪表盘