Mengelola dan mempertahankan agen Log Analytics untuk Windows dan Linux

  • Artikel

Setelah penyebaran awal agen Log Analytics Windows atau Linux di Azure Monitor, Anda mungkin perlu mengonfigurasi ulang agen, meningkatkannya, atau menghapusnya dari komputer jika telah mencapai tahap penghentian dalam siklus hidupnya. Anda dapat dengan mudah mengelola tugas pemeliharaan rutin ini secara manual atau melalui otomatisasi, yang mengurangi kesalahan operasional dan pengeluaran.

Penting

Agen Analitik Log warisan tidak akan digunakan lagi pada Agustus 2024. Setelah tanggal ini, Microsoft tidak akan lagi memberikan dukungan apa pun untuk agen Analitik Log. Bermigrasi ke agen Azure Monitor sebelum Agustus 2024 untuk terus menyerap data.

Meningkatkan agen

Tingkatkan ke rilis terbaru agen Analitik Log untuk Windows dan Linux secara manual atau otomatis berdasarkan skenario penyebaran Anda dan lingkungan tempat VM berjalan.

Lingkungan Metode penginstalan Metode peningkatan
Azure VM Ekstensi komputer virtual agen Log Analytics untuk Windows/Linux Agen secara otomatis ditingkatkan setelah model VM berubah, kecuali Anda mengonfigurasi templat Azure Resource Manager Untuk memilih keluar dengan mengatur properti autoUpgradeMinorVersion ke false. Namun, setelah disebarkan, ekstensi tidak akan meningkatkan versi minor kecuali disebarkan ulang, bahkan dengan properti ini diatur ke true. Hanya agen Linux yang mendukung penyebaran posting pembaruan otomatis dengan enableAutomaticUpgrade properti (lihat Mengaktifkan Pembaruan otomatis untuk agen Linux). Peningkatan versi utama selalu manual (lihat Properti VirtualMachineExtensionInner.AutoUpgradeMinorVersion).
Citra kustom Azure VM Penginstalan manual agen Analitik Log untuk Windows/Linux Memperbarui VM ke versi terbaru agen harus dilakukan dari baris perintah yang menjalankan paket penginstal Windows atau bundel skrip shell yang dapat diekstrak sendiri dan diinstal Linux.
VM Non-Azure Penginstalan manual agen Analitik Log untuk Windows/Linux Memperbarui VM ke versi terbaru agen harus dilakukan dari baris perintah yang menjalankan paket penginstal Windows atau bundel skrip shell yang dapat diekstrak sendiri dan diinstal Linux.

Memutakhirkan agen Windows

Untuk memperbarui agen pada VM Windows ke versi terbaru yang tidak diinstal dengan menggunakan ekstensi VM Analitik Log, Anda dapat menjalankan dari prompt perintah, skrip, atau solusi otomatisasi lainnya atau menggunakan Wizard Penyiapan MMASetup-platform.msi<>.

Untuk mengunduh versi terbaru agen Windows dari ruang kerja Log Analytics Anda:

  1. Masuk ke portal Azure.

  2. Di portal Microsoft Azure, pilih Semua layanan. Dalam daftar sumber daya, ketik Log Analytics. Saat Anda mulai mengetik, daftar akan memfilter berdasarkan input Anda. Pilih Ruang kerja Log Analytics.

  3. Dalam daftar ruang kerja Log Analytics, pilih ruang kerja.

  4. Di ruang kerja Analitik Log Anda, pilih petak peta Agen lalu pilih Windows Server.

  5. Pada layar Windows Servers, pilih versi Unduh Agen Windows yang sesuai untuk diunduh tergantung pada arsitektur prosesor sistem operasi Windows.

Catatan

Selama peningkatan agen Analitik Log untuk Windows, agen tersebut tidak mendukung konfigurasi atau konfigurasi ulang ruang kerja untuk dilaporkan. Untuk mengonfigurasi agen, ikuti salah satu metode yang didukung yang tercantum di bawah Tambahkan atau hapus ruang kerja.

Meningkatkan menggunakan Wizard Penyetelan

  1. Masuk ke komputer dengan akun yang memiliki hak administratif.

  2. Jalankan MMASetup-platform.exe<> untuk memulai Wizard Penyiapan.

  3. Pada halaman pertama Wizard Penyetelan, pilih Berikutnya.

  4. Dalam dialog Penyiapan Agen Pemantauan Microsoft, pilih Saya setuju untuk menerima perjanjian lisensi.

  5. Dalam dialog Penyetelan Agen Pemantauan Microsoft, pilih Tingkatkan. Halaman status menampilkan kemajuan peningkatan.

  6. Saat halaman Konfigurasi Microsoft Monitoring Agent berhasil diselesaikan muncul, pilih Selesai.

Meningkatkan dari baris perintah

  1. Masuk ke komputer dengan akun yang memiliki hak administratif.

  2. Untuk mengekstrak file penginstalan agen, jalankan MMASetup-<platform>.exe /c dari prompt perintah yang ditingkatkan, dan itu akan meminta Anda untuk mengekstrak file. Atau, Anda dapat menentukan jalur dengan meneruskan argumen MMASetup-<platform>.exe /c /t:<Full Path>.

  3. Jalankan perintah berikut, di mana D:\ adalah lokasi untuk file log pemutakhiran:

    setup.exe /qn /l*v D:\logs\AgentUpgrade.log AcceptEndUserLicenseAgreement=1

Meningkatkan agen Linux

Peningkatan dari versi sebelumnya (>1.0.0-47) didukung. Menjalankan penginstalan dengan perintah --upgrade akan meningkatkan semua komponen agen ke versi terbaru.

Jalankan perintah berikut untuk meningkatkan agen:

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

Mengaktifkan pembaruan otomatis untuk agen Linux

Kami menyarankan agar Anda mengaktifkan Peningkatan Ekstensi Otomatis dengan menggunakan perintah ini untuk memperbarui agen secara otomatis.

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

Menambahkan atau menghapus ruang kerja

Menambahkan atau menghapus ruang kerja menggunakan agen Windows atau agen Linux.

Agen Windows

Langkah-langkah di bagian ini diperlukan tidak hanya ketika Anda ingin mengonfigurasi ulang agen Windows untuk melaporkan ke ruang kerja yang berbeda atau menghapus ruang kerja dari konfigurasinya, tetapi juga ketika Anda ingin mengonfigurasi agen untuk melaporkan ke lebih dari satu ruang kerja. (Praktik ini biasanya disebut sebagai multihoming.) Mengonfigurasi agen Windows untuk melaporkan ke beberapa ruang kerja hanya dapat dilakukan setelah penyiapan awal agen dan dengan menggunakan metode yang dijelaskan di bagian ini.

Memperbarui pengaturan dari Panel Kontrol

  1. Masuk ke komputer dengan akun yang memiliki hak administratif.

  2. Buka Panel Kontrol.

  3. Pilih Microsoft Monitoring Agent lalu pilih tab Azure Log Analytics .

  4. Jika Anda menghapus ruang kerja, pilih ruang kerja tersebut lalu pilih Hapus. Ulangi langkah ini untuk ruang kerja lain yang agennya ingin Anda hentikan pelaporannya.

  5. Jika Anda menambahkan ruang kerja, pilih Tambahkan. Dalam dialog Tambahkan Ruang Kerja Analitik Log, tempelkan ID ruang kerja dan kunci ruang kerja (kunci primer). Jika komputer harus melapor ke ruang kerja Analitik Log di cloud Azure Government, pilih Azure US Government dari daftar tarik-turun Azure Cloud.

  6. Pilih OK untuk menyimpan perubahan Anda.

Menghapus ruang kerja menggunakan PowerShell

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

Menambahkan ruang kerja di komersial Azure menggunakan PowerShell

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

Menambahkan ruang kerja di Azure untuk Pemerintah AS menggunakan PowerShell

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

Catatan

Jika sebelumnya Anda pernah menggunakan baris perintah atau skrip untuk menginstal atau mengonfigurasi agen, EnableAzureOperationalInsights digantikan oleh AddCloudWorkspace dan RemoveCloudWorkspace.

Agen Linux

Langkah-langkah berikut menunjukkan cara mengonfigurasi ulang agen Linux jika Anda memutuskan untuk mendaftarkannya dengan ruang kerja yang berbeda atau menghapus ruang kerja dari konfigurasinya.

  1. Untuk memverifikasi agen terdaftar ke ruang kerja, jalankan perintah berikut:

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

    Perintah tersebut seharusnya akan menampilkan status yang mirip dengan contoh berikut:

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

    Penting bahwa status juga menunjukkan agen sedang berjalan. Jika tidak, langkah-langkah berikut untuk mengonfigurasi ulang agen tidak akan berhasil diselesaikan.

  2. Jika agen sudah terdaftar di ruang kerja, hapus ruang kerja terdaftar dengan menjalankan perintah berikut. Jika tidak, jika tidak terdaftar, lanjutkan ke langkah berikutnya.

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

  3. Untuk mendaftarkan dengan ruang kerja yang lain, jalankan perintah berikut:

    /opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>]

  4. Untuk memverifikasi diterapkan tidaknya perubahan Anda, jalankan perintah berikut:

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

    Perintah tersebut seharusnya akan menampilkan status yang mirip dengan contoh berikut:

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

Layanan agen tidak perlu dimulai ulang agar perubahan diterapkan.

Memperbarui pengaturan proksi

Agen Analitik Log (MMA) tidak menggunakan pengaturan proksi sistem. Akibatnya, Anda harus meneruskan pengaturan proksi saat menginstal MMA. Pengaturan ini akan disimpan di bawah konfigurasi MMA (registri) pada VM. Untuk mengonfigurasi agen agar berkomunikasi dengan layanan melalui server proksi atau gateway Log Analytics setelah penyebaran, gunakan salah satu metode berikut untuk menyelesaikan tugas ini.

Agen Windows

Gunakan agen Windows.

Memperbarui pengaturan menggunakan Panel Kontrol

  1. Masuk ke komputer dengan akun yang memiliki hak administratif.

  2. Buka Panel Kontrol.

  3. Pilih Microsoft Monitoring Agent lalu pilih tab Proksi Pengaturan.

  4. Klik Gunakan server proksi dan berikan URL dan nomor port server proksi atau gateway. Jika server proksi atau gateway Analitik Log Anda memerlukan autentikasi, masukkan nama pengguna dan kata sandi untuk mengautentikasi lalu pilih OK.

Perbarui pengaturan menggunakan PowerShell

Salin sampel kode PowerShell berikut, perbarui dengan informasi spesifik untuk lingkungan Anda, dan simpan dengan ekstensi nama file PS1. Jalankan skrip di setiap komputer yang tersambung langsung ke ruang kerja Log Analytics di Azure Monitor.

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)

Agen Linux

Lakukan langkah-langkah berikut jika komputer Linux Anda perlu berkomunikasi melalui server proksi atau gateway Log Analytics. Nilai konfigurasi proksi memiliki sintaks berikut: [protocol://][user:password@]proxyhost[:port]. Properti proxyhost menerima nama domain atau alamat IP server proksi yang sepenuhnya memenuhi syarat.

  1. Edit file /etc/opt/microsoft/omsagent/proxy.conf dengan menjalankan perintah berikut dan ubah nilai ke pengaturan spesifik Anda:

    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

  2. Hidupkan ulang agen dengan menjalankan perintah berikut:

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

    Jika Anda melihat cURL failed to perform on this base url di log, Anda dapat mencoba menghapus '\n' di proxy.conf EOF untuk mengatasi kegagalan:

    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>]

Hapus instalan agen

Gunakan salah satu prosedur berikut untuk menghapus instalan agen Windows atau Linux dengan menggunakan baris perintah atau Wizard Penyetelan.

Agen Windows

Gunakan agen Windows.

Hapus instalan dari Panel Kontrol

  1. Masuk ke komputer dengan akun yang memiliki hak administratif.

  2. Di Panel Kontrol, pilih Program dan Fitur.

  3. Di Program dan Fitur, pilih Hapus Instalan>Agen>Pemantauan Microsoft Ya.

Catatan

Wizard Penyetelan Agen juga dapat dijalankan dengan mengklik MMASetup-\<platform\>.exedua kali , yang tersedia untuk diunduh dari ruang kerja di portal Azure.

Hapus instalan dari baris perintah

File yang diunduh untuk agen adalah paket penginstalan mandiri yang dibuat dengan IExpress. Program penyiapan untuk agen dan file pendukung terkandung dalam paket dan harus diekstrak untuk menghapus instalasi dengan benar dengan menggunakan baris perintah yang ditunjukkan dalam contoh berikut.

  1. Masuk ke komputer dengan akun yang memiliki hak administratif.

  2. Untuk mengekstrak file penginstalan agen, dari perintah yang ditinggikan, jalankan extract MMASetup-<platform>.exe dan ini akan meminta Anda jalur untuk mengekstrak file. Atau, Anda dapat menentukan jalur dengan meneruskan argumen extract MMASetup-<platform>.exe /c:<Path> /t:<Path>. Untuk informasi selengkapnya tentang sakelar baris perintah yang didukung oleh IExpress, lihat Sakelar baris perintah untuk IExpress lalu perbarui contoh agar sesuai dengan kebutuhan Anda.

  3. Pada perintah, masukkan %WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb.

Agen Linux

Untuk menghapus agen, jalankan perintah berikut di komputer Linux. Argumen --purge sepenuhnya menghapus agen dan konfigurasinya.

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

Mengonfigurasi agen untuk melaporkan ke grup manajemen Manajer Operasi

Gunakan agen Windows.

Agen Windows

Lakukan langkah-langkah berikut untuk mengonfigurasi agen Log Analytics untuk Windows agar dilaporkan ke grup manajemen Manajer Operasi Pusat Sistem.

Catatan

Sebagai bagian dari transisi yang sedang berlangsung dari Microsoft Operations Management Suite ke Azure Monitor, Operations Management Suite Agent untuk Windows atau Linux akan disebut sebagai agen Analitik Log untuk Windows dan agen Analitik Log untuk Linux.

  1. Masuk ke komputer dengan akun yang memiliki hak administratif.

  2. Buka Panel Kontrol.

  3. Pilih Microsoft Monitoring Agent lalu pilih tab Manajer Operasi.

  4. Jika server Operations Manager Anda memiliki integrasi dengan Direktori Aktif, pilih Perbarui penetapan grup manajemen secara otomatis dari AD DS.

  5. Pilih Tambahkan untuk membuka dialog Tambahkan Grup Manajemen.

  6. Di bidang Nama grup manajemen, masukkan nama grup manajemen Anda.

  7. Di bidang Server manajemen utama, masukkan nama komputer server manajemen utama.

  8. Di bidang Port server manajemen, masukkan nomor port TCP.

  9. Di bawah Akun Tindakan Agen, pilih akun sistem lokal atau akun domain lokal.

  10. Pilih OK untuk menutup dialog Tambahkan Grup Manajemen. Lalu pilih OK untuk menutup dialog Properti Agen Pemantauan Microsoft.

Agen Linux

Lakukan langkah-langkah berikut untuk mengonfigurasi agen Log Analytics untuk Linux agar dilaporkan ke grup manajemen Manajer Operasi Pusat Sistem.

Catatan

Sebagai bagian dari transisi yang sedang berlangsung dari Microsoft Operations Management Suite ke Azure Monitor, Operations Management Suite Agent untuk Windows atau Linux akan disebut sebagai agen Analitik Log untuk Windows dan agen Analitik Log untuk Linux.

  1. Edit file /etc/opt/omi/conf/omiserver.conf.

  2. Pastikan bahwa baris yang dimulai dengan httpsport= menentukan port 1270, seperti, httpsport=1270.

  3. Mulai ulang server OMI dengan menggunakan perintah berikut:

    sudo /opt/omi/bin/service_control restart

Tanya jawab umum

Bagian ini menyediakan jawaban atas pertanyaan umum.

Bagaimana cara menghentikan agen Log Analytics agar tidak berkomunikasi dengan Azure Monitor?

Untuk agen yang terhubung ke Log Analytics secara langsung, buka Panel Kontrol dan pilih Microsoft Monitoring Agent. Di bawah tab Azure Log Analytics (OMS), hapus semua ruang kerja yang tercantum. Di Manajer Operasi Pusat Sistem, hapus komputer dari daftar komputer terkelola Log Analytics. Manajer Operasi memperbarui konfigurasi agen agar tidak lagi melapor ke Log Analytics.

Langkah berikutnya