Skip to content

Commit 30fa49c

Browse files
authored
Merge pull request #236340 from whhender/adding-purview-to-shir
adding Purview information to SHIR page
2 parents 18cae3e + 6a9a982 commit 30fa49c

File tree

6 files changed

+43
-5
lines changed

6 files changed

+43
-5
lines changed
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
**APPLIES TO:** :::image type="icon" source="../media/applies-to/yes.png" border="false":::Azure Data Factory :::image type="icon" source="../media/applies-to/yes.png" border="false":::Azure Synapse Analytics :::image type="icon" source="../media/applies-to/yes.png" border="false":::Microsoft Purview
2+
71.2 KB
Loading
126 KB
Loading

articles/data-factory/self-hosted-integration-runtime-troubleshoot-guide.md

Lines changed: 39 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,12 +13,14 @@ ms.author: lle
1313

1414
# Troubleshoot self-hosted integration runtime
1515

16-
[!INCLUDE[appliesto-adf-asa-md](includes/appliesto-adf-asa-md.md)]
16+
[!INCLUDE[appliesto-adf-asa-md](includes/appliesto-adf-asa-mp.md)]
1717

1818
This article explores common troubleshooting methods for self-hosted integration runtime (IR) in Azure Data Factory and Synapse workspaces.
1919

2020
## Gather self-hosted IR logs
2121

22+
### Azure Data Factory and Azure Synapse Analytics
23+
2224
For failed activities that are running on a self-hosted IR or a shared IR, the service supports viewing and uploading error logs. To get the error report ID, follow the instructions here, and then enter the report ID to search for related known issues.
2325

2426
1. On the Monitor page for the service UI, select **Pipeline runs**.
@@ -39,7 +41,7 @@ For failed activities that are running on a self-hosted IR or a shared IR, the s
3941

4042
:::image type="content" source="media/self-hosted-integration-runtime-troubleshoot-guide/send-logs.png" alt-text="Screenshot of the activity logs for the failed activity.":::
4143

42-
3. For further assistance, select **Send logs**.
44+
1. For further assistance, select **Send logs**.
4345

4446
The **Share the self-hosted integration runtime (IR) logs with Microsoft** window opens.
4547

@@ -56,6 +58,41 @@ For failed activities that are running on a self-hosted IR or a shared IR, the s
5658
> [!NOTE]
5759
> 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.
5860
61+
### Microsoft Purview
62+
63+
For failed Microsoft Purview activities that are running on a self-hosted IR or shared IR, the service supports viewing and uploading error logs from the [Windows Event Viewer](/shows/inside/event-viewer).
64+
65+
You can look up any errors you see in the error guide below.
66+
To get support and troubleshooting guidance for SHIR issues, you may need to generate an error report ID and [reach out to Microsoft support](https://azure.microsoft.com/support/create-ticket/).
67+
68+
To generate the error report ID for Microsoft Support, follow these instructions:
69+
70+
1. Before starting a scan in the Microsoft Purview governance portal:
71+
72+
1. Navigate to the machine where the self-hosted integration runtime is installed and open the Windows Event Viewer.
73+
1. Clear the Windows Event Viewer logs in the **Integration Runtime** section. Right-click on the logs and select the clear logs option.
74+
1. Navigate back to the Microsoft Purview governance portal and start the scan.
75+
76+
1. Once the scan shows status **Failed**, navigate back to the SHIR VM, or machine and refresh the event viewer in the **Integration Runtime** section.
77+
1. The activity logs are displayed for the failed scan run.
78+
79+
1. For further assistance from Microsoft, select **Send Logs**.
80+
81+
The **Share the self-hosted integration runtime (SHIR) logs with Microsoft** window opens.
82+
83+
:::image type="content" source="media/self-hosted-integration-runtime-troubleshoot-guide/send-logs-integration-runtime.png" lightbox="media/self-hosted-integration-runtime-troubleshoot-guide/send-logs-integration-runtime.png" alt-text="Screenshot of the send logs button on the self-hosted integration runtime (SHIR) to upload logs to Microsoft.":::
84+
85+
1. Select which logs you want to send.
86+
87+
* 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.
88+
* For a *shared IR*, you can upload only logs that are related to the failed activity.
89+
90+
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.
91+
92+
:::image type="content" source="media/self-hosted-integration-runtime-troubleshoot-guide/send-logs-complete.png" lightbox="media/self-hosted-integration-runtime-troubleshoot-guide/send-logs-complete.png" alt-text="Screenshot of the displayed report ID in the upload progress window for the Purview SHIR logs.":::
93+
94+
> [!NOTE]
95+
> 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.
5996
6097
## Self-hosted IR general failure or error
6198

Binary file not shown.

articles/purview/scanning-shir-troubleshooting.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,10 +32,9 @@ To generate the error report ID for Microsoft Support, follow these instructions
3232
1. Navigate to the machine where the self-hosted integration runtime is installed and open the Windows Event Viewer.
3333
1. Clear the windows event viewer logs in the **Integration Runtime** section. Right-click on the logs and select the clear logs option.
3434
1. Navigate back to the Microsoft Purview governance portal and start the scan.
35-
1. Once the scan shows status **Failed**, navigate back to the SHIR VM, or machine and refresh the event viewer in the **Integration Runtime** section.
36-
1. The activity logs are displayed for the failed scan run.
3735

38-
:::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.":::
36+
1. Once the scan shows status **Failed**, navigate back to the SHIR VM, or machine and refresh the event viewer in the **Integration Runtime** section.
37+
1. The activity logs are displayed for the failed scan run.
3938

4039
1. For further assistance from Microsoft, select **Send Logs**.
4140

0 commit comments

Comments
 (0)