在 Azure 監視器記錄中建立和管理專用叢集
本文內容
將 Log Analytics 工作區連結至 Azure 監視器中的專用叢集,可提供進階功能和更高的查詢使用率。 這些叢集每天至少需要 100 GB 的擷取承諾用量。 您可以連結和解除連結工作區與專用叢集,而不會遺失任何資料或中斷服務。
進階功能
需要專用叢集的功能:
客戶自控金鑰 - 使用您提供並控制的金鑰加密叢集資料。
加密箱 - 控制 Microsoft 支援工程師存取您資料的要求。
雙重加密 - 針對其中一個加密演算法或金鑰可能遭到入侵的情況提供保護。 在此情況下,額外的加密層會繼續保護您的資料。
跨查詢最佳化 - 當工作區位於相同叢集時,跨工作區查詢的執行速度會更快。
成本最佳化 - 將相同區域中的工作區連結至叢集,以取得所有工作區承諾用量層的折扣,甚至低擷取符合承諾用量層折扣資格的工作區也是如此。
可用性區域 - 透過依靠不同實體位置中的資料中心,其中配備獨立電源、冷卻功能和網路功能,來保護您的資料免於受到資料中心失敗的影響。 區域和獨立基礎結構中的實體區隔可大幅降低事件的發生率,因為工作區可以依賴來自任何區域的資源。 Azure 監視器可用性區域 涵蓋服務更廣泛的部分,而且一旦能在您的區域中使用,即可自動擴充您的 Azure 監視器復原能力。 根據預設,Azure 監視器會在支援的區域中建立已啟用可用性區域 (isAvailabilityZonesEnabled
: 'true') 的專用叢集。 目前並非所有區域都支援專用叢集可用性區域 。
從 Azure 事件中樞擷取 - 可讓您直接將資料從事件中樞擷取至 Log Analytics 工作區。 在來自所有連結工作區的擷取量合起來符合承諾用量層時,專用叢集可讓您使用此功能。
叢集定價模式
Log Analytics 專用叢集使用至少 100 GB/天的承諾用量層定價模式。 高於承諾用量層的任何使用量都會根據該承諾用量層的每 GB 費率計費。 如需專用叢集的定價詳細資料,請參閱 Azure 監視器記錄定價詳細資料 。 從選取定額層的時間算起,定額層有 31 天的定額期間。
必要條件
專用叢集每天至少需要 100 GB 的擷取承諾用量。
建立專用叢集時,您無法將其命名為與過去兩週內刪除的叢集同名。
所需的權限
若要執行叢集相關動作,您需要下列權限:
動作
需要的權限或角色
建立專用叢集
例如,Log Analytics 參與者內建角色 提供的 Microsoft.Resources/deployments/*
和 Microsoft.OperationalInsights/clusters/write
權限
變更叢集屬性
例如,Log Analytics 參與者內建角色 提供的 Microsoft.OperationalInsights/clusters/write
權限
將工作區連結至叢集
例如,Log Analytics 參與者內建角色 提供的 Microsoft.OperationalInsights/clusters/write
、Microsoft.OperationalInsights/workspaces/write
和 Microsoft.OperationalInsights/workspaces/linkedservices/write
權限
檢查工作區連結狀態
例如,Log Analytics 讀者內建角色 提供的工作區 Microsoft.OperationalInsights/workspaces/read
權限
取得叢集或檢查叢集的佈建狀態
例如,Log Analytics 讀者內建角色 提供的 Microsoft.OperationalInsights/clusters/read
權限
更新叢集中的承諾用量層或 billingType
例如,Log Analytics 參與者內建角色 提供的 Microsoft.OperationalInsights/clusters/write
權限
授與所需的權限
具有 */write
權限的擁有者或參與者角色,或具有 Microsoft.OperationalInsights/*
權限的 Log Analytics 參與者內建角色
取消工作區與叢集的連結
例如,Log Analytics 參與者內建角色 提供的 Microsoft.OperationalInsights/workspaces/linkedServices/delete
權限
刪除專用叢集
例如,Log Analytics 參與者內建角色 提供的 Microsoft.OperationalInsights/clusters/delete
權限
如需 Log Analytics 權限的詳細資訊,請參閱在 Azure 監視器中管理記錄資料和工作區的存取 。
Resource Manager 範本範例
此文章包括範例 Azure Resource Manager (ARM) 範本 ,可在 Azure 監視器中建立和設定 Log Analytics 叢集。 每個範例都包含範本檔案和參數檔案,且附有要提供給範本的範例值。
範本參考
建立專用叢集
建立新的專用叢集時提供下列屬性:
ClusterName :針對資源群組必須是唯一的。
ResourceGroupName :使用中央 IT 資源群組,因為組織中的許多小組通常都會共用叢集。 如需更多設計考量,請檢閱設計 Log Analytics 工作區設定 。
地點
SkuCapacity :您可以將承諾用量層設定為每天 100、200、300、400、500、1000、2000、5000、10000、25000、50000 GB。 CLI 中支援的最低承諾用量層目前為 500。 使用 REST 來設定最低 100 個承諾用量層。 如需叢集成本的詳細資訊,請參閱專用叢集 。
受控識別 :叢集支援兩種受控識別類型 :
系統指派的受控識別 - 當身分識別 type
設定為 "SystemAssigned " 時,此受控識別會在叢集建立時自動產生。 此身分識別後續可用來授與對 Key Vault 的儲存體存取權,以進行包裝和解除包裝作業。
叢集 REST 呼叫中的身分識別
{
"identity": {
"type": "SystemAssigned"
}
}
使用者指派的受控識別 - 可讓您在叢集建立時設定客戶自控金鑰 (若於叢集建立前在 Key Vault 中授與其權限)。
叢集 REST 呼叫中的身分識別
{
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.ManagedIdentity/UserAssignedIdentities/<cluster-assigned-managed-identity>"
}
}
}
建立叢集資源之後,您可以編輯屬性,例如 sku 、*keyVaultProperties 或 billingType 。 請參閱下方詳細資訊。
刪除的叢集需要兩週的時間才能完全移除。 每個訂用帳戶和區域最多可有七個叢集:五個作用中叢集,以及兩個在過去兩週內刪除的叢集。
注意
建立叢集牽涉到多項資源和作業,通常會在兩小時內完成。
不論資料擷取量為何,專用叢集都會在佈建後開始計費,建議您做好部署準備,以加速叢集的佈建和工作區連結。 驗證下列項目:
已識別要連結至叢集的初始工作區清單
您有訂用帳戶的權限,可用於叢集和任何要連結的工作區
按一下 Azure 入口網站中 [Log Analytics 專用叢集] 功能表中的 [建立] 。 系統會提示您輸入詳細資料,例如叢集名稱和承諾用量層。
注意
CLI 中支援的最低承諾用量層目前為 500。 使用 REST 來設定最低 100 個承諾用量層。
az account set --subscription "cluster-subscription-id"
az monitor log-analytics cluster create --no-wait --resource-group "resource-group-name" --name "cluster-name" --location "region-name" --sku-capacity "daily-ingestion-gigabyte"
# Wait for job completion when `--no-wait` was used
$clusterResourceId = az monitor log-analytics cluster list --resource-group "resource-group-name" --query "[?contains(name, 'cluster-name')].[id]" --output tsv
az resource wait --created --ids $clusterResourceId --include-response-body true
注意
PowerShell 中支援的最低承諾用量層目前為 500。 使用 REST 來設定最低 100 個承諾用量層。
Select-AzSubscription "cluster-subscription-id"
New-AzOperationalInsightsCluster -ResourceGroupName "resource-group-name" -ClusterName "cluster-name" -Location "region-name" -SkuCapacity "daily-ingestion-gigabyte" -AsJob
# Check when the job is done when `-AsJob` was used
Get-Job -Command "New-AzOperationalInsightsCluster*" | Format-List -Property *
呼叫
PUT https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/clusters/<cluster-name>?api-version=2022-10-01
Authorization: Bearer <token>
Content-type: application/json
{
"identity": {
"type": "systemAssigned"
},
"sku": {
"name": "capacityReservation",
"Capacity": 100
},
"properties": {
"billingType": "Cluster",
},
"location": "<region>",
}
回應
應為 202 (接受) 和標頭。
下列範例會建立新的空白 Log Analytics 叢集。
@description('Specify the name of the Log Analytics cluster.')
param clusterName string
@description('Specify the location of the resources.')
param location string = resourceGroup().location
@description('Specify the capacity reservation value.')
@allowed([
100
200
300
400
500
1000
2000
5000
])
param CommitmentTier int
@description('Specify the billing type settings. Can be \'Cluster\' (default) or \'Workspaces\' for proportional billing on workspaces.')
@allowed([
'Cluster'
'Workspaces'
])
param billingType string
resource cluster 'Microsoft.OperationalInsights/clusters@2021-06-01' = {
name: clusterName
location: location
identity: {
type: 'SystemAssigned'
}
sku: {
name: 'CapacityReservation'
capacity: CommitmentTier
}
properties: {
billingType: billingType
}
}
參數檔案
{
"$schema": "https://schema.management.azure.com/schemas/2019-08-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"clusterName": {
"value": "MyCluster"
},
"CommitmentTier": {
"value": 500
},
"billingType": {
"value": "Cluster"
}
}
}
下列範例會建立新的空白 Log Analytics 叢集。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"clusterName": {
"type": "string",
"metadata": {
"description": "Specify the name of the Log Analytics cluster."
}
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]",
"metadata": {
"description": "Specify the location of the resources."
}
},
"CommitmentTier": {
"type": "int",
"allowedValues": [
100,
200,
300,
400,
500,
1000,
2000,
5000
],
"metadata": {
"description": "Specify the capacity reservation value."
}
},
"billingType": {
"type": "string",
"allowedValues": [
"Cluster",
"Workspaces"
],
"metadata": {
"description": "Specify the billing type settings. Can be 'Cluster' (default) or 'Workspaces' for proportional billing on workspaces."
}
}
},
"resources": [
{
"type": "Microsoft.OperationalInsights/clusters",
"apiVersion": "2021-06-01",
"name": "[parameters('clusterName')]",
"location": "[parameters('location')]",
"identity": {
"type": "SystemAssigned"
},
"sku": {
"name": "CapacityReservation",
"capacity": "[parameters('CommitmentTier')]"
},
"properties": {
"billingType": "[parameters('billingType')]"
}
}
]
}
參數檔案
{
"$schema": "https://schema.management.azure.com/schemas/2019-08-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"clusterName": {
"value": "MyCluster"
},
"CommitmentTier": {
"value": 500
},
"billingType": {
"value": "Cluster"
}
}
}
檢查叢集佈建狀態
Log Analytics 叢集的佈建需要一段時間才能完成。 請使用下列其中一種方法來檢查 ProvisioningState 屬性。 若正在佈建,該值為 ProvisioningAccount ;若已完成,則為 Succeeded 。
az account set --subscription "cluster-subscription-id"
az monitor log-analytics cluster show --resource-group "resource-group-name" --name "cluster-name"
Select-AzSubscription "cluster-subscription-id"
Get-AzOperationalInsightsCluster -ResourceGroupName "resource-group-name" -ClusterName "cluster-name"
傳送叢集資源的 GET 要求,並查看 provisioningState 值。 若正在佈建,該值為 ProvisioningAccount ;若已完成,則為 Succeeded 。
GET https://management.azure.com/subscriptions/subscription-id/resourceGroups/resource-group-name/providers/Microsoft.OperationalInsights/clusters/cluster-name?api-version=2022-10-01
Authorization: Bearer <token>
回應
{
"identity": {
"type": "SystemAssigned",
"tenantId": "tenant-id",
"principalId": "principal-id"
},
"sku": {
"name": "capacityreservation",
"capacity": 100
},
"properties": {
"provisioningState": "ProvisioningAccount",
"clusterId": "cluster-id",
"billingType": "Cluster",
"lastModifiedDate": "last-modified-date",
"createdDate": "created-date",
"isDoubleEncryptionEnabled": false,
"isAvailabilityZonesEnabled": false,
"capacityReservationProperties": {
"lastSkuUpdate": "last-sku-modified-date",
"minCapacity": 100
}
},
"id": "/subscriptions/subscription-id/resourceGroups/resource-group-name/providers/Microsoft.OperationalInsights/clusters/cluster-name",
"name": "cluster-name",
"type": "Microsoft.OperationalInsights/clusters",
"location": "cluster-region"
}
受控識別服務會在您建立叢集時產生 principalId GUID。
將工作區連結至叢集
注意
只有在完成 Log Analytics 叢集佈建之後,才能執行工作區連結。
將工作區連結至叢集,涉及同步多個後端元件和快取序列化,這可能會在兩個小時內完成。
連結 Log Analytics 工作區時,工作區計費方案會變更為 LACluster ,您應該移除工作區範本中的 SKU,以避免工作區部署期間發生衝突。
除了叢集方案所控管的計費層面以外,所有工作區設定和查詢層面在連結期間和之後都會保持不變。
您需要工作區和叢集資源的「寫入」授權,才能進行工作區連結作業:
在工作區中:Microsoft.OperationalInsights/workspaces/write
在叢集資源中:Microsoft.OperationalInsights/clusters/write
一旦 Log Analytics 工作區連結至專用叢集時,傳送至工作區的新資料就會擷取至專用叢集,而先前擷取的資料仍會保留在 Log Analytics 叢集中。 連結工作區不會影響工作區作業,包括擷取和查詢體驗。 Log Analytics 查詢引擎會自動拼接來自新舊叢集的資料,因此查詢的結果是完整的。
叢集會依區域分隔,而且最多可以連結至 1,000 個工作區,這些工作區位於與叢集相同的區域中。 工作區一個月無法連結至叢集兩次以上,以防止資料分散。
連結的工作區可以位於與叢集所在的訂用帳戶不同的訂用帳戶中。 如果使用 Azure Lighthouse 將工作區和叢集對應至單一租用戶,則工作區和叢集可以位於不同的租用戶中。
使用客戶自控金鑰 (CMK) 設定專用叢集時,新擷取的資料會使用您的金鑰進行加密,而較舊的資料仍會使用 Microsoft 受控金鑰 (MMK) 進行加密。 金鑰設定由 Log Analytics 抽象化,且跨新舊資料加密的查詢無縫執行。
請使用下列步驟,將工作區連結至叢集。 您可以使用自動化,連結多個工作區:
從 Azure 入口網站中 [Log Analytics 專用叢集] 功能表選取您的叢集,然後按一下 [Linked workspaces] ,以檢視目前連結至專用叢集的所有工作區。 按一下 [Link workspaces] 以連結其他工作區。
# Find cluster resource ID
az account set --subscription "cluster-subscription-id"
$clusterResourceId = az monitor log-analytics cluster list --resource-group "resource-group-name" --query "[?contains(name, 'cluster-name')].[id]" --output tsv
# Link workspace
az account set --subscription "workspace-subscription-id"
az monitor log-analytics workspace linked-service create --no-wait --name cluster --resource-group "resource-group-name" --workspace-name "workspace-name" --write-access-resource-id $clusterResourceId
# Wait for job completion when `--no-wait` was used
$workspaceResourceId = az monitor log-analytics workspace list --resource-group "resource-group-name" --query "[?contains(name, 'workspace-name')].[id]" --output tsv
az resource wait --deleted --ids $workspaceResourceId --include-response-body true
注意
針對 LinkedServiceName
使用叢集 值。
Select-AzSubscription "cluster-subscription-id"
# Find cluster resource ID
$clusterResourceId = (Get-AzOperationalInsightsCluster -ResourceGroupName "resource-group-name" -ClusterName "cluster-name").id
Select-AzSubscription "workspace-subscription-id"
# Link the workspace to the cluster
Set-AzOperationalInsightsLinkedService -ResourceGroupName "resource-group-name" -WorkspaceName "workspace-name" -LinkedServiceName cluster -WriteAccessResourceId $clusterResourceId -AsJob
# Check when the job is done
Get-Job -Command "Set-AzOperationalInsightsLinkedService" | Format-List -Property *
使用下列 REST 呼叫連結至叢集:
Send
PUT https://management.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>/linkedservices/cluster?api-version=2020-08-01
Authorization: Bearer <token>
Content-type: application/json
{
"properties": {
"WriteAccessResourceId": "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/clusters/<cluster-name>"
}
}
回應
202 (接受) 和標頭。
檢查工作區連結狀態
此工作區連結作業最多可能需要 90 分鐘才能完成。 您可以在連結的工作區和叢集上檢查狀態。 完成時,工作區資源會在 features
下包含 clusterResourceId
屬性,而叢集會在 [associatedWorkspaces
] 區段下包含連結的工作區。
使用客戶自控金鑰設定叢集時,連結作業完成之後擷取至工作區的資料會以您的金鑰進行加密儲存。
在專用叢集的 [概觀] 頁面上,選取 [JSON 檢視] 。 [associatedWorkspaces
] 區段會列出連結至叢集的工作區。
az account set --subscription "workspace-subscription-id"
az monitor log-analytics workspace show --resource-group "resource-group-name" --workspace-name "workspace-name"
Select-AzSubscription "workspace-subscription-id"
Get-AzOperationalInsightsWorkspace -ResourceGroupName "resource-group-name" -Name "workspace-name"
呼叫
GET https://management.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>?api-version=2023-09-01
Authorization: Bearer <token>
回應
{
"properties": {
"source": "Azure",
"customerId": "workspace-name",
"provisioningState": "Succeeded",
"sku": {
"name": "pricing-tier-name",
"lastSkuUpdate": "Tue, 28 Jan 2020 12:26:30 GMT"
},
"retentionInDays": 31,
"features": {
"legacy": 0,
"searchVersion": 1,
"enableLogAccessUsingOnlyResourcePermissions": true,
"clusterResourceId": "/subscriptions/subscription-id/resourceGroups/resource-group-name/providers/Microsoft.OperationalInsights/clusters/cluster-name"
},
"workspaceCapping": {
"dailyQuotaGb": -1.0,
"quotaNextResetTime": "Tue, 28 Jan 2020 14:00:00 GMT",
"dataIngestionStatus": "RespectQuota"
}
},
"id": "/subscriptions/subscription-id/resourcegroups/resource-group-name/providers/microsoft.operationalinsights/workspaces/workspace-name",
"name": "workspace-name",
"type": "Microsoft.OperationalInsights/workspaces",
"location": "region"
}
變更叢集屬性
建立叢集資源並完全佈建之後,您可以使用 CLI、PowerShell 或 REST API 編輯叢集屬性。 您可以在佈建叢集之後設定的屬性包括:
keyVaultProperties - 包含 Azure Key Vault 中的金鑰和下列參數:KeyVaultUri 、KeyName 、KeyVersion 。 請參閱使用金鑰識別碼詳細資料更新叢集 。
身分識別 - 用來向 Key Vault 進行驗證的身分識別。 這可以由系統指派或使用者指派。
billingType - 叢集資源及其資料的計費屬性。 包含下列值:
叢集 (預設) - 叢集的成本取決於叢集資源。
工作區 - 叢集的成本取決於叢集中的工作區比例,如果當天的資料擷取量總計低於承諾用量層,就會將叢集資源的部分使用量列入計費。 若要深入了解叢集定價模式,請參閱 Log Analytics 專用叢集 。
重要
叢集更新不應在相同作業中同時包括身分識別和金鑰識別碼詳細資料。 如果您需要更新這兩者,則更新應該在兩個連續作業中進行。
下列範例會更新計費類型。
az account set --subscription "cluster-subscription-id"
az monitor log-analytics cluster update --resource-group "resource-group-name" --name "cluster-name" --billing-type {Cluster, Workspaces}
下列範例會更新計費類型。
Select-AzSubscription "cluster-subscription-id"
Update-AzOperationalInsightsCluster -ResourceGroupName "resource-group-name" -ClusterName "cluster-name" -BillingType "Workspaces"
下列範例會更新計費類型。
呼叫
PATCH https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/clusters/<cluster-name>?api-version=2022-10-01
Authorization: Bearer <token>
Content-type: application/json
{
"properties": {
"billingType": "Workspaces"
},
"location": "region"
}
下列範例會更新 Log Analytics 叢集,以使用客戶自控金鑰。
@description('Specify the name of the Log Analytics cluster.')
param clusterName string
@description('Specify the location of the resources')
param location string = resourceGroup().location
@description('Specify the key vault name.')
param keyVaultName string
@description('Specify the key name.')
param keyName string
@description('Specify the key version. When empty, latest key version is used.')
param keyVersion string
var keyVaultUri = format('{0}{1}', keyVaultName, environment().suffixes.keyvaultDns)
resource cluster 'Microsoft.OperationalInsights/clusters@2021-06-01' = {
name: clusterName
location: location
identity: {
type: 'SystemAssigned'
}
properties: {
keyVaultProperties: {
keyVaultUri: keyVaultUri
keyName: keyName
keyVersion: keyVersion
}
}
}
參數檔案
{
"$schema": "https://schema.management.azure.com/schemas/2019-08-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"clusterName": {
"value": "MyCluster"
},
"keyVaultUri": {
"value": "https://key-vault-name.vault.azure.net"
},
"keyName": {
"value": "MyKeyName"
},
"keyVersion": {
"value": ""
}
}
}
下列範例會更新 Log Analytics 叢集,以使用客戶自控金鑰。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"clusterName": {
"type": "string",
"metadata": {
"description": "Specify the name of the Log Analytics cluster."
}
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]",
"metadata": {
"description": "Specify the location of the resources"
}
},
"keyVaultName": {
"type": "string",
"metadata": {
"description": "Specify the key vault name."
}
},
"keyName": {
"type": "string",
"metadata": {
"description": "Specify the key name."
}
},
"keyVersion": {
"type": "string",
"metadata": {
"description": "Specify the key version. When empty, latest key version is used."
}
}
},
"variables": {
"keyVaultUri": "[format('{0}{1}', parameters('keyVaultName'), environment().suffixes.keyvaultDns)]"
},
"resources": [
{
"type": "Microsoft.OperationalInsights/clusters",
"apiVersion": "2021-06-01",
"name": "[parameters('clusterName')]",
"location": "[parameters('location')]",
"identity": {
"type": "SystemAssigned"
},
"properties": {
"keyVaultProperties": {
"keyVaultUri": "[variables('keyVaultUri')]",
"keyName": "[parameters('keyName')]",
"keyVersion": "[parameters('keyVersion')]"
}
}
}
]
}
參數檔案
{
"$schema": "https://schema.management.azure.com/schemas/2019-08-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"clusterName": {
"value": "MyCluster"
},
"keyVaultUri": {
"value": "https://key-vault-name.vault.azure.net"
},
"keyName": {
"value": "MyKeyName"
},
"keyVersion": {
"value": ""
}
}
}
取得資源群組中的所有叢集
從 Azure 入口網站 [Log Analytics 專用叢集] 功能表中,選取 [資源群組] 篩選條件。
az account set --subscription "cluster-subscription-id"
az monitor log-analytics cluster list --resource-group "resource-group-name"
Select-AzSubscription "cluster-subscription-id"
Get-AzOperationalInsightsCluster -ResourceGroupName "resource-group-name"
呼叫
GET https://management.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.OperationalInsights/clusters?api-version=2022-10-01
Authorization: Bearer <token>
回應
{
"value": [
{
"identity": {
"type": "SystemAssigned",
"tenantId": "tenant-id",
"principalId": "principal-id"
},
"sku": {
"name": "capacityreservation",
"capacity": 100
},
"properties": {
"provisioningState": "Succeeded",
"clusterId": "cluster-id",
"billingType": "Cluster",
"lastModifiedDate": "last-modified-date",
"createdDate": "created-date",
"isDoubleEncryptionEnabled": false,
"isAvailabilityZonesEnabled": false,
"capacityReservationProperties": {
"lastSkuUpdate": "last-sku-modified-date",
"minCapacity": 100
}
},
"id": "/subscriptions/subscription-id/resourceGroups/resource-group-name/providers/Microsoft.OperationalInsights/clusters/cluster-name",
"name": "cluster-name",
"type": "Microsoft.OperationalInsights/clusters",
"location": "cluster-region"
}
]
}
取得訂用帳戶中的所有叢集
從 Azure 入口網站 [Log Analytics 專用叢集] 功能表中,選取 [訂用帳戶] 篩選條件。
az account set --subscription "cluster-subscription-id"
az monitor log-analytics cluster list
Select-AzSubscription "cluster-subscription-id"
Get-AzOperationalInsightsCluster
呼叫
GET https://management.azure.com/subscriptions/<subscription-id>/providers/Microsoft.OperationalInsights/clusters?api-version=2022-10-01
Authorization: Bearer <token>
回應
與「資源群組內的叢集」相同,但範圍是訂用帳戶內。
更新叢集中的承諾用量層
當連結工作區的資料量隨著時間變更時,您可以適當地更新承諾用量層以最佳化成本。 承諾用量層是以 GB 為單位指定的,而且其值可以是每天 100、200、300、400、500、1000、2000、5000、10000、25000、50000 GB。 您不必提供完整的 REST 要求本文,但必須包含 SKU。
在承諾期期間,您可以變更為較高的定額層,這會重新開始 31 天的承諾期。 在完成承諾期之後,您無法回到隨用隨付或較低的定額層。
從 Azure 入口網站 [Log Analytics 專用叢集] 功能表中選取您的叢集,然後按一下 [承諾用量層] 旁 的 [變更]
az account set --subscription "cluster-subscription-id"
az monitor log-analytics cluster update --resource-group "resource-group-name" --name "cluster-name" --sku-capacity 500
Select-AzSubscription "cluster-subscription-id"
Update-AzOperationalInsightsCluster -ResourceGroupName "resource-group-name" -ClusterName "cluster-name" -SkuCapacity 500
呼叫
PATCH https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/clusters/<cluster-name>?api-version=2022-10-01
Authorization: Bearer <token>
Content-type: application/json
{
"sku": {
"name": "capacityReservation",
"Capacity": 2000
}
}
取消工作區與叢集的連結
您可以隨時從叢集取消與工作區的連結。 工作區定價層會變更為每 GB、在取消連結作業保留在叢集中之前擷取至叢集的資料,而工作區的新資料會擷取至記錄分析。
警告
取消連結工作區並不會將工作區資料移出叢集。 連結至叢集時針對工作區收集的任何資料,都會在工作區中定義的保留期間內保留在叢集中,而且只要叢集未遭刪除,即可存取這些資料。
查詢在工作區取消連結時不會受到影響,且服務會無縫執行跨叢集查詢。 如果叢集是以客戶自控金鑰 (CMK) 設定,則在連結時擷取至工作區的資料仍會以您的金鑰進行加密並可供存取,而您的金鑰和 Key Vault 的權限仍維持不變。
注意
一個月內特定工作區有兩個連結作業的限制,以防止跨叢集的資料散發。 如果您達到限制,請連絡支援人員。
解除連結的工作區會移至隨用隨付定價層。
使用下列命令從叢集取消工作區連結:
從 Azure 入口網站中 [Log Analytics 專用叢集] 功能表選取您的叢集,然後按一下 [Linked workspaces] ,以檢視目前連結至專用叢集的所有工作區。 選取您要取消連結的任何工作區,然後按一下 [取消連結] 。
az account set --subscription "workspace-subscription-id"
az monitor log-analytics workspace linked-service delete --resource-group "resource-group-name" --workspace-name "workspace-name" --name cluster
Select-AzSubscription "workspace-subscription-id"
# Unlink a workspace from cluster
Remove-AzOperationalInsightsLinkedService -ResourceGroupName "resource-group-name" -WorkspaceName {workspace-name} -LinkedServiceName cluster
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/linkedServices/{linkedServiceName}?api-version=2020-08-01
刪除叢集
您必須擁有叢集資源的寫入 權限。
叢集刪除作業應該謹慎執行,因為此作業無法復原。 所有從連結工作區擷取至叢集的資料,都會永久刪除。
叢集的計費會在刪除叢集後停止,不論叢集中定義的 31 天承諾用量層為何。
如果您刪除一個具有連結工作區的叢集,工作區會自動解除與叢集的連結、工作區會移至隨用隨付定價層,而且工作區的新資料會改為擷取至 Log Analytics 叢集。 您可以查詢工作區在連結至叢集之前和取消連結之後的時間範圍,且服務會無縫執行跨叢集查詢。
注意
每個訂用帳戶和區域有七個叢集的限制:五個作用中叢集,加上兩個在過去兩週內刪除的叢集。
刪除之後,叢集的名稱會保留兩週,且無法用於建立新的叢集。
使用下列命令來刪除叢集:
從 Azure 入口網站 [Log Analytics 專用叢集] 功能表中選取您的叢集,然後按一下 [刪除] 。
az account set --subscription "cluster-subscription-id"
az monitor log-analytics cluster delete --resource-group "resource-group-name" --name $clusterName
Select-AzSubscription "cluster-subscription-id"
Remove-AzOperationalInsightsCluster -ResourceGroupName "resource-group-name" -ClusterName "cluster-name"
使用下列 REST 呼叫來刪除叢集:
DELETE https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/clusters/<cluster-name>?api-version=2022-10-01
Authorization: Bearer <token>
回應
200 OK
變更受控識別類型
建立叢集之後,可以變更身分識別類型,且不會中斷擷取或具有下列考慮的查詢:
更新 SystemAssigned 至 UserAssigned — 在 金鑰保存庫 中授與 UserAssign 身分識別,然後在叢集中更新身分識別類型
更新 UserAssigned 至 SystemAssigned — 由於使用 SystemAssigned 更新叢集身分識別類型之後所建立的系統指派受控識別,因此必須遵循下列步驟
更新叢集並移除密鑰—使用值 「設定 keyVaultUri、keyName 和 keyVersion
將叢集身分識別類型更新為 SystemAssigned
更新 金鑰保存庫 並將許可權 授與身分識別
更新叢集中的金鑰
限制和條件約束
每個區域和訂用帳戶中最多可以建立五個作用中的叢集。
允許每個訂用帳戶和區域最多可有七個叢集:五個作用中叢集,加上兩個在過去 2 週內刪除的叢集。
最多可將 1,000 個 Log Analytics 工作區連結至叢集。
在特定工作區上,最多允許在 30 天內執行兩個工作區連結作業。
目前不支援將叢集移至另一個資源群組或訂用帳戶。
不支援將叢集移至另一個區域。
叢集更新不應在相同作業中同時包含身分識別和金鑰識別碼詳細資料。 如果您需要更新這兩者,則更新應該在兩個連續作業中進行。
加密箱目前不適用於中國。
加密箱目前無法套用至使用輔助方案 的資料表。
系統會自動針對自 2020 年 10 月在支援的區域中建立的叢集設定雙重加密 。 您可以在叢集上傳送 GET 要求,並針對已啟用雙重加密的叢集,觀察 isDoubleEncryptionEnabled
值是否為 true
,以驗證已將叢集設定為雙重加密。
如果您建立叢集並收到錯誤:「region-name 不支援針對叢集使用雙重加密。」,您仍然可以透過在 REST 要求本文中新增 "properties": {"isDoubleEncryptionEnabled": false}
,來建立不含雙重加密的叢集。
建立叢集之後,就無法變更雙重加密設定。
連結至叢集時,允許刪除工作區。 如果您決定在虛刪除 期間復原 工作區,則工作區會回到先前的狀態,並維持與叢集的連結。
在承諾期期間,您可以變更為較高的定額層,這會重新開始 31 天的承諾期。 在完成承諾期之後,您無法回到隨用隨付或較低的定額層。
疑難排解
如果您在建立叢集時得到衝突錯誤,則該叢集可能在過去 2 週內已遭刪除,且仍在刪除過程中。 叢集名稱在 2 週刪除期間仍會保留,且您無法使用該名稱建立新叢集。
如果您在叢集處於佈建或更新狀態時更新叢集,更新將會失敗。
某些作業的時間很長,可能需要一些時間才能完成。 其中包括叢集建立 、叢集金鑰更新 和叢集刪除 。 您可以將 GET 要求傳送至叢集或工作區,並觀察回應,以檢查作業狀態。 例如,未連結的工作區在features 下方不會有 clusterResourceId 。
如果您嘗試連結已連結至另一個叢集的 Log Analytics 工作區,作業將會失敗。
錯誤訊息
叢集建立
400--叢集名稱無效。 叢集名稱可以包含 a-z、A-Z、0-9 且長度為 3-63 的字元。
400--要求本文為 Null 或格式不正確。
400--SKU 名稱無效。 將 SKU 名稱設為 capacityReservation。
400--已提供容量,但 SKU 不是 capacityReservation。 將 SKU 名稱設為 capacityReservation。
400--SKU 中遺漏了容量。 將容量值設定為每天 100、200、300、400、500、1000、2000、5000、10000、25000、50000 GB。
400--容量已鎖定 30 天。 允許在更新後的 30 天之後減少容量。
400--未設定 SKU。 將 SKU 名稱設定為 capacityReservation,並將容量值設定為每天 100、200、300、400、500、1000、2000、5000、10000、25000、50000 GB。
400--無法立即執行作業。 非同步作業處於非成功狀態。 叢集必須先完成其作業,然後才能執行任何更新作業。
叢集更新
400 -- 叢集處於刪除狀態。 非同步作業正在進行中。 叢集必須先完成其作業,然後才能執行任何更新作業。
400--KeyVaultProperties 並非空白,但格式不正確。 請參閱金鑰識別碼更新 。
400 -- 無法在 Key Vault 中驗證金鑰。 可能是因為權限不足,或金鑰不存在時。 驗證您已在 Key Vault 中設定金鑰和存取原則 。
400--金鑰無法復原。 Key Vault 必須設定為虛刪除和清除保護。 請參閱 Key Vault 文件
400--無法立即執行作業。 請等候非同步作業完成,然後再試一次。
400 -- 叢集處於刪除狀態。 請等候非同步作業完成,然後再試一次。
叢集取得
404--找不到叢集,叢集可能已遭刪除。 如果您嘗試使用該名稱建立叢集,但發生衝突,表示該叢集正在刪除中。
叢集刪除
409 -- 無法在處於佈建狀態時刪除叢集。 請等候非同步作業完成,然後再試一次。
工作區連結
404 -- 找不到工作區。 您指定的工作區不存在或已刪除。
409 -- 工作區連結或取消連結作業正在進行中。
400 -- 找不到叢集,您指定的叢集不存在或已遭刪除。
工作區取消連結
404 -- 找不到工作區。 您指定的工作區不存在或已刪除。
409 -- 工作區連結或取消連結作業正在進行中。
下一步