Skip to content

Commit 2ca8b78

Browse files
committed
Update DPS connectivity per request.
1 parent 72da021 commit 2ca8b78

File tree

1 file changed

+10
-8
lines changed

1 file changed

+10
-8
lines changed

docs/sql-server/azure-arc/troubleshoot-telemetry-endpoint.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ Invoke-WebRequest: Response status code does not indicate success: 401 (Unauthor
102102
For DPS:
103103

104104
```powershell
105-
Invoke-WebRequest san-af-<region>-prod.azurewebsites.net
105+
Invoke-WebRequest dataprocessingservice.<region>.arcdataservices.com
106106
```
107107

108108
A possible response status code is:
@@ -123,23 +123,25 @@ You can probe connectivity to all regions with the [test-connectivity.ps1](https
123123

124124
## Endpoint reference
125125

126+
To connect to Azure, the endpoints use `*.arcdataservices.com`.
127+
128+
### Additional background
129+
126130
Beginning with [March, 12 2024](release-notes.md#march-12-2024), the Azure Extension for SQL Server uses the following endpoints:
127131

128132
- DPS: `dataprocessingservice.<region>.arcdataservices.com`
129133
- Telemetry `telemetry.<region>.arcdataservices.com`
130134

131135
Replace `<region>` with the short name of the Azure region where the Arc machine resource is located. The short name is derived from the Azure region name without spaces and all lower case.
132136

133-
For example, if your Arc machine resource is located in *East US 2* the short name of the region is `eastus2` and the telemetry endpoint is:
137+
For example, if your Arc machine resource is located in *East US 2* the short name of the region is `eastus2` and the telemetry endpoint is:
134138

135139
`telemetry.eastus2.arcdataservices.com`
136140

137-
Up to and including the [February 13, 2024](release-notes.md#february-13-2024), The specific endpoints were:
138-
139-
- DPS: `san-af-<region>-prod.azurewebsites.net`.
140-
- Telemetry `telemetry.<region>.arcdataservices.com`.
141+
If your extension is older than March 11, 2024, it may use older endpoints. Update your extension to use the current endpoint.
141142

142-
Your extension continues to use these services until it is updated.
143+
> [!NOTE]
144+
> The endpoint values before `*.arcdataservices.com` are subject to change.
143145
144146
## Use an HTTPS proxy server for outbound connectivity
145147

@@ -177,7 +179,7 @@ The following table shows some of the common DPS upload status values and what y
177179
|`Bad request`|400|Possible cause: The resource name (SQL Server instance or database name) doesn't conform to Azure resource naming conventions. For example, if the database name is a [reserved word](/azure/azure-resource-manager/troubleshooting/error-reserved-resource-name).|
178180
| `Unauthorized` | 401 | Likely cause: the extension is configured to send data through an HTTP proxy that requires authentication. Using an HTTP proxy that requires authentication is not currently supported. Use an unauthenticated HTTP proxy or no proxy.|
179181
| `Forbidden` | 403 | If the Azure Connected Machine agent is otherwise working as expected and this error doesn't resolve itself after a reboot, create a support case with Microsoft Support through the Azure portal.|
180-
| `NotFound` | 404 | The endpoint that the extension is trying to connect to doesn't exist. <br/><br/> To check which endpoint it is trying to connect to, search the logs for `dataprocessingservice` (or before March, 2024 `san-af`). This condition can happen if the Azure Connected Machine agent was deployed and connected to an Azure region in which the `Microsoft.AzureArcData` resource provider is not yet available. [Redeploy the Azure Connected Machine agent](/azure/azure-arc/servers/manage-agent?tabs=windows#uninstall-the-agent) in a region that the `Microsoft.AzureArcData` resource provider for aSQL Server enabled by Azure Arc is available. See also [Region availability](https://azure.microsoft.com/explore/global-infrastructure/products-by-region/?products=azure-arc).<br/><br/> It is possible that the DNS resolver cache is not refreshed for your machine. To refresh: <br/> - On Windows run: `ipconfig /flushdns`</br> - On Linux (if `systemd` is being used) run: `sudo resolvectl flush-caches` |
182+
| `NotFound` | 404 | The endpoint that the extension is trying to connect to doesn't exist. <br/><br/> To check which endpoint it is trying to connect to, search the logs for `dataprocessingservice`. This condition can happen if the Azure Connected Machine agent was deployed and connected to an Azure region in which the `Microsoft.AzureArcData` resource provider is not yet available. [Redeploy the Azure Connected Machine agent](/azure/azure-arc/servers/manage-agent?tabs=windows#uninstall-the-agent) in a region that the `Microsoft.AzureArcData` resource provider for aSQL Server enabled by Azure Arc is available. See also [Region availability](https://azure.microsoft.com/explore/global-infrastructure/products-by-region/?products=azure-arc).<br/><br/> It is possible that the DNS resolver cache is not refreshed for your machine. To refresh: <br/> - On Windows run: `ipconfig /flushdns`</br> - On Linux (if `systemd` is being used) run: `sudo resolvectl flush-caches` |
181183
| `Conflict` | 409 | Likely cause: temporary error happening inside of the DPS. If this does not resolve itself, create a support case with Microsoft Support through the Azure portal.|
182184
| `InternalServerError` | 500 | This is an error that is happening inside of the DPS. Create a support case with Microsoft Support through the Azure portal. |
183185

0 commit comments

Comments
 (0)