Zarządzanie i obsługa agenta usługi Log Analytics dla systemów Windows i Linux

Po początkowym wdrożeniu agenta usługi Log Analytics dla systemu Windows lub Linux w usłudze Azure Monitor może być konieczne ponowne skonfigurowanie agenta, uaktualnienie go lub usunięcie go z komputera, jeśli osiągnął etap wycofania w jego cyklu życia. Te rutynowe zadania konserwacji można łatwo zarządzać ręcznie lub za pomocą automatyzacji, co zmniejsza zarówno błędy operacyjne, jak i wydatki.

Ważne

Starszy agentusługi Log Analytics zostanie wycofany do sierpnia 2024 r. Po tej dacie firma Microsoft nie będzie już zapewniać żadnej pomocy technicznej dla agenta usługi Log Analytics. Przeprowadź migrację do agenta usługi Azure Monitor przed sierpniem 2024 r., aby kontynuować pozyskiwanie danych.

Uaktualnianie agenta

Przeprowadź uaktualnienie do najnowszej wersji agenta usługi Log Analytics dla systemów Windows i Linux ręcznie lub automatycznie na podstawie scenariusza wdrażania i środowiska, w którym działa maszyna wirtualna.

Środowisko Metoda instalacji Metoda uaktualniania
Maszyna wirtualna platformy Azure Rozszerzenie maszyny wirtualnej agenta usługi Log Analytics dla systemu Windows/Linux Agent jest automatycznie uaktualniany po zmianie modelu maszyny wirtualnej, chyba że skonfigurowano szablon usługi Azure Resource Manager do rezygnacji przez ustawienie właściwości autoUpgradeMinorVersion na false. Po wdrożeniu rozszerzenie nie uaktualnia wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true. Tylko agent systemu Linux obsługuje automatyczne wdrażanie po wdrożeniu aktualizacji z właściwością enableAutomaticUpgrade (zobacz Włączanie automatycznej aktualizacji agenta systemu Linux). Uaktualnienie wersji głównej jest zawsze ręczne (zobacz Właściwość VirtualMachineExtensionInner.AutoUpgradeMinorVersion).
Niestandardowe obrazy maszyn wirtualnych platformy Azure Ręczna instalacja agenta usługi Log Analytics dla systemu Windows/Linux Aktualizowanie maszyn wirtualnych do najnowszej wersji agenta musi być wykonywane z poziomu wiersza polecenia z uruchomionym pakietem Instalatora Windows lub pakietem skryptów powłoki samodzielnej wyodrębniania i instalowania systemu Linux.
Maszyny wirtualne spoza platformy Azure Ręczna instalacja agenta usługi Log Analytics dla systemu Windows/Linux Aktualizowanie maszyn wirtualnych do najnowszej wersji agenta musi być wykonywane z poziomu wiersza polecenia z uruchomionym pakietem Instalatora Windows lub pakietem skryptów powłoki samodzielnej wyodrębniania i instalowania systemu Linux.

Uaktualnianie agenta systemu Windows

Aby zaktualizować agenta na maszynie wirtualnej z systemem Windows do najnowszej wersji, która nie została zainstalowana przy użyciu rozszerzenia maszyny wirtualnej usługi Log Analytics, uruchom polecenie z wiersza polecenia, skryptu lub innego rozwiązania automatyzacji albo użyj Kreatora instalacji MMASetup-platform.msi<>.

Aby pobrać najnowszą wersję agenta systemu Windows z obszaru roboczego usługi Log Analytics:

  1. Zaloguj się w witrynie Azure Portal.

  2. W witrynie Azure Portal wybierz pozycję Wszystkie usługi. Na liście zasobów wprowadź log analytics. Po rozpoczęciu pisania zawartość listy jest filtrowana w oparciu o wpisywane dane. Wybierz pozycję Obszary robocze usługi Log Analytics.

  3. Na liście obszarów roboczych usługi Log Analytics wybierz obszar roboczy.

  4. W obszarze roboczym usługi Log Analytics wybierz kafelek Agenci , a następnie wybierz pozycję Serwery z systemem Windows.

  5. Na ekranie Serwery z systemem Windows wybierz odpowiednią wersję pobierz agenta systemu Windows, aby pobrać w zależności od architektury procesora systemu operacyjnego Windows.

Uwaga

Podczas uaktualniania agenta usługi Log Analytics dla systemu Windows nie obsługuje konfigurowania ani ponownego konfigurowania obszaru roboczego do raportowania. Aby skonfigurować agenta, wykonaj jedną z obsługiwanych metod wymienionych w obszarze Dodawanie lub usuwanie obszaru roboczego.

Uaktualnianie przy użyciu Kreatora instalacji

  1. Zaloguj się na komputerze przy użyciu konta z uprawnieniami administracyjnymi.

  2. Wykonaj polecenie MMASetup-platform.exe<>, aby uruchomić Kreatora instalacji.

  3. Na pierwszej stronie Kreatora instalacji wybierz przycisk Dalej.

  4. W oknie dialogowym Konfiguracja programu Microsoft Monitoring Agent wybierz pozycję Zgadzam się zaakceptować umowę licencyjną.

  5. W oknie dialogowym Konfiguracja programu Microsoft Monitoring Agent wybierz pozycję Uaktualnij. Na stronie stanu jest wyświetlany postęp uaktualniania.

  6. Po pomyślnym zakończeniu konfiguracji programu Microsoft Monitoring Agent wybierz pozycję Zakończ.

Uaktualnianie z wiersza polecenia

  1. Zaloguj się na komputerze przy użyciu konta z uprawnieniami administracyjnymi.

  2. Aby wyodrębnić pliki instalacyjne agenta, uruchom polecenie MMASetup-<platform>.exe /c z wiersza polecenia z podwyższonym poziomem uprawnień i wyświetli monit o ścieżkę do wyodrębnienia plików. Alternatywnie możesz określić ścieżkę, przekazując argumenty MMASetup-<platform>.exe /c /t:<Full Path>.

  3. Uruchom następujące polecenie, gdzie D:\ jest lokalizacją pliku dziennika uaktualniania:

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

Uaktualnianie agenta systemu Linux

Uaktualnienie z wcześniejszych wersji (>1.0.0-47) jest obsługiwane. Wykonanie instalacji za pomocą --upgrade polecenia spowoduje uaktualnienie wszystkich składników agenta do najnowszej wersji.

Uruchom następujące polecenie, aby uaktualnić agenta:

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

Włączanie automatycznej aktualizacji agenta systemu Linux

Zalecamy włączenie automatycznego uaktualniania rozszerzeń przy użyciu tych poleceń w celu automatycznego zaktualizowania agenta.

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

Dodawanie lub usuwanie obszaru roboczego

Dodaj lub usuń obszar roboczy przy użyciu agenta systemu Windows lub agenta systemu Linux.

Agent systemu Windows

Kroki opisane w tej sekcji są niezbędne nie tylko wtedy, gdy chcesz ponownie skonfigurować agenta systemu Windows do raportowania do innego obszaru roboczego lub usunąć obszar roboczy z jego konfiguracji, ale także wtedy, gdy chcesz skonfigurować agenta do raportowania do więcej niż jednego obszaru roboczego. (Ta praktyka jest często określana jako multihoming). Skonfigurowanie agenta systemu Windows do raportowania do wielu obszarów roboczych można wykonać tylko po wstępnej konfiguracji agenta i przy użyciu metod opisanych w tej sekcji.

Aktualizowanie ustawień z Panel sterowania

  1. Zaloguj się na komputerze przy użyciu konta z uprawnieniami administracyjnymi.

  2. Otwórz Panel sterowania.

  3. Wybierz pozycję Microsoft Monitoring Agent , a następnie wybierz kartę Azure Log Analytics .

  4. Jeśli usuwasz obszar roboczy, wybierz go, a następnie wybierz pozycję Usuń. Powtórz ten krok dla każdego innego obszaru roboczego, do którego agent ma zatrzymać raportowanie.

  5. Jeśli dodajesz obszar roboczy, wybierz pozycję Dodaj. W oknie dialogowym Dodawanie obszaru roboczego usługi Log Analytics wklej identyfikator obszaru roboczego i klucz obszaru roboczego (klucz podstawowy). Jeśli komputer powinien zgłosić się do obszaru roboczego usługi Log Analytics w chmurze Azure Government, wybierz pozycję Azure US Government z listy rozwijanej Chmura platformy Azure.

  6. Aby zapisać zmiany, wybierz pozycję OK.

Usuwanie obszaru roboczego przy użyciu programu PowerShell

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

Dodawanie obszaru roboczego na platformie Azure komercyjnego przy użyciu programu PowerShell

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

Dodawanie obszaru roboczego na platformie Azure dla instytucji rządowych USA przy użyciu programu PowerShell

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

Uwaga

Jeśli wcześniej użyto wiersza polecenia lub skryptu do zainstalowania lub skonfigurowania agenta, EnableAzureOperationalInsights zastąpiono elementami AddCloudWorkspace i RemoveCloudWorkspace.

Agent systemu Linux

W poniższych krokach pokazano, jak ponownie skonfigurować agenta systemu Linux, jeśli zdecydujesz się zarejestrować go w innym obszarze roboczym lub usunąć obszar roboczy z jego konfiguracji.

  1. Aby sprawdzić, czy agent jest zarejestrowany w obszarze roboczym, uruchom następujące polecenie:

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

    Powinien zwrócić stan podobny do następującego przykładu:

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

    Ważne jest, aby stan również pokazywał, że agent jest uruchomiony. W przeciwnym razie następujące kroki w celu ponownego skonfigurowania agenta nie zakończą się pomyślnie.

  2. Jeśli agent jest już zarejestrowany w obszarze roboczym, usuń zarejestrowany obszar roboczy, uruchamiając następujące polecenie. W przeciwnym razie, jeśli nie został zarejestrowany, przejdź do następnego kroku.

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

  3. Aby zarejestrować się w innym obszarze roboczym, uruchom następujące polecenie:

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

  4. Aby sprawdzić, czy zmiany weszły w życie, uruchom następujące polecenie:

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

    Powinien zwrócić stan podobny do następującego przykładu:

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

Aby zmiany zaczęły obowiązywać, usługa agenta nie musi być ponownie uruchamiana.

Aktualizowanie ustawień serwera proxy

Agent usługi Log Analytics (MMA) nie używa ustawień serwera proxy systemu. W związku z tym podczas instalowania programu MMA należy przekazać ustawienia serwera proxy. Te ustawienia będą przechowywane w obszarze konfiguracja programu MMA (rejestr) na maszynie wirtualnej. Aby skonfigurować agenta do komunikowania się z usługą za pośrednictwem serwera proxy lub bramy usługi Log Analytics po wdrożeniu, użyj jednej z następujących metod, aby wykonać to zadanie.

Agent systemu Windows

Użyj agenta systemu Windows.

Aktualizowanie ustawień przy użyciu Panel sterowania

  1. Zaloguj się na komputerze przy użyciu konta z uprawnieniami administracyjnymi.

  2. Otwórz Panel sterowania.

  3. Wybierz pozycję Microsoft Monitoring Agent, a następnie wybierz kartę Serwer proxy Ustawienia.

  4. Wybierz pozycję Użyj serwera proxy i podaj adres URL oraz numer portu serwera proxy lub bramy. Jeśli serwer proxy lub brama usługi Log Analytics wymaga uwierzytelniania, wprowadź nazwę użytkownika i hasło do uwierzytelnienia, a następnie wybierz przycisk OK.

Aktualizowanie ustawień przy użyciu programu PowerShell

Skopiuj poniższy przykładowy kod programu PowerShell, zaktualizuj go informacjami specyficznymi dla danego środowiska i zapisz go przy użyciu rozszerzenia nazwy pliku PS1. Uruchom skrypt na każdym komputerze, który łączy się bezpośrednio z obszarem roboczym usługi Log Analytics w usłudze 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)

Agent systemu Linux

Wykonaj następujące kroki, jeśli komputery z systemem Linux muszą komunikować się za pośrednictwem serwera proxy lub bramy usługi Log Analytics. Wartość konfiguracji serwera proxy ma następującą składnię: [protocol://][user:password@]proxyhost[:port]. Właściwość proxyhost akceptuje w pełni kwalifikowaną nazwę domeny lub adres IP serwera proxy.

  1. Edytuj plik /etc/opt/microsoft/omsagent/proxy.conf , uruchamiając następujące polecenia i zmieniając wartości na określone ustawienia:

    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. Uruchom ponownie agenta, uruchamiając następujące polecenie:

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

    Jeśli widzisz cURL failed to perform on this base url w dzienniku, możesz spróbować usunąć '\n' w proxy.conf EOF, aby rozwiązać problem:

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

Odinstalowywanie agenta

Użyj jednej z poniższych procedur, aby odinstalować agenta systemu Windows lub Linux przy użyciu wiersza polecenia lub Kreatora instalacji.

Agent systemu Windows

Użyj agenta systemu Windows.

Odinstalowywanie z Panel sterowania

  1. Zaloguj się na komputerze przy użyciu konta z uprawnieniami administracyjnymi.

  2. W Panel sterowania wybierz pozycję Programy i funkcje.

  3. W obszarze Programy i funkcje wybierz pozycję Microsoft Monitoring Agent>Odinstaluj>tak.

Uwaga

Kreator instalacji agenta można również uruchomić, klikając dwukrotnie plik MMASetup-\<platform\>.exe, który jest dostępny do pobrania z obszaru roboczego w witrynie Azure Portal.

Odinstalowywanie z wiersza polecenia

Pobrany plik dla agenta to samodzielny pakiet instalacyjny utworzony za pomocą IExpress. Program instalacyjny agenta i plików pomocniczych znajduje się w pakiecie i musi zostać wyodrębniony w celu poprawnego odinstalowania przy użyciu wiersza polecenia pokazanego w poniższym przykładzie.

  1. Zaloguj się na komputerze przy użyciu konta z uprawnieniami administracyjnymi.

  2. Aby wyodrębnić pliki instalacyjne agenta, z wiersza polecenia extract MMASetup-<platform>.exe z podwyższonym poziomem uprawnień zostanie wyświetlony monit o ścieżkę do wyodrębnienia plików. Alternatywnie możesz określić ścieżkę, przekazując argumenty extract MMASetup-<platform>.exe /c:<Path> /t:<Path>. Aby uzyskać więcej informacji na temat przełączników wiersza polecenia obsługiwanych przez IExpress, zobacz Przełączniki wiersza polecenia dla IExpress , a następnie zaktualizuj przykład zgodnie z potrzebami.

  3. Po wyświetleniu monitu wprowadź .%WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb

Agent systemu Linux

Aby usunąć agenta, uruchom poniższe polecenie na komputerze z systemem Linux. Argument --purge całkowicie usuwa agenta i jego konfigurację.

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

Konfigurowanie agenta do raportowania do grupy zarządzania programu Operations Manager

Użyj agenta systemu Windows.

Agent systemu Windows

Wykonaj następujące kroki, aby skonfigurować agenta usługi Log Analytics dla systemu Windows w celu raportowania do grupy zarządzania programu System Center Operations Manager.

Uwaga

W ramach trwającego przejścia z pakietu Microsoft Operations Management Suite do usługi Azure Monitor agent pakietu Operations Management Suite dla systemu Windows lub Linux będzie określany jako agent usługi Log Analytics dla systemu Windows i agent usługi Log Analytics dla systemu Linux.

  1. Zaloguj się na komputerze przy użyciu konta z uprawnieniami administracyjnymi.

  2. Otwórz Panel sterowania.

  3. Wybierz pozycję Microsoft Monitoring Agent , a następnie wybierz kartę Operations Manager .

  4. Jeśli serwery programu Operations Manager mają integrację z usługą Active Directory, wybierz pozycję Automatycznie aktualizuj przypisania grup zarządzania z usług AD DS.

  5. Wybierz pozycję Dodaj , aby otworzyć okno dialogowe Dodawanie grupy zarządzania.

  6. W polu Nazwa grupy zarządzania wprowadź nazwę grupy zarządzania.

  7. W polu Podstawowy serwer zarządzania wprowadź nazwę komputera podstawowego serwera zarządzania.

  8. W polu Port serwera zarządzania wprowadź numer portu TCP.

  9. W obszarze Konto działania agenta wybierz konto systemowe lokalne lub konto domeny lokalnej.

  10. Wybierz przycisk OK , aby zamknąć okno dialogowe Dodawanie grupy zarządzania. Następnie wybierz przycisk OK , aby zamknąć okno dialogowe Właściwości programu Microsoft Monitoring Agent.

Agent systemu Linux

Wykonaj następujące kroki, aby skonfigurować agenta usługi Log Analytics dla systemu Linux w celu raportowania do grupy zarządzania programu System Center Operations Manager.

Uwaga

W ramach trwającego przejścia z pakietu Microsoft Operations Management Suite do usługi Azure Monitor agent pakietu Operations Management Suite dla systemu Windows lub Linux będzie określany jako agent usługi Log Analytics dla systemu Windows i agent usługi Log Analytics dla systemu Linux.

  1. Edytuj plik /etc/opt/omi/conf/omiserver.conf.

  2. Upewnij się, że wiersz rozpoczynający się od httpsport= definiuje port 1270, na przykład httpsport=1270.

  3. Uruchom ponownie serwer OMI, używając następującego polecenia:

    sudo /opt/omi/bin/service_control restart

Często zadawane pytania

Ta sekcja zawiera odpowiedzi na typowe pytania.

Jak mogę zatrzymać komunikację agenta usługi Log Analytics z usługą Azure Monitor?

W przypadku agentów połączonych bezpośrednio z usługą Log Analytics otwórz Panel sterowania i wybierz pozycję Microsoft Monitoring Agent. Na karcie Azure Log Analytics (OMS) usuń wszystkie wymienione obszary robocze. W programie System Center Operations Manager usuń komputer z listy komputerów zarządzanych przez usługę Log Analytics. Program Operations Manager aktualizuje konfigurację agenta, aby nie raportować do usługi Log Analytics.

Następne kroki