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: articles/frontdoor/refstring.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Troubleshoot Azure Front Door with RefString
3
-
description: This article provides information about what a RefString is and how to gather them
3
+
description: This article provides information about what a RefString is and how to gather them.
4
4
author: Alej-b23
5
5
ms.author: pagonzalez
6
6
ms.service: azure-frontdoor
@@ -27,7 +27,7 @@ RefStrings can help you troubleshoot and resolve issues with Azure Front Door, s
27
27
> [!NOTE]
28
28
> If you encounter an error page from Microsoft services, it will already include a RefString for the request that generated the error page. In such cases, you can skip directly to the diagnostic step.
29
29
30
-
## How to gather a RefString?
30
+
## How to gather a RefString
31
31
32
32
To gather a RefString, you need to capture the HTTP response headers of the requests and look for the header named **X-Azure-Ref**. This header contains the RefString, encoded in Base64. You can use different methods to capture the HTTP response headers, depending on your preference and situation. Here are a few examples of how to obtain a RefString from various browsers and applications:
33
33
@@ -69,32 +69,32 @@ To learn more about viewing and capturing network traffic with Fiddler, see [Web
69
69
70
70
---
71
71
72
-
## How to use a RefString with some of our troubleshooting tools?
72
+
## How to use a RefString with some of our troubleshooting tools
73
73
Azure Front Door uses a RefString to manage 4xx and 5xx errors. The following are the steps to use the diagnostic tool with a RefString for tracking and diagnosing connectivity issues:
74
74
75
75
1. Navigate to your Azure Front Door Profile.
76
76
77
77
1. Select the **Diagnose and solve problems** menu.
78
78
79
-
:::image type="content" source="media/refstring/refstring-step-one-portal.png" alt-text="Diagnosing using RefString step one" lightbox="media/refstring/refstring-step-one-portal.png":::
79
+
:::image type="content" source="media/refstring/refstring-step-one-portal.png" alt-text="Screenshot showing the first step in diagnosing problems using a RefString." lightbox="media/refstring/refstring-step-one-portal.png":::
80
80
81
81
1. Scroll down and select **Connectivity** under the **Common problems** section.
82
82
83
-
:::image type="content" source="media/refstring/refstring-step-two-portal.png" alt-text="Diagnosing using RefString step two" lightbox="media/refstring/refstring-step-two-portal.png":::
83
+
:::image type="content" source="media/refstring/refstring-step-two-portal.png" alt-text="Screenshot showing the second step in diagnosing problems using a RefString." lightbox="media/refstring/refstring-step-two-portal.png":::
84
84
85
85
1. In the box **What issue are you having?** select **Select a problem subtype** and choose **4xx and 5xx errors** on the drop down-menu, then select the **Next**.
86
86
87
-
:::image type="content" source="./media/refstring/refstring-step-three-portal.png" alt-text="Diagnosing using RefString step three" lightbox="media/refstring/refstring-step-three-portal.png":::
87
+
:::image type="content" source="./media/refstring/refstring-step-three-portal.png" alt-text="Screenshot showing the third step in diagnosing problems using a RefString." lightbox="media/refstring/refstring-step-three-portal.png":::
88
88
89
89
1. Enter your RefString in the box within the **4xx and 5xx errors** section. You input the Restring given to you from your request under the **Tracking Reference – RefString** field.
90
90
91
-
:::image type="content" source="media/refstring/refstring-step-four-portal.png" alt-text="Diagnosing using RefString step four" lightbox="media/refstring/refstring-step-four-portal.png":::
91
+
:::image type="content" source="media/refstring/refstring-step-four-portal.png" alt-text="Screenshot showing the fourth step in diagnosing problems using a RefString." lightbox="media/refstring/refstring-step-four-portal.png":::
92
92
93
93
1. Finally, select **Run Diagnostics** to identify the cause of the issue, which explains the failure if it's a known problem.
94
94
95
95
An example of a result displaying an issue:
96
96
97
-
:::image type="content" source="media/refstring/refstring-example.png" alt-text="Diagnosis example using RefString" lightbox="media/refstring/refstring-example.png":::
97
+
:::image type="content" source="media/refstring/refstring-example.png" alt-text="Screenshot showing an example of the diagnosis at work using a RefString." lightbox="media/refstring/refstring-example.png":::
98
98
99
99
> [!NOTE]
100
100
> The diagnostic capabilities may require up to 15 minutes to deliver results. We ask for your patience that you allow the process to finish before taking further action.
0 commit comments