Skip to content

Commit e6132c1

Browse files
authored
Update monitor-application-gateway-reference.md
1 parent 4822480 commit e6132c1

File tree

1 file changed

+33
-31
lines changed

1 file changed

+33
-31
lines changed

articles/application-gateway/monitor-application-gateway-reference.md

Lines changed: 33 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -70,28 +70,47 @@ Similarly, if the *Application gateway total time* has a spike but the *Backend
7070
|**Unhealthy host count**|Count|The number of backends that are determined unhealthy by the health probe. You can filter on a per backend pool basis to show the number of unhealthy hosts in a specific backend pool.|
7171
|**Requests per minute per Healthy Host**|Count|The average number of requests received by each healthy member in a backend pool in a minute. Specify the backend pool using the *BackendPool HttpSettings* dimension.|
7272

73-
## Application Gateway layer 4 proxy monitoring
73+
### Backend health API
7474

75-
### Layer 4 metrics
75+
See [Application Gateways - Backend Health](/rest/api/application-gateway/application-gateways/backend-health?tabs=HTTP) for details of the API call to retrieve the backend health of an application gateway.
76+
77+
Sample Request:
78+
``output
79+
POST
80+
https://management.azure.com/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Network/
81+
applicationGateways/appgw/backendhealth?api-version=2021-08-01
82+
After
83+
``
84+
85+
After sending this POST request, you should see an HTTP 202 Accepted response. In the response headers, find the Location header and send a new GET request using that URL.
86+
87+
``output
88+
GET
89+
https://management.azure.com/subscriptions/subid/providers/Microsoft.Network/locations/region-name/operationResults/GUID?api-version=2021-08-01
90+
``
91+
92+
### Application Gateway TLS/TCP proxy monitoring
93+
94+
#### TLS/TCP proxy metrics
7695

7796
With layer 4 proxy feature now available with Application Gateway, there are some Common metrics (apply to both layer 7 as well as layer 4), and some layer 4 specific metrics. The following table describes all the metrics are the applicable for layer 4 usage.
7897

7998
| Metric | Description | Type | Dimension |
8099
|:--------------------|:---------------------------------------------------------------------------------------------------------------------------------------|:-------|:----------|
81-
| Current Connections | The number of active connections: reading, writing, or waiting. The count of current connections established with Application Gateway. | Common | None |
82-
| New Connections per second | The average number of connections handled per second in last 1 minute. | Common | None |
83-
| Throughput | The rate of data flow (inBytes+ outBytes) in the last 1 minute. | Common | None |
84-
| Healthy host count | The number of healthy backend hosts. | Common | BackendSettingsPool |
85-
| Unhealthy host | The number of unhealthy backend hosts. | Common | BackendSettingsPool |
86-
| ClientRTT | Average round trip time between clients and Application Gateway. | Common | Listener |
87-
| Backend Connect Time | Time spent establishing a connection with a backend server. | Common | Listener, BackendServer, BackendPool, BackendSetting |
88-
| Backend First Byte Response Time | Time interval between start of establishing a connection to backend server and receiving the first byte of data (approximating processing time of backend server). | Common | Listener, BackendServer, BackendPool, BackendHttpSetting`*` |
89-
| Backend Session Duration | The total time of a backend connection. The average time duration from the start of a new connection to its termination. | L4 only | Listener, BackendServer, BackendPool, BackendHttpSetting`*` |
90-
| Connection Lifetime | The total time of a client connection to application gateway. The average time duration from the start of a new connection to its termination in milliseconds. | L4 only | Listener |
100+
| Current Connections | The number of active connections: reading, writing, or waiting. The count of current connections established with Application Gateway. | Common metric | None |
101+
| New Connections per second | The average number of connections handled per second during that minute. | Common metric | None |
102+
| Throughput | The rate of data flow (inBytes+ outBytes) during that minute. | Common metric | None |
103+
| Healthy host count | The number of healthy backend hosts. | Common metric | BackendSettingsPool |
104+
| Unhealthy host | The number of unhealthy backend hosts. | Common metric | BackendSettingsPool |
105+
| ClientRTT | Average round trip time between clients and Application Gateway. | Common metric | Listener |
106+
| Backend Connect Time | Time spent establishing a connection with a backend server. | Common metric | Listener, BackendServer, BackendPool, BackendSetting |
107+
| Backend First Byte Response Time | Time interval between start of establishing a connection to backend server and receiving the first byte of data (approximating processing time of backend server). | Common metric | Listener, BackendServer, BackendPool, BackendHttpSetting`*` |
108+
| Backend Session Duration | The total time of a backend connection. The average time duration from the start of a new connection to its termination. | L4-specific | Listener, BackendServer, BackendPool, BackendHttpSetting`*` |
109+
| Connection Lifetime | The total time of a client connection to application gateway. The average time duration from the start of a new connection to its termination in milliseconds. | L4-specific | Listener |
91110

92111
`*` BackendHttpSetting dimension includes both layer 7 and layer 4 backend settings.
93112

94-
### Layer 4 logs
113+
#### TLS/TCP proxy logs
95114

96115
Application Gateway’s Layer 4 proxy provides log data through access logs. These logs are only generated and published if they are configured in the diagnostic settings of your gateway.
97116
- Also see: [Supported categories for Azure Monitor resource logs](/azure/azure-monitor/essentials/resource-logs-categories#microsoftnetworkapplicationgateways).
@@ -122,30 +141,13 @@ Application Gateway’s Layer 4 proxy provides log data through access logs. The
122141
| serverStatus |200 - session completed successfully. 400 - client data could not be parsed. 500 - internal server error. 502 - bad gateway. For example, when an upstream server could not be reached. 503 - service unavailable. For example, if access is limited by the number of connections. |
123142
| ResourceId |Application Gateway resource URI |
124143

125-
### Layer 4 backend health
144+
### TLS/TCP proxy backend health
126145

127146
Application Gateway’s layer 4 proxy provides the capability to monitor the health of individual members of the backend pools through the portal and REST API.
128147

129148
![Screenshot of backend health](./media/monitor-application-gateway-reference/backend-health.png)
130149

131-
### REST API
132-
133-
See [Application Gateways - Backend Health](/rest/api/application-gateway/application-gateways/backend-health?tabs=HTTP) for details of the API call to retrieve the backend health of an application gateway.
134150

135-
Sample Request:
136-
``output
137-
POST
138-
https://management.azure.com/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Network/
139-
applicationGateways/appgw/backendhealth?api-version=2021-08-01
140-
After
141-
``
142-
143-
After sending this POST request, you should see an HTTP 202 Accepted response. In the response headers, find the Location header and send a new GET request using that URL.
144-
145-
``output
146-
GET
147-
https://management.azure.com/subscriptions/subid/providers/Microsoft.Network/locations/region-name/operationResults/GUID?api-version=2021-08-01
148-
``
149151

150152
## Application Gateway v1 metrics
151153

0 commit comments

Comments
 (0)