Um cluster dedicado em Azure Monitor fornece recursos avançados de segurança e controle e otimização de custo. Você pode vincular workspaces novos ou existentes a um cluster dedicado sem interromper as operações de ingestão e consulta.
Recursos avançados
Azure Monitor Logs é um serviço de escala de nuvem totalmente gerenciado projetado para lidar automaticamente com ingestão, indexação e consulta em cargas de trabalho grandes e flutuantes. Seu mecanismo subjacente emprega mecanismos internos que otimizam a execução de consultas, distribuem o processamento e dimensionam automaticamente os recursos sem intervenção do usuário. Esse serviço de alto desempenho é a estrutura sobre a qual os workspaces padrão do Log Analytics, ou clusters compartilhados, são criados. Os seguintes recursos adicionais são desbloqueados quando você cria um cluster dedicado:
| Capacidade |
Description |
|
Chaves gerenciadas pelo cliente |
Criptografar dados usando uma chave que você fornece e controla. |
|
Lockbox |
Controle o acesso do engenheiro de suporte da Microsoft aos seus dados. |
|
Criptografia dupla |
Camada extra de criptografia para seus dados. |
|
Otimização entre espaços de trabalho |
As consultas entre workspaces são executadas mais rapidamente quando estão no mesmo cluster. |
| Otimização de custos |
Vincule workspaces na mesma região ao cluster e aproveite um desconto no nível de compromisso para dados ingeridos de todos os workspaces vinculados. |
|
Zonas de Disponibilidade |
Proteja seus dados com datacenters em locais físicos diferentes, equipados com energia, resfriamento e rede independentes.
Zonas de disponibilidade do Azure Monitor estendem automaticamente a resiliência do Azure Monitor. Azure Monitor habilita clusters dedicados para zonas de disponibilidade (isAvailabilityZonesEnabled: 'true') por padrão em todas as regiões que dão suporte a zonas de disponibilidade.
As regiões compatíveis com a zona de disponibilidade incluem suporte para clusters dedicados e clusters compartilhados. |
|
Ingestão do Hubs de Eventos do Azure |
Permite ingerir dados diretamente dos Hubs de Eventos no espaço de trabalho do Log Analytics. |
| Monitorar workspaces vinculados como um cluster |
Monitore o desempenho do cluster por meio de Azure Monitor, incluindo volume de ingestão, desempenho de consulta e utilização de compromisso de capacidade em todos os workspaces vinculados. |
Observação
Clusters dedicados não são uma maneira geral de tornar todas as consultas mais rápidas. Assim como acontece com qualquer sistema analítico grande, a execução de consultas em conjuntos de dados muito grandes requer recursos de computação extras e pode afetar o desempenho da consulta. Para um melhor desempenho de consulta além da otimização entre espaços de trabalho dos clusters dedicados, otimize suas consultas. Essa estratégia é especialmente eficaz com grandes conjuntos de dados e ao consultar em longos intervalos de tempo.
Modelo de preço do cluster
Os clusters dedicados do Log Analytics usam um modelo de preços por nível de compromisso, a partir de 100 GB por dia. A ingestão que excede o nível de compromisso é cobrada com base na taxa por GB. Você pode aumentar um nível de compromisso a qualquer momento, mas ele tem um período de compromisso de 31 dias antes que ele possa ser reduzido. Consulte Detalhes de preços dos Logs do Azure Monitor para obter detalhes sobre os níveis de compromisso.
O tipo de cobrança do cluster tem dois valores possíveis:
- Cluster (padrão): os custos do seu cluster são atribuídos ao recurso de cluster.
- Workspaces: os custos do seu cluster são atribuídos proporcionalmente aos workspaces no cluster, com o recurso de cluster sendo cobrado por parte do uso se o total de dados ingeridos por dia estiver abaixo do nível de compromisso. Confira Clusters dedicados do Log Analytics para saber mais sobre o modelo de preço do cluster.
Permissões necessárias
Para executar ações relacionadas ao cluster, você precisa ter estas permissões:
| Ação |
Permissões ou função necessárias |
| Criar um cluster dedicado |
As permissões Microsoft.Resources/deployments/* e Microsoft.OperationalInsights/clusters/write, conforme fornecidas pela função interna do Colaborador do Log Analytics, por exemplo |
| Alterar propriedades do cluster |
As permissões Microsoft.OperationalInsights/clusters/write, conforme fornecidas pela função interna do Colaborador do Log Analytics, por exemplo |
| Vincular espaços de trabalho a um cluster |
As permissões Microsoft.OperationalInsights/clusters/write, Microsoft.OperationalInsights/workspaces/write e Microsoft.OperationalInsights/workspaces/linkedservices/write conforme fornecidas pela função interna do Colaborador do Log Analytics, por exemplo |
| Verificar status do link do espaço de trabalho |
As permissões Microsoft.OperationalInsights/workspaces/read para o espaço de trabalho, conforme fornecido pela função interna do Log Analytics Reader, por exemplo |
| Obter clusters ou verificar o status de provisionamento de um cluster |
As permissões Microsoft.OperationalInsights/clusters/read, conforme fornecidas pela função interna do Leitor do Log Analytics, por exemplo |
| Atualizar a camada de compromisso ou billingType em um cluster |
As permissões Microsoft.OperationalInsights/clusters/write, conforme fornecidas pela função interna do Colaborador do Log Analytics, por exemplo |
| Conceder as permissões necessárias |
Função de Proprietário ou Colaborador com permissões */write, ou a função interna Colaborador do Log Analytics, que possui permissões Microsoft.OperationalInsights/* |
| Desvincular um espaço de trabalho do cluster |
As permissões Microsoft.OperationalInsights/workspaces/linkedServices/delete, conforme fornecidas pela função interna do Colaborador do Log Analytics, por exemplo |
| Excluir um cluster dedicado |
As permissões Microsoft.OperationalInsights/clusters/delete, conforme fornecidas pela função interna do Colaborador do Log Analytics, por exemplo |
Para obter mais informações sobre permissões de Log Analytics, consulte Gerenciar acesso a dados de log e workspaces no Azure Monitor.
Resource Manager exemplos de modelo
Este artigo inclui modelos de exemplo do Azure Resource Manager (ARM) para criar e configurar clusters de Log Analytics no Azure Monitor. Cada amostra inclui um arquivo de modelo e um arquivo de parâmetros com valores de amostra para fornecer ao modelo.
Observação
Consulte os exemplos do Azure Resource Manager do Azure Monitor para uma lista de exemplos disponíveis e diretrizes sobre como implantá-los em sua assinatura do Azure.
Referências de modelo
Preparação
A cobrança da camada de compromisso do cluster começa assim que você cria o cluster, independentemente da ingestão de dados. Prepare os seguintes itens antes de começar:
- A assinatura para criar o cluster.
- Uma lista de workspaces que você deseja vincular ao cluster. Essas áreas de trabalho devem estar na mesma região que o cluster.
- Uma decisão sobre o tipo de faturamento e a atribuição, definindo se deve ser definido para o cluster (padrão) ou para os espaços de trabalho vinculados proporcionalmente.
- Verificação de suas permissões para criar um cluster e vincular espaços de trabalho.
Observação
- A criação de cluster e a vinculação de workspaces são operações assíncronas que podem levar algumas horas para serem concluídas.
- A vinculação ou desvinculação de workspaces a um cluster não tem efeito na ingestão ou nas consultas durante as operações.
Criar um cluster dedicado
Forneça as seguintes propriedades ao criar um novo cluster dedicado:
ClusterName: deve ser exclusivo para o grupo de recursos.
ResourceGroupName: use um grupo de recursos de TI central, porque muitas equipes da organização costumam compartilhar clusters. Para mais considerações sobre design, consulte Projetar uma configuração de workspace do Log Analytics.
Localidade
SkuCapacity: as camadas de compromisso válidas são 100, 200, 300, 400, 500, 1000, 2000, 5000, 10000, 25000 ou 50000 GB por dia. Para obter mais informações sobre os custos do cluster, consulte Clusters dedicados.
Identidade gerenciada: os clusters dão suporte a dois tipos de identidade gerenciadas:
Identidade gerenciada atribuída pelo sistema - Automaticamente gerada com a criação do cluster quando a identidade type é configurada como "SystemAssigned". Use essa identidade para conceder acesso de armazenamento ao seu Key Vault para operações de encapsulamento e desencapsagem.
Identidade na chamada REST do cluster
{
"identity": {
"type": "SystemAssigned"
}
}
Identidade gerenciada atribuída pelo usuário – usando essa identidade, você pode configurar uma chave gerenciada pelo cliente na criação do cluster ao conceder permissões em seu Key Vault antes da criação do cluster.
Identidade na chamada REST do cluster
{
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/<SubscriptionId>/resourceGroups/<ResourceGroupName>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<ManagedIdentityName>": {}
}
}
}
Depois de criar o recurso de cluster, você pode editar propriedades como sku, keyVaultProperties ou billingType. Veja mais detalhes abaixo.
Os clusters excluídos levam duas semanas para serem completamente removidos. Você pode ter até sete clusters por assinatura e região - cinco ativos e dois excluídos nas últimas duas semanas.
Observação
A criação de um cluster envolve vários recursos e a operação normalmente é concluída em duas horas.
Um cluster dedicado é cobrado uma vez provisionado, independentemente da ingestão de dados. Prepare a implantação para agilizar o provisionamento e a vinculação dos workspaces ao cluster. Verifique o seguinte:
- Uma lista de workspaces iniciais a serem vinculados ao cluster é identificada
- Você tem permissões para a assinatura destinada ao cluster e a qualquer workspace a ser vinculado
Selecione Criar no menu Clusters dedicados do Log Analytics no portal do Azure. Você será solicitado a obter detalhes, como o nome do cluster e a camada de compromisso.
O exemplo de CLI do Azure a seguir usa o az monitor log-analytics cluster create comando. Ele cria um cluster com uma camada de compromisso de 1.000 GB.
# Set variables
resourceGroupName="<ResourceGroupName>"
clusterName="<ClusterName>"
azureRegion="<AzureRegion>"
skuCapacity=1000
# Create the cluster
az monitor log-analytics cluster create --no-wait \
--resource-group "$resourceGroupName" --name "$clusterName" \
--location "$azureRegion" --sku-capacity "$skuCapacity"
# Wait for cluster provisioning
az monitor log-analytics cluster wait --created \
--resource-group "$resourceGroupName" --name "$clusterName" --timeout 10800
Observação
Os comandos da CLI do Azure usam o ponto de extremidade do Azure Resource Manager no contexto atual da CLI, portanto management.azure.com não precisa ser especificado na sintaxe do comando.
O exemplo de Azure PowerShell a seguir usa o New-AzOperationalInsightsCluster cmdlet. Ele cria um cluster com uma camada de compromisso de 1.000 GB.
# Set variables
$resourceGroupName = "<ResourceGroupName>"
$clusterName = "<ClusterName>"
$azureRegion = "<AzureRegion>"
$skuCapacity = 1000
# Define parameters for New-AzOperationalInsightsCluster
$newAzOperationalInsightsClusterParams = @{
ResourceGroupName = $resourceGroupName
ClusterName = $clusterName
Location = $azureRegion
SkuCapacity = $skuCapacity
AsJob = $true
}
# Create the cluster and wait for the job
$clusterJob = New-AzOperationalInsightsCluster @newAzOperationalInsightsClusterParams
$clusterJob | Wait-Job | Receive-Job
Observação
Os cmdlets do Azure PowerShell usam o ponto de extremidade do Azure Resource Manager do contexto atual de Az, portanto management.azure.com não precisa ser especificado na sintaxe dos cmdlets.
O exemplo REST a seguir usa a operação da Clusters - Create Or Update API REST.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters/{clusterName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json
{
"identity": {
"type": "SystemAssigned"
},
"sku": {
"name": "CapacityReservation",
"capacity": 1000
},
"properties": {
"billingType": "Cluster"
},
"location": "<AzureRegion>"
}
Resposta
Deve ser 202 (Aceito) e um cabeçalho.
O exemplo de Bicep a seguir usa o tipo de recurso Microsoft.OperationalInsights/clusters. Ele cria um cluster com uma camada de compromisso de 1.000 GB.
param clusterName string = '<ClusterName>'
param azureRegion string = '<AzureRegion>'
@allowed([
100
200
300
400
500
1000
2000
5000
10000
25000
50000
])
param commitmentTier int = 1000
@allowed([
'Cluster'
'Workspaces'
])
param billingType string = 'Cluster'
resource logAnalyticsCluster 'Microsoft.OperationalInsights/clusters@<ApiVersion>' = {
name: clusterName
location: azureRegion
identity: {
type: 'SystemAssigned'
}
sku: {
name: 'CapacityReservation'
capacity: commitmentTier
}
properties: {
billingType: billingType
}
}
Arquivo de parâmetros
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"clusterName": {
"value": "<ClusterName>"
},
"azureRegion": {
"value": "<AzureRegion>"
},
"commitmentTier": {
"value": 1000
},
"billingType": {
"value": "Cluster"
}
}
}
O exemplo de modelo arm a seguir usa o Microsoft.OperationalInsights/clusters tipo de recurso. Ele cria um cluster com uma camada de compromisso de 1.000 GB.
Criar um cluster dedicado
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"clusterName": {
"type": "string",
"defaultValue": "<ClusterName>"
},
"azureRegion": {
"type": "string",
"defaultValue": "<AzureRegion>"
},
"commitmentTier": {
"type": "int",
"defaultValue": 1000,
"allowedValues": [
100,
200,
300,
400,
500,
1000,
2000,
5000,
10000,
25000,
50000
]
},
"billingType": {
"type": "string",
"defaultValue": "Cluster",
"allowedValues": [
"Cluster",
"Workspaces"
]
}
},
"resources": [
{
"type": "Microsoft.OperationalInsights/clusters",
"apiVersion": "<ApiVersion>",
"name": "[parameters('clusterName')]",
"location": "[parameters('azureRegion')]",
"identity": {
"type": "SystemAssigned"
},
"sku": {
"name": "CapacityReservation",
"capacity": "[parameters('commitmentTier')]"
},
"properties": {
"billingType": "[parameters('billingType')]"
}
}
]
}
Arquivo de parâmetros
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"clusterName": {
"value": "<ClusterName>"
},
"azureRegion": {
"value": "<AzureRegion>"
},
"commitmentTier": {
"value": 1000
},
"billingType": {
"value": "Cluster"
}
}
}
Verificar o status do provisionamento do cluster
O provisionamento do cluster Log Analytics leva um tempo para ser concluído. Use um dos seguintes métodos para verificar a propriedade ProvisioningState. O valor é Criando durante o provisionamento e Bem-sucedido quando concluído.
O portal fornece um status à medida que o cluster está sendo provisionado.
O exemplo de CLI do Azure a seguir usa o az monitor log-analytics cluster show comando.
# Set variables
resourceGroupName="<ResourceGroupName>"
clusterName="<ClusterName>"
# Retrieve the cluster
az monitor log-analytics cluster show \
--resource-group "$resourceGroupName" --name "$clusterName"
Observação
Os comandos da CLI do Azure usam o ponto de extremidade do Azure Resource Manager no contexto atual da CLI, portanto management.azure.com não precisa ser especificado na sintaxe do comando.
O exemplo de Azure PowerShell a seguir usa o Get-AzOperationalInsightsCluster cmdlet.
# Set variables
$resourceGroupName = "<ResourceGroupName>"
$clusterName = "<ClusterName>"
# Define parameters for Get-AzOperationalInsightsCluster
$getAzOperationalInsightsClusterParams = @{
ResourceGroupName = $resourceGroupName
ClusterName = $clusterName
}
# Retrieve the cluster
Get-AzOperationalInsightsCluster @getAzOperationalInsightsClusterParams
Observação
Os cmdlets do Azure PowerShell usam o ponto de extremidade do Azure Resource Manager do contexto atual de Az, portanto management.azure.com não precisa ser especificado na sintaxe dos cmdlets.
O exemplo REST a seguir usa a operação da Clusters - Get API REST. Verifique provisioningState para ver se há Succeeded antes de vincular um espaço de trabalho.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters/{clusterName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Resposta
{
"identity": {
"type": "SystemAssigned",
"tenantId": "00000000-0000-0000-0000-000000000000",
"principalId": "00000000-0000-0000-0000-000000000000"
},
"sku": {
"name": "CapacityReservation",
"capacity": 100
},
"properties": {
"provisioningState": "Creating",
"clusterId": "00000000-0000-0000-0000-000000000000",
"billingType": "Cluster",
"lastModifiedDate": "2026-05-01T00:00:00Z",
"createdDate": "2026-05-01T00:00:00Z",
"isDoubleEncryptionEnabled": false,
"isAvailabilityZonesEnabled": false,
"capacityReservationProperties": {
"lastSkuUpdate": "2026-05-01T00:00:00Z",
"minCapacity": 100
}
},
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-monitor/providers/Microsoft.OperationalInsights/clusters/cluster-monitor",
"name": "cluster-monitor",
"type": "Microsoft.OperationalInsights/clusters",
"location": "eastus"
}
O serviço de identidade gerenciada gera o GUID principalId quando você cria o cluster.
Vincular um workspace a um cluster
Observação
- Vincule apenas um workspace depois que o portal terminar de provisionar o cluster do Log Analytics.
- Conectar um espaço de trabalho a um cluster sincroniza diversos componentes de back-end e a atualização do cache, que normalmente é concluída em duas horas.
- Quando você vincula um workspace Log Analytics, o plano de cobrança do workspace muda para LACluster. Remova a SKU no modelo de workspace para evitar um conflito durante a implantação do workspace.
- Além dos aspectos de cobrança que o plano de cluster rege, todas as configurações do espaço de trabalho e os aspectos de consulta permanecem inalterados durante e após a vinculação.
Você precisa que o workspace e o recurso de cluster tenham permissões de ”gravação” para a operação de link do workspace:
- No espaço de trabalho:
Microsoft.OperationalInsights/workspaces/write
- No recurso de cluster:
Microsoft.OperationalInsights/clusters/write
Depois de vincular um workspace Log Analytics a um cluster dedicado, novos dados enviados para o workspace vão para o cluster dedicado, enquanto os dados ingeridos anteriormente permanecem no cluster Log Analytics. Vincular um workspace não afeta o funcionamento dele, incluindo as experiências de ingestão e consulta. O mecanismo de consulta do Log Analytics integra automaticamente dados de clusters novos e antigos, de modo que os resultados das consultas sejam completos.
Os clusters são regionais e podem se vincular a até 1.000 workspaces localizados na mesma região do cluster. Para evitar a fragmentação de dados, você não pode vincular um workspace a um cluster mais de duas vezes por mês.
Workspaces vinculados podem estar em assinaturas diferentes daquelas em que o cluster está. Se você usar o Azure Lighthouse para mapear ambos para um único locatário, o espaço de trabalho e o cluster podem estar em locatários diferentes.
Quando você configura um cluster dedicado com uma CMK (chave gerenciada pelo cliente), os dados recém-ingeridos são criptografados com sua chave, enquanto os dados mais antigos permanecem criptografados com uma MMK (chave gerenciada por Microsoft). Log Analytics abstrai a configuração de chave e as consultas entre criptografias de dados antigas e novas são executadas perfeitamente.
Use as seguintes etapas para vincular um workspace a um cluster. Você pode usar automação para vincular vários workspaces:
Selecione seu cluster no menu clusters dedicados do Log Analytics no portal do Azure. Selecione Workspaces Vinculados para exibir todos os workspaces atualmente vinculados ao cluster dedicado. Selecione Vincular espaços de trabalho para vincular espaços de trabalho adicionais.
O exemplo de CLI do Azure a seguir usa o az monitor log-analytics workspace linked-service create comando. O espaço de trabalho pode estar em uma assinatura diferente da do cluster. O nome do serviço vinculado deve ser cluster.
# Set variables
clusterSubscriptionId="<ClusterSubscriptionId>"
clusterResourceGroupName="<ClusterResourceGroupName>"
clusterName="<ClusterName>"
subscriptionId="<TargetSubscriptionId>"
resourceGroupName="<WorkspaceResourceGroupName>"
workspaceName="<WorkspaceName>"
# Build cluster resource ID
clusterPath="/subscriptions/$clusterSubscriptionId"
clusterPath+="/resourceGroups/$clusterResourceGroupName"
clusterProvider="Microsoft.OperationalInsights/clusters/$clusterName"
clusterResourceId="$clusterPath/providers/$clusterProvider"
# Link workspace
az monitor log-analytics workspace linked-service create --no-wait --name cluster \
--subscription "$subscriptionId" --resource-group "$resourceGroupName" \
--workspace-name "$workspaceName" --write-access-resource-id "$clusterResourceId"
# Wait for the linked service
az monitor log-analytics workspace linked-service wait --created --name cluster \
--subscription "$subscriptionId" --resource-group "$resourceGroupName" \
--workspace-name "$workspaceName" --timeout 10800
Observação
Os comandos da CLI do Azure usam o ponto de extremidade do Azure Resource Manager no contexto atual da CLI, portanto management.azure.com não precisa ser especificado na sintaxe do comando.
O exemplo de Azure PowerShell a seguir usa o Set-AzOperationalInsightsLinkedService cmdlet. O workspace pode estar em uma assinatura diferente do cluster. O nome do serviço vinculado deve ser cluster.
# Set variables
$clusterSubscriptionId = "<ClusterSubscriptionId>"
$clusterResourceGroupName = "<ClusterResourceGroupName>"
$clusterName = "<ClusterName>"
$subscriptionId = "<TargetSubscriptionId>"
$resourceGroupName = "<WorkspaceResourceGroupName>"
$workspaceName = "<WorkspaceName>"
# Build cluster resource ID
$clusterPath = "/subscriptions/$clusterSubscriptionId" +
"/resourceGroups/$clusterResourceGroupName"
$clusterProvider = "Microsoft.OperationalInsights/clusters/$clusterName"
$clusterResourceId = "$clusterPath/providers/$clusterProvider"
# Set the target subscription context
Set-AzContext -Subscription $subscriptionId
# Define parameters for Set-AzOperationalInsightsLinkedService
$setAzOperationalInsightsLinkedServiceParams = @{
ResourceGroupName = $resourceGroupName
WorkspaceName = $workspaceName
LinkedServiceName = "cluster"
WriteAccessResourceId = $clusterResourceId
AsJob = $true
}
# Link the workspace and wait for the job
Set-AzOperationalInsightsLinkedService @setAzOperationalInsightsLinkedServiceParams |
Wait-Job | Receive-Job
Observação
Os cmdlets do Azure PowerShell usam o ponto de extremidade do Azure Resource Manager do contexto atual de Az, portanto management.azure.com não precisa ser especificado na sintaxe dos cmdlets.
O exemplo REST a seguir usa a operação da Linked Services - Create Or Update API REST. A solicitação tem como destino a assinatura do workspace; o corpo identifica a assinatura do cluster.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/linkedServices/cluster?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json
{
"properties": {
"writeAccessResourceId": "/subscriptions/<ClusterSubscriptionId>/resourceGroups/<ClusterResourceGroupName>/providers/Microsoft.OperationalInsights/clusters/<ClusterName>"
}
}
Resposta
202 (Aceito) e cabeçalho.
Observação
Implantações por modelo criam ou atualizam o serviço vinculado; não são operações PATCH parciais.
- Implantar no grupo de recursos do espaço de trabalho.
- Mantenha as configurações de link de cluster existentes nas atualizações subsequentes.
O exemplo de Bicep a seguir usa o tipo de recurso Microsoft.OperationalInsights/workspaces/linkedServices. Os parâmetros de assinatura e grupo de recursos identificam o cluster, que pode estar em uma assinatura diferente da do espaço de trabalho.
param subscriptionId string = '<ClusterSubscriptionId>'
param resourceGroupName string = '<ClusterResourceGroupName>'
param workspaceName string = '<WorkspaceName>'
param clusterName string = '<ClusterName>'
var clusterResourceId = resourceId(
subscriptionId,
resourceGroupName,
'Microsoft.OperationalInsights/clusters',
clusterName
)
resource wsLink 'Microsoft.OperationalInsights/workspaces/linkedServices@<ApiVersion>' = {
name: '${workspaceName}/cluster'
properties: {
writeAccessResourceId: clusterResourceId
}
}
Observação
Implantações de modelo criam ou atualizam o serviço vinculado; não são operações PATCH parciais.
- Implante no grupo de recursos do workspace.
- Mantenha as configurações de link de cluster existentes nas atualizações subsequentes.
O exemplo de modelo arm a seguir usa o Microsoft.OperationalInsights/workspaces/linkedServices tipo de recurso. Os parâmetros de assinatura e grupo de recursos identificam o cluster, que pode estar em uma assinatura diferente da do espaço de trabalho.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"subscriptionId": {
"type": "string",
"defaultValue": "<ClusterSubscriptionId>"
},
"resourceGroupName": {
"type": "string",
"defaultValue": "<ClusterResourceGroupName>"
},
"workspaceName": {
"type": "string",
"defaultValue": "<WorkspaceName>"
},
"clusterName": {
"type": "string",
"defaultValue": "<ClusterName>"
}
},
"variables": {
"clusterResourceId": "[resourceId(parameters('subscriptionId'), parameters('resourceGroupName'), 'Microsoft.OperationalInsights/clusters', parameters('clusterName'))]"
},
"resources": [
{
"type": "Microsoft.OperationalInsights/workspaces/linkedServices",
"apiVersion": "<ApiVersion>",
"name": "[format('{0}/cluster', parameters('workspaceName'))]",
"properties": {
"writeAccessResourceId": "[variables('clusterResourceId')]"
}
}
]
}
Verificar status do link do espaço de trabalho
A operação de vinculação do workspace pode levar até 90 minutos para ser concluída. Você pode verificar o status nos workspaces vinculados e no cluster. Após a conclusão, os recursos do espaço de trabalho incluem a propriedade clusterResourceId em features e o cluster inclui os espaços de trabalho vinculados na seção associatedWorkspaces.
Quando você configura um cluster com uma chave gerenciada pelo cliente, os dados ingeridos são criptografados com sua chave para os workspaces após a conclusão da operação de link.
Na página Visão geral do cluster dedicado, selecione Exibição JSON. A seção associatedWorkspaces lista os workspaces vinculados ao cluster.
O exemplo de CLI do Azure a seguir usa o az monitor log-analytics workspace show comando.
# Set variables
resourceGroupName="<ResourceGroupName>"
workspaceName="<WorkspaceName>"
# Retrieve the workspace
az monitor log-analytics workspace show \
--resource-group "$resourceGroupName" --workspace-name "$workspaceName"
Observação
Os comandos da CLI do Azure usam o ponto de extremidade do Azure Resource Manager no contexto atual da CLI, portanto management.azure.com não precisa ser especificado na sintaxe do comando.
O exemplo de Azure PowerShell a seguir usa o Get-AzOperationalInsightsWorkspace cmdlet.
# Set variables
$resourceGroupName = "<ResourceGroupName>"
$workspaceName = "<WorkspaceName>"
# Define parameters for Get-AzOperationalInsightsWorkspace
$getAzOperationalInsightsWorkspaceParams = @{
ResourceGroupName = $resourceGroupName
Name = $workspaceName
}
# Retrieve the workspace
Get-AzOperationalInsightsWorkspace @getAzOperationalInsightsWorkspaceParams
Observação
Os cmdlets do Azure PowerShell usam o ponto de extremidade do Azure Resource Manager do contexto atual de Az, portanto management.azure.com não precisa ser especificado na sintaxe dos cmdlets.
O exemplo REST a seguir usa a operação da Workspaces - Get API REST.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Resposta
{
"properties": {
"source": "Azure",
"customerId": "00000000-0000-0000-0000-000000000000",
"provisioningState": "Succeeded",
"sku": {
"name": "LACluster",
"lastSkuUpdate": "Tue, 28 Jan 2020 12:26:30 GMT"
},
"retentionInDays": 31,
"features": {
"legacy": 0,
"searchVersion": 1,
"enableLogAccessUsingOnlyResourcePermissions": true,
"clusterResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-monitor/providers/Microsoft.OperationalInsights/clusters/cluster-monitor"
},
"workspaceCapping": {
"dailyQuotaGb": -1.0,
"quotaNextResetTime": "Tue, 28 Jan 2020 14:00:00 GMT",
"dataIngestionStatus": "RespectQuota"
}
},
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-monitor/providers/Microsoft.OperationalInsights/workspaces/workspace-monitor",
"name": "workspace-monitor",
"type": "Microsoft.OperationalInsights/workspaces",
"location": "eastus"
}
Alterar propriedades do cluster
Depois de criar o recurso de cluster e ele estiver totalmente provisionado, você poderá editar as propriedades do cluster usando a CLI, o PowerShell ou a API REST. Você pode definir as seguintes propriedades após o provisionamento do cluster:
-
keyVaultProperties - Contém a chave em Azure Key Vault com os seguintes parâmetros: KeyVaultUri, KeyName, KeyVersion. Consulte Atualizar cluster dedicado com detalhes do identificador de chave.
-
Identity - A identidade usada para autenticar no Key Vault. Essa identidade pode ser atribuída pelo sistema ou atribuída pelo usuário.
-
billingType – atribuição de cobrança para o recurso de cluster e seus dados. Inclui os seguintes valores:
-
Cluster (padrão) – os custos do cluster são atribuídos ao recurso de cluster.
-
Workspaces: os custos do seu cluster são atribuídos proporcionalmente aos workspaces no cluster, com o recurso de cluster sendo cobrado por parte do uso se o total de dados ingeridos por dia estiver abaixo da camada de serviço de compromisso. Confira Clusters dedicados do Log Analytics para saber mais sobre o modelo de preço do cluster.
Importante
Uma única atualização de cluster não deve incluir detalhes de identidade e identificador de chave na mesma operação. Se você precisar atualizar ambos, faça a atualização em duas operações consecutivas.
O exemplo de CLI do Azure a seguir usa o az monitor log-analytics cluster update comando. Ele define o tipo de cobrança usando o --billing-type parâmetro.
# Set variables
resourceGroupName="<ResourceGroupName>"
clusterName="<ClusterName>"
# Update the cluster billing type
az monitor log-analytics cluster update \
--resource-group "$resourceGroupName" --name "$clusterName" --billing-type Workspaces
Observação
Os comandos da CLI do Azure usam o ponto de extremidade do Azure Resource Manager no contexto atual da CLI, portanto management.azure.com não precisa ser especificado na sintaxe do comando.
O exemplo de Azure PowerShell a seguir usa o Update-AzOperationalInsightsCluster cmdlet. Ele define o tipo de cobrança usando o BillingType parâmetro.
# Set variables
$resourceGroupName = "<ResourceGroupName>"
$clusterName = "<ClusterName>"
# Define parameters for Update-AzOperationalInsightsCluster
$updateAzOperationalInsightsClusterParams = @{
ResourceGroupName = $resourceGroupName
ClusterName = $clusterName
BillingType = "Workspaces"
}
# Update the cluster billing type
Update-AzOperationalInsightsCluster @updateAzOperationalInsightsClusterParams
Observação
Os cmdlets do Azure PowerShell usam o ponto de extremidade do Azure Resource Manager do contexto atual de Az, portanto management.azure.com não precisa ser especificado na sintaxe dos cmdlets.
O exemplo REST a seguir usa a operação da Clusters - Update API REST. Ele define a billingType propriedade como Workspaces.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters/{clusterName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json
{
"properties": {
"billingType": "Workspaces"
}
}
Observação
Implantações de modelo criam ou atualizam o recurso; não são operações parciais de PATCH.
- Mantenha as configurações existentes do cluster.
- Configure sua identidade atribuída pelo sistema antes de atualizar os detalhes da chave.
- Não altere a identidade e a chave na mesma implantação.
O exemplo de Bicep a seguir usa o tipo de recurso Microsoft.OperationalInsights/clusters. Para atualizar a atribuição de cobrança, defina billingType no modelo a partir de Criar um cluster dedicado. O exemplo a seguir também configura uma chave gerenciada pelo cliente em um cluster com uma identidade atribuída pelo sistema existente.
param clusterName string = '<ClusterName>'
param azureRegion string = '<AzureRegion>'
param commitmentTier int = 1000
param billingType string = 'Cluster'
param keyVaultName string = '<KeyVaultName>'
param keyName string = '<KeyName>'
param keyVersion string = '<KeyVersion>'
var keyVaultUri = 'https://${keyVaultName}${environment().suffixes.keyvaultDns}'
resource logAnalyticsCluster 'Microsoft.OperationalInsights/clusters@<ApiVersion>' = {
name: clusterName
location: azureRegion
identity: {
type: 'SystemAssigned'
}
sku: {
name: 'CapacityReservation'
capacity: commitmentTier
}
properties: {
billingType: billingType
keyVaultProperties: {
keyVaultUri: keyVaultUri
keyName: keyName
keyVersion: keyVersion
}
}
}
Arquivo de parâmetros
Use o nível de compromisso existente do cluster e o tipo de cobrança. Defina keyVersion como uma cadeia de caracteres vazia para usar a versão mais recente da chave.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"clusterName": {
"value": "<ClusterName>"
},
"azureRegion": {
"value": "<AzureRegion>"
},
"commitmentTier": {
"value": 1000
},
"billingType": {
"value": "Cluster"
},
"keyVaultName": {
"value": "<KeyVaultName>"
},
"keyName": {
"value": "<KeyName>"
},
"keyVersion": {
"value": ""
}
}
}
Observação
Implantações de modelo criam ou atualizam o recurso; não são operações parciais de PATCH.
- Mantenha as configurações existentes do cluster.
- Configure sua identidade atribuída pelo sistema antes de atualizar os detalhes da chave.
- Não altere a identidade e a chave na mesma implantação.
O exemplo de modelo arm a seguir usa o Microsoft.OperationalInsights/clusters tipo de recurso. Para atualizar a atribuição de cobrança, defina billingType no modelo a partir de Criar um cluster dedicado. O exemplo a seguir também configura uma chave gerenciada pelo cliente em um cluster com uma identidade atribuída pelo sistema existente.
Configurar uma chave gerenciada pelo cliente em um cluster dedicado
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"clusterName": {
"type": "string",
"defaultValue": "<ClusterName>"
},
"azureRegion": {
"type": "string",
"defaultValue": "<AzureRegion>"
},
"commitmentTier": {
"type": "int",
"defaultValue": 1000
},
"billingType": {
"type": "string",
"defaultValue": "Cluster"
},
"keyVaultName": {
"type": "string",
"defaultValue": "<KeyVaultName>"
},
"keyName": {
"type": "string",
"defaultValue": "<KeyName>"
},
"keyVersion": {
"type": "string",
"defaultValue": "<KeyVersion>"
}
},
"variables": {
"keyVaultUri": "[format('https://{0}{1}', parameters('keyVaultName'), environment().suffixes.keyvaultDns)]"
},
"resources": [
{
"type": "Microsoft.OperationalInsights/clusters",
"apiVersion": "<ApiVersion>",
"name": "[parameters('clusterName')]",
"location": "[parameters('azureRegion')]",
"identity": {
"type": "SystemAssigned"
},
"sku": {
"name": "CapacityReservation",
"capacity": "[parameters('commitmentTier')]"
},
"properties": {
"billingType": "[parameters('billingType')]",
"keyVaultProperties": {
"keyVaultUri": "[variables('keyVaultUri')]",
"keyName": "[parameters('keyName')]",
"keyVersion": "[parameters('keyVersion')]"
}
}
}
]
}
Arquivo de parâmetros
Use o nível de compromisso e o tipo de cobrança existentes no cluster. Defina keyVersion como uma cadeia de caracteres vazia para usar a versão mais recente da chave.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"clusterName": {
"value": "<ClusterName>"
},
"azureRegion": {
"value": "<AzureRegion>"
},
"commitmentTier": {
"value": 1000
},
"billingType": {
"value": "Cluster"
},
"keyVaultName": {
"value": "<KeyVaultName>"
},
"keyName": {
"value": "<KeyName>"
},
"keyVersion": {
"value": ""
}
}
}
Obter todos os clusters no grupo de recursos
No menu Clusters dedicados do Log Analytics no portal do Azure, selecione o filtro Grupo de recursos.
O exemplo de CLI do Azure a seguir usa o az monitor log-analytics cluster list comando.
# Set variables
resourceGroupName="<ResourceGroupName>"
# List clusters in the resource group
az monitor log-analytics cluster list --resource-group "$resourceGroupName"
Observação
Os comandos da CLI do Azure usam o ponto de extremidade do Azure Resource Manager no contexto atual da CLI, portanto management.azure.com não precisa ser especificado na sintaxe do comando.
O exemplo de Azure PowerShell a seguir usa o Get-AzOperationalInsightsCluster cmdlet.
# Set variables
$resourceGroupName = "<ResourceGroupName>"
# List clusters in the resource group
Get-AzOperationalInsightsCluster -ResourceGroupName $resourceGroupName
Observação
Os cmdlets do Azure PowerShell usam o ponto de extremidade do Azure Resource Manager do contexto atual de Az, portanto management.azure.com não precisa ser especificado na sintaxe dos cmdlets.
O exemplo REST a seguir usa a operação da Clusters - List By Resource Group API REST.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters?api-version={apiVersion}
Authorization: Bearer {accessToken}
Resposta
{
"value": [
{
"identity": {
"type": "SystemAssigned",
"tenantId": "00000000-0000-0000-0000-000000000000",
"principalId": "00000000-0000-0000-0000-000000000000"
},
"sku": {
"name": "CapacityReservation",
"capacity": 100
},
"properties": {
"provisioningState": "Succeeded",
"clusterId": "00000000-0000-0000-0000-000000000000",
"billingType": "Cluster",
"lastModifiedDate": "2026-05-01T00:00:00Z",
"createdDate": "2026-05-01T00:00:00Z",
"isDoubleEncryptionEnabled": false,
"isAvailabilityZonesEnabled": false,
"capacityReservationProperties": {
"lastSkuUpdate": "2026-05-01T00:00:00Z",
"minCapacity": 100
}
},
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-monitor/providers/Microsoft.OperationalInsights/clusters/cluster-monitor",
"name": "cluster-monitor",
"type": "Microsoft.OperationalInsights/clusters",
"location": "eastus"
}
]
}
Obter todos os clusters na assinatura
No menu Clusters dedicados do Log Analytics no portal do Azure, selecione o filtro Assinatura.
O exemplo de CLI do Azure a seguir usa o az monitor log-analytics cluster list comando. Lista os clusters na assinatura atual.
# List clusters in the current subscription
az monitor log-analytics cluster list
Observação
Os comandos da CLI do Azure usam o ponto de extremidade do Azure Resource Manager no contexto atual da CLI, portanto management.azure.com não precisa ser especificado na sintaxe do comando.
O exemplo de Azure PowerShell a seguir usa o Get-AzOperationalInsightsCluster cmdlet. Lista os clusters na assinatura atual.
# List clusters in the current subscription
Get-AzOperationalInsightsCluster
Observação
Os cmdlets do Azure PowerShell usam o ponto de extremidade do Azure Resource Manager do contexto atual de Az, portanto management.azure.com não precisa ser especificado na sintaxe dos cmdlets.
O exemplo REST a seguir usa a operação da Clusters - List API REST.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.OperationalInsights/clusters?api-version={apiVersion}
Authorization: Bearer {accessToken}
Resposta
O mesmo que para clusters em um grupo de recursos, mas no escopo da assinatura.
Atualizar o nível de compromisso no cluster
Quando o volume de dados nos workspaces vinculados mudar ao longo do tempo, atualize o nível da Camada de serviço de Compromisso para otimizar o custo. Especifique a camada em unidades de gigabytes (GB). A camada pode ter valores de 100, 200, 300, 400, 500, 1.000, 2.000, 5.000, 10.000, 25.000 ou 50.000 GB por dia. Você não precisa fornecer o corpo completo da solicitação REST, mas deve incluir a SKU.
Durante o período de compromisso, você pode alterar para um nível de compromisso mais alta, que reinicia o período de compromisso de 31 dias. Você não pode voltar para o pagamento conforme o uso ou para uma camada de serviço de compromisso inferior até terminar o período de compromisso.
Selecione seu cluster no menu clusters dedicados do Log Analytics no portal do Azure. Selecione Alterar ao lado de nível de compromisso.
O exemplo de CLI do Azure a seguir usa o az monitor log-analytics cluster update comando. Ele define a camada de compromisso usando o --sku-capacity parâmetro.
# Set variables
resourceGroupName="<ResourceGroupName>"
clusterName="<ClusterName>"
skuCapacity=2000
# Update the commitment tier
az monitor log-analytics cluster update \
--resource-group "$resourceGroupName" --name "$clusterName" \
--sku-capacity "$skuCapacity"
Observação
Os comandos da CLI do Azure usam o ponto de extremidade do Azure Resource Manager no contexto atual da CLI, portanto management.azure.com não precisa ser especificado na sintaxe do comando.
O exemplo de Azure PowerShell a seguir usa o Update-AzOperationalInsightsCluster cmdlet. Ele define a camada de compromisso usando o SkuCapacity parâmetro.
# Set variables
$resourceGroupName = "<ResourceGroupName>"
$clusterName = "<ClusterName>"
$skuCapacity = 2000
# Define parameters for Update-AzOperationalInsightsCluster
$updateAzOperationalInsightsClusterParams = @{
ResourceGroupName = $resourceGroupName
ClusterName = $clusterName
SkuCapacity = $skuCapacity
}
# Update the commitment tier
Update-AzOperationalInsightsCluster @updateAzOperationalInsightsClusterParams
Observação
Os cmdlets do Azure PowerShell usam o ponto de extremidade do Azure Resource Manager do contexto atual de Az, portanto management.azure.com não precisa ser especificado na sintaxe dos cmdlets.
O exemplo REST a seguir usa a operação da Clusters - Update API REST. Ele define a camada de compromisso usando a sku.capacity propriedade.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters/{clusterName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json
{
"sku": {
"name": "CapacityReservation",
"capacity": 2000
}
}
Observação
Implantações baseadas em modelo criam ou atualizam o cluster; não são operações PATCH parciais. Mantenha a identidade, a chave, a cobrança e outras configurações existentes ao alterar sua camada de compromisso.
O exemplo de Bicep a seguir usa o tipo de recurso Microsoft.OperationalInsights/clusters. Defina commitmentTier como o valor necessário no modelo de Criar um cluster dedicado e reimplante-o com a configuração existente do cluster.
Observação
Implantações baseadas em modelo criam ou atualizam o cluster; não são operações PATCH parciais. Mantenha a identidade, a chave, a cobrança e outras configurações existentes ao alterar sua camada de compromisso.
O exemplo de modelo arm a seguir usa o Microsoft.OperationalInsights/clusters tipo de recurso. Defina commitmentTier como o valor necessário no modelo de Criar um cluster dedicado e reimplante-o com a configuração existente do cluster.
Desvincular um espaço de trabalho do cluster
Aviso
Desvincular um workspace não move os dados do workspace para fora do cluster. Todos os dados coletados para um workspace, enquanto vinculados a um cluster dedicado, permanecem no cluster durante o período de retenção definido pelo workspace e acessíveis desde que o cluster não seja excluído.
Você pode desvincular um workspace de um cluster a qualquer momento. Veja o que acontece quando um workspace é desvinculado
- O nível de preço do espaço de trabalho passa a ser cobrado por GB.
- Os dados ingeridos no cluster antes da operação de desvinculação permanecem no cluster.
- Os novos dados enviados para o workspace são ingeridos no workspace, e não no cluster dedicado.
- As consultas não são afetadas quando um workspace é desvinculado – o serviço Log Analytics executa consultas entre clusters perfeitamente.
- Se o cluster dedicado foi configurado com uma CMK (chave gerenciada pelo cliente), os dados ingeridos no workspace enquanto ele estava vinculado permanecem criptografados com sua chave no cluster dedicado e acessíveis desde que sua chave e permissões para Key Vault permaneçam.
Observação
- Para impedir a distribuição de dados entre clusters, você pode executar apenas duas operações de link para um workspace específico dentro de um mês. Entre em contato com o suporte se você atingir o limite.
- Workspaces desvinculados são movidos para o tipo de preço de pagamento conforme o uso.
Use os seguintes comandos para desvincular um workspace do cluster:
Selecione seu cluster no menu clusters dedicados de Log Analytics no portal do Azure. Selecione Workspaces Vinculados para exibir todos os workspaces atualmente vinculados ao cluster dedicado. Selecione todos os workspaces que você deseja desvincular e selecione Desvincular.
O exemplo de CLI do Azure a seguir usa o az monitor log-analytics workspace linked-service delete comando.
# Set variables
resourceGroupName="<ResourceGroupName>"
workspaceName="<WorkspaceName>"
# Unlink the workspace
az monitor log-analytics workspace linked-service delete --name cluster \
--resource-group "$resourceGroupName" --workspace-name "$workspaceName"
Observação
Os comandos da CLI do Azure usam o ponto de extremidade do Azure Resource Manager no contexto atual da CLI, portanto management.azure.com não precisa ser especificado na sintaxe do comando.
O exemplo de Azure PowerShell a seguir usa o Remove-AzOperationalInsightsLinkedService cmdlet.
# Set variables
$resourceGroupName = "<ResourceGroupName>"
$workspaceName = "<WorkspaceName>"
# Define parameters for Remove-AzOperationalInsightsLinkedService
$removeAzOperationalInsightsLinkedServiceParams = @{
ResourceGroupName = $resourceGroupName
WorkspaceName = $workspaceName
LinkedServiceName = "cluster"
}
# Unlink the workspace
Remove-AzOperationalInsightsLinkedService @removeAzOperationalInsightsLinkedServiceParams
Observação
Os cmdlets do Azure PowerShell usam o ponto de extremidade do Azure Resource Manager do contexto atual de Az, portanto management.azure.com não precisa ser especificado na sintaxe dos cmdlets.
O exemplo REST a seguir usa a operação da Linked Services - Delete API REST.
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/linkedServices/cluster?api-version={apiVersion}
Authorization: Bearer {accessToken}
Excluir cluster
Você precisa de permissões de gravação no recurso de cluster.
Exclua um cluster com cuidado. Esta operação não pode ser desfeita. Todos os dados ingeridos no cluster a partir dos workspaces vinculados são excluídos permanentemente.
A cobrança do cluster é interrompida quando você exclui o cluster, independentemente do período de compromisso de 31 dias definido no cluster.
Se você excluir um cluster que tenha workspaces vinculados, os workspaces serão desvinculados automaticamente do cluster. Eles passam para uma camada de preços de pagamento conforme o uso, e novos dados enviados para os workspaces são ingeridos por clusters do Log Analytics. Você pode consultar um workspace no intervalo de tempo antes de ser vinculado ao cluster e, após o desvinculamento, o serviço executa consultas entre clusters perfeitamente.
Observação
- Há um limite de sete clusters por assinatura e região: cinco clusters ativos, além de dois que foram excluídos nas últimas duas semanas.
- O nome de um cluster permanece reservado duas semanas após a exclusão, durante a qual você não pode usá-lo para criar um novo cluster.
Use os seguintes comandos para excluir um cluster:
Selecione seu cluster no menu clusters dedicados do Log Analytics no portal do Azure. Em seguida, selecione Excluir.
O exemplo de CLI do Azure a seguir usa o az monitor log-analytics cluster delete comando.
# Set variables
resourceGroupName="<ResourceGroupName>"
clusterName="<ClusterName>"
# Delete the cluster
az monitor log-analytics cluster delete \
--resource-group "$resourceGroupName" --name "$clusterName"
Observação
Os comandos da CLI do Azure usam o ponto de extremidade do Azure Resource Manager no contexto atual da CLI, portanto management.azure.com não precisa ser especificado na sintaxe do comando.
O exemplo de Azure PowerShell a seguir usa o Remove-AzOperationalInsightsCluster cmdlet.
# Set variables
$resourceGroupName = "<ResourceGroupName>"
$clusterName = "<ClusterName>"
# Define parameters for Remove-AzOperationalInsightsCluster
$removeAzOperationalInsightsClusterParams = @{
ResourceGroupName = $resourceGroupName
ClusterName = $clusterName
}
# Delete the cluster
Remove-AzOperationalInsightsCluster @removeAzOperationalInsightsClusterParams
Observação
Os cmdlets do Azure PowerShell usam o ponto de extremidade do Azure Resource Manager do contexto atual de Az, portanto management.azure.com não precisa ser especificado na sintaxe dos cmdlets.
O exemplo REST a seguir usa a operação da Clusters - Delete API REST.
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters/{clusterName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Resposta
200 Tudo certo
Alterar o tipo de identidade gerenciada
Você pode alterar o tipo de identidade depois de criar o cluster sem interromper a ingestão ou consultas. Considere o seguinte:
- Atualizando
SystemAssigned para UserAssigned – conceda a identidade UserAssign em Key Vault e atualize o tipo de identidade no cluster.
- Atualizando
UserAssigned para SystemAssigned - Já que a identidade gerenciada atribuída pelo sistema é criada após a atualização do tipo de identidade do cluster com SystemAssigned, siga estas etapas:
- Atualize o cluster para remover a chave – definir
keyVaultUri, keyName e keyVersion para o valor "".
- Atualize o tipo de identidade do cluster para
SystemAssigned.
- Atualize o Key Vault e conceda permissões à identidade.
-
Atualizar a chave no cluster dedicado.
Limites e restrições
Você pode criar até cinco clusters ativos em cada região e assinatura.
Você pode ter até sete clusters por assinatura e região: cinco clusters ativos mais dois clusters excluídos nas últimas duas semanas.
Você pode vincular até 1.000 workspaces Log Analytics a um cluster.
É possível realizar até duas operações de vinculação de workspace em um determinado workspace em um período de 30 dias.
Você não pode mover um cluster para outro grupo de recursos ou assinatura.
Você não pode mover um cluster para outra região.
Você não deve incluir detalhes de identidade e identificador de chave na mesma operação ao atualizar um cluster. Se você precisar atualizar ambos, faça duas operações de atualização consecutivas.
No momento, o Lockbox não está disponível na China.
No momento o Lockbox não pode ser aplicado a tabelas com o plano auxiliar.
Double encryption é configurado automaticamente para clusters criados a partir de outubro de 2020 em regiões com suporte. Para verificar se o cluster está configurado para criptografia dupla, envie uma solicitação GET ao cluster e observe se o valor isDoubleEncryptionEnabled é true para clusters com criptografia dupla habilitada.
- Se você criar um cluster e receber um erro "Nome-da-região não dá suporte à criptografia dupla para clusters.", ainda poderá criar o cluster sem criptografia dupla adicionando
"properties": {"isDoubleEncryptionEnabled": false} ao corpo da solicitação REST.
- Você não pode alterar a configuração de criptografia dupla depois de criar o cluster.
Você pode excluir um workspace enquanto ele está vinculado a um cluster. Se você recuperar o espaço de trabalho durante o período de soft-delete, o espaço de trabalho retornará ao estado anterior e permanecerá vinculado ao cluster.
Durante o período de compromisso, você pode alterar para um nível de compromisso mais alta, que reinicia o período de compromisso de 31 dias. Você não pode voltar para o pagamento conforme o uso ou para uma camada de serviço de compromisso inferior até terminar o período de compromisso.
Solução de problemas
Se você receber um erro de conflito ao criar um cluster, o cluster pode ter sido excluído, mas ainda estar em processo de exclusão. O nome do cluster permanece reservado durante o período de exclusão de duas semanas e você não pode criar um novo cluster com esse nome.
Se você atualizar o cluster enquanto o cluster estiver no estado de provisionamento ou atualização, a atualização falhará.
Algumas operações são longas e podem demorar um pouco para serem concluídas. Essas operações são criação de cluster, atualização de chave de cluster e exclusão de cluster. Você pode verificar o status da operação enviando uma solicitação GET para o cluster ou workspace e observar a resposta. Por exemplo, um workspace desvinculado não tem o clusterResourceId em funcionalidades.
Se você tentar vincular um workspace Log Analytics que já está vinculado a outro cluster, a operação falhará.
Mensagens de erro
As seções a seguir listam erros retornados por operações de cluster e workspace-link.
Criação de Cluster
- 400 – O nome do cluster não é válido. O nome do cluster pode conter caracteres a-z, A-Z, 0-9 e deve ter entre 3 e 63 caracteres de comprimento.
- 400 – O corpo da solicitação é nulo ou está em formato inadequado.
- 400 – O nome do SKU é inválido. Defina o nome do SKU como capacityReservation.
- 400 – A capacidade foi fornecida, mas o SKU não é capacityReservation. Defina o nome do SKU como capacityReservation.
- 400 – Capacidade ausente no SKU. Defina o valor da capacidade como 100, 200, 300, 400, 500, 1.000, 2.000, 5.000, 10.000, 25.000 ou 50.000 GB por dia.
- 400 – A capacidade está bloqueada por 30 dias. A redução da capacidade é permitida 30 dias após a atualização.
- 400 – Nenhum SKU definido. Defina o nome da SKU como capacityReservation e Capacity value como 100, 200, 300, 400, 500, 1.000, 2.000, 5.000, 10.000, 25.000 ou 50.000 GB por dia.
- 400 – A operação não pode ser executada agora. A operação assíncrona está em um estado diferente de bem-sucedido. O cluster precisa concluir a operação antes que uma atualização seja executada.
Atualização de cluster
- 400 – O cluster está em estado de exclusão. A operação assíncrona está em andamento. O cluster precisa concluir a operação antes que uma atualização seja executada.
- 400 – KeyVaultProperties não está vazio, mas tem um formato inválido. Confira a atualização do identificador de chave.
- 400– Falha ao validar a chave no Key Vault. Esse erro pode ocorrer devido à falta de permissões ou quando a chave não existe. Verifique se você configurou a chave e a política de acesso no Key Vault.
- 400 – A chave não pode ser recuperada. Defina o Key Vault para exclusão reversível e proteção contra remoção definitiva. Consulte a documentação do Key Vault.
- 400 – A operação não pode ser executada agora. Aguarde a conclusão da operação assíncrona e tente novamente.
- 400 – O cluster está em estado de exclusão. Aguarde a conclusão da operação assíncrona e tente novamente.
Obtenção de cluster
- 404 – Cluster não encontrado. Ele pode ter sido excluído. Se você tentar criar um cluster com esse nome e obter um conflito, o cluster estará em processo de exclusão.
Exclusão de cluster
- 409 – Não é possível excluir um cluster no estado de provisionamento. Aguarde a conclusão da operação assíncrona e tente novamente.
Vinculação de workspace
- 404 – Espaço de trabalho não encontrado. O workspace especificado não existe ou foi excluído.
- 409 – Operação de vinculação ou desvinculação do workspace em andamento.
- 400– Cluster não encontrado. O cluster especificado não existe ou foi excluído.
Desvinculação de workspace
- 404 – Espaço de trabalho não encontrado. O workspace especificado não existe ou foi excluído.
- 409 – Operação de vinculação ou desvinculação do workspace em andamento.
Próximas etapas