Bu makalede Azure sanal makinelerinde, sanal makine ölçek kümelerinde ve Azure Arc özellikli sunucularda Azure İzleyici Aracısı'nı yüklemek, kaldırmak, güncelleştirmek ve yapılandırmak için kullanabileceğiniz farklı yöntemler açıklanmaktadır.
Önkoşullar
Azure İzleyici Aracısı'nı kullanmaya yönelik önkoşullar ve diğer gereksinimler için şu makalelere bakın:
Önemli
Azure İzleyici Aracısı'nı yüklemek, yükseltmek veya kaldırmak için makinenin yeniden başlatılması gerekmez.
Yükleme seçenekleri
Aşağıdaki tabloda Azure VM'lerine ve Azure Arc özellikli sunuculara Azure İzleyici Aracısı yükleme seçenekleri listelenmiştir.
Azure'da olmayan tüm makineler için, Azure İzleyici Aracısı'nın yüklenebilmesi için önce makineye Azure Arc aracısının yüklenmesi gerekir.
| Yükleme yöntemi |
Açıklama |
| Sanal makine (VM) uzantısı |
Aracıyı Azure uzantı çerçevesi aracılığıyla yüklemek için bu makalede açıklanan yöntemlerden herhangi birini kullanın. Bu yöntem bir DCR oluşturmaz, bu nedenle veri toplama başlamadan önce en az bir DCR oluşturmanız ve aracıyla ilişkilendirmeniz gerekir. |
|
DCR oluşturma |
Azure portalında bir DCR oluşturduğunuzda, Azure İzleyici Aracısı DCR için kaynak olarak eklenen herhangi bir makineye yüklenir. Aracı, DCR'de tanımlandığı gibi verileri hemen toplamaya başlar. |
|
VM içgörüleri |
Bir makinede VM içgörülerini etkinleştirdiğinizde Azure İzleyici Aracısı yüklenir ve önceden tanımlanmış bir veri kümesi toplamak için bir DCR oluşturulur. Bu DCR'yi değiştirmemelisiniz, ancak daha fazla veri toplamak için daha fazla DCR oluşturabilirsiniz. |
|
Konteyner içgörüleri |
Kubernetes kümesinde Container Insights'ı etkinleştirdiğinizde, kümeye Azure İzleyici Aracısı'nın kapsayıcılı bir sürümü yüklenir ve veri toplamaya hemen başlamak için bir DCR oluşturulur. DCR'leri kullanarak Kapsayıcı içgörülerinde veri toplama ve maliyet iyileştirmeyi yapılandırma başlığı altında yer alan yönergeleri kullanarak DCR'yi değiştirebilirsiniz. |
|
İstemci yükleyicisi |
Aracıyı, Windows 11 ve Windows 10 istemcileri için bir Windows MSI yükleyicisi kullanarak yükleyin. |
|
Azure İlkesi |
Aracıyı Azure sanal makinelerine ve Azure Arc özellikli sunuculara otomatik olarak yüklemek ve bunları gerekli DCR'lerle otomatik olarak ilişkilendirmek için Azure İlkesi kullanın. |
Aracı uzantısını yükleme
Sanal makine uzantısı eklemek için PowerShell komutunu kullanarak Azure İzleyici Aracısı'nı bir Azure sanal makinesine veya Azure Arc özellikli bir sunucuya yükleyebilirsiniz.
Azure sanal makineleri
Azure İzleyici Aracısını bir Azure sanal makinesine yüklemek için aşağıdaki PowerShell komutlarını kullanın. Kullandığınız kimlik doğrulama yöntemine göre uygun komutu seçin.
Windows
## User-assigned managed identity
Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
## System-assigned managed identity
Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
Linux
## User-assigned managed identity
Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
## System-assigned managed identity
Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
Azure sanal makine ölçek kümesi
Azure İzleyici Aracısı'nı bir Azure sanal makine ölçek kümesine yüklemek için Add-AzVmssExtension PowerShell cmdlet'ini kullanın.
Azure Arc özellikli sunucular
Azure İzleyici Aracısı'nı Azure Arc özellikli bir sunucuya yüklemek için aşağıdaki PowerShell komutlarını kullanın:
Windows
New-AzConnectedMachineExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade
Linux
New-AzConnectedMachineExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade
Sanal makine uzantısı eklemek için Azure CLI komutunu kullanarak Azure İzleyici Aracısı'nı bir Azure sanal makinesine veya Azure Arc özellikli bir sunucuya yükleyebilirsiniz.
Azure sanal makineleri
Azure İzleyici Aracısı'nı bir Azure sanal makinesine yüklemek için aşağıdaki Azure CLI komutlarını kullanın. Kullandığınız kimlik doğrulama yöntemine göre uygun komutu seçin.
Kullanıcı tarafından atanmış yönetilen kimlik
Windows
az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
Linux
az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
Sistem tarafından atanan yönetilen kimlik
Windows
az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
Linux
az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
Azure sanal makineleri ölçek kümesi
Azure İzleyici Aracısı'nı bir Azure sanal makineleri ölçek kümesine yüklemek için az vmss extension set Azure CLI cmdlet'ini kullanın.
Azure Arc özellikli sunucular
Azure İzleyici Aracısı'nı Azure Arc özellikli bir sunucuya yüklemek için aşağıdaki Azure CLI komutlarını kullanın:
Windows
az connectedmachine extension create --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true
Linux
az connectedmachine extension create --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true
Azure İzleyici Aracısı'nı bir Azure sanal makinesine veya Azure Arc özellikli bir sunucuya yüklemek ve DCR'lerle bir ilişkilendirme oluşturmak için Bir Azure Resource Manager şablonu kullanabilirsiniz. DCR ilişkilendirmesini oluşturmadan önce herhangi bir DCR oluşturmanız gerekir.
Aracıyı yüklemek ve aşağıdaki kaynaklardan ilişkilendirmeyi oluşturmak için örnek şablonlar alın:
Aşağıdaki komutlar da dahil olmak üzere Resource Manager şablonları için herhangi bir dağıtım yöntemini kullanarak şablonları yükleyin.
PowerShell
New-AzResourceGroupDeployment -ResourceGroupName "<resource-group-name>" -TemplateFile "<template-filename.json>" -TemplateParameterFile "<parameter-filename.json>"
Azure Komut Satırı Arayüzü (Azure CLI)
az deployment group create --resource-group "<resource-group-name>" --template-file "<path-to-template>" --parameters "@<parameter-filename.json>"
uygulamasını kaldırma
Azure portalını kullanarak Azure İzleyici Aracısı'nı kaldırmak için sanal makinenize, ölçek kümenize veya Azure Arc özellikli sunucunuza gidin.
Uzantılar sekmesini ve ardından AzureMonitorWindowsAgent veya AzureMonitorLinuxAgent'ı seçin. Açılan iletişim kutusunda Kaldır'ı seçin.
Azure sanal makinesinde bir uygulamayı kaldırma
Azure sanal makinesinde Azure İzleyici Aracısı'nı kaldırmak için aşağıdaki PowerShell komutlarını kullanın:
Windows
Remove-AzVMExtension -Name AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name>
Linux
Remove-AzVMExtension -Name AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name>
Azure sanal makine ölçek kümesinde kaldırma işlemi
Azure sanal makine ölçek kümesinde Azure İzleyici Aracısı'nı kaldırmak için Remove-AzVmssExtension PowerShell cmdlet'ini kullanın.
Azure Arc özellikli bir sunucuda kaldırma
Azure Arc özellikli bir sunucuda Azure İzleyici Aracısı'nı kaldırmak için aşağıdaki PowerShell komutlarını kullanın:
Windows
Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorWindowsAgent
Linux
Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorLinuxAgent
Azure sanal makinesinde bir uygulamayı kaldırma
Azure sanal makinesinde Azure İzleyici Aracısı'nı kaldırmak için aşağıdaki Azure CLI komutlarını kullanın:
Windows
az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorWindowsAgent
Linux
az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorLinuxAgent
Azure sanal makine ölçek kümesinde kaldırma işlemi
Azure sanal makine ölçek kümesinde Azure İzleyici Aracısı'nı kaldırmak için az vmss extension delete Azure CLI cmdlet'ini kullanın.
Azure Arc özellikli bir sunucuda kaldırma
Azure Arc özellikli bir sunucuda Azure İzleyici Aracısı'nı kaldırmak için aşağıdaki Azure CLI komutlarını kullanın:
Windows
az connectedmachine extension delete --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
Linux
az connectedmachine extension delete --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
Güncelleştir
Not almak
Her zaman aracının en son sürümüne güncelleştirmenizi veya otomatik uzantı yükseltmeyi kabul etmeniz önerilir.
Otomatik uzantı dağıtımı, aracının en son sürümünü güvenli bir şekilde dağıtmak için standart Azure dağıtım uygulamalarını izler. Otomatik güncelleştirmelerin en son sürümü kullanıma sunmasının haftalar sürmesini beklemeniz gerekir.
Yükseltmeler toplu olarak verildiğinden bazı sanal makineleriniz, ölçek kümeleriniz veya Azure Arc özellikli sunucularınız diğerlerinden önce yükseltilebilir.
Bir uzantıyı hemen yükseltmeniz gerekiyorsa, bu makalede açıklanan el ile yönergeleri kullanabilirsiniz. Yalnızca geçen yıl yayımlanan aracılar desteklenir.
Aracının tek seferlik güncelleştirmesini yapmak için önce mevcut aracı sürümünü kaldırmanız gerekir. Ardından yeni sürümü açıklandığı gibi yükleyin.
Otomatik uzantı yükseltmesini etkinleştirerek aracının otomatik güncelleştirmesini etkinleştirmenizi öneririz. Sanal makinenize veya ölçek kümenize gidin, Uzantılar sekmesini ve ardından AzureMonitorWindowsAgent veya AzureMonitorLinuxAgent'ı seçin. Açılan iletişim kutusunda Otomatik yükseltmeyi etkinleştir'i seçin.
Azure sanal makinelerinde güncelleştirme
Ajanı bir kez güncellemek için, yeni sürümü anlatıldığı gibi yükleyin.
Otomatik uzantı yükseltmeyi kabul ederek aracının otomatik güncelleştirmesini etkinleştirmenizi öneririz.
Aşağıdaki PowerShell komutlarını kullanın:
Windows
Set-AzVMExtension -ExtensionName AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorWindowsAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true
Linux
Set-AzVMExtension -ExtensionName AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorLinuxAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true
Azure Arc özellikli sunucularda güncelleştirme
Aracının tek seferlik yükseltmesini yapmak için aşağıdaki PowerShell komutlarını kullanın:
Windows
$target = @{"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent" = @{"targetVersion"=<target-version-number>}}
Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
Linux
$target = @{"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent" = @{"targetVersion"=<target-version-number>}}
Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
Otomatik uzantı yükseltmesini kabul ederek aracının otomatik güncelleştirmesini etkinleştirmenizi öneririz.
Aşağıdaki PowerShell komutlarını kullanın:
Windows
Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorWindowsAgent -EnableAutomaticUpgrade
Linux
Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorLinuxAgent -EnableAutomaticUpgrade
Azure sanal makinelerinde güncelleştirme
Aracının tek seferlik güncelleştirmesini yapmak için önce mevcut aracı sürümünü kaldırmanız gerekir. Ardından bu makalede açıklandığı gibi yeni sürümü yükleyin.
Aşağıdaki Azure CLI komutlarını kullanarak otomatik uzantı yükseltme özelliğini kabul ederek aracının otomatik güncelleştirmesini etkinleştirmenizi öneririz:
Windows
az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Linux
az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Azure Arc özellikli sunucularda güncelleştirme
Aracının tek seferlik yükseltmesini yapmak için aşağıdaki Azure CLI komutlarını kullanın:
Windows
az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
Linux
az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
Otomatik uzantı yükseltmeyi kabul ederek aracının otomatik güncelleştirmesini etkinleştirmenizi öneririz.
Aşağıdaki Azure CLI komutlarını kullanın:
Windows
az connectedmachine extension update --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Linux
az connectedmachine extension update --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Veri toplama kuralları (DCR), makinenizdeki Azure İzleyici Aracısı için bir yönetim aracı görevi görür. AgentSettings DCR, aracıyı belirli izleme gereksinimlerinize göre yapılandırmak üzere belirli Azure İzleyici Aracısı parametrelerini yapılandırmak için kullanılabilir.
Not almak
AgentSettings DCR ile çalışırken dikkat edilmesi gereken önemli noktalar:
- Şu anda AgentSettings DCR yalnızca bir Azure Resource Manager şablonu kullanılarak yapılandırılabilir.
- AgentSettings, başka ayarı olmayan tek bir DCR olmalıdır.
- Sanal makine ve AgentSettings DCR aynı bölgede olmalıdır.
Desteklenen parametreler
AgentSettings DCR şu anda aşağıdaki parametrelerin ayarlanmasını desteklemektedir:
| Parametre |
Açıklama |
Geçerli değerler |
MaxDiskQuotaInMB |
Dayanıklılık sağlamak için aracı veri gönderemiyorsa yerel önbellekte veri toplar. Aracı, bağlantı geri yüklendikten sonra önbellekteki verileri gönderir. Bu parametre, Azure İzleyici Aracısı günlük dosyaları ve önbelleği tarafından kullanılan disk alanı miktarıdır (MB cinsinden). |
Linux: 4,000 ile 1,000,000
Windows: 40001,000,000 |
UseTimeReceivedForForwardedEvents |
Microsoft Sentinel Windows Olay İletme (WEF) tablosundaki WEF sütununu, TimeReceived verileri yerine TimeGenerated kullanacak şekilde değiştirir. |
0 veya 1 |
AgentSettings DCR'yi ayarlama
Vm'nize Azure İzleyici Aracısı'nı yükleyerek ortamı hazırlayın.
DCR oluşturun.
Bu örnek, Azure İzleyici Aracısı önbelleği tarafından kullanılan maksimum disk alanı miktarını 5.000 MB olarak ayarlar.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {},
"resources": [
{
"type": "Microsoft.Insights/dataCollectionRules",
"name": "dcr-contoso-01",
"apiVersion": "2023-03-11",
"properties":
{
"description": "A simple agent settings",
"agentSettings":
{
"logs": [
{
"name": "MaxDiskQuotaInMB",
"value": "5000"
}
]
}
},
"kind": "AgentSettings",
"location": "eastus"
}
]
}
DCR'yi makinenizle ilişkilendirin. Aşağıdaki Resource Manager dosyalarını kullanın.
Şablon dosyası:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"type": "string",
"metadata": {
"description": "The name of the virtual machine."
}
},
"dataCollectionRuleId": {
"type": "string",
"metadata": {
"description": "The resource ID of the data collection rule."
}
}
},
"resources": [
{
"type": "Microsoft.Insights/dataCollectionRuleAssociations",
"apiVersion": "2021-09-01-preview",
"scope": "[format('Microsoft.Compute/virtualMachines/{0}', parameters('vmName'))]",
"name": "agentSettings",
"properties": {
"description": "Association of data collection rule. Deleting this association will break the data collection for this virtual machine.",
"dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
}
}
]
}
Parametre dosyası:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"value": "my-azure-vm"
},
"dataCollectionRuleId": {
"value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
}
}
}
Değişiklikleri uygulamak için Azure İzleyici Aracısı'nı yeniden başlatın.
İlgili içerik
Aracıdan veri toplamak ve Azure İzleyici'ye göndermek için bir veri toplama kuralı oluşturun.