Обслуживание агента Log Analytics для Windows и Linux и управление им

После первоначального развертывания агента Log Analytics для Windows или Linux в Azure Monitor вам может понадобиться перенастроить, обновить или удалить его из компьютера после завершения жизненного цикла (стадия прекращения применения и списания). Вы можете легко управлять этими задачами обслуживания вручную или автоматизировать этот процесс, сократив при этом эксплуатационные расходы и количество ошибок.

Важно!

Поддержка устаревшего агента Log Analyticsбудет прекращена в августе 2024 года. Чтобы продолжить прием данных, перейдите на агент Azure Monitor до августа 2024 года.

Обновление агента

Агент Log Analytics для Windows и Linux можно обновить до последнего выпуска вручную или автоматически в зависимости от сценария развертывания и среды, в которой выполняется виртуальная машина.

Среда Метод установки Метод перехода
Azure Расширение виртуальной машины агента Log Analytics для Windows или Linux Агент автоматически обновится после изменения модели виртуальной машины, если только вы не настроили шаблон Azure Resource Manager для отказа, задав для свойства autoUpgradeMinorVersion значение false. Однако после развертывания расширение не будет обновляться до дополнительных версий, кроме случаев повторного развертывания, даже если это свойство имеет значение true. Только агент Linux поддерживает автоматическое обновление после развертывания с помощью свойства enableAutomaticUpgrade (см. раздел Включение автоматического обновления для агента Linux). Обновление основной версии всегда выполняется вручную (см. свойство VirtualMachineExtensionInner.AutoUpgradeMinorVersion).
Пользовательские образы виртуальных машин Azure Ручная установка агента Log Analytics для Windows или Linux Обновление виртуальных машин до последней версии агента необходимо выполнить из командной строки, в которой выполняется пакет установщика Windows или набор сценариев автоматической распаковки и установки для Linux.
Виртуальные машины, не связанные с Azure Ручная установка агента Log Analytics для Windows или Linux Обновление виртуальных машин до последней версии агента необходимо выполнить из командной строки, в которой выполняется пакет установщика Windows или набор сценариев автоматической распаковки и установки для Linux.

Агент обновления Windows

Чтобы обновить агент на виртуальной машине Windows до последней версии, не установленной с помощью расширения виртуальной машины Log Analytics, запустите действие из командной строки, скрипта или другого решения по автоматизации либо с помощью мастера установки MMASetup-<platform>.msi

Последнюю версию агента для Windows можно скачать из рабочей области Log Analytics, выполнив следующие действия.

  1. Войдите на портал Azure.

  2. На портале Azure щелкните Все службы. В списке ресурсов введите Log Analytics. Как только вы начнете вводить символы, список отфильтруется соответствующим образом. Выберите Рабочие области Log Analytics.

  3. В списке рабочих областей Log Analytics выберите рабочую область.

  4. В рабочей области Log Analytics выберите элемент Управление агентами, а затем Серверы Windows.

  5. На странице Серверы Windows выберите для скачивания соответствующую версию агента для Windows на основе архитектуры процессора, на котором выполняется операционная система Windows.

Примечание

Во время обновления агента Log Analytics для Windows он не поддерживает настройку или перенастройку рабочей области для передачи отчетов. Чтобы настроить агент, необходимо воспользоваться одним из поддерживаемых методов, перечисленных в разделе Добавление или удаление рабочей области.

Обновление с помощью мастера установки

  1. Войдите в систему компьютера, используя учетную запись с правами администратора.

  2. Выполните MMASetup-<platform>.exe, чтобы запустить мастер установки.

  3. На первой странице мастера установки нажмите кнопку Далее.

  4. В диалоговом окне Установки Microsoft Monitoring Agent нажмите кнопку Я принимаю, чтобы принять условия лицензионного соглашения.

  5. В диалоговом окне Установка Microsoft Monitoring Agent нажмите кнопку Обновить. На странице состояния отображается ход обновления.

  6. После появления страницы Настройка Microsoft Monitoring Agent выполнена успешно., нажмите кнопку Готово.

Обновление с помощью командной строки

  1. Войдите в систему компьютера, используя учетную запись с правами администратора.

  2. Чтобы извлечь файлы установки агента из командной строки с повышенными привилегиями, запустите файл MMASetup-<platform>.exe /c. После этого вы сможете выбрать путь для извлечения файлов. Кроме того, путь можно указать, передав аргументы MMASetup-<platform>.exe /c /t:<Full Path>.

  3. Выполните следующую команду (D:\ является местонахождением файла журнала обновления).

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

Обновление агента Linux

Поддерживается обновление с предыдущих версий (>1.0.0-47). При установке с помощью команды --upgrade все компоненты агента будут обновлены до последней версии.

Выполните следующую команду, чтобы обновить агент.

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

Включение автоматического обновления для агента Linux

Мы рекомендуем включить автоматическое обновление расширений с помощью приведенных ниже команд для автоматического обновления агента.

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

Добавление и удаление рабочей области

Агент Windows

Действия, описанные в этом разделе, необходимы, если требуется не только перенастроить агент Windows для передачи отчетов в другую рабочую область или удаления рабочей области из ее конфигурации, но и при необходимости настроить агент для передачи отчетов в несколько рабочих областей (обычно это называется множественной адресацией). Настройка агента Windows для создания отчетов в нескольких рабочих областях может выполняться только после начальной настройки агента и с помощью описанных ниже методов.

Обновление параметров на панели управления

  1. Войдите в систему компьютера, используя учетную запись с правами администратора.

  2. Откройте Панель управления.

  3. Выберите Microsoft Monitoring Agent и перейдите на вкладку Azure Log Analytics.

  4. Чтобы удалить рабочую область, выберите нужную и нажмите кнопку Удалить. Повторите этот шаг для всех рабочих областей, которые этот агент больше не должен отслеживать.

  5. Чтобы добавить рабочую область, нажмите кнопку Добавить, а затем в диалоговом окне Add a Log Analytics Workspace (Добавление рабочей области Log Analytics) введите идентификатор и ключ (первичный) рабочей области. Если компьютер должен передавать данные в рабочую область Log Analytics в облаке Azure для государственных организаций, выберите "Azure для US Gov организаций" из раскрывающегося списка "Облако Azure".

  6. Нажмите кнопку ОК , чтобы сохранить внесенные изменения.

Удаление рабочей области с помощью PowerShell

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

Добавление рабочей области в Azure для коммерческих организаций с помощью PowerShell

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

Добавление рабочей области в Azure для US Gov организаций с помощью PowerShell

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

Примечание

Если ранее вы устанавливали или настраивали агент с помощью командной строки или сценария, теперь вместо EnableAzureOperationalInsights используется AddCloudWorkspace и RemoveCloudWorkspace.

Агент Linux

Ниже описывается, как перенастроить агент для Linux, если вы решили зарегистрировать его в другой рабочей области или хотите удалить рабочую область из его конфигурации.

  1. Чтобы убедиться, что он зарегистрирован в рабочей области, выполните следующую команду.

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

    Результат выполнения команды должен иметь следующий вид.

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

    Важно, чтобы по состоянию было видно, что агент выполняется. В противном случае приведенные ниже шаги по перенастройке агент выполнить не удастся.

  2. Если он уже зарегистрирован в рабочей области, удалите ее, выполнив следующую команду. Если агент еще не зарегистрирован, перейдите к следующему шагу.

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

  3. Чтобы зарегистрировать агент в другой рабочей области, выполните следующую команду:

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

  4. Чтобы проверить внесенные изменения, выполните команду:

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

    Результат выполнения команды должен иметь следующий вид.

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

Службу агента не нужно перезапускать, чтобы изменения вступили в силу.

Обновление параметров прокси-сервера

Агент Log Analytics (MMA) не использует системные параметры прокси-сервера. Это означает, что пользователю нужно передать параметры прокси-сервера при установке MMA, и эти параметры будут сохранены в конфигурации MMA (в реестре) на виртуальной машине. Чтобы после развертывания настроить взаимодействие агента со службой через прокси-сервер или шлюз Log Analytics, используйте один из приведенных ниже способов.

Агент Windows

Обновление параметров с помощью панели управления

  1. Войдите в систему компьютера, используя учетную запись с правами администратора.

  2. Откройте Панель управления.

  3. Выберите Microsoft Monitoring Agent и перейдите на вкладку Параметры прокси-сервера.

  4. Щелкните Использовать прокси-сервер и укажите URL-адрес и номер порта прокси-сервера или шлюза. Если для доступа к прокси-серверу или шлюзу Log Analytics требуется аутентификация, введите имя пользователя и пароль, а затем нажмите кнопку ОК.

Обновление параметров с помощью PowerShell

Скопируйте следующий образец кода PowerShell, измените в нем сведения, относящиеся к используемой среде, и сохраните его в файле с расширением PS1. Выполните скрипт на каждом компьютере, подключенном напрямую к рабочему процессу Log Analytics в 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)

Агент Linux

Если компьютерам Linux нужно взаимодействовать через прокси-сервер или шлюз Log Analytics, выполните приведенные ниже действия. Значение конфигурации прокси-сервера имеет следующий синтаксис: [protocol://][user:password@]proxyhost[:port]. Свойство proxyhost принимает полное доменное имя или IP-адрес прокси-сервера.

  1. Измените файл /etc/opt/microsoft/omsagent/proxy.conf, выполнив следующие команды и указав собственные значения параметров.

    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. Перезапустите агент, выполнив следующую команду.

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

    Если в журнале отображается сообщение "cURL не удалось выполнить по этому базовому URL-адресу", попробуйте удалить "\n" в конце файла proxy.conf, чтобы устранить сбой:

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

Удаление агента

Чтобы удалить агент Windows или Linux с помощью мастера установки или командной строки, используйте одну из приведенных ниже процедур.

Агент Windows

Удаление из панели управления

  1. Войдите в систему компьютера, используя учетную запись с правами администратора.

  2. На панели управления щелкните элемент Программы и компоненты.

  3. В окне Программы и компоненты выберите Microsoft Monitoring Agent, щелкните Удалить, а затем нажмите кнопку Да.

Примечание

Мастер настройки агента можно также запустить, дважды щелкнув файл MMASetup-<platform>.exe, который можно скачать из рабочей области на портале Azure.

Удаление из командной строки

Скачанный файл агента — это автономный пакет установки, созданный IExpress. В нем содержатся программа установки агента и вспомогательные файлы. Чтобы удалить агент с помощью командной строки, содержимое этого пакета нужно извлечь. Ниже описано, как это сделать.

  1. Войдите в систему компьютера, используя учетную запись с правами администратора.

  2. Чтобы извлечь файлы установки агента из командной строки с повышенными привилегиями, запустите файл extract MMASetup-<platform>.exe. После этого вы сможете выбрать путь для извлечения файлов. Кроме того, путь можно указать, передав аргументы extract MMASetup-<platform>.exe /c:<Path> /t:<Path>. Дополнительные сведения о параметрах командной строки, поддерживаемых IExpress, см. в этой статье. Затем обновите пример в соответствии со своими потребностями.

  3. В командной строке введите следующую команду: %WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb.

Агент Linux

Чтобы удалить агент, выполните следующую команду на компьютере Linux. Аргумент --purge полностью удаляет агент и его конфигурацию.

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

Настройка передачи агентом отчетов в группу управления Operations Manager

Агент Windows

Чтобы в агенте Log Analytics для Windows настроить передачу отчетов в группу управления System Center Operations Manager, выполните приведенные ниже действия.

Примечание

В рамках текущего перехода с Microsoft Operations Management Suite на Azure Monitor агент Microsoft Operations Management Suite для операционных систем будет называться агентом Log Analytics для Windows и Log Analytics для Linux.

  1. Войдите в систему компьютера, используя учетную запись с правами администратора.

  2. Откройте Панель управления.

  3. Щелкните Microsoft Monitoring Agent и перейдите на вкладку Operations Manager.

  4. Если серверы Operations Manager интегрированы с Active Directory, установите флажок Автоматически обновлять назначения групп управления из AD DS.

  5. Нажмите кнопку Добавить, чтобы открыть диалоговое окно Добавление группы управления.

  6. В поле Имя группы управления введите имя группы управления.

  7. В поле Основной сервер управления введите имя компьютера основного сервера управления.

  8. В поле Порт сервера управления введите номер порта TCP.

  9. На странице Учетная запись действия агентавыберите учетную запись Local System или учетную запись локального домена.

  10. Нажмите кнопку ОК, чтобы закрыть диалоговое окно Добавление группы управления, и еще раз нажмите ОК, чтобы закрыть диалоговое окно Свойства Microsoft Monitoring Agent.

Агент Linux

Чтобы в агенте Log Analytics для Linux настроить передачу отчетов в группу управления System Center Operations Manager, выполните приведенные ниже действия.

Примечание

В рамках текущего перехода с Microsoft Operations Management Suite на Azure Monitor агент Microsoft Operations Management Suite для операционных систем будет называться агентом Log Analytics для Windows и Log Analytics для Linux.

  1. Измените файл /etc/opt/omi/conf/omiserver.conf

  2. Укажите для строки httpsport= номер порта 1270. Например: httpsport=1270.

  3. Перезапустите сервер OMI: sudo /opt/omi/bin/service_control restart.

Дальнейшие действия