Membuat dan mengelola kluster khusus di log Azure Monitor

Kluster khusus dalam Azure Monitor menyediakan kemampuan keamanan dan kontrol tingkat lanjut, dan pengoptimalan biaya. Anda dapat menghubungkan ruang kerja baru atau yang sudah ada ke kluster khusus tanpa mengganggu proses penyerapan dan kueri.

Kemampuan tingkat lanjut

Azure Monitor Logs adalah layanan berskala cloud yang dikelola sepenuhnya dan dirancang untuk secara otomatis menangani pemasukan data, pengindeksan, dan pencarian di seluruh beban kerja yang besar dan berfluktuasi. Mesin yang mendasarnya menggunakan mekanisme bawaan yang mengoptimalkan eksekusi kueri, mendistribusikan pemrosesan, dan secara otomatis menskalakan sumber daya dengan mulus tanpa intervensi pengguna. Layanan berkinerja tinggi ini adalah kerangka kerja tempat ruang kerja Log Analytics default, atau kluster yang dibagi, dibangun. Kemampuan tambahan berikut tidak terkunci saat Anda membuat kluster khusus:

Kemampuan	Deskripsi
Kunci yang dikelola pelanggan	Enkripsi data dengan menggunakan kunci yang Anda berikan dan kontrol.
Kotak kunci	Mengontrol akses teknisi dukungan Microsoft ke data Anda.
Enkripsi ganda	Lapisan enkripsi tambahan untuk data Anda.
Pengoptimalan lintas ruang kerja	Kueri lintas ruang kerja berjalan lebih cepat saat berada di kluster yang sama.
Pengoptimalan biaya	Tautkan ruang kerja di wilayah yang sama ke kluster, dan nikmati diskon tingkat komitmen untuk data yang diserap dari semua ruang kerja yang ditautkan.
Zona ketersediaan	Lindungi data Anda dengan pusat data di lokasi fisik yang berbeda, dilengkapi dengan daya, pendinginan, dan jaringan independen. Azure Monitor zona ketersediaan memperluas ketahanan Azure Monitor Anda secara otomatis. Azure Monitor memungkinkan kluster khusus untuk zona ketersediaan (`isAvailabilityZonesEnabled`: 'true') secara default di semua wilayah yang mendukung zona ketersediaan. Wilayah yang didukung oleh zona ketersediaan mencakup dukungan untuk kluster khusus dan kluster bersama.
Ingest dari Azure Event Hubs	Memungkinkan Anda menyerap data langsung dari Azure Event Hubs ke ruang kerja Log Analytics.
Memantau ruang kerja tertaut sebagai gugus	Pantau performa kluster melalui Azure Monitor, termasuk volume penyerapan, performa kueri, dan pemanfaatan komitmen kapasitas di semua ruang kerja yang ditautkan.

Catatan

Kluster yang didedikasikan bukanlah metode umum untuk mempercepat semua kueri. Seperti halnya sistem analitik besar apa pun, menjalankan kueri di seluruh himpunan data yang sangat besar memerlukan sumber daya komputasi tambahan dan dapat memengaruhi performa kueri. Untuk performa kueri yang lebih baik di luar pengoptimalan lintas ruang kerja kluster khusus, optimalkan kueri Anda. Strategi ini sangat efektif dengan himpunan data besar dan saat mengkueri dalam rentang waktu yang lama.

Model harga klaster

Log Analytics kluster khusus menggunakan model harga tingkat komitmen mulai dari 100 GB per hari. Penyerapan yang melebihi tingkat komitmen dibebankan berdasarkan tarif per GB. Anda dapat meningkatkan tingkat komitmen kapan saja, tetapi memiliki periode komitmen 31 hari sebelum dapat dikurangi. Lihat detail harga Azure Monitor Logs untuk informasi tentang tingkatan komitmen.

Jenis penagihan kluster memiliki dua kemungkinan nilai:

Kluster (default) - Biaya untuk kluster Anda diatribusikan ke sumber daya kluster.
Ruang kerja - Biaya untuk kluster Anda diatribusikan secara proporsional ke ruang kerja di kluster, dengan sumber daya kluster ditagih sebagian dari penggunaan jika total data yang diserap untuk hari itu berada di bawah tingkat komitmen. Lihat Log Analytics Klaster Khusus untuk mempelajari selengkapnya tentang model harga kluster.

Izin yang diperlukan

Untuk melakukan tindakan terkait kluster, Anda memerlukan izin ini:

Perbuatan	Izin atau peran yang diperlukan
Membuat kluster khusus	izin `Microsoft.Resources/deployments/*` dan `Microsoft.OperationalInsights/clusters/write`, seperti yang disediakan oleh peran bawaan kontributor Log Analytics, misalnya
Ubah properti kluster	izin `Microsoft.OperationalInsights/clusters/write`, seperti yang disediakan oleh peran bawaan Log Analytics Contributor, misalnya
Menautkan ruang kerja ke kluster	izin `Microsoft.OperationalInsights/clusters/write`, `Microsoft.OperationalInsights/workspaces/write`, dan `Microsoft.OperationalInsights/workspaces/linkedservices/write`, sebagaimana disediakan oleh peran bawaan kontributor Log Analytics, misalnya
Periksa status tautan ruang kerja	`Microsoft.OperationalInsights/workspaces/read` izin untuk ruang kerja, yang disediakan oleh peran bawaan Pembaca Log Analytics, misalnya
Mengambil kluster atau memeriksa status penyediaan kluster	izin `Microsoft.OperationalInsights/clusters/read`, seperti yang disediakan oleh peran bawaan pembaca Log Analytics, misalnya
Memperbarui tingkat komitmen atau jenis penagihan dalam cluster	izin `Microsoft.OperationalInsights/clusters/write`, seperti yang disediakan oleh peran bawaan Log Analytics Contributor, misalnya
Memberikan izin yang diperlukan	Peran Pemilik atau Kontributor yang memiliki izin `/write`, atau peran bawaan Log Analytics Kontributor, yang memiliki izin `Microsoft.OperationalInsights/`
Putuskan hubungan ruang kerja dari kluster	izin `Microsoft.OperationalInsights/workspaces/linkedServices/delete`, seperti yang disediakan oleh peran bawaan Log Analytics Contributor, misalnya
Menghapus kluster khusus	izin `Microsoft.OperationalInsights/clusters/delete`, seperti yang disediakan oleh peran bawaan Log Analytics Contributor, misalnya

Untuk informasi selengkapnya tentang izin Log Analytics, lihat Kelola akses ke data log dan ruang kerja di Azure Monitor.

sampel templat Resource Manager

Artikel ini menyertakan contoh templat Azure Resource Manager (ARM) untuk membuat dan mengonfigurasi kluster Log Analytics di Azure Monitor. Setiap sampel menyertakan file templat dan file parameter dengan sampel nilai yang akan disediakan untuk templat.

Catatan

Lihat sampel Azure Resource Manager untuk Azure Monitor untuk daftar sampel yang tersedia dan panduan tentang menyebarkannya di langganan Azure Anda.

Referensi templat

Kluster Microsoft OperationalInsights

Persiapan

Penagihan pada tingkat komitmen kluster dimulai segera setelah Anda membuat kluster, terlepas dari pemasukan data. Siapkan item berikut ini sebelum Anda memulai:

Langganan untuk membuat kluster.
Daftar ruang kerja yang ingin Anda tautkan ke kluster. Ruang kerja ini harus berada di wilayah yang sama dengan kluster.
Keputusan tentang jenis penagihan dan atribusi, apakah akan diatur ke kluster (default) atau ke ruang kerja yang ditautkan secara proporsional.
Verifikasi izin Anda untuk membuat kluster dan menautkan ruang kerja.

Catatan

Pembuatan kluster dan penautan ruang kerja adalah operasi asinkron yang dapat memakan waktu beberapa jam untuk diselesaikan.
Menautkan atau membatalkan tautan ruang kerja dari kluster tidak berpengaruh pada penyerapan atau kueri selama operasi.

Membuat kluster khusus

Berikan properti berikut saat membuat kluster khusus baru:

ClusterName: Harus unik untuk grup sumber daya.
ResourceGroupName: Gunakan grup sumber daya IT pusat karena banyak tim di organisasi biasanya berbagi kluster. Untuk pertimbangan desain lainnya, tinjau Desain konfigurasi ruang kerja Log Analytics.
Tempat
SkuCapacity: Tingkat komitmen yang valid adalah 100, 200, 300, 400, 500, 1000, 2000, 5000, 10000, 25000, atau 50000 GB per hari. Tingkat komitmen minimum yang didukung dalam CLI dan templat penyebaran adalah 500 GB. Gunakan REST API untuk mengonfigurasi tingkat komitmen yang lebih rendah dari 500 GB. Untuk informasi selengkapnya tentang biaya kluster, lihat Kluster khusus.
Identitas terkelola: Kluster mendukung dua jenis identitas terkelola:
- Identitas terkelola yang ditetapkan sistem - Dihasilkan secara otomatis dengan pembuatan kluster saat identitas type diatur ke "SystemAssigned". Gunakan identitas ini untuk memberikan akses penyimpanan ke Key Vault Anda untuk operasi membungkus dan membuka bungkus.
  
  Identitas dalam Panggilan REST Klaster
```
{
  "identity": {
    "type": "SystemAssigned"
    }
}
```
- Identitas terkelola yang ditetapkan pengguna - Dengan menggunakan identitas ini, Anda dapat mengonfigurasi kunci yang dikelola oleh pelanggan saat pembuatan kluster, ketika memberikan izinnya di Key Vault Anda sebelum pembuatan kluster.
  
  Identitas dalam Panggilan REST Klaster
```
{
"identity": {
  "type": "UserAssigned",
    "userAssignedIdentities": {
      "subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.ManagedIdentity/UserAssignedIdentities/<cluster-assigned-managed-identity>"
    }
  }  
}
```

Setelah membuat sumber daya kluster, Anda dapat mengedit properti seperti sku, keyVaultProperties, atau billingType. Lihat lebih detail di bawah ini.

Kluster yang dihapus membutuhkan waktu dua minggu untuk dihapus sepenuhnya. Anda dapat memiliki hingga tujuh kluster per langganan dan wilayah - lima aktif, dan dua dihapus dalam dua minggu terakhir.

Catatan

Membuat kluster melibatkan beberapa sumber daya dan operasi biasanya selesai dalam dua jam. Kluster khusus ditagih setelah disediakan terlepas dari penyerapan data. Siapkan penyebaran untuk mempercepat provisi dan penghubungan ruang kerja ke kluster. Verifikasi hal berikut:

Daftar ruang kerja awal yang akan ditautkan ke kluster diidentifikasi
Anda memiliki izin terhadap langganan yang ditujukan untuk kluster dan ruang kerja apa pun yang bisa dihubungkan

Pilih Buat di menu Log Analytics kluster khusus di portal Azure. Anda dimintai detail seperti nama kluster dan tingkat komitmen.

Catatan

Tingkat komitmen minimum yang didukung di CLI saat ini adalah 500 GB. Gunakan REST untuk mengonfigurasi tingkat komitmen yang lebih rendah dengan minimal 100 GB.

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

Catatan

Tingkat komitmen minimum yang didukung di PowerShell saat ini adalah 500 GB. Gunakan REST untuk mengonfigurasi tingkat komitmen yang lebih rendah dengan minimal 100 GB.

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 *

Panggil

PUT https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/clusters/<cluster-name>?api-version=2023-09-01
Authorization: Bearer <token>
Content-type: application/json

{
  "identity": {
    "type": "systemAssigned"
    },
  "sku": {
    "name": "capacityReservation",
    "Capacity": 100
    },
  "properties": {
    "billingType": "Cluster",
    },
  "location": "<region>",
}

Jawaban

Seharusnya kode status 202 (Diterima) dan header.

Sampel berikut membuat kluster Log Analytics kosong baru dengan tingkat komitmen 500 GB.

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

File parameter

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "clusterName": {
      "value": "MyCluster"
    },
    "CommitmentTier": {
      "value": 500
    },
    "billingType": {
      "value": "Cluster"
    }
  }
}

Sampel berikut membuat kluster Log Analytics kosong baru dengan tingkat komitmen 500 GB.

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

File parameter

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "clusterName": {
      "value": "MyCluster"
    },
    "CommitmentTier": {
      "value": 500
    },
    "billingType": {
      "value": "Cluster"
    }
  }
}

Periksa status penyediaan kluster

Penyediaan kluster Log Analytics membutuhkan waktu cukup lama untuk diselesaikan. Gunakan salah satu metode berikut untuk memeriksa properti ProvisioningState. Nilainya adalah Membuat saat provisi dan Berhasil saat selesai.

Portal menyediakan status saat kluster sedang diprovisikan.

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"

Kirim permintaan GET pada sumber daya kluster dan periksa nilai provisioningState . Nilainya adalah Membuat saat provisi dan Berhasil saat selesai.

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

Jawaban

{
  "identity": {
    "type": "SystemAssigned",
    "tenantId": "tenant-id",
    "principalId": "principal-id"
  },
  "sku": {
    "name": "capacityreservation",
    "capacity": 100
  },
  "properties": {
    "provisioningState": "Creating",
    "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"
}

Layanan identitas terkelola menghasilkan principalId GUID saat Anda membuat kluster.

Tautkan ruang kerja ke kluster

Catatan

Hanya hubungkan ruang kerja setelah portal selesai menyediakan kluster Log Analytics.
Menautkan ruang kerja ke kluster menyinkronkan beberapa komponen backend dan hidrasi cache, yang biasanya selesai dalam dua jam.
Saat Anda menautkan ruang kerja Log Analytics, paket penagihan ruang kerja berubah menjadi LACluster. Hapus SKU di templat ruang kerja untuk mencegah konflik selama penyebaran ruang kerja.
Selain aspek penagihan yang diatur oleh paket kluster, semua konfigurasi ruang kerja dan aspek kueri tetap tidak berubah selama dan setelah tautan.

Anda memerlukan izin 'tulis' ke ruang kerja dan sumber daya kluster untuk operasi tautan ruang kerja:

Di ruang kerja: Microsoft.OperationalInsights/workspaces/write
Dalam sumber daya kluster: Microsoft.OperationalInsights/clusters/write

Setelah Anda menautkan ruang kerja Log Analytics ke kluster khusus, data baru yang Anda kirim ke ruang kerja masuk ke kluster khusus Anda, sementara data yang sebelumnya diserap tetap berada di kluster Log Analytics. Menautkan ruang kerja tidak memengaruhi operasi ruang kerja, termasuk pengalaman pengambilan data dan kueri. Mesin kueri Log Analytics secara otomatis menjahit data dari kluster lama dan baru, sehingga hasil kueri selesai.

Kluster bersifat regional dan dapat menautkan hingga 1.000 ruang kerja yang terletak di wilayah yang sama dengan kluster. Untuk mencegah fragmentasi data, Anda tidak dapat menautkan ruang kerja ke kluster lebih dari dua kali sebulan.

Ruang kerja tertaut dapat berada di langganan yang berbeda dari langganan tempat kluster berada. Jika Anda menggunakan Azure Lighthouse untuk memetakan keduanya ke satu penyewa, ruang kerja dan kluster dapat berada di penyewa yang berbeda.

Saat Anda mengonfigurasi kluster khusus dengan kunci yang dikelola pelanggan (CMK), data yang baru diserap dienkripsi dengan kunci Anda, sementara data lama tetap dienkripsi dengan kunci yang dikelola Microsoft (MMK). Log Analytics menyederhanakan konfigurasi utama, dan melakukan kueri di seluruh enkripsi data lama dan baru dengan mulus.

Gunakan langkah-langkah berikut untuk menautkan ruang kerja ke kluster. Anda dapat menggunakan otomatisasi untuk menautkan beberapa ruang kerja:

Pilih kluster Anda dari menu kluster khusus Log Analytics di portal Azure. Pilih Ruang kerja tertaut untuk melihat semua ruang kerja yang saat ini ditautkan ke kluster khusus. Pilih Tautkan ruang kerja untuk menautkan ruang kerja tambahan.

Catatan

Gunakan nilai kluster untuk name layanan terkait.

# 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

Catatan

Gunakan nilai kluster untuk 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 *

Gunakan panggilan REST berikut untuk menautkan ke kluster:

Kirim

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

Jawaban

202 (Diterima) dan header.

Periksa status tautan ruang kerja

Operasi tautan ruang kerja dapat memakan waktu hingga 90 menit untuk diselesaikan. Anda dapat memeriksa status pada ruang kerja yang ditautkan dan kluster. Setelah selesai, sumber daya ruang kerja menyertakan properti clusterResourceId di bawah features, dan kluster menyertakan ruang kerja tertaut di bawah bagian associatedWorkspaces.

Saat Anda mengonfigurasi kluster dengan kunci yang dikelola oleh pelanggan, data yang dimasukkan dienkripsi menggunakan kunci Anda ke dalam ruang kerja setelah operasi tautan selesai.

Pada halaman Gambaran Umum untuk kluster khusus Anda, pilih Tampilan JSON. Bagian ini associatedWorkspaces mencantumkan ruang kerja yang ditautkan ke kluster.

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"

Panggil

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>

Jawaban

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

Ubah properti kluster

Setelah membuat sumber daya kluster dan sepenuhnya tersedia, Anda dapat mengedit properti kluster dengan menggunakan CLI, PowerShell, atau REST API. Anda dapat mengatur properti berikut setelah kluster disediakan:

keyVaultProperties - Berisi kunci dalam Azure Key Vault dengan parameter berikut: KeyVaultUri, KeyName, KeyVersion. Lihat Memperbarui kluster khusus dengan detail Pengidentifikasi kunci.
Identity - Identitas yang digunakan untuk mengautentikasi ke Key Vault Anda. Identitas ini dapat ditetapkan sistem atau ditetapkan pengguna.
billingType - Atribusi penagihan untuk sumber daya kluster dan datanya. Menyertakan nilai berikut:
- Kluster (default) - Biaya untuk kluster Anda diatribusikan ke sumber daya kluster.
- Workspaces - Biaya untuk kluster Anda diatribusikan secara proporsional ke Workspaces dalam Kluster, dengan sumber daya kluster ditagih sebagian dari penggunaan jika total data yang diserap untuk hari itu berada di bawah tingkat komitmen. Lihat Log Analytics Klaster Khusus untuk mempelajari selengkapnya tentang model harga kluster.

Penting

Pembaruan kluster tunggal tidak boleh menyertakan detail identitas dan pengidentifikasi kunci dalam operasi yang sama. Jika Anda perlu memperbarui keduanya, buat pembaruan dalam dua operasi berturut-turut.

Tidak Berlaku

Contoh berikut memperbarui jenis penagihan.

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}

Contoh berikut memperbarui jenis penagihan.

Select-AzSubscription "cluster-subscription-id"

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

Contoh berikut memperbarui jenis penagihan.

Panggil

PATCH https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/clusters/<cluster-name>?api-version=2023-09-01
Authorization: Bearer <token>
Content-type: application/json

{
  "properties": {
    "billingType": "Workspaces"
    },
    "location": "region"
}

Sampel berikut memperbarui kluster Log Analytics untuk menggunakan kunci yang dikelola pelanggan.

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

File parameter

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-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": ""
    }
  }
}

Sampel berikut memperbarui kluster Log Analytics untuk menggunakan kunci yang dikelola pelanggan.

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

File parameter

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-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": ""
    }
  }
}

Dapatkan semua kluster yang ada di grup sumber daya

Dari menu Log Analytics klaster khusus di portal Azure, pilih filter grup Resource.

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"

Panggil

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

Jawaban

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

Dapatkan semua kluster di langganan

Dari menu Log Analytics klaster khusus di portal Azure, pilih filter Subscription.

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

az monitor log-analytics cluster list

Select-AzSubscription "cluster-subscription-id"

Get-AzOperationalInsightsCluster

Panggil

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

Jawaban

Sama seperti untuk 'kluster dalam grup sumber daya', tetapi dalam cakupan langganan.

Perbarui tingkat komitmen di kluster

Jika volume data ke ruang kerja tertaut berubah seiring waktu, perbarui Tingkat Komitmen untuk mengoptimalkan biaya. Tentukan tingkat dalam satuan gigabyte (GB). Tingkatan dapat memiliki nilai 100, 200, 300, 400, 500, 1.000, 2.000, 5.000, 10.000, 25.000, atau 50.000 GB per hari. Anda tidak perlu menyediakan isi permintaan REST lengkap, tetapi Anda harus menyertakan SKU.

Selama periode komitmen, Anda dapat berubah ke tingkat komitmen yang lebih tinggi, yang memulai ulang periode komitmen 31 hari. Anda tidak dapat pindah kembali ke prabayar atau ke tingkat komitmen yang lebih rendah sampai Anda menyelesaikan periode komitmen.

Pilih kluster Anda dari menu kluster khusus Log Analytics di portal Azure. Pilih Ubah di samping Tingkat komitmen.

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

Panggil

PATCH https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/clusters/<cluster-name>?api-version=2023-09-01
Authorization: Bearer <token>
Content-type: application/json

{
  "sku": {
    "name": "capacityReservation",
    "Capacity": 2000
  }
}

Putuskan hubungan ruang kerja dari kluster

Peringatan

Membatalkan tautan ruang kerja tidak memindahkan data ruang kerja dari kluster. Setiap data yang dikumpulkan untuk ruang kerja saat ditautkan ke kluster khusus, tetap berada di kluster untuk periode retensi yang ditentukan oleh ruang kerja, dan dapat diakses selama kluster tidak dihapus.

Anda dapat melepaskan tautan ruang kerja dari kluster kapan saja. Inilah yang terjadi ketika ruang kerja dilepas tautannya

Tingkat harga ruang kerja diubah menjadi per GB
Data yang diserap ke kluster sebelum operasi batalkan tautan tetap berada di kluster
Data baru yang dikirim ke ruang kerja akan diserap ke ruang kerja, bukan kluster khusus
Kueri tidak terpengaruh saat ruang kerja tidak ditautkan - layanan Log Analytics melakukan kueri lintas kluster dengan mulus
Jika kluster khusus dikonfigurasi dengan kunci yang dikelola pelanggan (CMK), data yang diserap ke ruang kerja saat ditautkan tetap dienkripsi dengan kunci Anda di kluster khusus dan dapat diakses selama kunci dan izin Anda untuk Key Vault tetap ada

Catatan

Untuk mencegah distribusi data di seluruh kluster, Anda hanya dapat melakukan dua operasi tautan untuk ruang kerja tertentu dalam waktu satu bulan. Hubungi dukungan jika Anda mencapai batas.
Ruang kerja yang tidak ditautkan berpindah ke level penetapan harga berdasarkan penggunaan.

Gunakan perintah berikut untuk memutuskan tautan ruang kerja dari cluster:

Pilih kluster dari menu kluster khusus Log Analytics di portal Azure. Pilih Ruang kerja tertaut untuk melihat semua ruang kerja yang saat ini ditautkan ke kluster khusus. Pilih ruang kerja apa pun yang ingin Anda batalkan tautannya dan pilih Batalkan tautan.

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

Menghapus klaster

Anda memerlukan izin tulis pada sumber daya kluster.

Hapus kluster dengan hati-hati. Tindakan ini tidak dapat dibatalkan. Semua data yang diserap ke kluster dari ruang kerja tertaut dihapus secara permanen.

Penagihan kluster berhenti saat Anda menghapus kluster, terlepas dari periode komitmen 31 hari yang ditentukan dalam kluster.

Jika Anda menghapus kluster yang memiliki ruang kerja tertaut, ruang kerja secara otomatis melepaskan tautan dari kluster. Mereka pindah ke tingkat harga bayar sesuai penggunaan, dan data baru yang dikirim ke ruang kerja diserap ke kluster Log Analytics sebagai gantinya. Anda dapat mengkueri ruang kerja di seluruh rentang waktu sebelum ditautkan ke kluster, dan setelah membatalkan tautan, layanan melakukan kueri lintas kluster dengan mulus.

Catatan

Ada batas tujuh kluster per langganan dan wilayah: lima kluster aktif, ditambah dua yang dihapus dalam dua minggu terakhir.
Nama kluster tetap dicadangkan dua minggu setelah penghapusan, di mana Anda tidak dapat menggunakannya untuk membuat kluster baru.

Gunakan perintah berikut untuk menghapus cluster:

Pilih kluster Anda dari menu kluster khusus Log Analytics di portal Azure. Kemudian pilih Hapus.

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"

Gunakan panggilan REST berikut untuk menghapus kluster:

DELETE https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/clusters/<cluster-name>?api-version=2023-09-01
Authorization: Bearer <token>

Jawaban

200 OK

Mengubah jenis identitas terkelola

Anda dapat mengubah identitas setelah membuat kluster tanpa mengganggu penerimaan data atau kueri. Pertimbangkan hal berikut:

Memperbarui SystemAssigned ke UserAssigned - Berikan identitas UserAssign di Key Vault, lalu perbarui jenis identitas di kluster.
Memperbarui UserAssigned ke SystemAssigned - Karena identitas terkelola yang ditetapkan sistem dibuat setelah memperbarui jenis identitas kluster dengan SystemAssigned, ikuti langkah-langkah berikut:
1. Perbarui kluster untuk menghapus kunci - atur keyVaultUri, , keyNamedan keyVersion ke nilai "".
2. Perbarui jenis identitas kluster ke SystemAssigned.
3. Perbarui Key Vault dan berikan izin ke identitas.
4. Perbarui kunci di kluster khusus.

Batasan dan kendala

Anda dapat membuat hingga lima kluster aktif di setiap wilayah dan langganan.
Anda dapat memiliki hingga tujuh kluster per langganan dan wilayah: lima kluster aktif ditambah dua kluster yang Anda hapus dalam dua minggu terakhir.
Anda dapat menautkan hingga 1.000 ruang kerja Log Analytics ke kluster.
Anda dapat melakukan hingga dua operasi tautan ruang kerja pada ruang kerja tertentu dalam periode 30 hari.
Anda tidak dapat memindahkan kluster ke grup sumber daya atau langganan lain.
Anda tidak dapat memindahkan kluster ke wilayah lain.
Anda tidak boleh menyertakan detail identitas dan pengidentifikasi kunci dalam operasi yang sama saat memperbarui kluster. Jika Anda perlu memperbarui keduanya, buat dua operasi pembaruan berturut-turut.
Lockbox saat ini tidak tersedia di Tiongkok.
Lockbox saat ini tidak dapat diterapkan ke tabel dengan Rencana Tambahan.
Enkripsi ganda dikonfigurasi secara otomatis untuk kluster yang dibuat mulai Oktober 2020 di wilayah yang didukung. Anda dapat memverifikasi apakah kluster Anda dikonfigurasi untuk enkripsi ganda dengan mengirimkan permintaan GET pada kluster dan mengamati bahwa nilai isDoubleEncryptionEnabled adalah true untuk kluster dengan enkripsi ganda diaktifkan.
- Jika Anda membuat kluster dan mendapatkan pesan kesalahan "nama wilayah tidak mendukung Enkripsi Ganda untuk kluster.” Anda masih dapat membuat kluster tanpa Enkripsi ganda dengan menambahkan "properties": {"isDoubleEncryptionEnabled": false} dalam isi permintaan REST.
- Anda tidak dapat mengubah pengaturan enkripsi ganda setelah membuat kluster.
Anda dapat menghapus ruang kerja saat ditautkan ke kluster. Jika Anda memulihkan ruang kerja selama periode penghapusan sementara , ruang kerja kembali ke status sebelumnya dan tetap ditautkan ke kluster.
Selama periode komitmen, Anda dapat berubah ke tingkat komitmen yang lebih tinggi, yang memulai ulang periode komitmen 31 hari. Anda tidak dapat pindah kembali ke prabayar atau ke tingkat komitmen yang lebih rendah sampai Anda menyelesaikan periode komitmen.

Pemecahan Masalah

Jika Anda mendapatkan kesalahan konflik saat membuat kluster, kluster mungkin dihapus dan masih dalam proses penghapusan. Nama kluster tetap dicadangkan selama periode penghapusan dua minggu dan Anda tidak dapat membuat kluster baru dengan nama tersebut.
Jika Anda memperbarui kluster saat kluster berada dalam status provisi atau pembaruan, pembaruan gagal.
Beberapa operasi memerlukan waktu cukup lama untuk diselesaikan. Operasi ini adalah pembuatan kluster, pembaruan kunci kluster, dan penghapusan kluster. Anda dapat memeriksa status operasi dengan mengirim permintaan GET ke kluster atau ruang kerja dan mengamati respons. Misalnya, ruang kerja yang tidak ditautkan tidak memiliki clusterResourceId di bawah fitur.
Jika Anda mencoba menautkan ruang kerja Log Analytics yang sudah ditautkan ke kluster lain, operasi gagal.

Pesan kesalahan

Pembuatan Kluster

400--Nama kluster tidak valid. Nama kluster dapat berisi karakter a-z, A-Z, 0-9 dan panjang 3-63.
400--Isi permintaan adalah null atau dalam format yang buruk.
400--Nama SKU tidak valid. Atur nama SKU ke capacityReservation.
400--Kapasitas disediakan tetapi SKU bukan capacityReservation. Atur nama SKU ke capacityReservation.
400--Kapasitas Hilang dalam SKU. Atur Nilai kapasitas ke 100, 200, 300, 400, 500, 1.000, 2.000, 5.000, 10.000, 25.000, 50.000 GB per hari.
400--Kapasitas terkunci selama 30 hari. Penurunan kapasitas diizinkan 30 hari setelah pembaruan.
400--Tidak ada SKU yang ditetapkan. Atur nama SKU ke capacityReservation dan Kapasitas ke 100, 200, 300, 400, 500, 1.000, 2.000, 5.000, 10.000, 25.000, 50.000 GB per hari.
400--Operasi tidak dapat dijalankan sekarang. Operasi asinkron berada dalam kondisi selain berhasil. Kluster harus menyelesaikan operasinya sebelum operasi pembaruan dilakukan.

Pembaruan klaster

400--Kluster sedang dalam status penghapusan. Operasi asinkron sedang berlangsung. Kluster harus menyelesaikan operasinya sebelum operasi pembaruan dilakukan.
400--KeyVaultProperties tidak kosong tetapi memiliki format yang buruk. Lihat pembaruan pengidentifikasi kunci.
400--Gagal memvalidasi kunci di Key Vault. Bisa jadi disebabkan kurangnya izin atau jika kunci tidak ada. Verifikasi bahwa Anda mengatur kunci dan kebijakan akses di Key Vault.
400--Kunci tidak dapat dipulihkan. Key Vault harus diatur ke Penghapusan sementara dan Perlindungan penghapusan menyeluruh. Lihat dokumentasi Key Vault
400--Operasi tidak dapat dijalankan sekarang. Tunggu hingga operasi Async selesai dan coba lagi.
400--Kluster sedang dalam status penghapusan. Tunggu hingga operasi Async selesai dan coba lagi.

Pengambilan Data Kluster

404--Kluster tidak ditemukan, kluster mungkin telah dihapus. Jika Anda mencoba membuat kluster dengan nama tersebut dan mendapatkan konflik, kluster sedang dalam proses penghapusan.

Penghapusan Kluster

409--Tidak dapat menghapus kluster saat dalam status penyediaan. Tunggu hingga operasi Async selesai dan coba lagi.

Tautan ruang kerja

404--Ruang kerja tidak ditemukan. Ruang kerja yang Anda tentukan tidak ada atau telah dihapus.
409--Operasi penautan atau pembatalan penautan ruang kerja dalam proses.
400 -- Kluster tidak ditemukan, kluster yang Anda tentukan tidak ada atau telah dihapus.

Penghapusan tautan ruang kerja

404--Ruang kerja tidak ditemukan. Ruang kerja yang Anda tentukan tidak ada atau telah dihapus.
409--Operasi penautan atau pembatalan penautan ruang kerja dalam proses.

Langkah berikutnya

Pelajari tentang penagihan kluster khusus Log Analytics.
Pelajari tentang desain ruang kerja Log Analytics yang tepat.
Dapatkan templat sample lainnya untuk Azure Monitor.

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-04-20

Membuat dan mengelola kluster khusus di log Azure Monitor

Kemampuan tingkat lanjut

Model harga klaster

Izin yang diperlukan

sampel templat Resource Manager

Referensi templat

Persiapan

Membuat kluster khusus

Periksa status penyediaan kluster

Tautkan ruang kerja ke kluster

Periksa status tautan ruang kerja

Ubah properti kluster

Dapatkan semua kluster yang ada di grup sumber daya

Dapatkan semua kluster di langganan

Perbarui tingkat komitmen di kluster

Putuskan hubungan ruang kerja dari kluster

Menghapus klaster

Mengubah jenis identitas terkelola

Batasan dan kendala

Pemecahan Masalah

Pesan kesalahan

Pembuatan Kluster

Pembaruan klaster

Pengambilan Data Kluster

Penghapusan Kluster

Tautan ruang kerja

Penghapusan tautan ruang kerja

Langkah berikutnya

Saran dan Komentar

Sumber Daya Tambahan: