Skip to content

Commit b769fd9

Browse files
Merge pull request #210957 from Clare-Zheng82/0909-Add_Web_activity_error_codes
[Supportability] - Add Web activity error codes
2 parents 2efcf3b + fe80090 commit b769fd9

File tree

1 file changed

+86
-28
lines changed

1 file changed

+86
-28
lines changed

articles/data-factory/data-factory-troubleshoot-guide.md

Lines changed: 86 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ ms.service: data-factory
77
ms.subservice: troubleshooting
88
ms.custom: synapse
99
ms.topic: troubleshooting
10-
ms.date: 08/03/2022
10+
ms.date: 09/13/2022
1111
ms.author: abnarain
1212
---
1313

@@ -1022,56 +1022,114 @@ If the HDI activity is stuck in preparing for cluster, follow the guidelines bel
10221022
10231023
## Web Activity
10241024
1025-
### Error code: 2128
1025+
### Error Code: 2001
10261026
1027-
- **Message**: `No response from the endpoint. Possible causes: network connectivity, DNS failure, server certificate validation or timeout.`
1027+
- **Message**: `The length of execution output is over limit (around 4MB currently).`
10281028
1029-
- **Cause**: This issue is due to either Network connectivity, a DNS failure, a server certificate validation, or a timeout.
1029+
- **Cause**: The execution output is greater than 4 MB in size but the maximum supported output response payload size is 4 MB.
10301030
1031-
- **Recommendation**: Validate that the endpoint you are trying to hit is responding to requests. You may use tools like **Fiddler/Postman/Netmon/Wireshark**.
1031+
- **Recommendation**: Make sure the execution output size does not exceed 4 MB. For more information, see [How to scale out the size of data moving using Azure Data Factory](https://docs.microsoft.com/answers/questions/700102/how-to-scale-out-the-size-of-data-moving-using-azu.html).
10321032
1033-
### Error code: 2108
1033+
### Error Code: 2002
10341034
1035-
- **Message**: `Error calling the endpoint '%url;'. Response status code: '%code;'`
1035+
- **Message**: `The payload including configurations on activity/dataSet/linked service is too large. Please check if you have settings with very large value and try to reduce its size.`
10361036
1037-
- **Cause**: The request failed due to an underlying issue such as network connectivity, a DNS failure, a server certificate validation, or a timeout.
1037+
- **Cause**: The payload you are attempting to send is too large.
10381038
1039-
- **Recommendation**: Use Fiddler/Postman/Netmon/Wireshark to validate the request.
1039+
- **Recommendation**: Refer to [Payload is too large](data-factory-troubleshoot-guide.md#payload-is-too-large).
10401040
1041-
#### More details
1042-
To use **Fiddler** to create an HTTP session of the monitored web application:
1041+
### Error Code: 2003
10431042
1044-
1. Download, install, and open [Fiddler](https://www.telerik.com/download/fiddler).
1043+
- **Message**: `There are substantial concurrent external activity executions which is causing failures due to throttling under subscription <subscription id>, region <region code> and limitation <current limit>. Please reduce the concurrent executions. For limits, refer https://aka.ms/adflimits.`
10451044
1046-
1. If your web application uses HTTPS, go to **Tools** > **Fiddler Options** > **HTTPS**.
1045+
- **Cause**: Too many activities are running concurrently. This can happen when too many pipelines are triggered at once.
10471046
1048-
1. In the HTTPS tab, select both **Capture HTTPS CONNECTs** and **Decrypt HTTPS traffic**.
1047+
- **Recommendation**: Reduce pipeline concurrency. You might have to distribute the trigger time of your pipelines.
10491048
1050-
:::image type="content" source="media/data-factory-troubleshoot-guide/fiddler-options.png" alt-text="Fiddler options":::
1049+
### Error Code: 2010
10511050
1052-
1. If your application uses TLS/SSL certificates, add the Fiddler certificate to your device.
1051+
- **Message**: `The Self-hosted Integration Runtime ‘<SHIR name>’ is offline`
10531052
1054-
Go to: **Tools** > **Fiddler Options** > **HTTPS** > **Actions** > **Export Root Certificate to Desktop**.
1053+
- **Cause**: The self-hosted integration runtime is offline or the Azure integration runtime is expired or not registered.
10551054
1056-
1. Turn off capturing by going to **File** > **Capture Traffic**. Or press **F12**.
1055+
- **Recommendation**: Make sure your self-hosted integration runtime is up and running. Refer to [Troubleshoot self-hosted integration runtime](self-hosted-integration-runtime-troubleshoot-guide.md) for more information.
10571056
1058-
1. Clear your browser's cache so that all cached items are removed and must be downloaded again.
1057+
### Error Code: 2105
10591058
1060-
1. Create a request:
1059+
- **Message**: `The value type '<provided data type>', in key '<key name>' is not expected type '<expected data type>'`
10611060
1062-
1. Select the **Composer** tab.
1061+
- **Cause**: Data generated in the dynamic content expression doesn't match with the key and causes JSON parsing failure.
10631062
1064-
1. Set the HTTP method and URL.
1065-
1066-
1. If needed, add headers and a request body.
1063+
- **Recommendation**: Look at the key field and fix the dynamic content definition.
1064+
1065+
### Error code: 2108
1066+
1067+
- **Message**: `Error calling the endpoint '<URL>'. Response status code: 'NA - Unknown'. More details: Exception message: 'NA - Unknown [ClientSideException] Invalid Url:<URL>. Please verify Url or integration runtime is valid and retry. Localhost URLs are allowed only with SelfHosted Integration Runtime`
1068+
1069+
- **Cause**: Unable to reach the URL provided. This can occur because there was a network connection issue, the URL was unresolvable, or a localhost URL was being used on an Azure integration runtime.
1070+
1071+
- **Recommendation**: Verify that the provided URL is accessible.
1072+
1073+
<br/>
1074+
1075+
- **Message**: `Error calling the endpoint '%url;'. Response status code: '%code;'`
1076+
1077+
- **Cause**: The request failed due to an underlying issue such as network connectivity, a DNS failure, a server certificate validation, or a timeout.
1078+
1079+
- **Recommendation**: Use Fiddler/Postman/Netmon/Wireshark to validate the request.
1080+
1081+
**Using Fiddler**
1082+
1083+
To use **Fiddler** to create an HTTP session of the monitored web application:
1084+
1085+
1. Download, install, and open [Fiddler](https://www.telerik.com/download/fiddler).
1086+
1087+
1. If your web application uses HTTPS, go to **Tools** > **Fiddler Options** > **HTTPS**.
1088+
1089+
1. In the HTTPS tab, select both **Capture HTTPS CONNECTs** and **Decrypt HTTPS traffic**.
1090+
1091+
:::image type="content" source="media/data-factory-troubleshoot-guide/fiddler-options.png" alt-text="Fiddler options":::
1092+
1093+
1. If your application uses TLS/SSL certificates, add the Fiddler certificate to your device.
1094+
1095+
Go to: **Tools** > **Fiddler Options** > **HTTPS** > **Actions** > **Export Root Certificate to Desktop**.
1096+
1097+
1. Turn off capturing by going to **File** > **Capture Traffic**. Or press **F12**.
1098+
1099+
1. Clear your browser's cache so that all cached items are removed and must be downloaded again.
1100+
1101+
1. Create a request:
1102+
1103+
1. Select the **Composer** tab.
1104+
1105+
1. Set the HTTP method and URL.
1106+
1107+
1. If needed, add headers and a request body.
1108+
1109+
1. Select **Execute**.
1110+
1111+
1. Turn on traffic capturing again, and complete the problematic transaction on your page.
1112+
1113+
1. Go to: **File** > **Save** > **All Sessions**.
1114+
1115+
For more information, see [Getting started with Fiddler](https://docs.telerik.com/fiddler/Configure-Fiddler/Tasks/ConfigureFiddler).
1116+
1117+
### Error Code: 2113
1118+
1119+
- **Message**: `ExtractAuthorizationCertificate: Unable to generate a certificate from a Base64 string/password combination`
1120+
1121+
- **Cause**: Unable to generate certificate from Base64 string/password combination.
1122+
1123+
- **Recommendation**: Verify that the Base64 encoded PFX certificate and password combination you are using are correctly entered.
1124+
1125+
### Error Code: 2403
10671126
1068-
1. Select **Execute**.
1127+
- **Message**: `Get access token from MSI failed for Datafactory <DF mname>, region <region code>. Please verify resource url is valid and retry.`
10691128
1070-
1. Turn on traffic capturing again, and complete the problematic transaction on your page.
1129+
- **Cause**: Unable to acquire an access token from the resource URL provided.
10711130
1072-
1. Go to: **File** > **Save** > **All Sessions**.
1131+
- **Recommendation**: Verify that you have provided the correct resource URL for your managed identity.
10731132
1074-
For more information, see [Getting started with Fiddler](https://docs.telerik.com/fiddler/Configure-Fiddler/Tasks/ConfigureFiddler).
10751133
10761134
## General
10771135

0 commit comments

Comments
 (0)