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

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

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

Чтобы обновить агент на виртуальной машине 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
   

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Скачанный файл агента — это автономный пакет установки, созданный 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. Аргумент --purge полностью удаляет агент и его конфигурацию.

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

Используйте агент 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. Нажмите кнопку "ОК ", чтобы закрыть диалоговое окно "Добавить группу управления". Затем нажмите кнопку "ОК ", чтобы закрыть диалоговое окно "Свойства агента мониторинга Майкрософт".

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

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