Nginx OpenTelemetry Collector Documentation

June 12, 2024 by OpenObserve Team
Nginx Receiver


Wouldn’t it be nice if you had an accurate, real-time overview of your Nginx server? Something that would let you see all the requests, follow all the transactions, and collect all the metrics without breaking a sweat? Well, OpenTelemetry Collector documentation can help you set up monitoring for your Nginx server!

NGINX + OpenTelemetry provides an observability solution that makes this job a piece of cake, so let’s talk a little bit about NGINX and OpenTelemetry Collector, and how you can use these technologies to monitor and observe your web applications.

Overview of NGINX and its Significance

NGINX is an essential and widely-used web server, proxy, and load balancer in today’s web. Its performance, scalability, and simplicity make it an ideal choice for most web administrators and developers out there. Whether you're running a small website or managing a complex microservices architecture, NGINX offers the necessary tools to serve any kind of content with high performance and scalability. And, you can use the OpenTelemetry NGINX receiver to monitor its behavior.

OpenTelemetry’s Role in Observability

OpenTelemetry is an open-source project that provides standard APIs, SDKs, and tools for observability. It collects and generates telemetry data (metrics, logs, and traces) (which can help you monitor application performance and health), and export them to various monitoring solutions. When you use OpenTelemetry to monitor NGINX, and especially when using NGINX Receiver, you can see all this data in one place and keep an eye on your web apps.

Importance of Integrating NGINX with OpenTelemetry Collector

NGINX OpenTelemetry Collector enables you to monitor and observe your web server more effectively. The collector receives, processes, and sends the data from NGINX to the chosen observability platform. Using it, you can get better and smarter insights about the server, such as overall performance, traffic, error rate, and much more.

Prerequisites for Integration

Requirements for Configuring the OpenTelemetry Collector with NGINX

Before starting with the integration, make sure you have the following:

  • An NGINX server that is up and running
  • Basic experience with NGINX config files
  • An OpenTelemetry Collector instance that is up and running
  • Docker (optional, for Docker Compose)

Ensuring NGINX is Built with Necessary Modules for Metrics Collection

In order to enable metrics collection in NGINX, it should be built with vital modules like stub_status and other necessary modules depending on the data to be collected. This module ensures the extraction of real-time statistics that are crucial for comprehensive monitoring.

Setting Up NGINX for Metrics and Logs Collection

Setting Up NGINX for Metrics and Logs Collection

  1. Confirm that the stub_status module is enabled in your NGINX build:
nginx -V 2>&1 | grep -o with-http_stub_status_module

If the output includes with-http_stub_status_module , the module is enabled.

Got it? Great! Now, let's configure NGINX to start aggregating its metrics via the HTTP protocol.

  1. Configure the NGINX configuration file (typically located at /etc/nginx/nginx.conf or /etc/nginx/nginx.conf) to include the stub_status module. Add the following block to the server section:
location /nginx_status {
    allow;  # Allow access only from localhost
    deny all;  # Deny all other accesses

Check out our guide for more details on setting up NGINX proxy

Now let’s move on and configure NGINX to its metrics via the HTTP protocol.

Creating and Configuring an Endpoint for Server Statistics

This configuration will create an endpoint (/nginx_status) which can serve as real-time statistics about NGINX performance.

Instructions for Enabling and Accessing the NGINX Status Page for Metrics

To access the status page, visit 'http://your-server-ip/nginx_status' in your browser. You will see a page with various metrics like active connections, accepted connections, and handled requests.

Installing and Configuring the OpenTelemetry Collector

Step-by-Step Guide on Downloading and Setting Up the OpenTelemetry Collector

  1. Get the latest OpenTelemetry Collector installation package from the official GitHub repository or from your package manager.
  2. Follow the installation instructions to complete the collector installation.

Configuring the Collector for Receiving Metrics and Logs from NGINX

Now it's time to create a configuration file (e.g., otel-collector-config.yaml) with the necessary settings so that you can receive and process NGINX metrics via the NGINX Receiver.

Pipeline Configuration for Processing and Exporting Telemetry Data

Specify the pipeline configuration in the YAML file to process and export the data.

Examples of YAML Configurations for Integrating NGINX with the Collector

Ensure within the scrape configurations, targets match your NGINX status endpoint.

Here’s an example configuration using the NGINX Receiver:

    endpoint: "http://localhost:80/nginx_status"

    logLevel: debug

      receivers: [nginx]
      exporters: [logging]

Integrating NGINX with the OpenTelemetry Collector

Adding NGINX as a Receiver in the Collector’s Configuration

Add NGINX as a receiver in your otel-collector-config.yaml file. This will instruct the collector on how to retrieve the metrics from the NGINX Receiver.

Setting Collection Intervals for Metrics

Define the collection interval in the configuration to control the frequency metrics collected by the NGINX Receiver.

Example Configuration with Docker Compose for Easy Setup

For Docker environments, the configuration will look something like this

version: '3.7'
    image: otel/opentelemetry-collector
    command: ["--config", "/etc/otel-collector-config.yaml"]
      - ./otel-collector-config.yaml:/etc/otel-collector-config.yaml
      - "55680:55680"

Validating Metrics and Logs Collection

Steps to Ensure Metrics Are Being Correctly Reported to the Collector

Inspect the logs of the OpenTelemetry Collector to make sure that metrics are being received and processed correctly by the NGINX Receiver.

Methods for Validating Logs and Metrics in the Configured Backend or Dashboard

Don’t forget to verify the metrics and logs by simply viewing them in the configured backend or dashboard. Make sure that the data is the same as the expected output from NGINX.

Monitoring and Visualization

Configuring Dashboards for Visualizing NGINX Metrics

You can use tools to create dashboards that can visualize NGINX metrics, which will provide real-time insights into server performance.

Using Tools like SigNoz for Monitoring and Setting Up Alerts

SigNoz can be configured to monitor NGINX metrics and also set up alerts for specific conditions, this can help you stay proactive in managing your web services.

Creating a Comprehensive Dashboard View with the Collected Metrics

You can also combine various metrics into a single dashboard view, just so that you can get a holistic understanding of your NGINX performance and health.

And speaking of dashboards, let’s push the boundaries a bit further with some advanced configurations and troubleshooting!

Advanced Configuration and Troubleshooting

Expanding Observability by Integrating Additional Web Services

Here’s another thing, you can extend the observability setup by just integrating other web services and configuring forwarding to backend services in order to get a better comprehensive monitoring solution.

Troubleshooting Common Issues in Metrics Collection and Exportation

You can address common issues such as misconfigured endpoints, inadequate access permissions, and performance bottlenecks. Check the configuration files and logs to troubleshoot issues with the NGINX Receiver. Ensure that all endpoints and modules are correctly set up and that there are no network issues blocking data collection.

Debugging the Collector and NGINX Module Integration

Review collector and NGINX logs for errors, and check configurations against best practices. Use debug mode in OpenTelemetry Collector and NGINX logs to detect and fix problems with integrating the NGINX Receiver.

Conclusion and Further Steps

As we conclude, here are some more things that you should know. By integrating NGINX with OpenTelemetry Collector via the NGINX Receiver, you ensure better observability of your applications. This allows for deeper monitoring which translates directly into better optimization and maintenance of your web server. The NGINX Receiver automates the process of collecting traces for better debugging and monitoring, giving you a complete picture of your web server’s performance.

You can also consider scaling this implementation across services and applications for full-stack observability. Consider the NGINX Receiver as an example when planning the integration of other receivers among the OpenTelemetry components.

Easily integrate, visualize, and be alert on your NGINX metrics and much more! Try OpenObserve for advanced observability solutions.

NGINX Official Documentation

OpenTelemetry Collector Documentation

SigNoz Documentation

And that’s it! You are now collecting NGINX telemetry data with the OpenTelemetry Collector and the NGINX Receiver.



The OpenObserve Team comprises dedicated professionals committed to revolutionizing system observability through their innovative platform, OpenObserve. Dedicated to streamlining data observation and system monitoring, offering high performance and cost-effective solutions for diverse use cases.

OpenObserve Inc. © 2024