diff --git a/content/nginxaas-azure/changelog.md b/content/nginxaas-azure/changelog.md
index c9cb1c6cb..fbf219dd3 100644
--- a/content/nginxaas-azure/changelog.md
+++ b/content/nginxaas-azure/changelog.md
@@ -13,6 +13,13 @@ To see a list of currently active issues, visit the [Known issues]({{< relref "/
To review older entries, visit the [Changelog archive]({{< relref "/nginxaas-azure/changelog-archive" >}}) section.
+## TODO: March XX, 2025
+
+- {{% icon-resolved %}} **Azure Monitor Platform Metrics**
+
+ NGINXaaS now publishes platform metrics directly to Azure Monitor. Legacy monitoring based on custom metrics is deprecated, and 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">}}).
+
+
## March 13, 2025
- {{% icon-resolved %}} **Percentage capacity metric**
diff --git a/content/nginxaas-azure/monitoring/configure-alerts.md b/content/nginxaas-azure/monitoring/configure-alerts.md
index 0d67b5c24..25b99e966 100644
--- a/content/nginxaas-azure/monitoring/configure-alerts.md
+++ b/content/nginxaas-azure/monitoring/configure-alerts.md
@@ -10,7 +10,7 @@ url: /nginxaas/azure/monitoring/configure-alerts/
## Overview
-{{}}F5 NGINX as a Service for Azure (NGINXaaS) publishes custom metrics to Azure Monitor. To learn more about how to create and manage metrics-based alert rules, refer to the [Alerts section in Azure Monitor](https://learn.microsoft.com/en-us/azure/azure-monitor/alerts/alerts-create-new-alert-rule?tabs=metric) documentation from Microsoft. {{}}
+{{}}F5 NGINX as a Service for Azure (NGINXaaS) publishes platform metrics to Azure Monitor. To learn more about how to create and manage metrics-based alert rules, refer to the [Alerts section in Azure Monitor](https://learn.microsoft.com/en-us/azure/azure-monitor/alerts/alerts-create-new-alert-rule?tabs=metric) documentation from Microsoft. {{}}
This guide explains how to create and configure metrics-based alerts for your NGINXaaS for Azure deployment using Azure Monitor.
diff --git a/content/nginxaas-azure/monitoring/enable-monitoring.md b/content/nginxaas-azure/monitoring/enable-monitoring.md
index 833646c26..85a3475bb 100644
--- a/content/nginxaas-azure/monitoring/enable-monitoring.md
+++ b/content/nginxaas-azure/monitoring/enable-monitoring.md
@@ -7,75 +7,54 @@ docs: "DOCS-876"
url: /nginxaas/azure/monitoring/enable-monitoring/
---
-Monitoring your application's performance is crucial for maintaining its reliability and efficiency. F5 NGINX as a Service for Azure (NGINXaaS) seamlessly integrates with Azure Monitor, allowing you to collect, correlate, and analyze metrics for a thorough understanding of your application's health and behavior. With Azure Monitor, you gain access to a wealth of information regarding your application's operations. You can:
+Monitoring your application's performance is crucial for maintaining its reliability and efficiency. F5 NGINX as a Service for Azure (NGINXaaS) seamlessly integrates with Azure Monitor, allowing you to collect, correlate, and analyze metrics for a thorough understanding of your application's health and behavior.
-- Review Metrics: Examine the performance data collected from your application.
-- Correlate Data: Connect different data points to gain insights into application performance trends.
-- Analyze Performance: Dive deep into metrics to gain a comprehensive understanding of how your application operates.
-- Create Alerts: Set up proactive monitoring by configuring alerts that notify you of potential issues before they escalate.
+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.
-{{}}NGINXaaS for Azure publishes *custom* metrics to Azure Monitor. To learn about the differences between standard and custom metrics, refer to the [Custom metrics in Azure Monitor overview](https://docs.microsoft.com/en-us/azure/azure-monitor/essentials/metrics-custom-overview) documentation from Microsoft. Azure Monitor custom metrics are currently in public preview.{{}}
+### Prerequisites
+- A system assigned managed identity with `Monitoring Metrics Publisher` role.
-### Prerequisites
+{{}} When a system assigned managed identity is added to the deployment through portal, this role is automatically added.{{}}
-- A user assigned managed identity or a system assigned managed identity with `Monitoring Metrics Publisher` role.
+## Collection
-{{}} When a user assigned managed identity or a system assigned managed identity is added to the deployment through portal, this role is automatically added.{{}}
+Azure Monitor will collects metrics from the NGINXaaS deployment automatically if the prerequisites are met. No configuration is required.
-- User must be an owner or user access administrator for NGINX deployment resource to complete this set up.
+## Exporting
+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).
-- If you're unfamiliar with Azure Monitor, refer to the [Azure monitor overview](https://docs.microsoft.com/en-us/azure/azure-monitor/overview) documentation from Microsoft.
+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).
-## Enable monitoring
+{{}} 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).{{}}
-1. Log in to the Azure portal and navigate to your NGINXaaS for Azure deployment.
-2. In the navigation pane under **Settings**, select the **NGINX monitoring** section.
-3. Turn on the **Send metrics to Azure Monitor** setting.
-## View metrics with Azure Monitor metrics explorer
+## Cost and retention
+Azure Monitor platform metrics are ingested and stored free of charge, with a standard retention period of 93 days. Adding alerts, querying Azure Monitor using REST API or exporting metrics using Azure Monitor's diagnostic settings would incurs costs. For detailed pricing, you can refer to the [Azure Monitor pricing page](https://azure.microsoft.com/en-us/pricing/details/monitor/).
-1. In the navigation pane under **Monitoring**, select the **Metrics** section to access the Azure Monitor metrics explorer for your NGINXaaS deployment.
-2. Refer to the [Azure Monitor metrics explorer](https://docs.microsoft.com/en-us/azure/azure-monitor/essentials/metrics-getting-started) documentation from Microsoft to learn how you can create queries.
-{{}}Many of NGINX Plus's advanced statistics need to be enabled in the "nginx.conf" file before they will appear in the metrics explorer, for example "plus.http.request.bytes_*". Refer to [Gathering Data to Appear in Statistics](https://docs.nginx.com/nginx/admin-guide/monitoring/live-activity-monitoring/#gathering-data-to-appear-in-statistics) to learn more.{{}}
+## View metrics with Azure Monitor metrics explorer
-## Retrieve metrics through Azure Monitor API
+Access the [Microsoft Azure portal](https://portal.azure.com)
-This section shows you how to effectively discover, gather and analyze NGINXaaS metrics through the Azure Monitor API.
+1. Go to your NGINXaaS for Azure deployment.
+2. In the navigation pane under **Monitoring**, select the **Metrics** section to access the Azure Monitor metrics explorer for your NGINXaaS deployment.
-{{}}Refer to [Authenticate Azure Monitor requests](https://learn.microsoft.com/en-us/azure/azure-monitor/essentials/rest-api-walkthrough?tabs=portal#authenticate-azure-monitor-requests) for instructions on authenticating your API requests against the Azure Monitor API endpoint.{{}}
+Refer to the [Azure Monitor metrics explorer](https://docs.microsoft.com/en-us/azure/azure-monitor/essentials/metrics-getting-started) documentation from Microsoft to learn how you can create queries.
-1. **Retrieve metric namespaces:** Each metric belongs to a category, or "namespace", which groups similar types of metrics together. We recommend listing all namespaces for NGINXaaS to locate the metrics you're interested in. The following `curl` example shows how to retrieve all metrics namespaces on your NGINXaaS deployment:
+{{}}Many of NGINX Plus's advanced statistics need to be enabled in the "nginx.conf" file before they will appear in the metrics explorer, for example "plus.http.request.bytes_*". Refer to [Gathering Data to Appear in Statistics](https://docs.nginx.com/nginx/admin-guide/monitoring/live-activity-monitoring/#gathering-data-to-appear-in-statistics) to learn more.{{}}
- ```bash
- curl --request GET --header "Authorization: Bearer $TOKEN" "https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/my-nginx-rg/providers/NGINX.NGINXPLUS/nginxDeployments/my-nginx-dep/providers/microsoft.insights/metricNamespaces?api-version=2024-02-01"
- ```
+## Retrieve metrics through Azure Monitor REST API
- The following JSON shows an example response body:
+This section shows you how to effectively discover, gather and analyze NGINXaaS metrics through the Azure Monitor REST API.
- ```json
- {
- "value": [
- ...
- {
- "id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/my-nginx-rg/providers/NGINX.NGINXPLUS/nginxDeployments/my-nginx-dep/providers/microsoft.insights/metricNamespaces/NGINX Connections Statistics",
- "name": "nginx connections statistics",
- "type": "Microsoft.Insights/metricNamespaces",
- "classification": "Custom",
- "properties": {
- "metricNamespaceName": "nginx connections statistics"
- }
- },
- ...
- ]
- }
- ```
+{{}}Refer to [Authenticate Azure Monitor requests](https://learn.microsoft.com/en-us/azure/azure-monitor/essentials/rest-api-walkthrough?tabs=portal#authenticate-azure-monitor-requests) for instructions on authenticating your API requests against the Azure Monitor API endpoint.{{}}
-2. **Retrieve metric definitions:** Metrics definitions give you insights into the various metrics available for NGINXaaS within a namespace and what they represent. The following `curl` example shows how to retrieve all metrics definitions within the `nginx connections statistics` namespace for your NGINXaaS deployment:
+
+1. **Retrieve metric definitions:** Metrics definitions give you insights into the various metrics available for NGINXaaS within a namespace and what they represent. The following `curl` example shows how to retrieve all metrics definitions within the `nginx connections statistics` namespace for your NGINXaaS deployment:
```bash
- curl --request GET --header "Authorization: Bearer $TOKEN" "https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/my-nginx-rg/providers/NGINX.NGINXPLUS/nginxDeployments/my-nginx-dep/providers/microsoft.insights/metricDefinitions?metricnamespace=nginx%20connections%20statistics&api-version=2024-02-01"
+ curl --request GET --header "Authorization: Bearer $TOKEN" "https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/my-nginx-rg/providers/NGINX.NGINXPLUS/nginxDeployments/my-nginx-dep/providers/microsoft.insights/metricDefinitions?api-version=2024-02-01"
```
The following JSON shows an example response body:
@@ -87,22 +66,23 @@ This section shows you how to effectively discover, gather and analyze NGINXaaS
{
"id": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/my-nginx-rg/providers/NGINX.NGINXPLUS/nginxDeployments/my-nginx-dep/providers/microsoft.insights/metricdefinitions/Nginx Connections Statistics/nginx.conn.current",
"resourceId": "/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/my-nginx-rg/providers/NGINX.NGINXPLUS/nginxDeployments/my-nginx-deployment",
- "namespace": "NGINX Connections Statistics",
+ "namespace": "NGINX.NGINXPLUS/nginxDeployments",
+ "category":"nginx connections statistics",
"name": {
"value": "nginx.conn.current",
- "localizedValue": "nginx.conn.current"
+ "localizedValue": "Current connections"
},
...
- },
+ }
...
]
}
```
-3. **Metric values:** Finally, you can obtain the actual metric values which represent real-time or historical data points that tell you how your NGINXaaS is performing. The following `curl` example shows how to retrieve the value of metric `nginx.conn.current` within the `nginx connections statistics` namespace over a 10-minute time window averaged over 5 minute intervals:
+2. **Metric values:** You can obtain the actual metric values which represent real-time or historical data points that tell you how your NGINXaaS is performing. The following `curl` example shows how to retrieve the value of metric `nginx.conn.current` over a 10-minute time window averaged over 5 minute intervals:
```bash
- curl --request GET --header "Authorization: Bearer $TOKEN" "https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/my-nginx-rg/providers/NGINX.NGINXPLUS/nginxDeployments/my-nginx-dep/providers/microsoft.insights/metrics?metricnamespace=nginx%20connections%20statistics&metricnames=nginx.conn.current×pan=2024-03-27T20:00:00Z/2024-03-27T20:10:00Z&aggregation=Average&interval=PT5M&api-version=2024-02-01"
+ curl --request GET --header "Authorization: Bearer $TOKEN" "https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/resourceGroups/my-nginx-rg/providers/NGINX.NGINXPLUS/nginxDeployments/my-nginx-dep/providers/microsoft.insights/metrics?metricnames=nginx.conn.current×pan=2025-03-27T20:00:00Z/2025-03-27T20:10:00Z&aggregation=Average&interval=PT5M&api-version=2024-02-01"
```
The following JSON shows an example response body:
@@ -110,7 +90,7 @@ This section shows you how to effectively discover, gather and analyze NGINXaaS
```json
{
"cost": 9,
- "timespan": "2024-03-27T20:00:00Z/2024-03-27T20:10:00Z",
+ "timespan": "2025-03-27T20:00:00Z/2025-03-27T20:10:00Z",
"interval": "PT5M",
"value": [
{
@@ -118,19 +98,19 @@ This section shows you how to effectively discover, gather and analyze NGINXaaS
"type": "Microsoft.Insights/metrics",
"name": {
"value": "nginx.conn.current",
- "localizedValue": "nginx.conn.current"
+ "localizedValue": "Current connections"
},
- "unit": "Unspecified",
+ "unit": "Count",
"timeseries": [
{
"metadatavalues": [],
"data": [
{
- "timeStamp": "2024-03-27T20:00:00Z",
+ "timeStamp": "2025-03-27T20:00:00Z",
"average": 4
},
{
- "timeStamp": "2024-03-27T20:05:00Z",
+ "timeStamp": "2025-03-27T20:05:00Z",
"average": 4
}
]
@@ -139,7 +119,7 @@ This section shows you how to effectively discover, gather and analyze NGINXaaS
"errorCode": "Success"
}
],
- "namespace": "nginx connections statistics",
+ "namespace": "NGINX.NGINXPLUS/nginxDeployments",
"resourceregion": "eastus2"
}
```
diff --git a/content/nginxaas-azure/monitoring/metrics-catalog.md b/content/nginxaas-azure/monitoring/metrics-catalog.md
index ace227062..c5afc20a0 100644
--- a/content/nginxaas-azure/monitoring/metrics-catalog.md
+++ b/content/nginxaas-azure/monitoring/metrics-catalog.md
@@ -41,6 +41,8 @@ The metrics are categorized by the namespace used in Azure Monitor. The dimensio
| system.worker_connections | pid process_name | count | The number of nginx worker connections used on the dataplane. This metric is one of the factors which determines the deployment's consumed NCU value. | deployment |
| nginxaas.certificates | name status | count | The number of certificates added to the NGINXaaS deployment dimensioned by the name of the certificate and its status. Refer to [Certificate Health]({{< relref "/nginxaas-azure/getting-started/ssl-tls-certificates/overview.md#monitor-certificates" >}}) to learn more about the status dimension. | deployment |
| nginxaas.maxmind | status | count | The status of any MaxMind license in use for downloading geoip2 databases. Refer to [License Health]({{< relref "/nginxaas-azure/quickstart/geoip2.md#monitoring" >}}) to learn more about the status dimension. | deployment |
+| waf.enabled | | count | Current status of Web Application Firewall on the deployment. | deployment |
+| ports.used | | count | The number of listen ports used by the deployment during the aggregation interval. | deployment |
{{}}
@@ -54,9 +56,9 @@ The metrics are categorized by the namespace used in Azure Monitor. The dimensio
|------------------------------|----------------|----------|---------------------------------------------------------------------------------------------------------------|-----------------|
| nginx.conn.accepted | build version | count | Accepted Connections The total number of accepted client connections during the aggregation interval. | deployment |
| nginx.conn.dropped | build version | count | Dropped Connections The total number of dropped client connections during the aggregation interval. | deployment |
-| nginx.conn.active | build version | avg | Active Connections The average number of active client connections during the aggregation interval. | deployment |
-| nginx.conn.idle | build version | avg | Idle Connections The average number of idle client connections during the aggregation interval. | deployment |
-| nginx.conn.current | build version | avg | Current Connections The average number of active and idle client connections during the aggregation interval. | deployment |
+| nginx.conn.active | build version | count | Active Connections The average number of active client connections during the aggregation interval. | deployment |
+| nginx.conn.idle | build version | count | Idle Connections The average number of idle client connections during the aggregation interval. | deployment |
+| nginx.conn.current | build version | count | Current Connections The average number of active and idle client connections during the aggregation interval. | deployment |
{{}}
@@ -67,7 +69,7 @@ The metrics are categorized by the namespace used in Azure Monitor. The dimensio
| **Metric** | **Dimensions** | **Type** | **Description** | **Roll-up per** |
|----------------------------------------|-----------------------------|-------|-----------------------------------------------------------------------------------------------------------------------------|---------------|
| nginx.http.request.count | build version | count | HTTP Requests The total number of HTTP requests during the aggregation interval. | deployment |
-| nginx.http.request.current | build version | avg | Current Requests The average number of current requests during the aggregation interval. | deployment |
+| nginx.http.request.current | build version | count | Current Requests The number of current requests during the aggregation interval. | deployment |
| nginx.http.limit_conns.passed | build version limit_conn_zone | count | Limit Conn Zone Passed HTTP Connections The total number of connections that were neither limited nor accounted as limited during the aggregation interval. | limit conn zone |
| nginx.http.limit_conns.rejected | build version limit_conn_zone | count | Limit Conn Zone Rejected HTTP Connections The total number of connections that were rejected during the aggregation interval. | limit conn zone |
| nginx.http.limit_conns.rejected_dry_run| build version limit_conn_zone | count | Limit Conn Zone Rejected HTTP Connections In The Dry Run Mode The total number of connections accounted as rejected in the dry run mode during the aggregation interval. | limit conn zone |
@@ -107,26 +109,26 @@ The metrics are categorized by the namespace used in Azure Monitor. The dimensio
| plus.ssl.failed | build version | count | The total number of failed SSL handshakes during the aggregation interval. | deployment |
| plus.ssl.handshakes | build version | count |The total number of successful SSL handshakes during the aggregation interval. | deployment |
| plus.ssl.reuses | build version | count |The total number of session reuses during SSL handshakes in the aggregation interval. | deployment |
-| plus.ssl.no_common_protocol | build version | avg |The number of SSL handshakes failed because of no common protocol during the aggregation interval. | deployment |
-| plus.ssl.no_common_cipher | build version | avg |The number of SSL handshakes failed because of no shared cipher during the aggregation interval. | deployment |
-| plus.ssl.handshake_timeout | build version | avg | The number of SSL handshakes failed because of a timeout during the aggregation interval. | deployment |
-| plus.ssl.peer_rejected_cert | build version | avg |The number of failed SSL handshakes when nginx presented the certificate to the client but it was rejected with a corresponding alert message during the aggregation interval. | deployment |
-| plus.ssl.verify_failures.no_cert | build version | avg | SSL certificate verification errors - a client did not provide the required certificate during the aggregation interval. | deployment |
-| plus.ssl.verify_failures.expired_cert | build version | avg |SSL certificate verification errors - an expired or not yet valid certificate was presented by a client during the aggregation interval. | deployment |
-| plus.ssl.verify_failures.revoked_cert | build version | avg |SSL certificate verification errors - a revoked certificate was presented by a client during the aggregation interval. | deployment |
-| plus.ssl.verify_failures.hostname_mismatch | build version | avg |SSL certificate verification errors - server's certificate doesn't match the hostname during the aggregation interval. | deployment|
-| plus.ssl.verify_failures.other | build version | avg | SSL certificate verification errors - other SSL certificate verification errors during the aggregation interval. | deployment |
+| plus.ssl.no_common_protocol | build version | count |The number of SSL handshakes failed because of no common protocol during the aggregation interval. | deployment |
+| plus.ssl.no_common_cipher | build version | count |The number of SSL handshakes failed because of no shared cipher during the aggregation interval. | deployment |
+| plus.ssl.handshake_timeout | build version | count | The number of SSL handshakes failed because of a timeout during the aggregation interval. | deployment |
+| plus.ssl.peer_rejected_cert | build version | count |The number of failed SSL handshakes when nginx presented the certificate to the client but it was rejected with a corresponding alert message during the aggregation interval. | deployment |
+| plus.ssl.verify_failures.no_cert | build version | count | SSL certificate verification errors - a client did not provide the required certificate during the aggregation interval. | deployment |
+| plus.ssl.verify_failures.expired_cert | build version | count |SSL certificate verification errors - an expired or not yet valid certificate was presented by a client during the aggregation interval. | deployment |
+| plus.ssl.verify_failures.revoked_cert | build version | count |SSL certificate verification errors - a revoked certificate was presented by a client during the aggregation interval. | deployment |
+| plus.ssl.verify_failures.hostname_mismatch | build version | count |SSL certificate verification errors - server's certificate doesn't match the hostname during the aggregation interval. | deployment|
+| plus.ssl.verify_failures.other | build version | count | SSL certificate verification errors - other SSL certificate verification errors during the aggregation interval. | deployment |
| plus.http.ssl.handshakes | build version server_zone | count |The total number of successful SSL handshakes during the aggregation interval. | server zone |
| plus.http.ssl.handshakes.failed | build version server_zone | count | The total number of failed SSL handshakes during the aggregation interval. | server zone |
| plus.http.ssl.session.reuses | build version server_zone | count |The total number of session reuses during SSL handshakes in the aggregation interval. | server zone |
-| plus.http.ssl.no_common_protocol | build version server_zone | avg |The number of SSL handshakes failed because of no common protocol during the aggregation interval. | server zone |
-| plus.http.ssl.no_common_cipher | build version server_zone | avg |The number of SSL handshakes failed because of no shared cipher during the aggregation interval. | server zone |
-| plus.http.ssl.handshake_timeout | build version server_zone | avg | The number of SSL handshakes failed because of a timeout during the aggregation interval. | server zone |
-| plus.http.ssl.peer_rejected_cert | build version server_zone | avg |The number of failed SSL handshakes when nginx presented the certificate to the client but it was rejected with a corresponding alert message during the aggregation interval. | server zone |
-| plus.http.ssl.verify_failures.no_cert | build version server_zone | avg | SSL certificate verification errors - a client did not provide the required certificate during the aggregation interval. | server zone |
-| plus.http.ssl.verify_failures.expired_cert | build version server_zone | avg |SSL certificate verification errors - an expired or not yet valid certificate was presented by a client during the aggregation interval. | server zone |
-| plus.http.ssl.verify_failures.revoked_cert | build version server_zone | avg |SSL certificate verification errors - a revoked certificate was presented by a client during the aggregation interval. | server zone |
-| plus.http.ssl.verify_failures.other | build version server_zone | avg | SSL certificate verification errors - other SSL certificate verification errors during the aggregation interval. | server zone |
+| plus.http.ssl.no_common_protocol | build version server_zone | count |The number of SSL handshakes failed because of no common protocol during the aggregation interval. | server zone |
+| plus.http.ssl.no_common_cipher | build version server_zone | count |The number of SSL handshakes failed because of no shared cipher during the aggregation interval. | server zone |
+| plus.http.ssl.handshake_timeout | build version server_zone | count | The number of SSL handshakes failed because of a timeout during the aggregation interval. | server zone |
+| plus.http.ssl.peer_rejected_cert | build version server_zone | count |The number of failed SSL handshakes when nginx presented the certificate to the client but it was rejected with a corresponding alert message during the aggregation interval. | server zone |
+| plus.http.ssl.verify_failures.no_cert | build version server_zone | count | SSL certificate verification errors - a client did not provide the required certificate during the aggregation interval. | server zone |
+| plus.http.ssl.verify_failures.expired_cert | build version server_zone | count |SSL certificate verification errors - an expired or not yet valid certificate was presented by a client during the aggregation interval. | server zone |
+| plus.http.ssl.verify_failures.revoked_cert | build version server_zone | count |SSL certificate verification errors - a revoked certificate was presented by a client during the aggregation interval. | server zone |
+| plus.http.ssl.verify_failures.other | build version server_zone | count | SSL certificate verification errors - other SSL certificate verification errors during the aggregation interval. | server zone |
{{}}
@@ -137,6 +139,26 @@ The metrics are categorized by the namespace used in Azure Monitor. The dimensio
| **Metric** | **Dimensions** | **Type** | **Description** | **Roll-up per** |
|----------------------------------------|-----------------------------|-------|-----------------------------------------------------------------------------------------------------------------------------|---------------|
| plus.cache.hit.ratio | build version cache_zone | avg | Cache Hit Ratio The average ratio of cache hits to misses during the aggregation interval. | cache zone |
+| plus.cache.size | build version cache_zone | avg | Cache Size The average size of the cache during the aggregation interval. | cache zone |
+| plus.cache.max_size | build version cache_zone | max | Cache Max Size The max size of the cache during the aggregation interval. | cache zone |
+| plus.cache.hit.responses | build version cache_zone | count | The total number of responses that were served from the cache during the aggregation interval. | cache zone |
+| plus.cache.hit.bytes | build version cache_zone | count | The total number of bytes served from the cache during the aggregation interval. | cache zone |
+| plus.cache.stale.responses | build version cache_zone | count | The total number of responses served from stale cache content during the aggregation interval. | cache zone |
+| plus.cache.stale.bytes | build version cache_zone | count | The total number of bytes served from stale cache content during the aggregation interval. | cache zone |
+| plus.cache.updating.responses | build version cache_zone | count | The total number of responses served from the cache while the cache is being updated during the aggregation interval. | cache zone |
+| plus.cache.updating.bytes | build version cache_zone | count | The total number of bytes served from the cache while the cache is being updated during the aggregation interval. | cache zone |
+| plus.cache.revalidated.responses | build version cache_zone | count | The total number of cache responses that were successfully revalidated with the origin server during the aggregation interval. | cache zone |
+| plus.cache.revalidated.bytes | build version cache_zone | count | The total number of bytes served from the cache after successful revalidation with the origin server during the aggregation interval. | cache zone |
+| plus.cache.miss.responses | build version cache_zone | count | The total number of responses that were not served from the cache (cache misses) during the aggregation interval. | cache zone |
+| plus.cache.miss.bytes | build version cache_zone | count | The total number of bytes served from the origin server due to cache misses during the aggregation interval. | cache zone |
+| plus.cache.expired.responses | build version cache_zone | count | The total number of cache responses that expired and had to be refreshed from the origin server during the aggregation interval. | cache zone |
+| plus.cache.expired.bytes | build version cache_zone | count | The total number of bytes served from the cache after expiration and refresh from the origin server during the aggregation interval. | cache zone |
+| plus.cache.expired.responses_written | build version cache_zone | count | The total number of expired cache responses that were refreshed and written back to the cache during the aggregation interval. | cache zone |
+| plus.cache.expired.bytes_written | build version cache_zone | count | The total number of bytes written back to the cache after expiration and refresh from the origin server during the aggregation interval. | cache zone |
+| plus.cache.bypass.responses | build version cache_zone | count | The total number of responses that bypassed the cache during the aggregation interval. | cache zone |
+| plus.cache.bypass.bytes | build version cache_zone | count | The total number of bytes served by bypassing the cache during the aggregation interval. | cache zone |
+| plus.cache.bypass.responses_written | build version cache_zone | count | The total number of responses that bypassed the cache and were written back to the cache during the aggregation interval. | cache zone |
+| plus.cache.bypass.bytes_written | build version cache_zone | count | The total number of bytes that bypassed the cache and were written back to the cache during the aggregation interval. | cache zone |
{{}}
@@ -148,10 +170,10 @@ The metrics are categorized by the namespace used in Azure Monitor. The dimensio
|----------------------------------------|-----------------------------|-------|-----------------------------------------------------------------------------------------------------------------------------|---------------|
| plus.worker.conn.accepted| build version worker_id | count |The total number of client connections accepted by the worker process during the aggregation interval. | worker |
| plus.worker.conn.dropped| build version worker_id | count |The total number of client connections dropped by the worker process during the aggregation interval. | worker |
-| plus.worker.conn.active| build version worker_id | avg| The current number of active client connections that are currently being handled by the worker process during the aggregation interval. | worker |
-| plus.worker.conn.idle| build version worker_id | avg|The number of idle client connections that are currently being handled by the worker process during the aggregation interval. | worker |
+| plus.worker.conn.active| build version worker_id | count | The current number of active client connections that are currently being handled by the worker process during the aggregation interval. | worker |
+| plus.worker.conn.idle| build version worker_id | count |The number of idle client connections that are currently being handled by the worker process during the aggregation interval. | worker |
| plus.worker.http.request.total | build version worker_id | count | The total number of client requests received by the worker process during the aggregation interval. | worker |
-| plus.worker.http.request.current | build version worker_id | avg| The current number of client requests that are currently being processed by the worker process during the aggregation interval. | worker|
+| plus.worker.http.request.current | build version worker_id | count | The current number of client requests that are currently being processed by the worker process during the aggregation interval. | worker|
{{}}
@@ -161,7 +183,7 @@ The metrics are categorized by the namespace used in Azure Monitor. The dimensio
| **Metric** | **Dimensions** | **Type** | **Description** | **Roll-up per** |
|-----------------------------------|-----------------------------|-------|-----------------------------------------------------------------------------------------------------------------------------|---------------|
-| plus.http.upstream.peers.conn.active | build version upstream peer.address peer.name | avg | Upstream Server Active Connections The average number of active client connections during the aggregation interval. | upstream server |
+| plus.http.upstream.peers.conn.active | build version upstream peer.address peer.name | count | Upstream Server Active Connections The number of active client connections during the aggregation interval. | upstream server |
| plus.http.upstream.peers.request.count | build version upstream peer.address peer.name | count | Upstream Server HTTP Requests The total number of HTTP requests during the aggregation interval. | upstream server |
| plus.http.upstream.peers.response.count | build version upstream peer.address peer.name | count | Upstream Server HTTP Responses The total number of HTTP responses during the aggregation interval. | upstream server |
| plus.http.upstream.peers.status.1xx | build version upstream peer.address peer.name | count | Upstream Server HTTP 1xx Responses The total number of HTTP responses with a 1xx status code during the aggregation interval. | upstream server |
@@ -187,30 +209,30 @@ The metrics are categorized by the namespace used in Azure Monitor. The dimensio
| plus.http.upstream.peers.response.time | build version upstream peer.address peer.name | avg | Upstream Server Response Time The average time to get the [full response](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#var_upstream_response_time) from the server during the aggregation interval. | upstream server |
| plus.http.upstream.peers.header.time | build version upstream peer.address peer.name | avg | Upstream Server Header Time The average time to get the [response header](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#var_upstream_header_time) from the server | upstream server |
| plus.http.upstream.zombies | build version | avg | Upstream Zombies The current number of servers removed from the group but still processing active client requests | deployment |
-| plus.http.upstream.keepalives | build version | avg | Upstream Keepalive Connections The current number of idle [keepalive](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#keepalive) connections | deployment |
+| plus.http.upstream.keepalives | build version | count | Upstream Keepalive Connections The current number of idle [keepalive](https://nginx.org/en/docs/http/ngx_http_upstream_module.html#keepalive) connections | deployment |
| plus.http.upstream.queue.maxsize | build version | avg | Upstream Queue Max Size The maximum number of requests that can be in the queue at the same time | deployment |
| plus.http.upstream.queue.overflows | build version | sum | Upstream Queue Overflows The total number of requests rejected due to the queue overflow | deployment |
| plus.http.upstream.queue.size | build version | avg | Upstream Queue Size The current number of requests in the queue | deployment |
| plus.http.upstream.peers.ssl.handshakes | build version upstream peer.address peer.name | count | The total number of successful SSL handshakes during the aggregation interval. | upstream peer |
| plus.http.upstream.peers.ssl.handshakes.failed | build version upstream peer.address peer.name | count |The total number of failed SSL handshakes during the aggregation interval. | upstream peer |
| plus.http.upstream.peers.ssl.session.reuses | build version upstream peer.address peer.name | count |The total number of session reuses during SSL handshake in the aggregation interval. | upstream peer |
-| plus.http.upstream.peers.ssl.no_common_protocol | build version upstream peer.address peer.name | avg | The number of SSL handshakes failed because of no common protocol during the aggregation interval. | upstream peer |
-| plus.http.upstream.peers.ssl.handshake_timeout | build version upstream peer.address peer.name | avg |The number of SSL handshakes failed because of a timeout during the aggregation interval. | upstream peer |
-| plus.http.upstream.peers.ssl.peer_rejected_cert | build version upstream peer.address peer.name | avg | The number of failed SSL handshakes when nginx presented the certificate to the client but it was rejected with a corresponding alert message during the aggregation interval. | upstream peer |
-| plus.http.upstream.peers.ssl.verify_failures.expired_cert | build version upstream peer.address peer.name | avg | SSL certificate verification errors - an expired or not yet valid certificate was presented by a client during the aggregation interval. | upstream peer |
-| plus.http.upstream.peers.ssl.verify_failures.revoked_cert | build version upstream peer.address peer.name | avg | SSL certificate verification errors - a revoked certificate was presented by a client during the aggregation interval. | upstream peer |
-| plus.http.upstream.peers.ssl.verify_failures.hostname_mismatch | build version upstream peer.address peer.name | avg | SSL certificate verification errors - server's certificate doesn't match the hostname during the aggregation interval. | upstream peer |
-| plus.http.upstream.peers.ssl.verify_failures.other | build version upstream peer.address peer.name | avg |SSL certificate verification errors - other SSL certificate verification errors during the aggregation interval. | upstream peer |
+| plus.http.upstream.peers.ssl.no_common_protocol | build version upstream peer.address peer.name | count | The number of SSL handshakes failed because of no common protocol during the aggregation interval. | upstream peer |
+| plus.http.upstream.peers.ssl.handshake_timeout | build version upstream peer.address peer.name | count |The number of SSL handshakes failed because of a timeout during the aggregation interval. | upstream peer |
+| plus.http.upstream.peers.ssl.peer_rejected_cert | build version upstream peer.address peer.name | count | The number of failed SSL handshakes when nginx presented the certificate to the client but it was rejected with a corresponding alert message during the aggregation interval. | upstream peer |
+| plus.http.upstream.peers.ssl.verify_failures.expired_cert | build version upstream peer.address peer.name | count | SSL certificate verification errors - an expired or not yet valid certificate was presented by a client during the aggregation interval. | upstream peer |
+| plus.http.upstream.peers.ssl.verify_failures.revoked_cert | build version upstream peer.address peer.name | count | SSL certificate verification errors - a revoked certificate was presented by a client during the aggregation interval. | upstream peer |
+| plus.http.upstream.peers.ssl.verify_failures.hostname_mismatch | build version upstream peer.address peer.name | count | SSL certificate verification errors - server's certificate doesn't match the hostname during the aggregation interval. | upstream peer |
+| plus.http.upstream.peers.ssl.verify_failures.other | build version upstream peer.address peer.name | count |SSL certificate verification errors - other SSL certificate verification errors during the aggregation interval. | upstream peer |
| plus.stream.upstream.peers.ssl.handshakes | build version upstream peer.address peer.name | count |The total number of successful SSL handshakes during the aggregation interval. | upstream peer |
| plus.stream.upstream.peers.ssl.handshakes.failed | build version upstream peer.address peer.name | count | The total number of failed SSL handshakes during the aggregation interval. | upstream peer |
| plus.stream.upstream.peers.ssl.session.reuses | build version upstream peer.address peer.name | count | The total number of session reuses during SSL handshake in the aggregation interval. | upstream peer |
-| plus.stream.upstream.peers.ssl.no_common_protocol | build version upstream peer.address peer.name | avg | The number of SSL handshakes failed because of no common protocol during the aggregation interval. | upstream peer |
-| plus.stream.upstream.peers.ssl.handshake_timeout | build version upstream peer.address peer.name | avg | The number of SSL handshakes failed because of a timeout during the aggregation interval. | upstream peer |
-| plus.stream.upstream.peers.ssl.peer_rejected_cert | build version upstream peer.address peer.name | avg | The number of failed SSL handshakes when nginx presented the certificate to the client but it was rejected with a corresponding alert message during the aggregation interval. | upstream peer |
-| plus.stream.upstream.peers.ssl.verify_failures.expired_cert | build version upstream peer.address peer.name | avg | SSL certificate verification errors - an expired or not yet valid certificate was presented by a client during the aggregation interval. | upstream peer |
-| plus.stream.upstream.peers.ssl.verify_failures.revoked_cert | build version upstream peer.address peer.name | avg | SSL certificate verification errors - a revoked certificate was presented by a client during the aggregation interval. | upstream peer |
-| plus.stream.upstream.peers.ssl.verify_failures.hostname_mismatch | build version upstream peer.address peer.name | avg | SSL certificate verification errors - server's certificate doesn't match the hostname during the aggregation interval. | upstream peer |
-| plus.stream.upstream.peers.ssl.verify_failures.other | build version upstream peer.address peer.name | avg | SSL certificate verification errors - other SSL certificate verification errors during the aggregation interval. | upstream peer |
+| plus.stream.upstream.peers.ssl.no_common_protocol | build version upstream peer.address peer.name | count | The number of SSL handshakes failed because of no common protocol during the aggregation interval. | upstream peer |
+| plus.stream.upstream.peers.ssl.handshake_timeout | build version upstream peer.address peer.name | count | The number of SSL handshakes failed because of a timeout during the aggregation interval. | upstream peer |
+| plus.stream.upstream.peers.ssl.peer_rejected_cert | build version upstream peer.address peer.name | count | The number of failed SSL handshakes when nginx presented the certificate to the client but it was rejected with a corresponding alert message during the aggregation interval. | upstream peer |
+| plus.stream.upstream.peers.ssl.verify_failures.expired_cert | build version upstream peer.address peer.name | count | SSL certificate verification errors - an expired or not yet valid certificate was presented by a client during the aggregation interval. | upstream peer |
+| plus.stream.upstream.peers.ssl.verify_failures.revoked_cert | build version upstream peer.address peer.name | count | SSL certificate verification errors - a revoked certificate was presented by a client during the aggregation interval. | upstream peer |
+| plus.stream.upstream.peers.ssl.verify_failures.hostname_mismatch | build version upstream peer.address peer.name | count | SSL certificate verification errors - server's certificate doesn't match the hostname during the aggregation interval. | upstream peer |
+| plus.stream.upstream.peers.ssl.verify_failures.other | build version upstream peer.address peer.name | count | SSL certificate verification errors - other SSL certificate verification errors during the aggregation interval. | upstream peer |
{{}}
@@ -247,10 +269,10 @@ The metrics are categorized by the namespace used in Azure Monitor. The dimensio
| plus.stream.status.2xx | build, version, server_zone | count | The total number of sessions completed with status codes “2xx”. | server zone |
| plus.stream.status.4xx | build, version, server_zone | count | The total number of sessions completed with status codes “4xx”. | server zone |
| plus.stream.status.5xx | build, version, server_zone | count | The total number of sessions completed with status codes “5xx”. | server zone |
-| plus.stream.status.connections | build, version, server_zone | avg | The total number of connections accepted from clients. | server zone |
-| plus.stream.status.discarded | build, version, server_zone | avg | The total number of connections completed without creating a session. | server zone |
-| plus.stream.status.processing | build, version, server_zone | avg | The number of client connections that are currently being processed. | server zone |
-| plus.stream.upstream.peers.conn.active | build, version, upstream, peer.address, peer.name | avg | The current number of connections. | upstream peer |
+| plus.stream.status.connections | build, version, server_zone | avg | The averge number of connections accepted from clients. | server zone |
+| plus.stream.status.discarded | build, version, server_zone | avg | The average number of connections completed without creating a session. | server zone |
+| plus.stream.status.processing | build, version, server_zone | avg | The average of client connections that are currently being processed. | server zone |
+| plus.stream.upstream.peers.conn.active | build, version, upstream, peer.address, peer.name | count | The current number of connections. | upstream peer |
| plus.stream.upstream.peers.downstart | build, version, upstream, peer.address, peer.name | timestamp | The time when the server became “unavail”, “checking”, or “unhealthy”, in the ISO 8601 format with millisecond resolution. | upstream peer |
| plus.stream.upstream.peers.downtime | build, version, upstream, peer.address, peer.name | count | Total time the server was in the “unavail”, “checking”, and “unhealthy” states. | upstream peer |
| plus.stream.upstream.peers.fails | build, version, upstream, peer.address, peer.name | count | The total number of unsuccessful attempts to communicate with the server. | upstream peer |
@@ -272,14 +294,14 @@ The metrics are categorized by the namespace used in Azure Monitor. The dimensio
| plus.stream.ssl.handshakes| build version server_zone| count | The total number of successful SSL handshakes during the aggregation interval. | server zone|
| plus.stream.ssl.handshakes.failed | build version server_zone | count | SSL Handshakes Failed The total number of failed SSL handshakes during the aggregation interval. | server zone |
| plus.stream.ssl.session.reuses | build version server_zone | count | The total number of session reuses during SSL handshakes in the aggregation interval. | server zone |
-| plus.stream.ssl.no_common_protocol | build version server_zone| avg |The number of SSL handshakes failed because of no common protocol during the aggregation interval. |server zone |
-| plus.stream.ssl.no_common_cipher| build version server_zone | avg | The number of SSL handshakes failed because of no shared cipher during the aggregation interval. | server zone |
-| plus.stream.ssl.handshake_timeout | build version server_zone | avg | The number of SSL handshakes failed because of a timeout during the aggregation interval. | server zone |
-| plus.stream.ssl.peer_rejected_cert | build version server_zone | avg | The number of failed SSL handshakes when nginx presented the certificate to the client but it was rejected with a corresponding alert message during the aggregation interval. | server zone |
-| plus.stream.ssl.verify_failures.no_cert | build version server_zone | avg |SSL certificate verification errors - a client did not provide the required certificate during the aggregation interval. |server zone |
-| plus.stream.ssl.verify_failures.expired_cert | build version server_zone | avg |SSL certificate verification errors - an expired or not yet valid certificate was presented by a client during the aggregation interval. |server zone |
-| plus.stream.ssl.verify_failures.revoked_cert | build version server_zone | avg |SSL certificate verification errors - a revoked certificate was presented by a client during the aggregation interval. |server zone |
-| plus.stream.ssl.verify_failures.other | build version server_zone | avg |SSL certificate verification errors - other SSL certificate verification errors during the aggregation interval. | server zone |
+| plus.stream.ssl.no_common_protocol | build version server_zone| count |The number of SSL handshakes failed because of no common protocol during the aggregation interval. |server zone |
+| plus.stream.ssl.no_common_cipher| build version server_zone | count | The number of SSL handshakes failed because of no shared cipher during the aggregation interval. | server zone |
+| plus.stream.ssl.handshake_timeout | build version server_zone | count | The number of SSL handshakes failed because of a timeout during the aggregation interval. | server zone |
+| plus.stream.ssl.peer_rejected_cert | build version server_zone | count | The number of failed SSL handshakes when nginx presented the certificate to the client but it was rejected with a corresponding alert message during the aggregation interval. | server zone |
+| plus.stream.ssl.verify_failures.no_cert | build version server_zone | count |SSL certificate verification errors - a client did not provide the required certificate during the aggregation interval. |server zone |
+| plus.stream.ssl.verify_failures.expired_cert | build version server_zone | count |SSL certificate verification errors - an expired or not yet valid certificate was presented by a client during the aggregation interval. |server zone |
+| plus.stream.ssl.verify_failures.revoked_cert | build version server_zone | count |SSL certificate verification errors - a revoked certificate was presented by a client during the aggregation interval. |server zone |
+| plus.stream.ssl.verify_failures.other | build version server_zone | count |SSL certificate verification errors - other SSL certificate verification errors during the aggregation interval. | server zone |
| plus.stream.zone_sync.status.bytes_in | build, version | count | The number of bytes received by all nodes during the aggregation interval. | deployment |
| plus.stream.zone_sync.status.bytes_out | build, version | count | The number of bytes sent by all nodes during the aggregation interval. | deployment |
| plus.stream.zone_sync.status.msgs_in | build, version | count | The number of messages received by all nodes during the aggregation interval. | deployment |