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

Статья
10/26/2023

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

Важно!

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

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

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

Среда	Метод установки	Метод перехода
Azure	Расширение виртуальной машины агента Log Analytics для Windows или Linux	Агент автоматически обновляется после изменения модели виртуальной машины, если вы не настроили шаблон Azure Resource Manager, чтобы отказаться `autoUpgradeMinorVersion`от этого свойства. Однако после развертывания расширение не обновит дополнительные версии без повторного развертывания, даже если это свойство не имеет значения 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, выполните следующие действия.

Войдите на портал Azure.
На портале Azure щелкните Все службы. В списке ресурсов введите Log Analytics. Как только вы начнете вводить символы, список отфильтруется соответствующим образом. Выберите Рабочие области Log Analytics.
В списке рабочих областей Log Analytics выберите рабочую область.
В рабочей области Log Analytics выберите плитку "Агенты" , а затем выберите Серверы Windows.
На экране Windows Server выберите соответствующую версию агента Windows для скачивания в зависимости от архитектуры процессора операционной системы Windows.

Примечание.

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

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

Войдите в систему компьютера, используя учетную запись с правами администратора.
Выполните MMASetup-platform.exe<>, чтобы запустить мастер установки.
На первой странице мастера установки нажмите кнопку "Далее".
В диалоговом окне установки агента мониторинга Майкрософт выберите "Я согласен принять лицензионное соглашение".
В диалоговом окне установки агента мониторинга Майкрософт выберите "Обновить". На странице состояния отображается ход обновления.
После успешного завершения настройки агента мониторинга Майкрософт нажмите кнопку "Готово".

Обновление из командной строки

Войдите в систему компьютера, используя учетную запись с правами администратора.
Чтобы извлечь файлы установки агента, запустите MMASetup-<platform>.exe /c из командной строки с повышенными привилегиями и предложит вам получить путь к извлечению файлов. Кроме того, путь можно указать, передав аргументы MMASetup-<platform>.exe /c /t:<Full Path>.
Выполните следующую команду, где 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

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

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

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

Добавьте или удалите рабочую область с помощью агента Windows или агента Linux.

Агент Windows

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

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

Войдите в систему компьютера, используя учетную запись с правами администратора.
Откройте панель управления.
Выберите Microsoft Monitoring Agent и перейдите на вкладку Azure Log Analytics .
Если вы удаляете рабочую область, выберите ее и нажмите кнопку "Удалить". Повторите этот шаг для всех рабочих областей, которые этот агент больше не должен отслеживать.
Если вы добавляете рабочую область, нажмите кнопку "Добавить". В диалоговом окне "Добавление рабочей области Log Analytics" вставьте идентификатор рабочей области и ключ рабочей области (первичный ключ). Если компьютер должен передавать данные в рабочую область Log Analytics в облаке Azure для государственных организаций, выберите Azure для государственных организаций США из раскрывающегося списка Облако Azure.
Нажмите кнопку ОК , чтобы сохранить изменения.

Удаление рабочей области с помощью 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, если вы решили зарегистрировать его в другой рабочей области или хотите удалить рабочую область из его конфигурации.

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

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

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

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

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

/opt/microsoft/omsagent/bin/omsadmin.sh -X
Чтобы зарегистрировать агент в другой рабочей области, выполните следующую команду:

/opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>]
Чтобы проверить внесенные изменения, выполните команду:

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

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

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

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

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

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

Агент Windows

Используйте агент Windows.

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

Войдите в систему компьютера, используя учетную запись с правами администратора.
Откройте панель управления.
Выберите Microsoft Monitoring Agent и перейдите на вкладку "Прокси-сервер Параметры".
Щелкните Использовать прокси-сервер и укажите 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-адрес прокси-сервера.

Измените файл /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
```

Перезапустите агент, выполнив следующую команду.

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

Если вы видите cURL failed to perform on this base url в журнале, попробуйте удалить '\n' его в proxy.conf EOF, чтобы устранить сбой:

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

Используйте агент Windows.

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

Войдите в систему компьютера, используя учетную запись с правами администратора.
В панели управления выберите Программы и компоненты.
В разделе "Программы и компоненты" выберите "Агент мониторинга>Майкрософт" "Удалить>да".

Примечание.

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

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

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

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

Агент Windows

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

Примечание.

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

Войдите в систему компьютера, используя учетную запись с правами администратора.
Откройте панель управления.
Выберите Microsoft Monitoring Agent и перейдите на вкладку Operations Manager .
Если серверы Operations Manager интегрируют с Active Directory, выберите автоматическое обновление назначений групп управления из AD DS.
Нажмите кнопку "Добавить", чтобы открыть диалоговое окно "Добавить группу управления".
В поле "Имя группы управления" введите имя группы управления.
В поле "Основной сервер управления" введите имя компьютера основного сервера управления.
В поле порта сервера управления введите номер TCP-порта.
В разделе "Учетная запись действия агента" выберите учетную запись локальной системы или локальную учетную запись домена.
Нажмите кнопку "ОК ", чтобы закрыть диалоговое окно "Добавить группу управления". Затем нажмите кнопку "ОК ", чтобы закрыть диалоговое окно "Свойства агента мониторинга Майкрософт".

Агент Linux

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

Примечание.

Измените файл /etc/opt/omi/conf/omiserver.conf.
Убедитесь, что строка, начинающаяся с httpsport= определения порта 1270, например httpsport=1270.
Перезапустите сервер OMI с помощью следующей команды:

sudo /opt/omi/bin/service_control restart

Часто задаваемые вопросы

В этом разделы приводятся ответы на часто задаваемые вопросы.

Как остановить отправку данных в Azure Monitor из агента Log Analytics?

Для агентов, подключенных к Log Analytics, откройте панель управления и выберите Microsoft Monitoring Agent. На вкладке Azure Log Analytics (OMS) удалите все рабочие области. В SCOM удалите компьютер из списка компьютеров, находящихся под управлением Log Analytics. Operations Manager обновит конфигурацию агента, чтобы больше не отправлять отчеты в Log Analytics.

Следующие шаги

Проверьте устранение неполадок агента Linux, если при установке или управлении агентом Linux возникают проблемы.
Проверьте устранение неполадок агента Windows при установке или управлении агентом Windows.

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

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

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

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

Обновление из командной строки

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

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

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

Агент Windows

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

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

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

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

Агент Linux

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

Агент Windows

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

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

Агент Linux

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

Агент Windows

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

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

Агент Linux

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

Агент Windows

Агент Linux

Часто задаваемые вопросы

Как остановить отправку данных в Azure Monitor из агента Log Analytics?

Следующие шаги

Дополнительные ресурсы