Een toegewezen cluster maken en beheren in Azure Monitor-logboeken

Artikel
09/29/2024

Een Log Analytics-werkruimte koppelen aan een toegewezen cluster in Azure Monitor biedt geavanceerde mogelijkheden en een hoger querygebruik. Clusters vereisen een minimale opnameverplichting van 100 GB per dag. U kunt werkruimten koppelen en ontkoppelen vanuit een toegewezen cluster zonder gegevensverlies of serviceonderbreking.

Geavanceerde mogelijkheden

Mogelijkheden waarvoor toegewezen clusters nodig zijn:

Door de klant beheerde sleutels - Clustergegevens versleutelen met behulp van sleutels die u opgeeft en beheert.
Lockbox - Beheer de toegangsaanvragen van microsoft-ondersteuningstechnicus voor uw gegevens.
Dubbele versleuteling : beveilig tegen een scenario waarbij een van de versleutelingsalgoritmen of sleutels kan worden aangetast. In dit geval blijft de extra versleutelingslaag uw gegevens beveiligen.
Optimalisatie tussen query's : query's voor meerdere werkruimten worden sneller uitgevoerd wanneer werkruimten zich in hetzelfde cluster bevinden.
Kostenoptimalisatie : koppel uw werkruimten in dezelfde regio aan het cluster om korting op de toezeggingslaag te krijgen voor alle werkruimten, zelfs voor werkruimten met een lage opname die in aanmerking komen voor korting op de toezeggingslaag.
Beschikbaarheidszones : bescherm uw gegevens tegen storingen in datacenters door te vertrouwen op datacenters op verschillende fysieke locaties, uitgerust met onafhankelijke voeding, koeling en netwerken. De fysieke scheiding in zones en onafhankelijke infrastructuur maakt een incident veel minder waarschijnlijk omdat de werkruimte kan vertrouwen op de resources van een van de zones. Azure Monitor-beschikbaarheidszones hebben betrekking op bredere onderdelen van de service en wanneer deze beschikbaar zijn in uw regio, wordt uw Azure Monitor-tolerantie automatisch uitgebreid. Azure Monitor maakt toegewezen clusters als beschikbaarheidszone ingeschakeld (isAvailabilityZonesEnabled: 'true') standaard in ondersteunde regio's. Beschikbaarheidszones voor toegewezen clusters worden momenteel niet ondersteund in alle regio's.
Opnemen vanuit Azure Event Hubs : hiermee kunt u gegevens rechtstreeks vanuit een Event Hub opnemen in een Log Analytics-werkruimte. Met een toegewezen cluster kunt u de mogelijkheid gebruiken bij opname van alle gekoppelde werkruimten, gecombineerd aan de toezeggingslaag.

Clusterprijsmodel

Log Analytics Dedicated Clusters maken gebruik van een prijsmodel voor de toezeggingscategorie van ten minste 100 GB/dag. Voor elk gebruik boven het laagniveau worden kosten in rekening gebracht op basis van het tarief per GB van die toezeggingslaag. Zie prijsinformatie voor Azure Monitor-logboeken voor prijsinformatie voor toegewezen clusters. De toezeggingslagen hebben een toezeggingsperiode van 31 dagen vanaf het moment dat een toezeggingslaag is geselecteerd.

Vereisten

Toegewezen clusters vereisen een minimale opnameverplichting van 100 GB per dag.
Wanneer u een toegewezen cluster maakt, kunt u deze niet een naam opgeven met dezelfde naam als een cluster dat de afgelopen twee weken is verwijderd.

Vereiste machtigingen

Als u clustergerelateerde acties wilt uitvoeren, hebt u deze machtigingen nodig:

Actie	Benodigde machtigingen of rol
Een toegewezen cluster maken	`Microsoft.Resources/deployments/*`en `Microsoft.OperationalInsights/clusters/write` machtigingen, zoals geleverd door de ingebouwde rol Log Analytics-inzender, bijvoorbeeld
Clustereigenschappen wijzigen	`Microsoft.OperationalInsights/clusters/write` machtigingen, zoals geleverd door de ingebouwde rol Log Analytics-inzender, bijvoorbeeld
Werkruimten koppelen aan een cluster	`Microsoft.OperationalInsights/clusters/write`, `Microsoft.OperationalInsights/workspaces/write`en `Microsoft.OperationalInsights/workspaces/linkedservices/write` machtigingen, zoals geleverd door de ingebouwde rol Log Analytics-inzender, bijvoorbeeld
Status van werkruimtekoppeling controleren	`Microsoft.OperationalInsights/workspaces/read` machtigingen voor de werkruimte, zoals geleverd door de ingebouwde rol log analytics-lezer, bijvoorbeeld
Clusters ophalen of de inrichtingsstatus van een cluster controleren	`Microsoft.OperationalInsights/clusters/read` machtigingen, zoals geleverd door de ingebouwde rol log analytics-lezer, bijvoorbeeld
Toezeggingslaag of billingType bijwerken in een cluster	`Microsoft.OperationalInsights/clusters/write` machtigingen, zoals geleverd door de ingebouwde rol Log Analytics-inzender, bijvoorbeeld
De vereiste machtigingen verlenen	De rol Eigenaar of Inzender met `/write` machtigingen of de ingebouwde rol Log Analytics-inzender, die machtigingen heeft `Microsoft.OperationalInsights/`
Een werkruimte ontkoppelen van een cluster	`Microsoft.OperationalInsights/workspaces/linkedServices/delete` machtigingen, zoals geleverd door de ingebouwde rol Log Analytics-inzender, bijvoorbeeld
Een toegewezen cluster verwijderen	`Microsoft.OperationalInsights/clusters/delete` machtigingen, zoals geleverd door de ingebouwde rol Log Analytics-inzender, bijvoorbeeld

Zie Toegang tot logboekgegevens en werkruimten beheren in Azure Monitor voor meer informatie over Log Analytics-machtigingen.

Voorbeelden van Resource Manager-sjablonen

Dit artikel bevat voorbeelden van ARM-sjablonen (Azure Resource Manager) voor het maken en configureren van Log Analytics-clusters in Azure Monitor. Elk voorbeeld bevat een sjabloonbestand en een parameterbestand met voorbeeldwaarden voor het sjabloon.

Notitie

Zie Azure Resource Manager-voorbeelden voor Azure Monitor voor een lijst met voorbeelden die beschikbaar zijn en richtlijnen voor het implementeren ervan in uw Azure-abonnement.

Sjabloonverwijzingen

Microsoft.OperationalInsights-clusters

Een toegewezen cluster maken

Geef de volgende eigenschappen op bij het maken van een nieuw toegewezen cluster:

ClusterName: moet uniek zijn voor de resourcegroep.
ResourceGroupName: gebruik een centrale IT-resourcegroep omdat veel teams in de organisatie meestal clusters delen. Voor meer ontwerpoverwegingen raadpleegt u De configuratie van een Log Analytics-werkruimte ontwerpen.
Location
SkuCapacity: U kunt de toezeggingslaag instellen op 100, 200, 300, 400, 500, 1000, 2000, 5000, 10000, 25000, 50000 GB per dag. De minimale toezeggingslaag die wordt ondersteund in CLI is momenteel 500. Gebruik REST om lagere toezeggingslagen te configureren met minimaal 100. Zie Toegewezen clusters voor meer informatie over clusterkosten.
Beheerde identiteit: clusters ondersteunen twee typen beheerde identiteiten:
- Door het systeem toegewezen beheerde identiteit: automatisch gegenereerd bij het maken van het cluster wanneer de identiteit type is ingesteld op SystemAssigned. Deze identiteit kan later worden gebruikt om opslagtoegang te verlenen tot uw Key Vault voor inpak- en uitpakbewerkingen.
  
  Identiteit in REST-aanroep van cluster
```
{
  "identity": {
    "type": "SystemAssigned"
    }
}
```
- Door de gebruiker toegewezen beheerde identiteit: hiermee kunt u een door de klant beheerde sleutel configureren bij het maken van een cluster wanneer u deze machtigingen in uw Key Vault verleent voordat het cluster wordt gemaakt.
  
  Identiteit in REST-aanroep van cluster
```
{
"identity": {
  "type": "UserAssigned",
    "userAssignedIdentities": {
      "subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.ManagedIdentity/UserAssignedIdentities/<cluster-assigned-managed-identity>"
    }
  }  
}
```

Nadat u de clusterresource hebt gemaakt, kunt u eigenschappen bewerken, zoals sku, *keyVaultProperties of billingType. Zie hieronder meer informatie.

Het verwijderen van verwijderde clusters duurt twee weken. U kunt maximaal zeven clusters per abonnement en regio hebben, vijf actieve clusters en twee die in de afgelopen twee weken zijn verwijderd.

Notitie

Het maken van een cluster omvat meerdere resources en bewerkingen die doorgaans binnen twee uur zijn voltooid. Toegewezen cluster wordt gefactureerd zodra het inrichten is ingericht, ongeacht de gegevensopname. Het wordt aanbevolen om de implementatie voor te bereiden om de inrichting en werkruimtenkoppeling naar het cluster te versnellen. Controleer het volgende:

Er wordt een lijst met de eerste werkruimte geïdentificeerd die aan het cluster moet worden gekoppeld
U hebt machtigingen voor het abonnement dat is bedoeld voor het cluster en elke werkruimte die moet worden gekoppeld

Klik op Maken in het menu Toegewezen Log Analytics-clusters in Azure Portal. U wordt gevraagd om details, zoals de naam van het cluster en de toezeggingslaag.

Notitie

De minimale toezeggingslaag die wordt ondersteund in CLI is momenteel 500. Gebruik REST om lagere toezeggingslagen te configureren met minimaal 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

Notitie

De minimale toezeggingslaag die wordt ondersteund in PowerShell is momenteel 500. Gebruik REST om lagere toezeggingslagen te configureren met minimaal 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 *

Roepen

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

Respons

Moet 202 (geaccepteerd) en een koptekst zijn.

In het volgende voorbeeld wordt een nieuw leeg Log Analytics-cluster gemaakt.

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

Parameterbestand

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

In het volgende voorbeeld wordt een nieuw leeg Log Analytics-cluster gemaakt.

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

Parameterbestand

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

De inrichtingsstatus van het cluster controleren

Het inrichten van het Log Analytics-cluster duurt even. Gebruik een van de volgende methoden om de eigenschap ProvisioningState te controleren. De waarde is ProvisioningAccount tijdens het inrichten en geslaagd wanneer deze is voltooid.

De portal geeft een status op wanneer het cluster wordt ingericht.

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"

Verzend een GET-aanvraag op de clusterresource en bekijk de provisioningState-waarde . De waarde is ProvisioningAccount tijdens het inrichten en geslaagd wanneer deze is voltooid.

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>

Respons

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

De beheerde identiteitsservice genereert de principalId-GUID wanneer u het cluster maakt.

Een werkruimte koppelen aan een cluster

Notitie

Het koppelen van een werkruimte kan pas worden uitgevoerd nadat het inrichten van het Log Analytics-cluster is voltooid.
Het koppelen van een werkruimte aan een cluster omvat het synchroniseren van meerdere back-endonderdelen en cachehydratering, die doorgaans binnen twee uur zijn voltooid.
Wanneer u een Log Analytics-werkruimte koppelt, wordt het factureringsplan voor de werkruimte gewijzigd in LACluster en moet u de SKU in de werkruimtesjabloon verwijderen om conflicten tijdens de implementatie van de werkruimte te voorkomen.
Behalve de factureringsaspecten die onder het clusterplan vallen, blijven alle werkruimteconfiguraties en queryaspecten ongewijzigd tijdens en na de koppeling.

U hebt schrijfmachtigingen nodig voor zowel de werkruimte als de clusterresource voor de koppelingsbewerking van de werkruimte:

In de werkruimte: Microsoft.OperationalInsights/workspaces/write
In de clusterresource: Microsoft.OperationalInsights/clusters/write

Zodra de Log Analytics-werkruimte is gekoppeld aan een toegewezen cluster, worden nieuwe gegevens die naar de werkruimte worden verzonden, opgenomen in uw toegewezen cluster, terwijl eerder opgenomen gegevens in het Log Analytics-cluster blijven. Het koppelen van een werkruimte heeft geen invloed op de werkruimtebewerking, inclusief opname- en query-ervaringen. De Log Analytics-query-engine steekt automatisch gegevens van oude en nieuwe clusters samen en de resultaten van query's zijn voltooid.

Clusters zijn regionaal en kunnen worden gekoppeld aan maximaal 1000 werkruimten in dezelfde regio als het cluster. Een werkruimte kan niet meer dan twee keer per maand worden gekoppeld aan een cluster om gegevensfragmentatie te voorkomen.

Gekoppelde werkruimten kunnen zich in verschillende abonnementen bevinden dan het abonnement waarin het cluster zich bevindt. De werkruimte en het cluster kunnen zich in verschillende tenants bevinden als Azure Lighthouse wordt gebruikt om beide toe te wijzen aan één tenant.

Wanneer een toegewezen cluster is geconfigureerd met een door de klant beheerde sleutel (CMK), worden de zojuist opgenomen gegevens versleuteld met uw sleutel, terwijl oudere gegevens versleuteld blijven met een door Microsoft beheerde sleutel (MMK). De sleutelconfiguratie wordt geabstraheerd door Log Analytics en de query op oude en nieuwe gegevensversleuteling wordt naadloos uitgevoerd.

Gebruik de volgende stappen om een werkruimte aan een cluster te koppelen. U kunt automatisering gebruiken om meerdere werkruimten te koppelen:

Selecteer uw cluster in het menu Toegewezen Log Analytics-clusters in Azure Portal en klik vervolgens op Gekoppelde werkruimten om alle werkruimten weer te geven die momenteel zijn gekoppeld aan het toegewezen cluster. Klik op Werkruimten koppelen om extra werkruimten te koppelen.

Notitie

Clusterwaarde gebruiken voor gekoppelde servicename.

# 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

Notitie

Gebruik de clusterwaarde voor 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 *

Gebruik de volgende REST-aanroep om een koppeling naar een cluster te maken:

Verzenden

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

Respons

202 (Geaccepteerd) en koptekst.

Status van werkruimtekoppeling controleren

Het kan tot 90 minuten duren voordat de koppelingsbewerking voor de werkruimte is voltooid. U kunt de status controleren op zowel de gekoppelde werkruimten als het cluster. Als dit is voltooid, bevatten clusterResourceId de werkruimtebronnen de eigenschap onder featuresen bevat het cluster gekoppelde werkruimten onder associatedWorkspaces de sectie.

Wanneer een cluster is geconfigureerd met een door de klant beheerde sleutel, worden gegevens die worden opgenomen in de werkruimten nadat de koppelingsbewerking is voltooid, versleuteld met uw sleutel opgeslagen.

Selecteer JSON-weergave op de pagina Overzicht voor uw toegewezen cluster. In associatedWorkspaces de sectie worden de werkruimten weergegeven die aan het cluster zijn gekoppeld.

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"

Roepen

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>

Respons

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

Clustereigenschappen wijzigen

Nadat u de clusterresource hebt gemaakt en deze volledig is ingericht, kunt u clustereigenschappen bewerken met behulp van CLI, PowerShell of REST API. Eigenschappen die u kunt instellen nadat het cluster is ingericht, zijn:

keyVaultProperties - Bevat de sleutel in Azure Key Vault met de volgende parameters: KeyVaultUri, KeyName, KeyVersion. Zie Cluster bijwerken met sleutel-id-gegevens.
Identiteit : de identiteit die wordt gebruikt voor verificatie bij uw Key Vault. Dit kan door het systeem toegewezen of door de gebruiker toegewezen zijn.
billingType : factureringsvermelding voor de clusterresource en de bijbehorende gegevens. Bevat de volgende waarden:
- Cluster (standaard): de kosten voor uw cluster worden toegeschreven aan de clusterresource.
- Werkruimten : de kosten voor uw cluster worden evenredig toegewezen aan de werkruimten in het cluster, waarbij de clusterresource een deel van het gebruik in rekening wordt gebracht als de totale opgenomen gegevens voor de dag onder de toezeggingslaag vallen. Zie Toegewezen Log Analytics-clusters voor meer informatie over het clusterprijsmodel.

Belangrijk

Bij het bijwerken van het cluster mogen niet zowel de id- als de sleutel-id-gegevens in dezelfde bewerking worden opgenomen. Als u beide wilt bijwerken, moet de update twee opeenvolgende bewerkingen hebben.

N.v.t.

In het volgende voorbeeld wordt het factureringstype bijgewerkt.

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}

In het volgende voorbeeld wordt het factureringstype bijgewerkt.

Select-AzSubscription "cluster-subscription-id"

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

In het volgende voorbeeld wordt het factureringstype bijgewerkt.

Roepen

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

In het volgende voorbeeld wordt een Log Analytics-cluster bijgewerkt om een door de klant beheerde sleutel te gebruiken.

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

Parameterbestand

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

In het volgende voorbeeld wordt een Log Analytics-cluster bijgewerkt om een door de klant beheerde sleutel te gebruiken.

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

Parameterbestand

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

Alle clusters in resourcegroep ophalen

Selecteer in het menu Toegewezen Log Analytics-clusters in Azure Portal het filter Resourcegroep .

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"

Roepen

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

Respons

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

Alle clusters in abonnement ophalen

Selecteer in het menu Toegewezen Log Analytics-clusters in Azure Portal het filter Abonnement .

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

az monitor log-analytics cluster list

Select-AzSubscription "cluster-subscription-id"

Get-AzOperationalInsightsCluster

Roepen

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

Respons

Hetzelfde als voor 'clusters in een resourcegroep', maar in het abonnementsbereik.

Toezeggingslaag bijwerken in cluster

Wanneer het gegevensvolume naar gekoppelde werkruimten na verloop van tijd verandert, kunt u het niveau van de toezeggingslaag op de juiste manier bijwerken om de kosten te optimaliseren. De laag wordt opgegeven in eenheden van Gigabytes (GB) en kan waarden hebben van 100, 200, 300, 400, 500, 1000, 2000, 5000, 10000, 25000, 50000 GB per dag. U hoeft niet de volledige rest-aanvraagtekst op te geven, maar u moet de SKU opnemen.

Tijdens de toezeggingsperiode kunt u overschakelen naar een hogere toezeggingslaag, waarmee de toezeggingsperiode van 31 dagen opnieuw wordt gestart. U kunt pas teruggaan naar betalen per gebruik of naar een lagere toezeggingslaag nadat u de toezeggingsperiode hebt voltooid.

Selecteer uw cluster in het menu toegewezen Log Analytics-clusters in Azure Portal en klik vervolgens op Wijzigen naast de toezeggingslaag

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

Roepen

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

Een werkruimte ontkoppelen van een cluster

U kunt een werkruimte op elk gewenst moment loskoppelen van een cluster. De prijscategorie voor werkruimten wordt gewijzigd in per GB, gegevens die zijn opgenomen in het cluster voordat de koppelingsbewerking in het cluster blijft bestaan en nieuwe gegevens voor werkruimte worden opgenomen in Log Analytics.

Waarschuwing

Als u een werkruimte ontkoppelt, worden werkruimtegegevens niet uit het cluster verplaatst. Alle gegevens die worden verzameld voor werkruimten terwijl deze zijn gekoppeld aan het cluster, blijven in het cluster voor de retentieperiode die is gedefinieerd in de werkruimte en toegankelijk zolang het cluster niet wordt verwijderd.

Query's worden niet beïnvloed wanneer de werkruimte niet is gekoppeld en service naadloos query's tussen clusters uitvoert. Als het cluster is geconfigureerd met door de klant beheerde sleutel (CMK), blijven gegevens die zijn opgenomen in de werkruimte terwijl ze zijn gekoppeld, versleuteld met uw sleutel en toegankelijk, terwijl uw sleutel en machtigingen voor Key Vault behouden blijven.

Notitie

Er geldt een limiet van twee koppelingsbewerkingen voor een specifieke werkruimte binnen een maand om gegevensdistributie tussen clusters te voorkomen. Neem contact op met de ondersteuning als u de limiet bereikt.
Niet-gekoppelde werkruimten worden verplaatst naar de prijscategorie Betalen per gebruik.

Gebruik de volgende opdrachten om een werkruimte los te koppelen van een cluster:

Selecteer uw cluster in het menu Toegewezen Log Analytics-clusters in Azure Portal en klik vervolgens op Gekoppelde werkruimten om alle werkruimten weer te geven die momenteel zijn gekoppeld aan het toegewezen cluster. Selecteer de werkruimten die u wilt ontkoppelen en klik op Ontkoppelen.

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

Cluster verwijderen

U moet schrijfmachtigingen hebben voor de clusterresource.

Het verwijderen van clusters moet voorzichtig worden uitgevoerd, omdat de bewerking niet kan worden hersteld. Alle opgenomen gegevens naar het cluster vanuit gekoppelde werkruimten worden definitief verwijderd.

De facturering van het cluster stopt wanneer het cluster wordt verwijderd, ongeacht de toezeggingslaag van 31 dagen die in het cluster is gedefinieerd.

Als u een cluster verwijdert dat gekoppelde werkruimten bevat, worden werkruimten automatisch ontkoppeld van het cluster, worden werkruimten verplaatst naar de prijscategorie Betalen per gebruik en worden nieuwe gegevens in werkruimten opgenomen in Log Analytics-clusters. U kunt een query uitvoeren op de werkruimte voor het tijdsbereik voordat deze is gekoppeld aan het cluster, en nadat de koppeling is ontkoppeld, en de service naadloos clusterquery's uitvoert.

Notitie

Er geldt een limiet van zeven clusters per abonnement en regio, vijf actief, plus twee die in de afgelopen twee weken zijn verwijderd.
De naam van het cluster blijft twee weken na verwijdering gereserveerd en kan niet worden gebruikt voor het maken van een nieuw cluster.

Gebruik de volgende opdrachten om een cluster te verwijderen:

Selecteer uw cluster in het menu toegewezen Log Analytics-clusters in Azure Portal en klik vervolgens op Verwijderen.

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"

Gebruik de volgende REST-aanroep om een cluster te verwijderen:

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>

Respons

200 OK

Type beheerde identiteit wijzigen

Identiteitstype kan worden gewijzigd nadat het cluster is gemaakt zonder onderbreking van opname of query's met de volgende overwegingen:

SystemAssigned bijwerken naar UserAssigned: userAssign-identiteit verlenen in Key Vault en vervolgens identiteitstype bijwerken in cluster
UserAssigned bijwerken naar SystemAssigned: aangezien door het systeem toegewezen beheerde identiteit is gemaakt na het bijwerken van het clusteridentiteitstype met SystemAssigned, moeten de volgende stappen worden gevolgd
1. Cluster bijwerken en de sleutel verwijderen: stel keyVaultUri, keyName en keyVersion in met de waarde ''
2. Clusteridentiteitstype bijwerken naar SystemAssigned
3. Key Vault bijwerken en machtigingen verlenen aan de identiteit
4. Sleutel bijwerken in cluster

Limieten en beperkingen

Er kunnen maximaal vijf actieve clusters worden gemaakt in elke regio en elk abonnement.
Maximaal zeven clusters toegestaan per abonnement en regio, vijf actief, plus twee clusters die in de afgelopen 2 weken zijn verwijderd.
Er kunnen maximaal 1000 Log Analytics-werkruimten aan een cluster worden gekoppeld.
Er zijn maximaal twee werkruimtekoppelingsbewerkingen voor bepaalde werkruimten toegestaan in een periode van 30 dagen.
Het verplaatsen van een cluster naar een andere resourcegroep of een ander abonnement wordt momenteel niet ondersteund.
Het verplaatsen van een cluster naar een andere regio wordt niet ondersteund.
Bij het bijwerken van het cluster mogen niet zowel identiteits- als sleutel-id-gegevens in dezelfde bewerking worden opgenomen. Als u beide moet bijwerken, moet de update zich in twee opeenvolgende bewerkingen bevinden.
Lockbox is momenteel niet beschikbaar in China.
Lockbox kan momenteel niet worden toegepast op tabellen met het hulpplan.
Dubbele versleuteling wordt automatisch geconfigureerd voor clusters die zijn gemaakt vanaf oktober 2020 in ondersteunde regio's. U kunt controleren of uw cluster is geconfigureerd voor dubbele versleuteling door een GET-aanvraag op het cluster te verzenden en te observeren dat de isDoubleEncryptionEnabled waarde voor clusters is waarvoor dubbele versleuteling is true ingeschakeld.
- Als u een cluster maakt en de foutmelding 'regionaam biedt geen ondersteuning voor dubbele versleuteling voor clusters', kunt u het cluster nog steeds zonder dubbele versleuteling maken door de hoofdtekst van de REST-aanvraag toe te voegen "properties": {"isDoubleEncryptionEnabled": false} .
- De instelling voor dubbele versleuteling kan niet worden gewijzigd nadat het cluster is gemaakt.
Het verwijderen van een werkruimte is toegestaan terwijl deze is gekoppeld aan het cluster. Als u besluit om de werkruimte te herstellen tijdens de periode voor voorlopig verwijderen, keert de werkruimte terug naar de vorige status en blijft deze gekoppeld aan het cluster.
Tijdens de toezeggingsperiode kunt u overschakelen naar een hogere toezeggingslaag, waarmee de toezeggingsperiode van 31 dagen opnieuw wordt gestart. U kunt pas teruggaan naar betalen per gebruik of naar een lagere toezeggingslaag nadat u de toezeggingsperiode hebt voltooid.

Probleemoplossing

Als er een conflictfout optreedt bij het maken van een cluster, is het mogelijk in de afgelopen 2 weken en in het verwijderingsproces verwijderd. De clusternaam blijft gereserveerd gedurende de verwijderingsperiode van 2 weken en u kunt geen nieuw cluster met die naam maken.
Als u uw cluster bijwerkt terwijl het cluster de inrichtings- of updatestatus heeft, mislukt de update.
Sommige bewerkingen zijn lang en kunnen enige tijd duren. Dit zijn het maken van clusters, het bijwerken van de clustersleutel en het verwijderen van clusters. U kunt de bewerkingsstatus controleren door GET-aanvraag naar het cluster of de werkruimte te verzenden en het antwoord te bekijken. Niet-gekoppelde werkruimte heeft bijvoorbeeld niet de clusterResourceId onder functies.
Als u probeert een Log Analytics-werkruimte te koppelen die al is gekoppeld aan een ander cluster, mislukt de bewerking.

Foutberichten

Cluster maken

400--Clusternaam is niet geldig. De clusternaam kan tekens a-z, A-Z, 0-9 en lengte van 3-63 bevatten.
400- De hoofdtekst van de aanvraag is null of heeft een ongeldige indeling.
400--SKU-naam is ongeldig. Stel de SKU-naam in op capacityReservation.
400-Capaciteit is opgegeven, maar de SKU is geen capacityReservation. Stel de SKU-naam in op capacityReservation.
400- Ontbrekende capaciteit in SKU. Stel de capaciteitswaarde in op 100, 200, 300, 400, 500, 1000, 2000, 5000, 10000, 25000, 50000 GB per dag.
400- Capaciteit is 30 dagen vergrendeld. Het verlagen van de capaciteit is 30 dagen na de update toegestaan.
400- Er is geen SKU ingesteld. Stel de SKU-naam in op capacityReservation en Capaciteitswaarde op 100, 200, 300, 400, 500, 1000, 2000, 5000, 10000, 250000, 50000 GB per dag.
400- Bewerking kan nu niet worden uitgevoerd. Asynchrone bewerking heeft een andere status dan geslaagd. Het cluster moet de bewerking voltooien voordat een updatebewerking wordt uitgevoerd.

Clusterupdate

400--Cluster heeft de status Verwijderen. Asynchrone bewerking wordt uitgevoerd. Het cluster moet de bewerking voltooien voordat een updatebewerking wordt uitgevoerd.
400--KeyVaultProperties is niet leeg, maar heeft een slechte indeling. Zie de update van de sleutel-id.
400- Kan de sleutel niet valideren in Key Vault. Dit kan worden veroorzaakt door een gebrek aan machtigingen of als de sleutel niet bestaat. Controleer of u sleutel- en toegangsbeleid instelt in Key Vault.
400--Sleutel kan niet worden hersteld. Key Vault moet zijn ingesteld op Voorlopig verwijderen en Beveiliging opschonen. Raadpleeg de Key Vault-documentatie
400- Bewerking kan nu niet worden uitgevoerd. Wacht tot de Async-bewerking is voltooid en probeer het opnieuw.
400--Cluster heeft de status Verwijderen. Wacht tot de Async-bewerking is voltooid en probeer het opnieuw.

Cluster ophalen

404--Cluster niet gevonden, het cluster is mogelijk verwijderd. Als u probeert een cluster met die naam te maken en conflict op te halen, wordt het cluster verwijderd.

Cluster verwijderen

409: kan een cluster niet verwijderen tijdens de inrichtingsstatus. Wacht tot de Async-bewerking is voltooid en probeer het opnieuw.

Werkruimtekoppeling

404- Werkruimte niet gevonden. De opgegeven werkruimte bestaat niet of is verwijderd.
409:-Workspace link or unlink operation in process.
400- Cluster niet gevonden, het cluster dat u hebt opgegeven, bestaat niet of is verwijderd.

Werkruimte ontkoppelen

404- Werkruimte niet gevonden. De opgegeven werkruimte bestaat niet of is verwijderd.
409:-Workspace link or unlink operation in process.

Volgende stappen

Meer informatie over facturering van toegewezen Log Analytics-clusters.
Meer informatie over het juiste ontwerp van Log Analytics-werkruimten.
Download andere voorbeeldsjablonen voor Azure Monitor.

Delen via

Een toegewezen cluster maken en beheren in Azure Monitor-logboeken

Geavanceerde mogelijkheden

Clusterprijsmodel

Vereisten

Vereiste machtigingen

Voorbeelden van Resource Manager-sjablonen

Sjabloonverwijzingen

Een toegewezen cluster maken

De inrichtingsstatus van het cluster controleren

Een werkruimte koppelen aan een cluster

Status van werkruimtekoppeling controleren

Clustereigenschappen wijzigen

Alle clusters in resourcegroep ophalen

Alle clusters in abonnement ophalen

Toezeggingslaag bijwerken in cluster

Een werkruimte ontkoppelen van een cluster

Cluster verwijderen

Type beheerde identiteit wijzigen

Limieten en beperkingen

Probleemoplossing

Foutberichten

Cluster maken

Clusterupdate

Cluster ophalen

Cluster verwijderen

Werkruimtekoppeling

Werkruimte ontkoppelen

Volgende stappen

Feedback

Aanvullende resources