You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: support/developer/webapps/iis/health-diagnostic-performance/troubleshoot-arr-using-frt-rules.md
+32-16Lines changed: 32 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,17 +1,17 @@
1
1
---
2
2
title: Using Failed Request Tracing rules to troubleshoot Application Request Routing
3
3
description: Describes the steps to enable Failed Request Tracing rules to debug failures and trace steps in Application Request Routing.
4
-
ms.date: 07/02/2008
4
+
ms.date: 01/03/2025
5
5
ms.author: haiyingyu
6
6
author: HaiyingYu
7
7
ms.reviewer: johnhart, riande
8
8
ms.custom: sap:Health, Diagnostic, and Performance Features\Failed Request Tracing
9
9
---
10
10
# Using Failed Request Tracing rules to troubleshoot Application Request Routing
11
11
12
-
_Applies to:_ Internet Information Services 7.0 and later versions
12
+
_Applies to:_ Internet Information Services on Windows Server 2016 and later operating system versions
13
13
14
-
Failed Request Tracing is a powerful tool for troubleshooting request-processing failures in IIS 7.0 and later versions. This article provides steps to enable Failed Request Tracing rules to debug failures and trace steps in Application Request Routing. For more information about Failed Request Tracing rules, see [Troubleshoot failed requests using tracing in IIS 8.5](troubleshoot-failed-requests-using-tracing-in-iis-85.md).
14
+
Failed Request Tracing is a powerful tool for troubleshooting request-processing failures in the Internet Information Services (IIS) web server that ships with Windows Server 2016 or later versions. This article provides steps to enable Failed Request Tracing rules to debug failures and trace steps in Application Request Routing. For more information about Failed Request Tracing rules, see [Troubleshoot failed requests using tracing in IIS](troubleshoot-failed-requests-using-tracing-in-iis-85.md).
15
15
16
16
## Goal
17
17
@@ -21,7 +21,7 @@ To configure Failed Request Tracing rules and to understand what to look for whe
21
21
22
22
This walkthrough requires the following prerequisites:
23
23
24
-
- IIS 7.0 or above on Windows 2008 (any SKU) or newer with Tracing role service installed for IIS.
24
+
- IIS on Windows Sever 2016 (any SKU) or newer with Tracing role service installed for IIS.
25
25
- Microsoft Application Request Routing and dependent modules.
26
26
- Minimum of two application servers with working sites and applications.
27
27
@@ -36,24 +36,38 @@ Configure the Failed Request Tracing rules for Application Request Routing using
36
36
### How to configure Failed Request Tracing rules using the UI
37
37
38
38
1. Launch Internet Information Services (IIS) Manager (inetmgr).
39
-
1. Select **Default Web Site**.
39
+
1. Select **Default Web Site**.
40
+
40
41
:::image type="content" source="media/troubleshoot-arr-using-frt-rules/site-list-expanded.png" alt-text="Screenshot showing the Sites list expanded. Default Web Site is highlighted.":::
41
-
1. In the **Actions** pane, under **Configure**, select **Failed Request Tracing…**.
42
+
43
+
1. In the **Actions** pane, under **Configure**, select **Failed Request Tracing…**.
44
+
42
45
:::image type="content" source="media/troubleshoot-arr-using-frt-rules/failed-request-tracing-in-action-pane.png" alt-text="Screenshot focused on Failed Request Tracing in the Actions pane.":::
43
-
1. In the **Edit Web Site Failed Request Tracing Settings** dialog box, select the **Enable** checkbox.
46
+
47
+
1. In the **Edit Web Site Failed Request Tracing Settings** dialog box, select the **Enable** checkbox.
48
+
44
49
:::image type="content" source="media/troubleshoot-arr-using-frt-rules/edit-web-site-frt-settings-dialog.png" alt-text="Screenshot of the Edit Web Site Failed Request Tracing Settings dialog.":::
50
+
45
51
1. Select **OK** to save changes.
46
52
1. Select **Default Web Site**.
47
53
1. Double-click **Failed Request Tracing Rules**.
48
-
1. In the **Actions** pane, select **Add…**.
49
-
:::image type="content" source="media/troubleshoot-arr-using-frt-rules/add-frt-rule-window.png" alt-text="Screenshot of the Add Failed Request Tracing Rule window. All content is selected.":::
54
+
1. In the **Actions** pane, select **Add…**.
55
+
56
+
:::image type="content" source="media/troubleshoot-arr-using-frt-rules/add-frt-rule-window.png" alt-text="Screenshot of the Add Failed Request Tracing Rule window. All content is selected.":::
57
+
50
58
Select **All content (\*)**, and then select **Next**.
51
-
1. Select **Status code(s):** and enter _200-399_.
52
-
:::image type="content" source="media/troubleshoot-arr-using-frt-rules/add-frt-rule-select-status-code.png" alt-text="Screenshot of the Add Failed Request Tracing Rule. Status code is checked.":::
59
+
1. Select **Status code(s):** and enter _200-399_.
60
+
61
+
:::image type="content" source="media/troubleshoot-arr-using-frt-rules/add-frt-rule-select-status-code.png" alt-text="Screenshot of the Add Failed Request Tracing Rule. Status code is checked.":::
62
+
53
63
Select **Next**. The above configuration has created a Failed Request Tracing rule that writes traces when the status code falls between 200 and 399.
54
-
1. Deselect **ASP**,**ASPNET**, and **ISAPI Extension**. After selecting **WWW Server**, deselect everything under **Areas:**, except for **Rewrite** and **RequestRouting**. Because Application Request Routing relies on the URL Rewrite Module to inspect incoming requests, it's recommended that you enable the traces for both Application Request Routing (**RequestRouting**) and URL Rewrite Module (**Rewrite**).
55
-
:::image type="content" source="media/troubleshoot-arr-using-frt-rules/edit-frt-rule-window.png" alt-text="Screenshot of the Edit Failed Request Tracing Rule window. W W W server is selected in the Providers section.":::
56
-
For additional information about URL Rewrite Module traces, see [Using Failed Request Tracing to Trace Rewrite Rules](/iis/extensions/url-rewrite-module/using-failed-request-tracing-to-trace-rewrite-rules) .
64
+
65
+
1. Deselect **ASP**,**ASPNET**, and **ISAPI Extension**. After selecting **WWW Server**, deselect everything under **Areas:**, except for **Rewrite** and **RequestRouting**. Because Application Request Routing relies on the URL Rewrite Module to inspect incoming requests, it's recommended that you enable the traces for both Application Request Routing (**RequestRouting**) and URL Rewrite Module (**Rewrite**).
66
+
67
+
:::image type="content" source="media/troubleshoot-arr-using-frt-rules/edit-frt-rule-window.png" alt-text="Screenshot of the Edit Failed Request Tracing Rule window. W W W server is selected in the Providers section.":::
68
+
69
+
For additional information about URL Rewrite Module traces, see [Using Failed Request Tracing to Trace Rewrite Rules](/iis/extensions/url-rewrite-module/using-failed-request-tracing-to-trace-rewrite-rules).
70
+
57
71
1. Select **Finish**.
58
72
59
73
### How to configure Failed Request Tracing rules using the command-line
@@ -96,8 +110,10 @@ In this step, you'll send requests to Application Request Routing and analyze Fa
96
110
97
111
1. Send a request to Application Request Routing. If Application Request Routing is functioning correctly, it results in a 200 response, which falls within the 200 to 399 range that is specified in [Step 1](#step-1-configure-failed-request-tracing-rules). Therefore, the logs are written to the location above.
98
112
1. List the files in the directory to confirm that new XML files are written.
99
-
1. Open the XML file. Select **Request Details**. Select **Complete Request Trace**, and then Select **Expand All**. The following image is an example of a Failed Request Tracing log for Application Request Routing:
100
-
:::image type="content" source="media/troubleshoot-arr-using-frt-rules/request-diagnostics-for-sample.png" alt-text="Screenshot of a browser window showing the Request Diagnostics for the example website in a tab.":::
113
+
1. Open the XML file. Select **Request Details**. Select **Complete Request Trace**, and then Select **Expand All**. The following image is an example of a Failed Request Tracing log for Application Request Routing:
114
+
115
+
:::image type="content" source="media/troubleshoot-arr-using-frt-rules/request-diagnostics-for-sample.png" alt-text="Screenshot of a browser window showing the Request Diagnostics for the example website in a tab." lightbox="media/troubleshoot-arr-using-frt-rules/request-diagnostics-for-sample.png":::
116
+
101
117
1. Pay closer attention to the following sections:
0 commit comments