Nginx status module. Through metrics like connection states .
Nginx status module Nov 15, 2025 · Nginx NGINX is a high-performance web server, reverse proxy, and load balancer known for its ability to handle thousands of concurrent connections efficiently with minimal resource usage. The nginx-plus-module-otel module is an NGINX-authored dynamic module that enables NGINX Plus to send telemetry data to an OTel collector. --add-dynamic-module= path enables an external dynamic module. 4. You can use the --with-http_stub_status_module configuration parameter when building NGINX from source: Step-by-step guide After installing and configuring Nginx, you can follow these steps to monitor Nginx status. This module was available as part of our commercial subscription until 1. This module has a custom json format to better fit the kibana beats. Learn to set up the NGINX status page with for real-time server performance monitoring and seamless integration. Here is one the status page of our web servers with 18 virtual hosts: The status page shows all virtual hosts in section “Server zones” and all upstream servers for the FastCGI PHP backend servers. 1 Nov 9, 2021 · To collect metrics from NGINX, you first need to ensure that NGINX has an enabled status module and a URL for reporting its status metrics. --with-compat enables dynamic modules compatibility. 04, adaptar el firewall, administrar el proceso de Nginx y configurar bloques de servidor Aug 20, 2025 · Secure your Nginx server with a free SSL certificate from Let’s Encrypt on Ubuntu. This is similar to the live activity monitoring of NGINX Plus Oct 13, 2018 · 1. Through metrics like connection states Nov 7, 2025 · sudo service nginx reload You can run the following command to automate the previous steps. general. You can get data by polling a configurable web page (such as /status), or through variables written to log files. This module allows system administrators and developers to monitor server activity, track connection statistics, and identify potential performance bottlenecks without requiring external tools. This is an NGINX module that provides access to virtual host status information. Use the command: View the NGINX status page This document explains how to get access to the stub status in NGINX and the dashboard in NGINX Plus. Nov 17, 2025 · Collection Index Collections in the Community Namespace Community. Please make sure that the directory and the actual configuration file with stub_status are readable by NGINX Amplify Agent; otherwise, NGINX Amplify Agent won’t be able to determine the stub_status URL correctly. Nov 4, 2025 · Learn how to use the Nginx location directive with real-world examples for static files, regex matching, reverse proxy setups, and common configurations. Nov 5, 2025 · Nginx status page can give realtime data about Nginx's health. --add-module= path enables an external module. On GridPane this is installed and enabled by default, and ready to use for any use cases you have that requires it. Note: This module is not distributed with the Nginx source. Aug 4, 2021 · How to enable Nginx status module? On most Linux distros, the module is already enabled. What Will You Find in This Article? I would like to know how to install the stub_status module on an already installed Nginx server via apt-get repository. --with-cc= path sets the name of the C The above is an example nginx_status URI for stub_status. ngx_mail_imap_module ngx_mail_pop3_module ngx_mail_smtp_module ngx_stream_core_module ngx_stream_access_module ngx_stream_geo_module ngx_stream_geoip_module ngx_stream_js_module ngx_stream_keyval_module ngx_stream_limit_conn_module ngx_stream_log_module ngx_stream_map_module ngx_stream_mqtt_preread_module ngx_stream_mqtt_filter_module ngx Aug 21, 2019 · This module nginx-module-vts offers really extended status information for your Nginx. Nginx status is provided by http_stub_status module. Integers For general purposes, nginx code uses two integer types, ngx_int_t and ngx_uint_t, which are typedefs for intptr_t and uintptr_t respectively. Sep 23, 2020 · NGINX is a popular web server that is free, scalable and enjoys a wide user base. Its widespread adoption makes it a cornerstone of modern web infrastructure. Mar 2, 2022 · The module provides access to basic status information. In the realm of server management and configuration, understanding how to leverage the upstream module The optional status_zone parameter (1. One of its powerful features is the ability to enable a status page that prov Nginx status module Introduction Nginx is a popular open-source web server, widely used for its performance and scalability. The parameter is available as part of our commercial subscription. This operation simply reads the header information and immediately enters the writing state after reading, so the time is short. NGINX status module for connection/request and upstream status, which is returned in JSON format. Traffic, requests, and status codes are available. One of the modules available is the http_stub_status_module, which provides real-time monitoring statistics for Nginx. Aug 19, 2021 · Is it possible to enable to the stub_status module in Nginx so that we can monitor the status from an external tool Feb 27, 2025 · Learn how to monitor Nginx effectively, track key metrics, analyze logs, and prevent downtime with the right tools and best practices. NGINX status page displays many useful server KPI metrics such as no. NGINX Plus comes with a dashboard that reports key load-balancing and performance metrics. The default metricset is stubstatus. This file is typically located at /etc/nginx/nginx. The cache status should be a MISS if Nginx does not have the slice (s) required to fulfil the client's request. Learn to install Certbot, configure HTTPS, and automate renewals. nginx -V 2>&1 | grep -o with-http_stub_status_module If you don’t see any output in the terminal, you’re going to have to compile Nginx from source with the –with-http_stub_status_module as a configuration parameter Jan 3, 2012 · requests redirected by the “X-Accel-Redirect” response header field from an upstream server; subrequests formed by the “ include virtual ” command of the ngx_http_ssi_module module, by the ngx_http_addition_module module directives, and by auth_request and mirror directives; requests changed by the rewrite directive. In this blog post, we will discuss the Dec 9, 2013 · Apache has status page that can provide data about Apache. Set up a web server, enable firewall rules, and optimize Nginx performance. If several health checks are defined for the same group of servers, a single failure of any check will make the corresponding server be Jan 20, 2024 · Introduction The NGINX upstream module is a pivotal feature within NGINX, an incredibly popular web server and reverse proxy tool. Please note that the information provided do not only affect the single server within The ngx_http_upstream_module module is used to define groups of servers that can be referenced by the proxy_pass, fastcgi_pass, uwsgi_pass, scgi_pass, memcached_pass, and grpc_pass directives. Apr 13, 2019 · The trick here is to compile Nginx with this great Nginx virtual host traffic status module. Do you know if this is an available feature? I have read that this module is Feb 14, 2023 · After starting and checking the nginx server status in this step, we list the nginx module using the following command. Verify that your nginx binary includes the module before Apr 30, 2025 · The Nginx web server is renowned for its performance and scalability, making it a common choice for system administrators. However, you can check this for your specific machine using the following command. The server group must reside in the shared memory. Having said that, the open source version has a much simpler version of the status page that you can build using --with-http_stub_status_module. General community. May 13, 2025 · Learn how to configure PHP-FPM with NGINX for efficient, secure PHP execution. Nov 17, 2025 · This module is part of the community. . 19. 23. ) 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 Mar 22, 2022 · Step 3 – Enable “ngx_http_stub_status_module” in Nginx If you use open source NGINX, your instances may lack the stub status module. For example, you can detect high-latency endpoints by filtering access logs for long response times using custom log formats. May 26, 2025 · NGINX logs are instrumental in identifying potential bottlenecks and suspicious behavior on your server. It can help you tweak few Nginx config. 20. To verify if your Nginx is installed with this module, run nginx -V 2>&1 | grep -o with-http_stub_status_module If the result shows “with-http_stub_status_module”, you have the module installed. Mar 11, 2016 · Nginx stub_status module Like the Apache mod_status module, Nginx also has a module that can provide you with realtime data regarding its stats. stub_status Module installationReading — Reads the number of Header messages on the client. How do I enable and display such page using nginx server? How do I enable nginx status page on Linux or Unix-like operating systems? Nginx virtual host traffic status module. If a health check fails, the server will be considered unhealthy. Modify NGINX Configuration:Open your NGINX configuration file. It creates a status. You can compile your own NGINX-enabling the module as you compile it-but most modern Linux distributions provide alternative NGINX packages with various combinations of extra modules built in. Luckily, there is a guy that did almost all of the work compiling in the VTS module. Dec 21, 2024 · In this article, we will explore how to build an integrated monitoring system using the Nginx VTS (Virtual Host Traffic Status) module with Prometheus and Grafana. Use the command: Jan 8, 2018 · Monitor NGINX with the stub_status module, log files, NGINX Amplify, the NGINX Plus API module and dashboard, third-party plug-ins, and more. This check parses the information provided by the NGINX stub status module. general collection (version 11. It contains the current status such as servers, upstreams, user-defined filter. You might already have this collection installed if you are using the ansible package. NGINX comes with a status page that reports basic metrics about NGINX called the stub status. NGINX Amplify Agent will determine the correct URI automatically upon parsing your NGINX configuration. Follow this step-by-step guide to configure your production-ready Django app. Check your operating system’s NGINX packages to find one that includes the Enabling the NGINX status page involves configuring NGINX to expose a special endpoint that provides information about the server's current status, including active connections, requests, and more. nginx_status_info module – Retrieve information on nginx status Edit on GitHub ngx_mail_imap_module ngx_mail_pop3_module ngx_mail_smtp_module ngx_stream_core_module ngx_stream_access_module ngx_stream_geo_module ngx_stream_geoip_module ngx_stream_js_module ngx_stream_keyval_module ngx_stream_limit_conn_module ngx_stream_log_module ngx_stream_map_module ngx_stream_mqtt_preread_module ngx_stream_mqtt_filter_module ngx NGINX provides ngx_http_stub_status_module module which allows us to access status data about NGINX itself. Oct 12, 2018 · On most Linux distributions, the Nginx version comes with the ngx_http_stub_status_module enabled. Apr 9, 2025 · Learn how to install and configure Nginx on Ubuntu with this step-by-step guide. It shows all the results by default, and can be set to show part of them by specifying zones. 1; deny all; } } nginx version: nginx/1. 17. You can learn more about it… The ngx_http_rewrite_module module is used to change request URI using PCRE regular expressions, return redirects, and conditionally select configurations. The module may be combined with other access modules, such as ngx_http_access_module, ngx_http_auth_basic_module, and ngx_http_auth_jwt_module, via the satisfy directive. OTel enables the collection of telemetry data from a deployed application stack. Jan 13, 2010 · The ngx_http_status_module module provides access to various status information. The core source file comes from Tengine, which is developed and maintained by Alibaba. Mar 31, 2024 · Nginx Status Modules: This is the most direct way to get the goods. Sep 10, 2025 · Learn how to install and configure Nginx web server on Ubuntu. This operation not only reads the header, but also waits for the service response, so Using the Stub Status module NGINX provides an introspection module that outputs certain statistics about how it is running. conf or /etc/nginx/sites Jan 13, 2010 · ngx_http_status_module 示例配置 指令 status status_format status_zone 数据 兼容性 1. NGINX Plus has exclusive enterprise grade features beyond what's available in the open source offering, including session persistence, configuration via API, and active health checks. Integrating Telegraf and NGINX The ngx_http_upstream_hc_module module allows enabling periodic health checks of the servers in a group referenced in the surrounding location. En esta guía, explicaremos cómo instalar Nginx en su servidor de Ubuntu 20. We are going to set up our monitoring by using metrics provided by this module. Step-by-step guide After installing and configuring Nginx, you can follow these steps to monitor Nginx status. OpenTelemetry (OTel) is an observability framework for monitoring, tracing, troubleshooting, and optimizing applications. This is a porting version of the nginx-module-vts to the NGINX "stream" subsystem so as to support the same features in nginx-module-vts. My config file server { listen localhost; location /nginx_status { stub_status on; allow 127. To see the statistics produced by this module, the stub_status directive needs to be set to on. The agent plug-in nginx_status fetches these information and processes it. Here are the steps to enable the nginx_status page:1. For beginners working with Nginx Mar 15, 2020 · This article explains the process used to check the current status of your Nginx server as well as how to use the ngx_http_stub_status_module to gain more insight about your web server. Writing — The number of header information in response to the data to the client. 13. Jul 9, 2015 · 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. The break, if, return, rewrite, and set directives are processed in the following order: the directives of this module specified on the server level are executed sequentially; repeatedly: a location is searched based on a request URI; the When using the HTTP slice module with Nginx cofigured as a caching reverse proxy, from an empty cache, the access log shows a cache HIT for almost all requests, despite Nginx fetching the file from the upstream server in the background. Feb 4, 2025 · This post demonstrates how to monitor nginx using Prometheus and Grafana, covering steps from enabling the nginx status module to configuring Grafana dashboards. If you see --with-http_stub_status_module as output in the terminal, means the status module is enabled. The module supports W3C trace context propagation Learn how to enable and view Nginx's built-in server status page. If you have enabled that module, then the URL /nginx_status shows interesting information about the inner state of the web server when accessed from localhost. Explore installation, setup, and performance tuning best practices. Details on installation, including patching the Nginx source and compiling Nginx with this module, as well as configuration instructions and examples, can be found below. Status data can be used in load-balancer env also. get). One of the key features of Nginx is its modular architecture, which allows for easy customization and extension. NGINX+ contains a ngx_http_status_module module that provides access to various status Description This is an Nginx module that provides access to stream server traffic status information. page. We can monitor traffic by country or city using Max Mind Geo IP database. 2 and The status module is enabled if you see with-http_stub_status_module as output in the terminal. Feb 28, 2024 · In this article, we will explore How to Monitor Nginx with Prometheus. This module provides access to virtual host status information. The template Nginx by Zabbix agent - collects metrics by polling the Module ngx_http_stub_status_module locally with Zabbix agent: Active connections: 291 server accepts handled requests 16630948 16630948 31070465 Reading: 6 Writing: 179 Waiting: 106 Note that this template doesn't support HTTPS and redirects (limitations of web. It contains the current status such as servers, upstreams, caches This module periodically fetches metrics from Nginx servers. If the command output does not include http_stub_status_module, you must install an NGINX package that includes the module. First of all, It is required both the directive server_traffic_status_zone type = grpc [grpc_service = name] [grpc_status = code] enables periodic health checks of a gRPC server or a particular gRPC service specified with the optional grpc_service parameter (1. It offers several modules such as ngx_http_stub_status_module module that allows you to easily monitor server health. 5). About nginx_http_upstream_check_module - support upstream servers health check with NGINX. Basically nginx –V command is used to display the installed nginx version; also, we can use the same command to display the installed nginx module in our system. of active client connections, accepted, handled & total requests. The command turns on stub_status, reloads nginx, and verifies that the expected information is exposed through the endpoint. To enbale stats edit nginx configuration file for your web site, add following code location /nginx_status { stub_status; […] This module provides additional status information by extending the build-in Nginx status module with finer details. The easiest way to configure a performant, secure, and stable nginx server. Sep 15, 2022 · Learn how to configure Nginx as a reverse proxy on Ubuntu. 1). Jul 17, 2020 · Explains how to see which flags Nginx compiled and list installed Nginx modules under a Linux, macOS, *BSD or Unix-like systems. Feb 24, 2025 · The stub_status module in NGINX provides real-time server health metrics like active connections, handled requests, and connection states (reading, writing, waiting). NGINX REST API available since NGINX Plus Release 14 - an interface that can obtain extended status information, reset Nov 10, 2020 · Nginx virtual host traffic status module (Nginx Module VTS) has lot of usefull monitoring for your open source Nginx server. First, confirm that Nginx was compiled with the HttpStudStatusModule. Contribute to vozlt/nginx-module-vts development by creating an account on GitHub. This is when using Nginx with DNS spoofing to For me the accepted answer did not work (although it might be correct from coding perspective) I just needed to restart nginx sudo service nginx restart Any sudo nginx -s reload I did would give back 404. Nginx stub status module Make sure that the server process is configured with the stub status module. The req status module for pure nginx. 10 版本起,该模块被 1. If that command returns no output, you will need to enable the status module. By integrating Prometheus with Nginx, administrators can gain valuable insights into their web server’s performance and health, enabling proactive management and optimization. This module is not built by default, it should be enabled with the --with-http_auth_request_module configuration parameter. Nginx Module VTS also can monitoring upstream status and request. Oct 2, 2025 · Learn how to set up Django with Postgres, Nginx, and Gunicorn on Ubuntu. The Nginx metricsets were tested with Nginx 1. This module is called stub_status and is enabled with the --with-http_stub_status_module configure flag. 3 中的 ngx_http_api_module 模块所取代。 ngx_http_status_module 模块提供了访问各种状态信息的接口。 该模块作为我们 商业订阅 的一部分提供。 示例配置 RPM package nginx-module-vts. Description NGINX Plus is a software load balancer, web server, and content cache built on top of open source NGINX. It contains the current status such as servers, upstreams, caches. While its not as detailed as Apache mod_status, the data is still useful, especially if you are using Nginx as a load balancer. Nginx Status Module Introduction The Nginx Status Module is a built-in feature that provides essential real-time metrics about your Nginx web server's performance. 5) enables collection of DNS server statistics of requests and responses in the specified zone. If NGINX Amplify NGINX Plus provides various monitoring tools for your server infrastructure: the interactive Dashboard page available since NGINX Plus Release 9 - a real-time live activity monitoring interface that shows key load and performance metrics of your server infrastructure. Step-by-step setup with HTTPS, headers, WebSockets, and load balancing examples. May 21, 2020 · Introducción Nginx es uno de los servidores web más populares del mundo y aloja algunos de los sitios más grandes y con mayor tráfico en Internet. --with-cpp_test_module enables building the ngx_cpp_test_module module. Es una opción ligera que se puede utilizar como servidor web o proxy inverso. conf file if it doesn't exist or overwrites the existing one if it does exist. Nov 26, 2013 · The source code you linked is from 8 years ago and the commercial version was released 1 year ago, so I doubt this is what he is looking for. You can check out if the module is already enabled or not using following command. The module is intended for nginx developers and is not built by default. 0. Nov 9, 2021 · To collect metrics from NGINX, you first need to ensure that NGINX has an enabled status module and a URL for reporting its status metrics. Monitoring NGINX's performance metrics is essential for maintaining reliable web services. 10. (See the companion article for an in-depth exploration of NGINX metrics. Let's get your status page up and running! The status information is about connections, requests, response status codes, input and output flows, rt, and upstreams. Follow instructions with firewall setup, security hardening, and troubleshooting tips. Having the information provided by the Nginx status page can be useful to help determine information pertaining to the number of requests your server is currently receiving, the amount of active connections, etc. ihuukeikxhmkhmiviucnnvpzdhmgblwyvxtsgrogcqpowefiefttaivotvqtfygyegzujayivg