Skip to content

Commit 38553e3

Browse files
authored
resolve comments
1 parent ad46690 commit 38553e3

File tree

1 file changed

+7
-5
lines changed

1 file changed

+7
-5
lines changed

articles/azure-web-pubsub/howto-troubleshoot-common-issues.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.devlang: csharp
1111

1212
# Troubleshooting guide for common issues
1313

14-
This article provides troubleshooting guidance for some of the common issues that customers might encounter. Listed errors are available to check when you turn on `LiveTrace` tool or collect from diagnostics following [Capture resource logs](./howto-troubleshoot-resource-logs.md).
14+
This article provides troubleshooting guidance for some of the common issues that customers might encounter. Listed errors are available to check when you turn on [`live trace tool`](./howto-troubleshoot-resource-logs.md#capture-resource-logs-by-using-the-live-trace-tool) or collect from [Azure monior](./howto-troubleshoot-resource-logs.md#capture-resource-logs-with-azure-monitor).
1515

1616
## 404 from HttpHandlerUnexpectedResponse
1717

@@ -45,12 +45,14 @@ This error indicates event request get a `500` response from registered upstream
4545

4646
## AbuseProtectionResponseMissingAllowedOrigin
4747

48-
Web PubSub follows the [CloudEvents Abuse Protection](https://github.com/cloudevents/spec/blob/v1.0/http-webhook.md#4-abuse-protection) to validate the upstream webhook. Every registered upstream webhook URL will be validated. The `WebHook-Request-Origin` request header is set to the service domain name `<web-pubsub-name>.webpubsub.azure.com`, and it expects the response to have a header `WebHook-Allowed-Origin` to contain this domain name or `*`.
49-
5048
### Possible errors
5149

5250
- `Abuse protection for 'https://<upstream-host>/<upstream-path>' missing allowed origins: .`
5351

52+
### Root cause
53+
54+
Web PubSub follows the [CloudEvents Abuse Protection](https://github.com/cloudevents/spec/blob/v1.0/http-webhook.md#4-abuse-protection) to validate the upstream webhook. Every registered upstream webhook URL will be validated. The `WebHook-Request-Origin` request header is set to the service domain name `<web-pubsub-name>.webpubsub.azure.com`, and it expects the response to have a header `WebHook-Allowed-Origin` to contain this domain name or `*`.
55+
5456
### Troubleshooting guide
5557

5658
Review the upstream side code to ensure when upstream receives the `OPTIONS` preflight request from Web PubSub service, it's correctly handled following the rule that contains the expected header `WebHook-Allowed-Origin` and value.
@@ -77,7 +79,7 @@ This error indicates the `Abuse Protection` request get a `401` response from th
7779

7880
## Client connection drops
7981

80-
When the client is connected to Azure Web PubSub, the persistent connection between the client and Azure Web PubSUb can sometimes drop for different reasons. This section describes several possibilities causing such connection drop and provides some guidance on how to identify the root cause.
82+
When the client is connected to Azure Web PubSub, the persistent connection between the client and Azure Web PubSub can sometimes drop for different reasons. This section describes several possibilities causing such connection drop and provides some guidance on how to identify the root cause.
8183

8284
You can check the metric `Connection Close Count` from Azure portal.
8385

@@ -93,7 +95,7 @@ You can check the metric `Connection Close Count` from Azure portal.
9395

9496
### Troubleshooting guide
9597

96-
`PingTimeout` and `SlowClient` indicates that you have some clients not able to afford current traffic load. It's suggested to control the message sending speed and investigate client traces if client side performance can be improved.
98+
`PingTimeout` and `SlowClient` indicates that you have some clients not able to afford current traffic load. It's suggested to control the message sending speed and investigate [client traces](./howto-troubleshoot-network-trace) if client side performance can be improved.
9799

98100
## ConnectionCountLimitReached
99101

0 commit comments

Comments
 (0)