Windows ve Linux için Log Analytics aracısını yönetme ve bakımını yapma

Makale
10/15/2024

Azure İzleyici'de Log Analytics Windows veya Linux aracısının ilk dağıtımından sonra aracıyı yeniden yapılandırmanız, yükseltmeniz veya yaşam döngüsünde kullanımdan kaldırma aşamasına ulaştıysa bilgisayardan kaldırmanız gerekebilir. Bu rutin bakım görevlerini el ile veya otomasyon aracılığıyla kolayca yönetebilirsiniz; bu da hem operasyonel hataları hem de giderleri azaltır.

Önemli

Eski Log Analytics aracısı 31 Ağustos 2024 itibarıyla kullanımdan kaldırılmıştır. Microsoft artık Log Analytics aracısı için herhangi bir destek sağlamayacaktır. Verileri Azure İzleyici'ye almak için Log Analytics aracısını kullanıyorsanız şimdi Azure İzleyici aracısına geçin.

Aracıyı yükseltme

Dağıtım senaryonuza ve VM'nin çalıştığı ortama göre Windows ve Linux için Log Analytics aracısının en son sürümüne el ile veya otomatik olarak yükseltin.

Ortam	Yükleme yöntemi	Yükseltme yöntemi
Azure VM	Windows/Linux için Log Analytics aracısı VM uzantısı	Azure Resource Manager şablonunuzu özelliğini `autoUpgradeMinorVersion` false olarak ayarlayarak devre dışı bırakacak şekilde yapılandırmadığınız sürece, aracı VM modeli değiştikten sonra otomatik olarak yükseltilir. Ancak dağıtıldıktan sonra, bu özellik true olarak ayarlanmış olsa bile uzantı yeniden dağıtılmadığı sürece ikincil sürümleri yükseltmez. Yalnızca Linux aracısı özelliğiyle `enableAutomaticUpgrade` dağıtım sonrası otomatik güncelleştirmeyi destekler (bkz . Linux aracısı için Otomatik güncelleştirmeyi etkinleştirme). Ana sürüm yükseltmesi her zaman el ile yapılır (bkz . VirtualMachineExtensionInner.AutoUpgradeMinorVersion Özelliği).
Özel Azure VM görüntüleri	Windows/Linux için Log Analytics aracısını el ile yükleme	VM'leri aracının en yeni sürümüne güncelleştirme işlemi, Windows installer paketini veya Linux kendi kendine ayıklanan ve yüklenebilir kabuk betiği paketini çalıştıran komut satırından gerçekleştirilmelidir.
Azure dışı VM'ler	Windows/Linux için Log Analytics aracısını el ile yükleme	VM'leri aracının en yeni sürümüne güncelleştirme işlemi, Windows installer paketini veya Linux kendi kendine ayıklanan ve yüklenebilir kabuk betiği paketini çalıştıran komut satırından gerçekleştirilmelidir.

Windows aracısını yükseltme

Windows VM'sinde aracıyı Log Analytics VM uzantısı kullanılarak yüklenmeyen en son sürüme güncelleştirmek için komut isteminden, betikten veya başka bir otomasyon çözümünden çalıştırabilir veya MMASetup-platform<>.msi Kurulum Sihirbazı'nı kullanabilirsiniz.

Log Analytics çalışma alanınızdan Windows aracısının en son sürümünü indirmek için:

Azure Portal’ında oturum açın.
Azure portalda Tüm hizmetler’i seçin. Kaynak listesine Log Analytics yazın. Yazmaya başladığınızda liste, girişinize göre filtrelenir. Log Analytics çalışma alanı’nı seçin.
Log Analytics çalışma alanları listenizde çalışma alanını seçin.
Log Analytics çalışma alanınızda Aracılar kutucuğunu ve ardından Windows Sunucuları'nı seçin.
Windows Sunucuları ekranında, Windows işletim sisteminin işlemci mimarisine bağlı olarak indirebileceğiniz uygun Windows Aracısı sürümünü seçin.

Not

Windows için Log Analytics aracısının yükseltilmesi sırasında, rapor vermek üzere bir çalışma alanının yapılandırılmasını veya yeniden yapılandırılmasını desteklemez. Aracıyı yapılandırmak için, Çalışma alanı ekleme veya kaldırma altında listelenen desteklenen yöntemlerden birini izleyin.

Kurulum Sihirbazı'nı kullanarak yükseltme

Bilgisayarda yönetici haklarına sahip bir hesapla oturum açın.
Kurulum Sihirbazı'nı başlatmak için MMASetup-platform><.exe yürütür.
Kurulum Sihirbazı'nın ilk sayfasında İleri'yi seçin.
Microsoft Monitoring Agent Kurulumu iletişim kutusunda Lisans sözleşmesini kabul ediyorum'u seçin.
Microsoft Monitoring Agent Kurulumu iletişim kutusunda Yükselt'i seçin. Durum sayfası yükseltmenin ilerleyişini görüntüler.
Microsoft Monitoring Agent yapılandırması başarıyla tamamlandığında sayfası görüntülendiğinde Son'u seçin.

Komut satırından yükseltme

Bilgisayarda yönetici haklarına sahip bir hesapla oturum açın.
Aracı yükleme dosyalarını ayıklamak için, yükseltilmiş bir komut isteminden komutunu çalıştırın MMASetup-<platform>.exe /c ; sizden dosyaları ayıklamanın yolunu sorar. Alternatif olarak, bağımsız değişkenlerini MMASetup-<platform>.exe /c /t:<Full Path>geçirerek yolu belirtebilirsiniz.
Aşağıdaki komutu çalıştırın; burada D:\ yükseltme günlük dosyasının konumudur:
```
setup.exe /qn /l*v D:\logs\AgentUpgrade.log AcceptEndUserLicenseAgreement=1
```

Linux aracısını yükseltme

Önceki sürümlerden yükseltme (>1.0.0-47) desteklenir. komutuyla --upgrade yüklemeyi gerçekleştirmek, aracının tüm bileşenlerini en son sürüme yükseltecektir.

Aracıyı yükseltmek için aşağıdaki komutu çalıştırın:

sudo sh ./omsagent-*.universal.x64.sh --upgrade

Linux aracısı için otomatik güncelleştirmeyi etkinleştirme

Aracıyı otomatik olarak güncelleştirmek için bu komutları kullanarak Otomatik Uzantı Yükseltme'yi etkinleştirmenizi öneririz.

PowerShell
Azure CLI

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

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 \
  --enable-auto-upgrade true

Çalışma alanı ekleme veya kaldırma

Windows aracısını veya Linux aracısını kullanarak çalışma alanı ekleyin veya kaldırın.

Windows aracısı

Bu bölümdeki adımlar yalnızca Windows aracısını farklı bir çalışma alanına rapor vermek veya yapılandırmasından bir çalışma alanını kaldırmak için yeniden yapılandırmak istediğinizde değil, aynı zamanda aracıyı birden fazla çalışma alanına rapor vermek üzere yapılandırmak istediğinizde de gereklidir. (Bu uygulama genellikle çok ana bilgisayarlı olarak adlandırılır.) Windows aracısını birden çok çalışma alanına rapor vermek üzere yapılandırmak, yalnızca aracının ilk kurulumundan sonra ve bu bölümde açıklanan yöntemler kullanılarak gerçekleştirilebilir.

Denetim Masası ayarlarını güncelleştirme

Bilgisayarda yönetici haklarına sahip bir hesapla oturum açın.
Denetim Masası'nı açın.
Microsoft Monitoring Agent'ı ve ardından Azure Log Analytics sekmesini seçin.
Bir çalışma alanını kaldırıyorsanız, çalışma alanını seçin ve ardından Kaldır'ı seçin. Aracının raporlamayı durdurmasını istediğiniz diğer tüm çalışma alanları için bu adımı yineleyin.
Çalışma alanı ekliyorsanız Ekle'yi seçin. Log Analytics Çalışma Alanı Ekle iletişim kutusunda çalışma alanı kimliğini ve çalışma alanı anahtarını (birincil anahtar) yapıştırın. Bilgisayarın Azure Kamu buluttaki bir Log Analytics çalışma alanına rapor vermesi gerekiyorsa, Azure Bulut açılan listesinden Azure US Government'ı seçin.
Değişikliklerinizi kaydetmek için Tamam'ı seçin.

PowerShell kullanarak çalışma alanını kaldırma

$workspaceId = "<Your workspace Id>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.RemoveCloudWorkspace($workspaceId)
$mma.ReloadConfiguration()

PowerShell kullanarak Azure ticari uygulamasında çalışma alanı ekleme

$workspaceId = "<Your workspace Id>"
$workspaceKey = "<Your workspace Key>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey)
$mma.ReloadConfiguration()

PowerShell kullanarak ABD Kamu için Azure'da çalışma alanı ekleme

$workspaceId = "<Your workspace Id>"
$workspaceKey = "<Your workspace Key>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey, 1)
$mma.ReloadConfiguration()

Not

Aracıyı yüklemek veya yapılandırmak için daha önce komut satırını veya betiği kullandıysanız, EnableAzureOperationalInsights ve RemoveCloudWorkspaceile AddCloudWorkspace değiştirildi.

Linux Aracısı

Aşağıdaki adımlar, farklı bir çalışma alanına kaydetmeye veya bir çalışma alanını yapılandırmasından kaldırmaya karar verirseniz Linux aracısını nasıl yeniden yapılandırabileceğinizi gösterir.

Aracının bir çalışma alanına kayıtlı olduğunu doğrulamak için aşağıdaki komutu çalıştırın:

/opt/microsoft/omsagent/bin/omsadmin.sh -l

Aşağıdaki örneğe benzer bir durum döndürmelidir:

Primary Workspace: <workspaceId> Status: Onboarded(OMSAgent Running)

Durumun aracının çalıştığını da göstermesi önemlidir. Aksi takdirde, aracıyı yeniden yapılandırmak için aşağıdaki adımlar başarıyla tamamlanmaz.
Aracı zaten bir çalışma alanına kayıtlıysa, aşağıdaki komutu çalıştırarak kayıtlı çalışma alanını kaldırın. Aksi takdirde, kayıtlı değilse sonraki adıma geçin.

/opt/microsoft/omsagent/bin/omsadmin.sh -X
Farklı bir çalışma alanına kaydolmak için aşağıdaki komutu çalıştırın:

/opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>]
Değişikliklerinizin etkili olduğunu doğrulamak için aşağıdaki komutu çalıştırın:

/opt/microsoft/omsagent/bin/omsadmin.sh -l

Aşağıdaki örneğe benzer bir durum döndürmelidir:

Primary Workspace: <workspaceId> Status: Onboarded(OMSAgent Running)

Değişikliklerin etkili olması için aracı hizmetinin yeniden başlatılması gerekmez.

Proxy ayarlarını güncelleştirme

Log Analytics Aracısı (MMA), sistem ara sunucusu ayarlarını kullanmaz. Sonuç olarak, MMA'yı yüklerken ara sunucu ayarlarını geçirmeniz gerekir. Bu ayarlar VM'de MMA yapılandırması (kayıt defteri) altında depolanır. Aracıyı dağıtımdan sonra ara sunucu veya Log Analytics ağ geçidi üzerinden hizmetle iletişim kuracak şekilde yapılandırmak için bu görevi tamamlamak için aşağıdaki yöntemlerden birini kullanın.

Windows aracısı

Bir Windows aracısı kullanın.

Denetim Masası kullanarak ayarları güncelleştirme

Bilgisayarda yönetici haklarına sahip bir hesapla oturum açın.
Denetim Masası'nı açın.
Microsoft Monitoring Agent'ı ve ardından Ara Sunucu Ayarları sekmesini seçin.
Ara sunucu kullan'ı seçip ara sunucunun veya ağ geçidinin URL'sini ve bağlantı noktası numarasını girin. Proxy sunucunuz veya Log Analytics ağ geçidiniz kimlik doğrulaması gerektiriyorsa, kimlik doğrulaması için kullanıcı adını ve parolayı girin ve tamam'ı seçin.

PowerShell kullanarak ayarları güncelleştirme

Aşağıdaki örnek PowerShell kodunu kopyalayın, ortamınıza özgü bilgilerle güncelleştirin ve bir PS1 dosya adı uzantısıyla kaydedin. Betiği Azure İzleyici'deki Log Analytics çalışma alanına doğrudan bağlanan her bilgisayarda çalıştırın.

param($ProxyDomainName="https://proxy.contoso.com:30443", $cred=(Get-Credential))

# First we get the Health Service configuration object. We need to determine if we
#have the right update rollup with the API we need. If not, no need to run the rest of the script.
$healthServiceSettings = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'

$proxyMethod = $healthServiceSettings | Get-Member -Name 'SetProxyInfo'

if (!$proxyMethod)
{
    Write-Output 'Health Service proxy API not present, will not update settings.'
    return
}

Write-Output "Clearing proxy settings."
$healthServiceSettings.SetProxyInfo('', '', '')

$ProxyUserName = $cred.username

Write-Output "Setting proxy to $ProxyDomainName with proxy username $ProxyUserName."
$healthServiceSettings.SetProxyInfo($ProxyDomainName, $ProxyUserName, $cred.GetNetworkCredential().password)

Linux Aracısı

Linux bilgisayarlarınızın bir ara sunucu veya Log Analytics ağ geçidi üzerinden iletişim kurması gerekiyorsa aşağıdaki adımları gerçekleştirin. Ara sunucu yapılandırma değeri aşağıdaki söz dizimine sahiptir: [protocol://][user:password@]proxyhost[:port]. özelliği, proxyhost ara sunucunun tam etki alanı adını veya IP adresini kabul eder.

Aşağıdaki komutları çalıştırarak dosyayı /etc/opt/microsoft/omsagent/proxy.conf düzenleyin ve değerleri kendi ayarlarınızla değiştirin:

proxyconf="https://proxyuser:proxypassword@proxyserver01:30443"
sudo echo $proxyconf >>/etc/opt/microsoft/omsagent/proxy.conf
sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/proxy.conf

Aşağıdaki komutu çalıştırarak aracıyı yeniden başlatın:

sudo /opt/microsoft/omsagent/bin/service_control restart [<workspace id>]

Günlükte görüyorsanızcURL failed to perform on this base url, hatayı çözmek için EOF'de proxy.conf kaldırmayı '\n' deneyebilirsiniz:

od -c /etc/opt/microsoft/omsagent/proxy.conf
cat /etc/opt/microsoft/omsagent/proxy.conf | tr -d '\n' > /etc/opt/microsoft/omsagent/proxy2.conf
rm /etc/opt/microsoft/omsagent/proxy.conf
mv /etc/opt/microsoft/omsagent/proxy2.conf /etc/opt/microsoft/omsagent/proxy.conf
sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/proxy.conf
sudo /opt/microsoft/omsagent/bin/service_control restart [<workspace id>]

Aracıyı kaldırma

Komut satırını veya Kurulum Sihirbazı'nı kullanarak Windows veya Linux aracısını kaldırmak için aşağıdaki yordamlardan birini kullanın.

Windows aracısı

Windows aracısını kullanın.

Denetim Masası'dan kaldırma

Bilgisayarda yönetici haklarına sahip bir hesapla oturum açın.
Denetim Masası'nda, Programlar ve Özellikler'i seçin.
Programlar ve Özellikler'de Microsoft Monitoring Agent>Kaldırma Evet'i> seçin.

Not

Aracı Kurulum Sihirbazı, Azure portalındaki bir çalışma alanından indirilebilen öğesine çift tıklayarak MMASetup-\<platform\>.exeda çalıştırılabilir.

Komut satırından kaldırma

Aracı için indirilen dosya, IExpress ile oluşturulan bağımsız bir yükleme paketidir. Aracı ve destekleyici dosyalar için kurulum programı pakette yer alır ve aşağıdaki örnekte gösterilen komut satırı kullanılarak düzgün bir şekilde kaldırılacak şekilde ayıklanmalıdır.

Bilgisayarda yönetici haklarına sahip bir hesapla oturum açın.
Aracı yükleme dosyalarını ayıklamak için, yükseltilmiş bir komut isteminden komutunu çalıştırın extract MMASetup-<platform>.exe ve sizden dosyaları ayıklama yolunu ister. Alternatif olarak, bağımsız değişkenlerini extract MMASetup-<platform>.exe /c:<Path> /t:<Path>geçirerek yolu belirtebilirsiniz. IExpress tarafından desteklenen komut satırı anahtarları hakkında daha fazla bilgi için bkz . IExpress için komut satırı anahtarları ve ardından örneği gereksinimlerinize uyacak şekilde güncelleştirme.
İstemde girin %WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb.

Linux Aracısı

Aracıyı kaldırmak için Linux bilgisayarında aşağıdaki komutu çalıştırın. --purge bağımsız değişkeni aracıyı ve yapılandırmasını tamamen kaldırır.

wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh --purge

Aracıyı Operations Manager yönetim grubuna rapor vermek üzere yapılandırma

Windows aracısını kullanın.

Windows aracısı

Windows için Log Analytics aracısını bir System Center Operations Manager yönetim grubuna rapor vermek üzere yapılandırmak üzere aşağıdaki adımları gerçekleştirin.

Not

Microsoft Operations Management Suite'ten Azure İzleyici'ye devam eden geçişin bir parçası olarak, Windows veya Linux için Operations Management Suite Aracısı, Windows için Log Analytics aracısı ve Linux için Log Analytics aracısı olarak adlandırılır.

Bilgisayarda yönetici haklarına sahip bir hesapla oturum açın.
Denetim Masası'nı açın.
Microsoft Monitoring Agent'ı ve ardından Operations Manager sekmesini seçin.
Operations Manager sunucularınızın Active Directory ile tümleştirmesi varsa AD DS'den yönetim grubu atamalarını otomatik olarak güncelleştir'i seçin.
Yönetim Grubu Ekle iletişim kutusunu açmak için Ekle'yi seçin.
Yönetim grubu adı alanına yönetim grubunuzun adını girin.
Birincil yönetim sunucusu alanına, birincil yönetim sunucusunun bilgisayar adını girin.
Yönetim sunucusu bağlantı noktası alanına TCP bağlantı noktası numarasını girin.
Aracı Eylem Hesabı'nın altında yerel sistem hesabını veya yerel bir etki alanı hesabını seçin.
Yönetim Grubu Ekle iletişim kutusunu kapatmak için Tamam'ı seçin. Ardından Tamam'ı seçerek Microsoft Monitoring Agent Özellikleri iletişim kutusunu kapatın.

Linux Aracısı

Linux için Log Analytics aracısını bir System Center Operations Manager yönetim grubuna rapor vermek üzere yapılandırmak üzere aşağıdaki adımları gerçekleştirin.

Not

/etc/opt/omi/conf/omiserver.conf dosyasını düzenleyin.
ile httpsport= başlayan satırın gibi 1270 httpsport=1270numaralı bağlantı noktasını tanımladığından emin olun.
Aşağıdaki komutu kullanarak OMI sunucusunu yeniden başlatın:

sudo /opt/omi/bin/service_control restart

Sık sorulan sorular

Bu bölüm, sık sorulan soruların yanıtlarını sağlar.

Log Analytics aracısının Azure İzleyici ile iletişim kurmasını Nasıl yaparım? durdurdu?

Log Analytics'e doğrudan bağlı aracılar için Denetim Masası açın ve Microsoft Monitoring Agent'ı seçin. Azure Log Analytics (OMS) sekmesinin altında listelenen tüm çalışma alanlarını kaldırın. System Center Operations Manager'da, bilgisayarı Log Analytics ile yönetilen bilgisayarlar listesinden kaldırın. Operations Manager artık Log Analytics'e rapor vermek için aracının yapılandırmasını güncelleştirir.

Sonraki adımlar

Linux aracısını yüklerken veya yönetirken sorunlarla karşılaşırsanız Linux aracısı sorunlarını giderme makalesini gözden geçirin.
Windows aracısını yüklerken veya yönetirken sorunlarla karşılaşırsanız Windows aracısını giderme makalesini gözden geçirin.

Aracılığıyla paylaş

Windows ve Linux için Log Analytics aracısını yönetme ve bakımını yapma

Aracıyı yükseltme

Windows aracısını yükseltme

Kurulum Sihirbazı'nı kullanarak yükseltme

Komut satırından yükseltme

Linux aracısını yükseltme

Linux aracısı için otomatik güncelleştirmeyi etkinleştirme

Çalışma alanı ekleme veya kaldırma

Windows aracısı

Denetim Masası ayarlarını güncelleştirme

PowerShell kullanarak çalışma alanını kaldırma

PowerShell kullanarak Azure ticari uygulamasında çalışma alanı ekleme

PowerShell kullanarak ABD Kamu için Azure'da çalışma alanı ekleme

Linux Aracısı

Proxy ayarlarını güncelleştirme

Windows aracısı

Denetim Masası kullanarak ayarları güncelleştirme

PowerShell kullanarak ayarları güncelleştirme

Linux Aracısı

Aracıyı kaldırma

Windows aracısı

Denetim Masası'dan kaldırma

Komut satırından kaldırma

Linux Aracısı

Aracıyı Operations Manager yönetim grubuna rapor vermek üzere yapılandırma

Windows aracısı

Linux Aracısı

Sık sorulan sorular

Log Analytics aracısının Azure İzleyici ile iletişim kurmasını Nasıl yaparım? durdurdu?

Sonraki adımlar

Geri Bildirim

Ek kaynaklar