Skip to content

Commit f4dc464

Browse files
committed
NGINXaaS Platform metric migration
1 parent af2a366 commit f4dc464

File tree

2 files changed

+36
-2
lines changed

2 files changed

+36
-2
lines changed
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
title: Migrate from Custom Metrics to Platform Metrics
3+
weight: 1000
4+
toc: true
5+
url: /nginxaas/azure/getting-started/migrate-to-native-metrics/
6+
type:
7+
- how-to
8+
---
9+
10+
## Overview
11+
NGINXaaS previously supported monitoring using [Custom Metrics](https://learn.microsoft.com/en-us/azure/azure-monitor/metrics/metrics-custom-overview). Custom metrics is a preview feature in Azure and support for it will be dropped in the future. We have added support for Platform metrics which is the Azure recommended way for monitoring resources, we strongly recommend you to migrate your deployments monitoring to use Platform metrics to take advantage of reduced latency and higher reliability.
12+
13+
## Migration Steps
14+
This section contains instructions on how to migrate your deployment monitoring from Custom Metrics to Platform Metrics.
15+
16+
1. Verify that your NGINXaaS deployment meets the [pre-requisites]({{< relref "/nginxaas-azure/monitoring/enable-monitoring.md#prerequisites">}}) for Platform metrics to work.
17+
2. If the per-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.
18+
3. Turn off legacy monitoring.
19+
20+
- **Using Portal**
21+
1. Go to the **NGINX monitoring** page of the NGINXaaS deployment in the Azure portal.
22+
2. Toggle Off the `Send metrics to Azure Monitor` switch.
23+
3. Click Save.
24+
25+
- **Using Terraform**
26+
1. Set `diagnose_support_enabled` to false in the `azurerm_nginx_deployment` resource.
27+
2. Run `terraform plan` followed by `terraform apply` to upgrade the deployment.
28+
29+
- **Using Azure CLI**
30+
Run the command below:
31+
```bash
32+
az nginx deployment update --name myDeployment --resource-group \
33+
myResourceGroup --enable-diagnostics="false"
34+
```

content/nginxaas-azure/monitoring/enable-monitoring.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Monitoring your application's performance is crucial for maintaining its reliabi
1212

1313
Refer to the [Azure monitor overview](https://docs.microsoft.com/en-us/azure/azure-monitor/overview) documentation from Microsoft to learn more about Azure Monitor.
1414

15-
### Prerequisites
15+
## Prerequisites
1616

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

@@ -25,7 +25,7 @@ Azure Monitor will collects metrics from the NGINXaaS deployment automatically i
2525
## Exporting
2626
You can export Azure Monitor metrics to other destinations like Log Analytics workspace, Azure Storage Account, Azure Event Hubs or Azure Monitor partner solutions using Diagnostic Setting. For more information, see the [Metrics diagnostic setting](https://learn.microsoft.com/en-us/azure/azure-monitor/essentials/diagnostic-settings).
2727

28-
To configure diagnostic settings for a service, see [Create diagnostic settings in Azure Monitor](https://learn.microsoft.com/en-us/azure/azure-monitor/essentials/create-diagnostic-settings).
28+
To configure diagnostic settings for a service, see [Create diagnostic settings in Azure Monitor](https://learn.microsoft.com/en-us/azure/azure-monitor/essentials/create-diagnostic-settings). You can export metrics by selecting the `AllMetrics` category in diagnostic settings.
2929

3030
{{<note>}} Not all metrics are exportable via diagnostic settings, for a list of exportable metrics, see [NGINXaaS exportable metrics](https://learn.microsoft.com/en-us/azure/azure-monitor/reference/supported-metrics/nginx-nginxplus-nginxdeployments-metrics).{{</note>}}
3131

0 commit comments

Comments
 (0)