structure

Author: mmacy

articles/active-directory-b2c/active-directory-b2c-troubleshoot-custom.md

@@ -15,29 +15,27 @@ ms.subservice: B2C
 
 # Collect Azure Active Directory B2C logs with Application Insights
 
-This article provides steps for collecting logs from Active Directory B2C (Azure AD B2C) so that you can diagnose problems with your custom policies.
+This article provides steps for collecting logs from Active Directory B2C (Azure AD B2C) so that you can diagnose problems with your custom policies. Application Insights provides a way to diagnose exceptions and visualize application performance issues. Azure AD B2C includes a feature for sending data to Application Insights.
 
 The detailed activity logs described here should be enabled **ONLY** during the development of your custom policies.
 
 > [!WARNING]
 > Do not enable development mode in production. Logs collect all claims sent to and from identity providers. You as the developer assume responsibility for any personal data collected in your Application Insights logs. These detailed logs are collected only when the policy is placed in **DEVELOPER MODE**.
 
-## Use Application Insights
+## Set up Application Insights
 
-Application Insights provides a way to diagnose exceptions and visualize application performance issues. Azure AD B2C includes a feature for sending data to Application Insights.
-
-### Set up Application Insights
+If you don't already have one, create an instance of Application Insights in your subscription.
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
-1. Select the **Directory + subscription** filter in the top menu, and then select the directory that contains your Azure subscription (not the Azure AD B2C tenant).
+1. Select the **Directory + subscription** filter in the top menu, and then select the directory that contains your Azure subscription (not your Azure AD B2C directory).
 1. Select **Create a resource** in the left-hand navigation menu.
 1. Search for and select **Application Insights**, then select **Create**.
 1. Complete the form, select **Review + create**, and then select **Create**.
 1. Once the deployment has been completed, select **Go to resource**.
 1. Under **Configure** in Application Insights menu, select **Properties**.
 1. Record the **INSTRUMENTATION KEY** for use in a later step.
 
-### Configure the custom policy
+## Configure the custom policy
 
 1. Open the relying party (RP) file, for example *SignUpOrSignin.xml*.
 1. Add the following attributes to the `<TrustFrameworkPolicy>` element:
@@ -80,31 +78,31 @@ Application Insights provides a way to diagnose exceptions and visualize applica
 
 1. Upload the policy.
 
-### See the logs in Application Insights
+## See the logs in Application Insights
 
 There is a short delay, typically less than five minutes, before you can see new logs in Application Insights.
 
 1. Open the Application Insights resource that you created in the [Azure portal](https://portal.azure.com).
-1. In the **Overview** menu, .  on **Analytics**.
+1. In the **Overview** menu, select **Analytics**.
 1. Open a new tab in Application Insights.
-1. Here is a list of queries you can use to see the logs
+
+Here is a list of queries you can use to see the logs:
 
 | Query | Description |
 |---------------------|--------------------|
-traces | See all of the logs generated by Azure AD B2C |
-traces \| where timestamp > ago(1d) | See all of the logs generated by Azure AD B2C for the last day
+`traces` | See all of the logs generated by Azure AD B2C |
+`traces | where timestamp > ago(1d)` | See all of the logs generated by Azure AD B2C for the last day
 
 The entries may be long. Export to CSV for a closer look.
 
-You can learn more about the Analytics tool [here](https://docs.microsoft.com/azure/application-insights/app-insights-analytics).
+For more information about querying, see [Overview of log queries in Azure Monitor](../azure-monitor/log-query/log-query-overview).
 
->[!NOTE]
->The community has developed a user journey viewer to help identity developers. It is not supported by Microsoft and made available strictly as-is. It reads from your Application Insights instance and provides a well-structured view of the user journey events. You obtain the source code and deploy it in your own solution.
+## Next steps
 
-The version of the viewer that reads events from Application Insights is located [here](https://github.com/Azure-Samples/active-directory-b2c-advanced-policies/tree/master/wingtipgamesb2c/src/WingTipUserJourneyPlayerWebApplication)
+The community has developed a user journey viewer to help identity developers. It reads from your Application Insights instance and provides a well-structured view of the user journey events. You obtain the source code and deploy it in your own solution.
 
-[GitHub Repository for Unsupported Custom Policy Samples and Related tools](https://github.com/Azure-Samples/active-directory-b2c-advanced-policies)
+The user journey player is not supported by Microsoft, and is made available strictly as-is.
 
-## Next Steps
+You can find the version of the viewer that reads events from Application Insights on GitHub, here:
 
-Explore the data in Application Insights to help you understand how the Identity Experience Framework underlying B2C works to deliver your own identity experiences.
+[Azure-Samples/active-directory-b2c-advanced-policies](https://github.com/Azure-Samples/active-directory-b2c-advanced-policies/tree/master/wingtipgamesb2c/src/WingTipUserJourneyPlayerWebApplication)