Merge pull request #232605 from abandyop/patch-17

Add Troubleshooting Guide for SHIR for external public and customers

Author: v-ccolin

articles/data-factory/includes/troubleshoot-shir-include.md

@@ -203,3 +203,14 @@ landingContent:
           url: catalog-private-link-name-resolution.md
         - text: Connect to private networks
           url: manage-integration-runtimes.md
+          
+          
+   #Card
+  - title: Troubleshooting Microsoft Purview
+    linkLists:
+    - linkListType: how-to-guide
+      links:
+        - text: Troubleshooting Purview scans - SHIR 
+          url: scanning-shir-troubleshooting.md
+          
+          

articles/purview/index.yml

@@ -0,0 +1,68 @@
+---
+title: Troubleshoot SHIR self-hosted integration runtime
+titleSuffix: Microsoft Purview, Azure Data Factory & Azure Synapse
+description: Learn how to troubleshoot self-hosted integration runtime issues in Microsoft Purview. 
+author: abandyop
+ms.service: purview
+ms.subservice: purview-data-map
+ms.custom: purview
+ms.topic: troubleshooting
+ms.date: 04/01/2023
+ms.author: arindamba
+---
+
+# Troubleshoot Microsoft Purview SHIR self-hosted integration runtime
+
+APPLIES TO:  :::image type="icon" source="media/yes.png" border="false":::Microsoft Purview :::image type="icon" source="media/yes.png" border="false":::Azure Data Factory :::image type="icon" source="media/yes.png" border="false":::Azure Synapse Analytics
+
+This article explores common troubleshooting methods for self-hosted integration runtime (SHIR) in Microsoft Purview, Azure Data Factory and Synapse workspaces.
+
+## Gather Microsoft Purview specific SHIR self-hosted integration runtime logs
+
+For failed activities that are running on a self-hosted IR or a shared IR, the service supports viewing and uploading error logs from the [Windows Event Viewer](https://learn.microsoft.com/shows/inside/event-viewer).
+To get support and troubleshooting guidance for SHIR issues, you may need to generate an error report and send it across to Microsoft. To generate the error report ID, follow the instructions here, and then enter the report ID to search for related known issues.
+
+1. Before starting the scan on the Microsoft Purview governance portal: 
+- Navigate to the SHIR VM, or machine and open the Windows Event Viewer.
+- Clear the windows event viewer logs in the "Integration Runtime" section. Right-click on the logs and select clear logs option.
+- Navigate back to the Microsoft Purview governance portal and start the scan.
+- Once the scan shows status "Failed", navigate back to the SHIR VM, or machine and refresh the event viewer in the "Integration Runtime" section.
+- The activity logs are displayed for the failed scan run.
+    
+    :::image type="content" source="media/scanning-shir-troubleshooting/shir-event-viewer-logs-ir.png" lightbox="media/scanning-shir-troubleshooting/shir-event-viewer-logs-ir.png" alt-text="Screenshot of the logs for the failed scan SHIR activity."::: 
+    
+1. For further assistance from Microsoft, select **Send Logs**.
+ 
+   The **Share the self-hosted integration runtime (SHIR) logs with Microsoft** window opens.
+
+    :::image type="content" source="media/scanning-shir-troubleshooting/shir-send-logs-ir.png" lightbox="media/scanning-shir-troubleshooting/shir-send-logs-ir.png" alt-text="Screenshot of the send logs button on the self-hosted integration runtime (SHIR) to upload logs to Microsoft.":::
+
+1. Select which logs you want to send. 
+    * For a *self-hosted IR*, you can upload logs that are related to the failed activity or all logs on the self-hosted IR node. 
+    * For a *shared IR*, you can upload only logs that are related to the failed activity.
+
+1. When the logs are uploaded, keep a record of the Report ID for later use if you need further assistance to solve the issue.
+
+    :::image type="content" source="media/scanning-shir-troubleshooting/shir-send-logs-complete.png" lightbox="media/scanning-shir-troubleshooting/shir-send-logs-complete.png" alt-text="Screenshot of the displayed report ID in the upload progress window for the Purview SHIR logs.":::
+
+> [!NOTE]
+> Log viewing and uploading requests are executed on all online self-hosted IR instances. If any logs are missing, make sure that all the self-hosted IR instances are online. 
+
+
+## Self-hosted integration runtime SHIR general failure or error
+
+There are lots of common errors, warnings, issues between Purview SHIR and Azure Data Factory or Azure Synapse SHIR. If your SHIR issues aren't resolved at this stage, refer to the [Azure Data Factory ADF or Azure Synapse SHIR troubleshooting guide](../data-factory/self-hosted-integration-runtime-troubleshoot-guide.md)
+
+[!INCLUDE[SHIR](../data-factory/includes/troubleshoot-shir-include.md)]
+
+## Manage your Purview SHIR - next steps
+
+For more help with troubleshooting, try the following resources:
+
+*  [Getting started with Microsoft Purview](https://azure.microsoft.com/products/purview/)
+*  [Create and Manage SHIR Self-hosted integration runtimes in Purview](manage-integration-runtimes.md)
+*  [Stack overflow forum for Microsoft Purview](https://stackoverflow.com/questions/tagged/azure-purview)
+*  [Twitter information about Microsoft Purview](https://twitter.com/hashtag/Purview)
+*  [Microsoft Purview Troubleshooting](frequently-asked-questions.yml)
+
+

articles/purview/media/no.png

@@ -223,6 +223,8 @@ items:
               href: manage-integration-runtimes.md
             - name: Self-hosted integration runtime auto-update and expiration
               href: self-hosted-integration-runtime-version.md
+            - name: Troubleshoot SHIR Self-hosted integration runtime
+              href: scanning-shir-troubleshooting.md
         - name: Scan
           items:
           - name: Scan a registered source
@@ -235,6 +237,8 @@ items:
             href: how-to-monitor-data-map-population.md
           - name: Troubleshoot scans & connections
             href: troubleshoot-connections.md
+          - name: Troubleshoot SHIR Self-hosted integration runtime
+            href: scanning-shir-troubleshooting.md
         - name: Classify
           items:
           - name: Automatically apply classifications