Bu makalede Azure sanal makinelerinde, ölçek kümelerinde ve Azure Arc özellikli sunucularda Azure İzleyici Aracısı'nı yükleme, kaldırma, güncelleştirme ve yapılandırmaya yönelik farklı yöntemler ayrıntılı olarak açıklanmaktadır.
Önemli
Azure İzleyici Aracısı, istemci makineye yüklendikten sonra veri toplamaya başlamak için en az bir veri toplama kuralı (DCR) gerektirir. Kullandığınız yükleme yöntemine bağlı olarak, DCR otomatik olarak oluşturulabilir veya oluşturulmayabilir. Aksi takdirde Azure İzleyici Aracısı ile veri toplama başlığı altında yer alan yönergeleri izleyerek veri toplamayı yapılandırmanız gerekir.
Önkoşullar
Azure İzleyici Aracısı için önkoşullar ve diğer gereksinimler için aşağıdaki makalelere bakın:
Azure İzleyici Aracısı'nın yüklenmesi, yükseltilmesi veya kaldırılması için makinenin yeniden başlatılması gerekmez.
Yükleme seçenekleri
Aşağıdaki tabloda Azure VM'lere ve Azure Arc özellikli sunuculara Azure İzleyici Aracısı'nı yüklemek için farklı seçenekler listelenmiştir. Azure İzleyici Aracısı'nın yüklenebilmesi için önce Azure Arc aracısının Azure'da olmayan makinelere yüklenmesi gerekir.
Yükleme yöntemi
Açıklama
VM uzantısı
Aracıyı yüklemek için Azure uzantı çerçevesini kullanmak için aşağıdaki yöntemlerden herhangi birini kullanın. Bu yöntem bir DCR oluşturmaz, bu nedenle veri toplama başlamadan önce en az bir tane oluşturmanız ve aracıyla ilişkilendirmeniz gerekir.
Azure portalında bir DCR oluşturduğunuzda, DCR için kaynak olarak eklenen tüm makinelere Azure İzleyici Aracısı yüklenir. Aracı, DCR'de tanımlanan verileri hemen toplamaya başlar.
Bir makinede VM içgörülerini etkinleştirdiğinizde Azure İzleyici Aracısı yüklenir ve önceden tanımlanmış bir veri kümesi toplayan bir DCR oluşturulur. Bu DCR'yi değiştirmemelisiniz, ancak diğer verileri toplamak için ek DCR'ler oluşturabilirsiniz.
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.
Not
Kiracılar arasında veri göndermek için önce Azure Lighthouse'ı etkinleştirmeniz gerekir.
Azure İzleyici Aracısı'nın yüklü olduğu bir makineyi kopyalama desteklenmez. Bu durumlar için en iyi yöntem, ama'ı büyük ölçekte dağıtmak için kod aracı olarak Azure İlkesi veya Altyapı kullanmaktır.
Aracı uzantısını yükleme
Bu bölümde, VM uzantısını kullanarak Azure İzleyici Aracısı'nı yüklemeyle ilgili ayrıntılar sağlanır.
Azure portalını kullanarak aracıyı yüklemek ve veri toplamak için bir DCR oluşturmak için Azure İzleyici Aracısı ile veri toplama yönergelerini kullanın.
Sanal makine uzantısı eklemek için PowerShell komutunu kullanarak Azure sanal makinelerine ve Azure Arc özellikli sunuculara Azure İzleyici Aracısı'nı yükleyebilirsiniz.
Azure sanal makineleri
Azure sanal makinelerine Azure İzleyici Aracısı yüklemek için aşağıdaki PowerShell komutlarını kullanın. Seçtiğiniz kimlik doğrulama yöntemine göre uygun komutu seçin.
Sanal makine uzantısı eklemek için Azure CLI komutunu kullanarak Azure sanal makinelerine ve Azure Arc özellikli sunuculara Azure İzleyici Aracısı'nı yükleyebilirsiniz.
Azure sanal makineleri
Azure sanal makinelerine Azure İzleyici Aracısı'nı yüklemek için aşağıdaki CLI komutlarını kullanın. Seçtiğiniz kimlik doğrulama yöntemine göre uygun komutu seçin.
Kullanıcı 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 --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 İzleyici Aracısı'nı Azure sanal makinelerine ve Azure Arc özellikli sunuculara yüklemek ve veri toplama kurallarıyla bir ilişkilendirme oluşturmak için Resource Manager şablonlarını kullanabilirsiniz. İlişkilendirmeyi oluşturmadan önce herhangi bir veri toplama kuralı oluşturmanız gerekir.
Aracıyı yüklemek ve ilişkilendirmeyi aşağıdaki kaynaklardan oluşturmak için örnek şablonları alın:
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 seçin ve AzureMonitorWindowsAgent veya AzureMonitorLinuxAgent'ı seçin. Açılan iletişim kutusunda Kaldır'ı seçin.
Azure sanal makinelerinde kaldırma
Azure sanal makinelerinde Azure İzleyici Aracısı'nı kaldırmak için aşağıdaki PowerShell komutlarını kullanın.
Azure Arc özellikli sunucularda Azure İzleyici Aracısı'nı kaldırmak için aşağıdaki 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>
Yok
Güncelleştir
Not
Yüklü uzantıları tüm bölgelerde kararlı sürüme güncelleştirmek için Otomatik Uzantı Yükseltme'yi etkinleştirmeniz önerilmektedir. Bir sürüm, ilk sürümden sonra 5 hafta kadar sürebilen yüksek kaliteli bir çıtayı karşılayana kadar otomatik olarak dağıtılmaz. Yükseltmeler toplu olarak verildiğinden bazı sanal makinelerinizin, ölçek kümelerinizin veya Arc özellikli sunucularınızın diğerlerinden önce yükseltildiğini görebilirsiniz. Bir uzantıyı hemen yükseltmeniz gerekiyorsa aşağıdaki el ile yönergeleri kullanabilirsiniz.
Aracının tek seferlik güncelleştirmesini gerçekleştirmek 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ükseltme özelliğini etkinleştirerek aracının otomatik güncelleştirmesini etkinleştirmenizi öneririz. Sanal makinenize veya ölçek kümenize gidin, Uzantılar sekmesini seçin ve AzureMonitorWindowsAgent veya AzureMonitorLinuxAgent'ı seçin. Açılan iletişim kutusunda Otomatik yükseltmeyi etkinleştir'i seçin.
Azure sanal makinelerinde güncelleştirme
Aracının tek seferlik güncelleştirmesini gerçekleştirmek için önce mevcut aracı sürümünü kaldırmanız, ardından yeni sürümü açıklandığı gibi yüklemeniz gerekir.
Aşağıdaki PowerShell komutlarını kullanarak Otomatik Uzantı Yükseltme özelliğini etkinleştirerek aracının otomatik güncelleştirmesini etkinleştirmenizi öneririz.
Aşağıdaki PowerShell komutlarını kullanarak Otomatik Uzantı Yükseltme özelliğini etkinleştirerek aracının otomatik güncelleştirmesini etkinleştirmenizi öneririz.
Aracının tek seferlik güncelleştirmesini gerçekleştirmek için önce mevcut aracı sürümünü kaldırmanız, ardından yeni sürümü açıklandığı gibi yüklemeniz gerekir.
Aşağıdaki CLI komutlarını kullanarak Otomatik Uzantı Yükseltme özelliğini etkinleştirerek 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 gerçekleştirmek için aşağıdaki 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>
Aşağıdaki PowerShell komutlarını kullanarak Otomatik Uzantı Yükseltme özelliğini etkinleştirerek aracının otomatik güncelleştirmesini etkinleştirmenizi öneririz.
Veri Toplama Kuralları (DCR), makinenizde Azure İzleyici Aracısı (AMA) 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 AMA parametrelerini yapılandırmak için kullanılabilir.
Not
DCR ile AgentSettings çalışırken dikkat edilmesi gereken önemli noktalar:
AgentSettings DCR şu anda yalnızca ARM şablonları 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 bulunmalıdır.
Desteklenen parametreler
AgentSettings DCR şu anda aşağıdaki parametrelerin yapılandırılmasını desteklemektedir:
Parametre
Açıklama
Geçerli değerler
MaxDiskQuotaInMB
Azure İzleyici Aracısı günlük dosyaları ve önbelleği tarafından kullanılan disk alanı miktarını (MB cinsinden) tanımlar.
Linux: 1025-51199 Windows: 4000-51199
UseTimeReceivedForForwardedEvents
Sentinel WEF tablosundaki WEF sütununu TimeGenerated verileri yerine TimeReceived kullanacak şekilde değiştirir
Şu ARM şablonunu ve parametre dosyalarını kullanın:
ARM ş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')]"
}
}
]
}