Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
docs:
files:
- content/nim/monitoring/overview-metrics.md
- content/nginx-one/getting-started.md
<!-- - content/nginx-one/getting-started.md (temporarily disabled) -->
---

To collect comprehensive metrics for NGINX Plus--including bytes streamed, information about upstream systems and caches, and counts of all HTTP status codes--add the following to your NGINX Plus configuration file (for example, `/etc/nginx/nginx.conf` or an included file):
Expand Down
32 changes: 29 additions & 3 deletions content/nginx-one/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -136,17 +136,43 @@ If you followed the [Installation and upgrade](https://docs.nginx.com/nginx-agen

## Enable NGINX metrics reporting

In order for NGINX One Console to show specific traffic and system metrics, you need to enable the appropriate API on your NGINX data plane instances. The sections below provide step-by-step instructions for both NGINX Plus and NGINX Open Source (OSS).
NGINX One Console dashboard relies on the NGINX Plus and NGINX Open Source Stub Status APIs to report traffic and system metrics. The following sections include instructions on how to enable those metrics.
<!--
In order for NGINX One Console to show specific traffic and system metrics, you need to enable the appropriate API on your NGINX data plane instances. The sections below provide step-by-step instructions for both NGINX Plus and NGINX Open Source (OSS). -->

### Enable NGINX Plus API

{{< include "/use-cases/monitoring/enable-nginx-plus-api.md" >}}
<!-- {{< include "/use-cases/monitoring/enable-nginx-plus-api.md" >}} -->
To collect metrics for NGINX Plus, add the following to your NGINX Plus configuration file:

```nginx
# Enable the /api/ location with appropriate access control
# to use the NGINX Plus API.
#
location /api/ {
api write=on;
allow 127.0.0.1;
deny all;
}
```

This configuration:

- Enables the NGINX Plus API.
- Allows requests only from `127.0.0.1` (localhost).
- Blocks all other requests for security.

After saving the changes, reload NGINX to apply the new configuration:

```shell
nginx -s reload
```

### Enable NGINX Open Source Stub Status API

{{< include "/use-cases/monitoring/enable-nginx-oss-stub-status.md" >}}

---
---

## View instance metrics with the NGINX One dashboard

Expand Down
Loading