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
This article explores common troubleshooting methods for self-hosted integration runtime (IR) in Azure Data Factory and Synapse workspaces.
19
19
20
20
## Gather self-hosted IR logs
21
21
22
+
### Azure Data Factory and Azure Synapse Analytics
23
+
22
24
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.
23
25
24
26
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
39
41
40
42
:::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.":::
41
43
42
-
3. For further assistance, select **Send logs**.
44
+
1. For further assistance, select **Send logs**.
43
45
44
46
The **Share the self-hosted integration runtime (IR) logs with Microsoft** window opens.
45
47
@@ -56,6 +58,41 @@ For failed activities that are running on a self-hosted IR or a shared IR, the s
56
58
> [!NOTE]
57
59
> 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.
58
60
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.
Copy file name to clipboardExpand all lines: articles/purview/scanning-shir-troubleshooting.md
+2-3Lines changed: 2 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,10 +32,9 @@ To generate the error report ID for Microsoft Support, follow these instructions
32
32
1. Navigate to the machine where the self-hosted integration runtime is installed and open the Windows Event Viewer.
33
33
1. Clear the windows event viewer logs in the **Integration Runtime** section. Right-click on the logs and select the clear logs option.
34
34
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.
37
35
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.
39
38
40
39
1. For further assistance from Microsoft, select **Send Logs**.
0 commit comments