Linux için Log Analytics sanal makine uzantısı

Genel bakış

Azure İzleyici Günlükleri, bulut ve şirket içi varlıklar genelinde izleme, uyarı ve uyarı düzeltme özellikleri sağlar. Linux için Log Analytics sanal makine uzantısı Microsoft tarafından yayımlanır ve desteklenir. Uzantı, Log Analytics aracısını Azure sanal makinelerine yükler ve sanal makineleri mevcut bir Log Analytics çalışma alanına kaydeder. Bu belgede Linux için Log Analytics sanal makine uzantısı için desteklenen platformlar, yapılandırmalar ve dağıtım seçenekleri ayrıntılı olarak açıklanır.

Not

Azure Arc özellikli sunucular, Log Analytics aracısı VM uzantısını Azure olmayan Windows ve Linux makinelerine dağıtmanıza, kaldırmanıza ve güncelleştirmenize olanak tanır ve karma makinenizin yaşam döngüsü boyunca yönetimini basitleştirir. Daha fazla bilgi için bkz . Azure Arc özellikli sunucularla VM uzantısı yönetimi.

Önkoşullar

İşletim sistemi

Desteklenen Linux dağıtımları hakkında ayrıntılı bilgi için Azure İzleyici aracılarına genel bakış makalesine bakın.

Aracı ve VM Uzantısı sürümü

Aşağıdaki tablo, her sürüm için Log Analytics VM uzantısının ve Log Analytics aracı paketinin sürümünün eşlemesini sağlar. Log Analytics aracı paketi sürümü için sürüm notlarının bağlantısı eklenmiştir. Sürüm notları, belirli bir aracı sürümü için kullanılabilen hata düzeltmeleri ve yeni özelliklerle ilgili ayrıntıları içerir.

Log Analytics Linux VM uzantısı sürümü	Log Analytics Aracısı paket sürümü
1.19.0	1.19.0
1.18.1	1.18.1
1.17.2	1.17.2
1.17.1	1.17.1
1.16.0	1.16.0
1.14.23	1.14.23
1.14.20	1.14.20
1.14.19	1.14.19
1.14.16	1.14.16
1.14.13	1.14.13
1.14.11	1.14.11
1.14.9	1.14.9
1.13.40	1.13.40
1.13.35	1.13.35
1.13.33	1.13.33
1.13.27	1.13.27
1.13.15	1.13.9-0
1.12.25	1.12.15-0
1.11.15	1.11.0-9
1.10.0	1.10.0-1
1.9.1	1.9.0-0
1.8.11	1.8.1-256
1.8.0	1.8.0-256
1.7.9	1.6.1-3
1.6.42.0	1.6.0-42
1.4.60.2	1.4.4-210
1.4.59.1	1.4.3-174
1.4.58.7	14.2-125
1.4.56.5	1.4.2-124
1.4.55.4	1.4.1-123
1.4.45.3	1.4.1-45
1.4.45.2	1.4.0-45
1.3.127.5	1.3.5-127
1.3.127.7	1.3.5-127
1.3.18.7	1.3.4-15

Bulut için Microsoft Defender

Bulut için Microsoft Defender Log Analytics aracısını otomatik olarak sağlar ve Azure aboneliğinizdeki Bulut için Defender tarafından oluşturulan varsayılan Log Analytics çalışma alanına bağlar. Bulut için Microsoft Defender kullanıyorsanız, bu belgedeki adımları kullanmayın. Bunu yaptığınızda, yapılandırılan çalışma alanının üzerine yazılır ve Bulut için Microsoft Defender ile bağlantı kesilir.

İnternet bağlantısı

Linux için Log Analytics aracısı uzantısı, hedef sanal makinenin İnternet'e bağlı olmasını gerektirir.

Uzantı şeması

Aşağıdaki JSON, Log Analytics aracı uzantısının şemasını gösterir. Uzantı, hedef Log Analytics çalışma alanından çalışma alanı kimliğini ve çalışma alanı anahtarını gerektirir; bu değerler , Azure portalındaki Log Analytics çalışma alanınızda bulunabilir. Çalışma alanı anahtarı hassas veriler olarak ele alınacağından, korumalı ayar yapılandırmasında depolanmalıdır. Azure VM uzantısı korumalı ayar verileri şifrelenir ve yalnızca hedef sanal makinede şifresi çözülür. workspaceId ve workspaceKey değerlerinin büyük/küçük harfe duyarlı olduğunu unutmayın.

Not

Kapsayıcı İzleme çözümü kullanımdan kaldırıldığı için, aşağıdaki belgelerde isteğe bağlı "skipDockerProviderInstall" ayarı kullanılır: true.

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "name": "OMSExtension",
  "apiVersion": "2018-06-01",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
  ],
  "properties": {
    "publisher": "Microsoft.EnterpriseCloud.Monitoring",
    "type": "OmsAgentForLinux",
    "typeHandlerVersion": "1.16",
    "autoUpgradeMinorVersion": true,
    "settings": {
      "workspaceId": "myWorkspaceId",
      "skipDockerProviderInstall": true
    },
    "protectedSettings": {
      "workspaceKey": "myWorkSpaceKey"
    }
  }
}

Not

Yukarıdaki şema, şablonun kök düzeyinde yerleştirileceğini varsayar. Bunu şablondaki sanal makine kaynağının içine koyarsanız ve typename özellikleri daha aşağıda açıklandığı gibi değiştirilmelidir.

Özellik değerleri

Veri Akışı Adı	Değer / Örnek
apiVersion	2018-06-01
Yayımcı	Microsoft.EnterpriseCloud.Monitoring
Tür	OmsAgentForLinux
typeHandlerVersion	1.16
workspaceId (örn.	6f680a37-00c6-41c7-a93f-1437e3462574
workspaceKey (örn.	z4bU3p1/GrnWpQkky4gdabWXAhbWSTz70hm4m2Xt92XI+rSRgE8qVvRhsGo9TXffbrTahyrwv35W0pOqQAU7uQ==

Şablon dağıtımı

Not

Log Analytics VM uzantısının bazı bileşenleri de Tanılama VM uzantısında gönderilir. Bu mimari nedeniyle, her iki uzantı da aynı ARM şablonunda örneği oluşturulursa çakışmalar ortaya çıkabilir. Bu yükleme zamanı çakışmalarını önlemek için, uzantıların sırayla yüklendiğinden emin olmak için yönergesini kullanındependsOn. Uzantılar her iki sırayla da yüklenebilir.

Azure VM uzantıları Azure Resource Manager şablonlarıyla dağıtılabilir. Şablonlar, Azure İzleyici Günlüklerine ekleme gibi dağıtım sonrası yapılandırma gerektiren bir veya daha fazla sanal makine dağıtılırken idealdir. Log Analytics aracısı VM uzantısını içeren örnek bir Resource Manager şablonu Azure Hızlı Başlangıç Galerisi'nde bulunabilir.

Bir sanal makine uzantısının JSON yapılandırması, sanal makine kaynağının içine yerleştirilebilir veya Resource Manager JSON şablonunun köküne veya en üst düzeyine yerleştirilebilir. JSON yapılandırmasının yerleştirilmesi, kaynak adı ve türünün değerini etkiler. Daha fazla bilgi için bkz . Alt kaynaklar için ad ve tür ayarlama.

Aşağıdaki örnekte, VM uzantısının sanal makine kaynağının içinde iç içe yerleştirilmiş olduğu varsayılır. Uzantı kaynağını iç içe yerleştirirken, JSON sanal makinenin nesnesine yerleştirilir "resources": [] .

{
  "type": "extensions",
  "name": "OMSExtension",
  "apiVersion": "2018-06-01",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
  ],
  "properties": {
    "publisher": "Microsoft.EnterpriseCloud.Monitoring",
    "type": "OmsAgentForLinux",
    "typeHandlerVersion": "1.16",
    "settings": {
      "workspaceId": "myWorkspaceId",
      "skipDockerProviderInstall": true
    },
    "protectedSettings": {
      "workspaceKey": "myWorkSpaceKey"
    }
  }
}

JSON uzantısını şablonun köküne yerleştirirken, kaynak adı üst sanal makineye bir başvuru içerir ve tür iç içe yapılandırmayı yansıtır.

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "name": "<parentVmResource>/OMSExtension",
  "apiVersion": "2018-06-01",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
  ],
  "properties": {
    "publisher": "Microsoft.EnterpriseCloud.Monitoring",
    "type": "OmsAgentForLinux",
    "typeHandlerVersion": "1.16",
    "settings": {
      "workspaceId": "myWorkspaceId",
      "skipDockerProviderInstall": true
    },
    "protectedSettings": {
      "workspaceKey": "myWorkSpaceKey"
    }
  }
}

Azure CLI dağıtımı

Azure CLI, Log Analytics aracısı VM uzantısını mevcut bir sanal makineye dağıtmak için kullanılabilir. Aşağıdaki myWorkspaceKey değerini çalışma alanı anahtarınız ve myWorkspaceId değerini çalışma alanı kimliğiniz ile değiştirin. Bu değerler, Azure portalındaki Log Analytics çalışma alanınızda Gelişmiş Ayarlar altında bulunabilir. latestVersion değerini Log Analytics Linux VM uzantısı sürümünden bir sürümle değiştirin.

az vm extension set \
  --resource-group myResourceGroup \
  --vm-name myVM \
  --name OmsAgentForLinux \
  --publisher Microsoft.EnterpriseCloud.Monitoring \
  --protected-settings '{"workspaceKey":"myWorkspaceKey"}' \
  --settings '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}' \
  --version latestVersion

Azure PowerShell dağıtımı

Azure PowerShell cmdlet'leri Log Analytics aracısı VM uzantısını mevcut bir sanal makineye dağıtmak için kullanılabilir. Aşağıdaki myWorkspaceKey değerini çalışma alanı anahtarınız ve myWorkspaceId değerini çalışma alanı kimliğiniz ile değiştirin. Bu değerler, Azure portalındaki Log Analytics çalışma alanınızda Gelişmiş Ayarlar altında bulunabilir. latestVersion değerini Log Analytics Linux VM uzantısı sürümünden bir sürümle değiştirin.

Set-AzVMExtension \
  -ResourceGroupName myResourceGroup \
  -VMName myVM \
  -ExtensionName OmsAgentForLinux \
  -ExtensionType OmsAgentForLinux \
  -Publisher Microsoft.EnterpriseCloud.Monitoring \
  -TypeHandlerVersion latestVersion \
  -ProtectedSettingString '{"workspaceKey":"myWorkspaceKey"}' \
  -SettingString '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}'

Sorun giderme ve destek

Sorun giderme

Uzantı dağıtımlarının durumuyla ilgili veriler Azure portalından ve Azure CLI veya Azure PowerShell kullanılarak alınabilir. Belirli bir VM'nin uzantılarının dağıtım durumunu görmek için Azure CLI kullanıyorsanız aşağıdaki komutu çalıştırın.

az vm extension list --resource-group myResourceGroup --vm-name myVM -o table

Uzantı yürütme çıkışı şu dosyada günlüğe kaydedilir:

/var/log/azure/Microsoft.EnterpriseCloud.Monitoring.OmsAgentForLinux/extension.log

Bir VM'de yüklü OMS uzantısı sürümünü almak için, Azure CLI kullanıyorsanız aşağıdaki komutu çalıştırın.

az vm extension show --resource-group myResourceGroup --vm-name myVM --instance-view

Bir VM'de yüklü OMS uzantısı sürümünü almak için Azure PowerShell kullanıyorsanız aşağıdaki komutu çalıştırın.

Get-AzVMExtension -ResourceGroupName my_resource_group  -VMName my_vm_name -Name OmsAgentForLinux -Status

Hata kodları ve anlamları

Hata Kodu	Anlamı	Olası Eylem
9	Erken çağrılmasını etkinleştir	Azure Linux Aracısı'nı kullanılabilir en son sürüme güncelleştirin.
10	VM zaten bir Log Analytics çalışma alanına bağlı	VM'yi uzantı şemasında belirtilen çalışma alanına bağlamak için, genel ayarlarda stopOnMultiple Bağlan ions değerini false olarak ayarlayın veya bu özelliği kaldırın. Bu VM, bağlı olduğu her çalışma alanı için bir kez faturalandırılır.
11	Uzantıya geçersiz yapılandırma sağlandı	Dağıtım için gereken tüm özellik değerlerini ayarlamak için yukarıdaki örnekleri izleyin.
17	Log Analytics paketi yükleme hatası
18	OMSConfig paketi yüklenemedi.	Kök hata için komut çıkışına bakın.
19	OMI paketi yükleme hatası
20	SCX paketi yükleme hatası
33	omsconfig için meta yapılandırma oluşturulurken hata oluştu.	Çıktıdaki ayrıntıları içeren bir GitHub Sorunu oluşturun.
51	Bu uzantı VM'nin işlem sisteminde desteklenmiyor
52	Bu uzantı eksik bağımlılık veya izin nedeniyle başarısız oldu	Hangi bağımlılığın veya iznin eksik olduğu hakkında daha fazla bilgi için çıktıyı ve günlükleri denetleyin.
53	Bu uzantı eksik veya yanlış yapılandırma parametreleri nedeniyle başarısız oldu	Neyin yanlış gittiği hakkında daha fazla bilgi için çıktıyı ve günlükleri denetleyin. Ayrıca, çalışma alanı kimliğinin doğruluğunu denetleyin ve makinenin İnternet'e bağlı olduğunu doğrulayın.
55	Azure İzleyici hizmetine bağlanılamıyor veya gerekli paketler eksik veya dpkg paket yöneticisi kilitlendi	Sistemin İnternet erişimi olup olmadığını veya geçerli bir HTTP proxy'si sağlandığını denetleyin. Ayrıca, çalışma alanı kimliğinin doğruluğunu denetleyin ve curl ve tar yardımcı programlarının yüklendiğini doğrulayın.

Ek sorun giderme bilgileri Log Analytics-Agent-for-Linux Sorun Giderme Kılavuzu'nda bulunabilir.

Destek

Bu makalenin herhangi bir noktasında daha fazla yardıma ihtiyacınız varsa MSDN Azure ve Stack Overflow forumlarında Azure uzmanlarına başvurabilirsiniz. Alternatif olarak, bir Azure desteği olayı da oluşturabilirsiniz. Azure desteği sitesine gidin ve Destek al'ı seçin. Azure Desteği'ni kullanma hakkında bilgi için Microsoft Azure desteği SSS bölümünü okuyun.