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

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

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

Обновление до последнего выпуска агента Log Analytics для 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 Server выберите соответствующую версию агента Windows для скачивания в зависимости от архитектуры процессора операционной системы Windows.

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

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

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

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

4. В диалоговом окне установки агента мониторинга Майкрософт выберите "Я согласен принять лицензионное соглашение".

5. В диалоговом окне установки агента мониторинга Майкрософт выберите "Обновить". На странице состояния отображается ход обновления.

6. После успешного завершения настройки агента мониторинга Майкрософт нажмите кнопку "Готово".

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

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

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 для отправки данных на несколько рабочих областей может выполняться только после начальной установки агента и с использованием методов, описанных в этом разделе.

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

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

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

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

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

5. Если вы добавляете рабочую область, нажмите кнопку "Добавить". В диалоговом окне "Добавление рабочей области Log Analytics" вставьте идентификатор рабочей области и ключ рабочей области (первичный ключ). Если компьютер должен сообщать в рабочую область Log Analytics в облаке Azure для государственных учреждений США, выберите Azure для государственных учреждений США в раскрывающемся списке Azure Cloud.

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 для государственных организаций США с помощью PowerShell

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

Агент 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

Используйте агент 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 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.

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

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

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

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

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

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

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

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

Агент Windows

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

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

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

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

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

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

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

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

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

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

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

Агент Linux

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

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

2. Убедитесь, что строка, начинающаяся с httpsport=, определяет порт 1270, например httpsport=1270.

3. Перезапустите сервер OMI с помощью следующей команды:

   sudo /opt/omi/bin/service_control restart

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

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

Как остановить взаимодействие агента Log Analytics с Azure Monitor?

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

Дальнейшие шаги

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