Skip to content

Commit fe3e53b

Browse files
Merge pull request #259494 from yossi-y/patch-14
Updated linked workspace section
2 parents f919e31 + 865bb97 commit fe3e53b

File tree

1 file changed

+14
-8
lines changed

1 file changed

+14
-8
lines changed

articles/azure-monitor/logs/logs-dedicated-clusters.md

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -201,32 +201,34 @@ The managed identity service generates the *principalId* GUID when you create th
201201

202202
---
203203

204-
205204
## Link a workspace to a cluster
206205

207206
When a Log Analytics workspace is linked to a dedicated cluster, the workspace billing plan in workspace is changed to cluster plan, new data ingested to the workspace is routed to your dedicated cluster, and existing data remains in Log Analytics cluster. Linking a workspace has no effect on data ingestion and query experiences. Log Analytics query engine stitches data from old and new clusters automatically, and the results of queries are complete and accurate.
208207

209208
When dedicated cluster is configured with customer-managed key (CMK), new ingested data is encrypted with your key, while older data remains encrypted with Microsoft-managed key (MMK). The key configuration is abstracted by Log Analytics and the query across old and new data encryptions is performed seamlessly.
210209

211-
A cluster can be linked to up to 1,000 workspaces. Linked workspaces must be located in the same region as the cluster. A workspace can't be linked to a cluster more than twice a month, to prevent data fragmentation.
210+
A cluster can be linked to up to 1,000 workspaces located in the same region as the cluster. A workspace can't be linked to a cluster more than twice a month, to prevent data fragmentation.
211+
212+
Other than the billing aspects that is governed by the cluster plan, all workspace configurations and query aspects remain unchanged after the link.
213+
214+
The workspace and the cluster can be in different subscriptions. It's possible for the workspace and cluster to be in different tenants if Azure Lighthouse is used to map both of them to a single tenant.
212215

213216
You need 'write' permissions to both the workspace and the cluster resource for workspace link operation:
214217

215218
- In the workspace: *Microsoft.OperationalInsights/workspaces/write*
216219
- In the cluster resource: *Microsoft.OperationalInsights/clusters/write*
217220

218-
Other than the billing aspects that is governed by the cluster plan, the linked workspace configuration remain.
219-
220-
The workspace and the cluster can be in different subscriptions. It's possible for the workspace and cluster to be in different tenants if Azure Lighthouse is used to map both of them to a single tenant.
221-
222221
> [!NOTE]
223222
> Linking a workspace can be performed only after the completion of the Log Analytics cluster provisioning.
224223
> Linking a workspace to a cluster involves syncing multiple backend components and cache hydration, which can take up to two hours.
225224
226-
Use the following commands to link a workspace to a cluster:
225+
Use the following steps to link a workspace to a cluster. You can automated for linking multiple workspaces:
227226

228227
#### [CLI](#tab/cli)
229228

229+
> [!NOTE]
230+
> Use **cluster** value for linked-service ```name```.
231+
230232
```azurecli
231233
# Find cluster resource ID
232234
az account set --subscription "cluster-subscription-id"
@@ -243,6 +245,9 @@ az resource wait --deleted --ids $workspaceResourceId --include-response-body tr
243245

244246
#### [PowerShell](#tab/powershell)
245247

248+
> [!NOTE]
249+
> Use **cluster** value for ```LinkedServiceName```.
250+
246251
```powershell
247252
Select-AzSubscription "cluster-subscription-id"
248253
@@ -258,7 +263,7 @@ Set-AzOperationalInsightsLinkedService -ResourceGroupName "resource-group-name"
258263
Get-Job -Command "Set-AzOperationalInsightsLinkedService" | Format-List -Property *
259264
```
260265

261-
#### [REST API](#tab/restapi)
266+
#### [REST API](#tab/restapi)
262267

263268
Use the following REST call to link to a cluster:
264269

@@ -282,6 +287,7 @@ Content-type: application/json
282287

283288
---
284289

290+
285291
### Check workspace link status
286292

287293
When a cluster is configured with customer-managed keys, data ingested to the workspaces after the link operation completion is stored encrypted with your managed key. The workspace link operation can take up to 90 minutes to complete and you can check the state by sending Get request to workspace and observe if *clusterResourceId* property is present in the response under *features*.

0 commit comments

Comments
 (0)