Criar e gerenciar um cluster dedicado nos Logs do Azure Monitor

Artigo
09/30/2024

A vinculação de um workspace do Log Analytics a um cluster dedicado no Azure Monitor fornece funcionalidades avançadas e maior utilização de consulta. Os clusters exigem um compromisso mínimo de ingestão de 100 GB por dia. Você pode vincular e desvincular workspaces de um cluster dedicado sem perda de dados ou interrupção do serviço.

Recursos avançados

Os recursos que exigem clusters dedicados são:

Chaves gerenciadas pelo cliente – Criptografe os dados de cluster usando chaves fornecidas e controladas por você.
Sistema de Proteção de Dados – Controle as solicitações de acesso dos engenheiros de suporte da Microsoft aos seus dados.
Criptografia dupla – Forneça proteção contra um cenário em que um dos algoritmos ou uma das chaves de criptografia pode ser comprometida. Nesse caso, a camada extra de criptografia continua protegendo seus dados.
Otimização entre consultas – as consultas entre workspaces são executadas mais rapidamente quando os workspaces estão no mesmo cluster.
Otimização de custos – Vincule seus workspaces na mesma região ao cluster para obter o desconto por nível de compromisso para todos os workspaces, mesmo para os que têm baixa ingestão que estão qualificados para o desconto por nível de compromisso.
Zonas de disponibilidade – Proteja seus dados contra falhas do datacenter, contando com datacenters em diferentes localizações físicas, equipadas com energia, resfriamento e rede independentes. Essa separação física em zonas e infraestrutura independente tornam um incidente muito menos provável, pois o workspace pode contar com os recursos de qualquer uma das zonas. As zonas de disponibilidade do Azure Monitor abrangem partes mais amplas do serviço e, quando disponíveis na sua região, estendem automaticamente a resiliência do Azure Monitor. O Azure Monitor cria clusters dedicados como habilitados para zonas de disponibilidade (isAvailabilityZonesEnabled: 'true') por padrão nas regiões com suporte. Atualmente, não há suporte para zonas de disponibilidade de clusters dedicados em todas as regiões.
Ingerir a partir de Hubs de Eventos do Azure: permite ingerir dados diretamente de um hub de eventos para um workspace do Log Analytics. O cluster dedicado permite que você use a funcionalidade quando a ingestão de todos os workspaces vinculados combinados atende ao nível de compromisso.

Modelo de preço do cluster

Os Clusters Dedicados do Log Analytics usam um modelo de preço de nível de compromisso de pelo menos 100 GB/dia. Qualquer uso acima do nível da camada gera custos com base na taxa por GB do respectivo nível de compromisso. Consulte os detalhes de preços dos Logs do Azure Monitor para obter detalhes de preços para clusters dedicados. As camadas de compromisso têm um período de compromisso de 31 dias a partir do momento em que uma camada de compromisso é selecionada.

Pré-requisitos

Os clusters dedicados exigem um compromisso mínimo de ingestão de 100 GB por dia.
Ao criar um cluster dedicado, não é possível nomeá-lo com o mesmo nome de um cluster que foi excluído nas últimas duas semanas.

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 workspaces 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 o status de vinculação do workspace	As permissões `Microsoft.OperationalInsights/workspaces/read` para os workspaces, conforme fornecidas pela função integrada Leitor do Log Analytics, 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 Proprietário ou Colaborador que tenha permissões `/write` ou uma função interna de Colaborador do Log Analytics que tenha permissões `Microsoft.OperationalInsights/`
Desvincular um workspace 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 as permissões do Log Analytics, confira Gerenciar o acesso a dados de log e workspaces no Azure Monitor.

Exemplos de modelo do Resource Manager

Este artigo inclui exemplos de modelos do ARM (Azure Resource Manager) usados para criar e configurar clusters do 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 Amostras do Azure Resource Manager do Azure Monitor para obter uma lista de amostras disponíveis e diretrizes sobre como implantá-las em sua assinatura do Azure.

Referências de modelo

clusters do Microsoft.OperationalInsights

Criar um cluster dedicado

Informe as seguintes propriedades ao criar um 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 ver mais considerações de design, examine Como criar uma configuração de workspace do Log Analytics.
Localidade
SkuCapacity: você pode definir o nível de compromisso para 100, 200, 300, 400, 500, 1.000, 2.000, 5.000, 10.000, 25.000, 50.000 GB por dia. O nível de compromisso mínimo com suporte na CLI atualmente é de 500. Use REST para configurar níveis de compromisso mais baixos com um mínimo de 100. Para obter mais informações sobre os custos do cluster, consulte Dedicar clusters.
Identidade gerenciada: os clusters dão suporte a dois tipos de identidade gerenciada:
- Identidade gerenciada atribuída pelo sistema – Gerada automaticamente com a criação do cluster quando o type de identidade é definido como "SystemAssigned". Essa identidade pode ser usada posteriormente para conceder acesso de armazenamento à sua Key Vault para operações de encapsulamento e desencapsulamento.
  
  Identidade na chamada REST do cluster
```
{
  "identity": {
    "type": "SystemAssigned"
    }
}
```
- Identidade gerenciada atribuída pelo usuário – Permite configurar a chave gerenciada pelo cliente na criação do cluster, ao conceder a ela permissões no Key Vault antes da criação do cluster.
  
  Identidade na chamada REST do cluster
```
{
"identity": {
  "type": "UserAssigned",
    "userAssignedIdentities": {
      "subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.ManagedIdentity/UserAssignedIdentities/<cluster-assigned-managed-identity>"
    }
  }  
}
```

Depois de criar o recurso de cluster, edite 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. O cluster dedicado é cobrado depois de provisionado, independentemente da ingestão de dados, e é recomendável preparar a implantação para agilizar o link de provisionamento e workspaces para o cluster. Verifique o seguinte:

Uma lista do workspace inicial a ser vinculado ao cluster é identificada
Você tem permissões para assinatura destinadas ao cluster e a qualquer workspace a ser vinculado

Clique em Criar no menu Clusters dedicados do Log Analytics no portal do Azure. Detalhes serão solicitados, como o nome do cluster e o nível de compromisso.

Observação

O nível de compromisso mínimo com suporte na CLI atualmente é de 500. Use REST para configurar níveis de compromisso mais baixos com um mínimo de 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

Observação

O nível de compromisso mínimo com suporte no PowerShell atualmente é de 500. Use REST para configurar níveis de compromisso mais baixos com um mínimo de 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 *

Chamar

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>",
}

Resposta

Deve ser 202 (Aceito) e um cabeçalho.

O exemplo a seguir criará um cluster vazio do 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
  }
}

Arquivo de parâmetros

{
  "$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"
    }
  }
}

O exemplo a seguir criará um cluster vazio do 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')]"
      }
    }
  ]
}

Arquivo de parâmetros

{
  "$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"
    }
  }
}

Verificar o status do provisionamento do cluster

O provisionamento do cluster do Log Analytics leva algum tempo para ser concluído. Use um dos seguintes métodos para verificar a propriedade ProvisioningState. O valor é ProvisioningAccount durante o provisionamento e Succeeded quando concluído.

O portal fornecerá um status à medida que o cluster estiver sendo provisionado.

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"

Envie uma solicitação GET no recurso de cluster e observe o valor provisioningState. O valor é ProvisioningAccount durante o provisionamento e Succeeded quando concluído.

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>

Resposta

{
  "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"
}

O serviço de identidade gerenciada gera o GUID principalId quando você cria o cluster.

Vincular um workspace a um cluster

Observação

A vinculação de um workspace só pode ser executada após a conclusão do provisionamento de cluster do Log Analytics.
Vincular um workspace a um cluster envolve a sincronização de vários componentes de back-end e hidratação de cache, o que normalmente leva duas horas para ser concluído.
Ao vincular um workspace do Log Analytics, o plano de cobrança do workspace foi alterado para LACluster e você deve remover o SKU no modelo de workspace para evitar conflitos durante a implantação do workspace.
Além dos aspectos de cobrança regidos pelo plano de cluster, todas as configurações do workspace e os aspectos de consulta permanecem inalterados durante e após o link.

Você precisa ter permissões de 'gravação' no workspace e o recurso de cluster para a operação de vinculação do workspace:

No workspace: Microsoft.OperationalInsights/workspaces/write
No recurso de cluster: Microsoft.OperationalInsights/clusters/write

Quando um workspace do Log Analytics é vinculado a um cluster dedicado, novos dados enviados para o workspace são ingeridos para seu cluster dedicado, enquanto os dados ingeridos anteriormente permanecem no cluster do Log Analytics. A vinculação de um workspace não tem efeito sobre a operação do workspace, incluindo a ingestão e as experiências de consulta. O mecanismo de consulta do Log Analytics costura dados de clusters antigos e novos automaticamente, e os resultados das consultas são completos.

Os clusters são regionais e podem ser vinculados a até 1.000 workspaces localizados na mesma região do cluster. Um workspace não pode ser vinculado a um cluster mais de duas vezes por mês, para evitar a fragmentação de dados.

Os workspaces vinculados podem estar em assinaturas diferentes da assinatura em que o cluster está localizado. O workspace e o cluster poderão estar em locatários diferentes se o Azure Lighthouse for usado para mapeá-los para um único locatário.

Quando um cluster dedicado é configurado com uma chave gerenciada pelo cliente (CMK), os dados recém-ingeridos são criptografados com sua chave, enquanto os dados mais antigos permanecem criptografados com uma chave gerenciada pela Microsoft (MMK). A configuração de chave é abstraída pelo Log Analytics e a consulta entre criptografias de dados antigas e novas é executada 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 e clique em Workspaces vinculados para exibir todos os workspaces atualmente vinculados ao cluster dedicado. Clique em Vincular workspaces para vincular workspaces adicionais.

Observação

Use o valor do cluster para serviço name vinculado.

# 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

Observação

Use o valor do cluster para 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 *

Use a seguinte chamada REST para vincular a um cluster:

Enviar

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>"
    }
}

Resposta

202 (Aceito) e o cabeçalho.

Verificar o status de vinculação do workspace

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. Quando concluídos, os recursos do workspace incluirão a propriedade clusterResourceId em features e o cluster incluirá workspaces vinculados na seção associatedWorkspaces.

Quando um cluster é configurado com uma chave gerenciada pelo cliente, os dados ingeridos nos workspaces após a conclusão da operação de vinculação serão armazenados de maneira criptografada com sua chave.

Na página Visão geral do cluster dedicado, selecione Exibição JSON. A seção associatedWorkspaces lista os workspaces vinculados ao cluster.

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"

Chamar

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>

Response

{
  "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"
}

Alterar propriedades do cluster

Depois que você criar o recurso de cluster e ele estiver totalmente provisionado, edite as propriedades do cluster usando a CLI, o PowerShell ou a API REST. As propriedades que você poderá definir depois que o cluster for provisionado incluem:

keyVaultProperties – contém a chave no Azure Key Vault com os seguintes parâmetros: KeyVaultUri, KeyName, KeyVersion. Confira Atualizar cluster com detalhes do identificador de chave.
Identidade – a identidade usada para autenticar o Key Vault. Pode ser atribuída pelo sistema ou 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 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.

Importante

A atualização do cluster não deve incluir os detalhes do identificador da chave e da identidade na mesma operação. Se você precisar atualizar ambos, a atualização deverá ocorrer em duas operações consecutivas.

N/D

O exemplo a seguir atualiza o tipo de cobrança.

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}

O exemplo a seguir atualiza o tipo de cobrança.

Select-AzSubscription "cluster-subscription-id"

Update-AzOperationalInsightsCluster -ResourceGroupName "resource-group-name" -ClusterName "cluster-name" -BillingType "Workspaces"

O exemplo a seguir atualiza o tipo de cobrança.

Chamar

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"
}

O exemplo a seguir atualizará um cluster do Log Analytics para usar uma chave gerenciada pelo cliente.

@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
    }
  }
}

Arquivo de parâmetros

{
  "$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": ""
    }
  }
}

O exemplo a seguir atualizará um cluster do Log Analytics para usar uma chave gerenciada pelo cliente.

{
  "$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')]"
        }
      }
    }
  ]
}

Arquivo de parâmetros

{
  "$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": ""
    }
  }
}

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.

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"

Chamar

GET https://management.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.OperationalInsights/clusters?api-version=2022-10-01
Authorization: Bearer <token>

Response

{
  "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"
    }
  ]
}

Obter todos os clusters na assinatura

No menu Clusters dedicados do Log Analytics no portal do Azure, selecione o filtro Assinatura.

az account set --subscription "cluster-subscription-id"

az monitor log-analytics cluster list

Select-AzSubscription "cluster-subscription-id"

Get-AzOperationalInsightsCluster

Chamar

GET https://management.azure.com/subscriptions/<subscription-id>/providers/Microsoft.OperationalInsights/clusters?api-version=2022-10-01
Authorization: Bearer <token>

Resposta

A mesma 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, você pode atualizar o Nível de Compromisso adequadamente para otimizar o custo. O nível é especificado em unidades de Gigabytes (GB) e pode ter valores de 100, 200, 300, 400, 500, 1.000, 2.000, 5.000, 10.000, 25.000, 50.000 GB por dia. Você não precisa fornecer o corpo da solicitação REST completa, mas precisa incluir o 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 um nível de compromisso inferior até terminar o período de compromisso.

Selecione seu cluster no menu Clusters dedicados do Log Analytics no portal do Azure e clique em Alterar ao lado do Nível de compromisso

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

Chamar

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
  }
}

Desvincular um workspace do cluster

Você pode desvincular um workspace de um cluster a qualquer momento. O tipo de preço do workspace é alterado para por GB, os dados são ingeridos no cluster antes que a operação de desvinculação permaneça no cluster e novos dados para o workspace são ingeridos no Log Analytics.

Aviso

Desvincular um workspace não move os dados do workspace para fora do cluster. Todos os dados coletados para o workspace enquanto estiverem vinculados ao cluster, permanecerão no cluster durante o período de retenção definido no workspace e poderão ser acessados desde que o cluster não seja excluído.

As consultas não são afetadas quando o workspace está desvinculado e o serviço executa consultas entre clusters perfeitamente. Se o cluster tiver sido configurado com a Chave gerenciada pelo cliente (CMK), os dados ingeridos no workspace enquanto vinculados continuam criptografados e acessíveis com sua chave, enquanto a chave e as permissões para o Key Vault permanecerem.

Observação

Há um limite de duas operações de vinculação para um workspace específico dentro de um mês para impedir a distribuição de dados entre clusters. Entre em contato com o suporte se você atingir o limite.
Workspaces desvinculados são movidos para o tipo de preço Pagamento Conforme o Uso.

Use os seguintes comandos para desvincular um workspace do cluster:

Selecione seu cluster no menu Clusters dedicados do Log Analytics no portal do Azure e clique em Workspaces vinculados para exibir todos os workspaces atualmente vinculados ao cluster dedicado. Selecione os workspaces que você deseja desvincular e clique em Desvincular.

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

Excluir cluster

Você precisa ter permissões de gravação no recurso de cluster.

A operação de exclusão de cluster deve ser feita com cuidado, pois a operação não é recuperável. Todos os dados ingeridos no cluster por meio de workspaces vinculados são excluídos permanentemente.

A cobrança do cluster é interrompida quando excluída, independentemente do nível de compromisso de 31 dias definido no cluster.

Se você excluir um cluster que tenha workspaces vinculados, eles serão desvinculados automaticamente do cluster, os workspaces serão movidos para o tipo de preço pagamento conforme o uso e novos dados para workspaces serão ingeridos para clusters do Log Analytics. Você poderá consultar o workspace para o intervalo de tempo antes do link para o cluster e após a desvinculação, e o serviço executará consultas entre clusters perfeitamente.

Observação

Há um limite de sete clusters por assinatura e região, cinco ativos e dois excluídos nas últimas duas semanas.
O nome do cluster permanece reservado por duas semanas após a exclusão e não pode ser usado 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 e clique em Excluir.

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"

Use a seguinte chamada REST para excluir um cluster:

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>

Resposta

200 OK

Alterar o tipo de identidade gerenciada

O tipo de identidade pode ser alterado após a criação do cluster sem interrupção na ingestão ou consultas com as seguintes considerações:

Atualizando SystemAssigned para UserAssigned—Conceda UserAssign no Key Vault e atualize o tipo de identidade no cluster
Atualizando UserAssigned para SystemAssigned—Como a identidade gerenciada atribuída pelo sistema foi criada após a atualização do tipo de identidade do cluster com SystemAssigned, as etapas a seguir devem ser seguidas
1. Atualize o cluster e remova a chave—Defina keyVaultUri, keyName e keyVersion com o valor ""
2. Atualizar o tipo de identidade do cluster para SystemAssigned
3. Atualizar o Key Vault e conceder permissões à identidade
4. Atualizar chave no cluster

Limites e restrições

É possível criar um máximo de cinco clusters ativos em cada região e assinatura.
No máximo, sete clusters são permitidos por assinatura e região, cinco ativos e dois excluídos nas duas últimas semanas.
No máximo 1.000 workspaces do Log Analytics podem ser vinculados a um cluster.
Um máximo de duas operações de vinculação de workspace em um workspace específico é permitido no período de 30 dias.
No momento, não há suporte para mover o cluster para outro grupo de recursos ou assinatura.
Não há suporte para a movimentação de um cluster para outra região.
A atualização do cluster não deve incluir os detalhes do identificador da chave e da identidade na mesma operação. Se você precisar atualizar ambos, a atualização deverá ocorrer em duas operações consecutivas.
No momento, o Sistema de Proteção de Dados não está disponível na China.
Atualmente, o Lockbox não pode ser aplicado a tabelas com o plano Auxiliar.
A criptografia dupla é configurada 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.
- A configuração de criptografia dupla não pode ser alterada após a criação do cluster.
A exclusão de um workspace vinculado é permitida enquanto ele está vinculado ao cluster. Se você decidir recuperar o workspace durante o período de exclusão temporária, ele 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 um nível 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, ele pode ter sido excluído nas últimas duas semanas e ainda estar em processo de exclusão. O nome do cluster permanece reservado durante o período de exclusão e você não poderá criar outro cluster com esse nome.
Atualizações do cluster, enquanto ele estiver no estado de provisionamento ou de atualização, falharão.
Algumas operações são longas e podem demorar um pouco para serem concluídas. Elas incluem: criação de cluster, atualização de chave de cluster e exclusão de cluster. Você pode verificar o status da operação enviando solicitação GET ao cluster ou workspace e observar a resposta. Por exemplo, um workspace desvinculado não terá clusterResourceId em recursos.
Se você tentar vincular um workspace do Log Analytics que já esteja vinculado a outro cluster, ocorrerá uma falha na operação.

Mensagens de erro

Criação de Cluster

400 – O nome do cluster não é válido. O nome do cluster pode conter caracteres de a-z, A-Z, 0-9 e ter comprimento de 3-63.
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, 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 o valor da capacidade como 100, 200, 300, 400, 500, 1.000, 2.000, 5.000, 10.000, 25.000, 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 do 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. Pode ser que faltem permissões ou que a chave não exista. Verifique se você definiu a política de acesso e chave no Key Vault.
400 – A chave não pode ser recuperada. Key Vault precisa ser definido como exclusão reversível e proteção de limpeza. Confira a documentação do Key Vault
400 – A operação não pode ser executada agora. Espere pela conclusão da operação assíncrona e tente de novo.
400 – O cluster está em estado de exclusão. Espere pela conclusão da operação assíncrona e tente de novo.

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 ocorrer um conflito, significa que o cluster está em processo de exclusão.

Exclusão de cluster

409 – Não é possível excluir um cluster no estado de provisionamento. Espere pela conclusão da operação assíncrona e tente de novo.

Vincular workspace

404 – Workspace 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.

Desvincular workspace

404 – Workspace 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

Saiba mais sobre o Faturamento do cluster dedicado do Log Analytics.
Saiba mais sobre o design correto dos workspaces do Log Analytics.
Obtenha outros modelos de amostra para o Azure Monitor.

Compartilhar via

Criar e gerenciar um cluster dedicado nos Logs do Azure Monitor

Recursos avançados

Modelo de preço do cluster

Pré-requisitos

Permissões necessárias

Exemplos de modelo do Resource Manager

Referências de modelo

Criar um cluster dedicado

Verificar o status do provisionamento do cluster

Vincular um workspace a um cluster

Verificar o status de vinculação do workspace

Alterar propriedades do cluster

Obter todos os clusters no grupo de recursos

Obter todos os clusters na assinatura

Atualizar o nível de compromisso no cluster

Desvincular um workspace do cluster

Excluir cluster

Alterar o tipo de identidade gerenciada

Limites e restrições

Solução de problemas

Mensagens de erro

Criação de Cluster

Atualização do cluster

Obtenção de Cluster

Exclusão de cluster

Vincular workspace

Desvincular workspace

Próximas etapas

Comentários

Recursos adicionais