Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
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
2 changes: 1 addition & 1 deletion content/includes/nginxaas-azure/terraform-resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@ nd-files:
---

- [NGINXaaS Managed Identity Documentation]({{< ref "/nginxaas-azure/getting-started/managed-identity-portal.md" >}})
- [NGINXaaS Azure Monitor Documentation]({{< ref "/nginxaas-azure/monitoring/enable-monitoring.md" >}})
- [NGINXaaS Azure Monitor Documentation]({{< ref "/nginxaas-azure/monitoring/enable-metrics.md" >}})
Original file line number Diff line number Diff line change
Expand Up @@ -298,7 +298,7 @@ To see a list of currently active issues, visit the [Known issues]({{< ref "/ngi

NGINXaaS, powered by [NGINX Plus](https://www.nginx.com/products/nginx/), is a fully managed service that removes the burden of deploying your own NGINX Plus cluster, installing libraries, upgrading, and managing it.

NGINXaaS simplifies the process of moving your [existing NGINX configuration]({{< ref "/nginxaas-azure/getting-started/nginx-configuration#add-nginx-configuration" >}}) to the Azure cloud. Once your configurations are moved to Azure, [securely manage SSL/TLS certificates and keys stored in Azure Key Vault and reference them within your NGINX configurations]({{< ref "/nginxaas-azure/getting-started/ssl-tls-certificates/ssl-tls-certificates-portal.md" >}}). You can [watch your application's traffic in real time]({{< ref "/nginxaas-azure/monitoring/enable-monitoring" >}}) with Azure monitoring and alerts, and scale your deployment to fit your needs, maximizing cost efficiency.
NGINXaaS simplifies the process of moving your [existing NGINX configuration]({{< ref "/nginxaas-azure/getting-started/nginx-configuration#add-nginx-configuration" >}}) to the Azure cloud. Once your configurations are moved to Azure, [securely manage SSL/TLS certificates and keys stored in Azure Key Vault and reference them within your NGINX configurations]({{< ref "/nginxaas-azure/getting-started/ssl-tls-certificates/ssl-tls-certificates-portal.md" >}}). You can [watch your application's traffic in real time]({{< ref "/nginxaas-azure/monitoring/enable-metrics" >}}) with Azure monitoring and alerts, and scale your deployment to fit your needs, maximizing cost efficiency.
You can create, update, and delete your NGINXaaS deployment using the [Azure Resource Manager]({{< ref "/nginxaas-azure/client-tools/templates.md" >}}), the [Azure SDK]({{< ref "/nginxaas-azure/client-tools/sdk" >}}), [CLI]({{< ref "/nginxaas-azure/getting-started/create-deployment/deploy-azure-cli.md" >}}), and [Terraform]({{< ref "/nginxaas-azure/getting-started/create-deployment/deploy-terraform.md" >}}) in addition to the [Azure portal]({{< ref "/nginxaas-azure/getting-started/create-deployment/" >}}).

Our new "Standard" plan is ready for production workloads.
Expand Down
2 changes: 1 addition & 1 deletion content/nginxaas-azure/changelog/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ NGINXaaS now allows both precompiled and custom policies for F5 WAF for NGINX to

- {{% icon-feature %}} **Azure Monitor Platform Metrics**

NGINXaaS now publishes platform metrics directly to Azure Monitor. Compared to legacy monitoring based on custom metrics, platform metrics offers reduced latency and higher reliability. We strongly recommend migrating your alerts to use platform metrics for improved monitoring and management. For more details on enabling platform metrics, please refer to [Enable Monitoring]({{< relref "/nginxaas-azure/monitoring/enable-monitoring.md">}}).
NGINXaaS now publishes platform metrics directly to Azure Monitor. Compared to legacy monitoring based on custom metrics, platform metrics offers reduced latency and higher reliability. We strongly recommend migrating your alerts to use platform metrics for improved monitoring and management. For more details on enabling platform metrics, please refer to [Enable Monitoring]({{< relref "/nginxaas-azure/monitoring/enable-metrics.md">}}).

## April 22, 2025

Expand Down
2 changes: 1 addition & 1 deletion content/nginxaas-azure/client-tools/sdk.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ For example scripts to create or update deployment resources, see [NGINXaaS Snip
- [Azure SDK Deployment Create or Update Documentation](https://learn.microsoft.com/en-us/python/api/azure-mgmt-nginx/azure.mgmt.nginx.operations.deploymentsoperations?view=azure-python#azure-mgmt-nginx-operations-deploymentsoperations-begin-create-or-update)
- [Azure SDK Deployment Delete Documentation](https://learn.microsoft.com/en-us/python/api/azure-mgmt-nginx/azure.mgmt.nginx.operations.deploymentsoperations?view=azure-python#azure-mgmt-nginx-operations-deploymentsoperations-begin-delete)
- [NGINXaaS Managed Identity Documentation]({{< ref "/nginxaas-azure/getting-started/managed-identity-portal.md" >}})
- [NGINXaaS Azure Monitor Documentation]({{< ref "/nginxaas-azure/monitoring/enable-monitoring/" >}})
- [NGINXaaS Azure Monitor Documentation]({{< ref "/nginxaas-azure/monitoring/enable-metrics/" >}})

### Create or update a certificate

Expand Down
2 changes: 1 addition & 1 deletion content/nginxaas-azure/client-tools/templates.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ F5 NGINXaaS for Azure (NGINXaaS) deployments can be managed using the ARM API or
See [NGINXaaS Snippets](https://github.com/nginxinc/nginxaas-for-azure-snippets/tree/main/arm-templates/deployments/create-or-update) for an example template to create or update deployment resources.

- [NGINXaaS Managed Identity Documentation]({{< ref "/nginxaas-azure/getting-started/managed-identity-portal.md" >}})
- [NGINXaaS Azure Monitor Documentation]({{< ref "/nginxaas-azure/monitoring/enable-monitoring.md" >}})
- [NGINXaaS Azure Monitor Documentation]({{< ref "/nginxaas-azure/monitoring/enable-metrics.md" >}})

### Create or update a certificate

Expand Down
2 changes: 1 addition & 1 deletion content/nginxaas-azure/client-tools/terraform.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ F5 NGINXaaS for Azure (NGINXaaS) deployments can be managed using Terraform. Thi
See [NGINXaaS Snippets](https://github.com/nginxinc/nginxaas-for-azure-snippets/tree/main/terraform/deployments/create-or-update) for an example to create or update deployment resources.

- [NGINXaaS Managed Identity Documentation]({{< ref "/nginxaas-azure/getting-started/managed-identity-portal.md" >}})
- [NGINXaaS Azure Monitor Documentation]({{< ref "/nginxaas-azure/monitoring/enable-monitoring.md" >}})
- [NGINXaaS Azure Monitor Documentation]({{< ref "/nginxaas-azure/monitoring/enable-metrics.md" >}})

### Create or update a certificate

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ For Azure client tools, such as the Azure CLI or Azure Resource Manager, the cer

## Monitor certificates

To view the status of your SSL/TLS certificates, [enable monitoring]({{< ref "/nginxaas-azure/monitoring/enable-monitoring.md" >}}) for your NGINXaaS deployment and navigate to the **Metrics** tab in the Azure portal. View the `nginxaas.certificates` metric under the `nginxaas statistics` metric namespace. The `nginxaas.certificates` metric allows you to filter by certificate name and the status of the certificate. The status dimension reports the health of your certificates through the following values:
To view the status of your SSL/TLS certificates, [enable monitoring]({{< ref "/nginxaas-azure/monitoring/enable-metrics.md" >}}) for your NGINXaaS deployment and navigate to the **Metrics** tab in the Azure portal. View the `nginxaas.certificates` metric under the `nginxaas statistics` metric namespace. The `nginxaas.certificates` metric allows you to filter by certificate name and the status of the certificate. The status dimension reports the health of your certificates through the following values:

{{< table >}}

Expand Down
2 changes: 1 addition & 1 deletion content/nginxaas-azure/monitoring/configure-alerts.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ This guide explains how to create and configure metrics-based alerts for your NG

- To complete this setup, you must be an owner or user access administrator for the NGINX deployment resource.

- To enable metrics, see [Enable Monitoring]({{< ref "/nginxaas-azure/monitoring/enable-monitoring.md" >}}).
- To enable metrics, see [Enable Metrics]({{< ref "/nginxaas-azure/monitoring/enable-metrics.md" >}}).

{{< call-out "note" >}} See [Azure monitor overview](https://docs.microsoft.com/en-us/azure/azure-monitor/overview) documentation to familiarize with Azure Monitor. {{< /call-out >}}

Expand Down
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
title: Enable monitoring
title: Enable metrics
weight: 200
toc: true
nd-docs: DOCS-876
url: /nginxaas/azure/monitoring/enable-monitoring/
url: /nginxaas/azure/monitoring/enable-metrics/
type:
- how-to
---
Expand All @@ -14,9 +14,10 @@ Refer to the [Azure monitor overview](https://docs.microsoft.com/en-us/azure/azu

## Prerequisites

- A system assigned managed identity with `Monitoring Metrics Publisher` role.
- A system assigned managed identity.

{{< call-out "note" >}} When a system assigned managed identity is added to the deployment through portal, this role is automatically added.{{< /call-out >}}
{{< call-out "note" >}}The system-assigned managed identity does not need any role assignments to enable the metrics functionality described in this section.
{{< /call-out >}}

## Collection

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ F5 NGINXaaS for Azure previously supported monitoring through [Custom Metrics](h

Follow the steps in this section to migrate your deployment monitoring from Custom metrics to Platform metrics.

1. Verify that your NGINXaaS deployment meets the [pre-requisites]({{< ref "/nginxaas-azure/monitoring/enable-monitoring.md#prerequisites">}}) for Platform metrics to work.
1. Verify that your NGINXaaS deployment meets the [pre-requisites]({{< ref "/nginxaas-azure/monitoring/enable-metrics.md#prerequisites">}}) for Platform metrics to work.
2. If the pre-requisites are met, Platform metrics are enabled by default on all NGINXaaS deployment. Verify that you are able to see the new metrics in Azure Monitor under the `Standard Metrics` namespace.
3. **Migrate existing alert rules** to use Platform metrics instead of Custom metrics:

Expand Down
2 changes: 1 addition & 1 deletion content/nginxaas-azure/quickstart/geoip2.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ http {

All licenses are [validated with MaxMind](https://dev.maxmind.com/license-key-validation-api/) when initially added to your deployment, but MaxMind licenses can expire or be manually revoked.

To view the status of your MaxMind license, [enable monitoring]({{< ref "/nginxaas-azure/monitoring/enable-monitoring.md" >}}) for your NGINXaaS deployment and navigate to the Metrics tab. View the `nginxaas.maxmind` metric under the `nginxaas statistics` metric namespace. The `nginxaas.maxmind` metric reports the health of your license through the `status` dimension:
To view the status of your MaxMind license, [enable metrics]({{< ref "/nginxaas-azure/monitoring/enable-metrics.md" >}}) for your NGINXaaS deployment and navigate to the Metrics tab. View the `nginxaas.maxmind` metric under the `nginxaas statistics` metric namespace. The `nginxaas.maxmind` metric reports the health of your license through the `status` dimension:

{{< table >}}

Expand Down
2 changes: 1 addition & 1 deletion content/nginxaas-azure/quickstart/scaling.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ NGINXaaS provides metrics for visibility of the current and historical capacity

See the [Metrics Catalog]({{< ref "/nginxaas-azure/monitoring/metrics-catalog.md" >}}) for a reference of all metrics.

{{< call-out "note" >}}These metrics aren't visible unless enabled, see how to [Enable Monitoring]({{< ref "/nginxaas-azure/monitoring/enable-monitoring.md" >}}) for details.{{< /call-out >}}
{{< call-out "note" >}}These metrics aren't visible unless enabled, see how to [Enable Metrics]({{< ref "/nginxaas-azure/monitoring/enable-metrics.md" >}}) for details.{{< /call-out >}}
{{< call-out "warning" >}}The `ncu.consumed` metric is now deprecated and is on the path to retirement. Please change any alerting on this metric to use the new Capacity Percentage metric.{{< /call-out >}}

## Estimating how many NCUs to provision
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -393,7 +393,7 @@ These features will be added in future releases.

## Monitoring

[Enable monitoring]({{< ref "/nginxaas-azure/monitoring/enable-monitoring.md" >}}), check [real time monitoring](https://github.com/nginxinc/nginx-openid-connect/blob/main/README.md#real-time-monitoring) to see how OIDC metrics are collected, and use "plus.http.*" metrics filtered with location_zone dimension in [NGINX requests and response statistics]({{< ref "/nginxaas-azure/monitoring/metrics-catalog.md#nginx-requests-and-response-statistics" >}}) to check the OIDC metrics.
[Enable metrics]({{< ref "/nginxaas-azure/monitoring/enable-metrics.md" >}}), check [real time monitoring](https://github.com/nginxinc/nginx-openid-connect/blob/main/README.md#real-time-monitoring) to see how OIDC metrics are collected, and use "plus.http.*" metrics filtered with location_zone dimension in [NGINX requests and response statistics]({{< ref "/nginxaas-azure/monitoring/metrics-catalog.md#nginx-requests-and-response-statistics" >}}) to check the OIDC metrics.

## See Also

Expand Down