Windows 및 Linux용 Log Analytics 에이전트 관리 및 유지 관리

아티클
10/26/2023

Azure Monitor에서 Windows 및 Linux용 Log Analytics 에이전트의 초기 배포 후 에이전트를 다시 구성하거나 업그레이드하거나 수명 주기의 사용 중지 단계에 도달한 경우 컴퓨터에서 제거해야 할 수 있습니다. 이러한 일상적인 유지 관리 작업을 수동으로 또는 자동화를 통해 간단히 관리하여 조작 오류와 비용을 모두 줄일 수 있습니다.

Important

레거시 Log Analytics 에이전트는 2024년 8월에 지원 중단됩니다. Microsoft에서는 이 날짜 이후 Log Analytics 에이전트에 대한 지원을 더 이상 제공하지 않습니다. 데이터 수집을 계속하려면 2024년 8월 이전에 Azure Monitor 에이전트로 마이그레이션합니다.

에이전트 업그레이드

VM이 실행되는 환경과 배포 시나리오에 따라 Windows 및 Linux용 Log Analytics 에이전트를 최신 릴리스로 수동 또는 자동으로 업그레이드합니다.

환경	설치 방법	업그레이드 방법
Azure VM	Windows/Linux용 Log Analytics 에이전트 VM 확장	속성 `autoUpgradeMinorVersion`을 false로 설정하여 옵트아웃하도록 Azure Resource Manager 템플릿을 구성하지 않는 한 에이전트는 VM 모델이 변경된 후 자동으로 업그레이드됩니다. 그러나 일단 배포되면 이 속성이 true로 설정된 경우에도 확장이 재배포되지 않는 한 부 버전을 업그레이드하지 않습니다. Linux 에이전트만 `enableAutomaticUpgrade` 속성을 사용한 자동 업데이트 사후 배포를 지원합니다(Linux 에이전트에 대한 자동 업데이트 사용 참조). 주 버전 업그레이드는 항상 수동입니다(VirtualMachineExtensionInner.AutoUpgradeMinorVersion 속성 참조).
사용자 지정 Azure VM 이미지	Windows/Linux용 Log Analytics 에이전트 수동 설치	VM을 에이전트의 최신 버전으로 업데이트하려면 Windows 설치 관리자 패키지 또는 Linux 자동 압축 풀기 및 설치 가능한 셸 스크립트 번들을 실행하는 명령줄에서 수행해야 합니다.
비 Azure VM	Windows/Linux용 Log Analytics 에이전트 수동 설치	VM을 에이전트의 최신 버전으로 업데이트하려면 Windows 설치 관리자 패키지 또는 Linux 자동 압축 풀기 및 설치 가능한 셸 스크립트 번들을 실행하는 명령줄에서 수행해야 합니다.

Windows 에이전트 업그레이드

Windows VM의 에이전트를 Log Analytics VM 확장을 사용하여 설치되지 않은 최신 버전으로 업데이트하려면 명령 프롬프트, 스크립트 또는 기타 자동화 솔루션에서 실행하거나 MMASetup-<platform>.msi 설치 마법사를 사용하여 실행합니다.

Log Analytics 작업 영역에서 최신 버전의 Windows 에이전트를 다운로드하려면 다음을 수행합니다.

Azure Portal에 로그인합니다.
Azure Portal에서 모든 서비스를 선택합니다. 리소스 목록에서 Log Analytics를 입력합니다. 입력을 시작하면 입력에 따라 목록이 필터링됩니다. Log Analytics 작업 영역을 선택합니다.
Log Analytics 작업 영역 목록에서 작업 영역을 선택합니다.
Log Analytics 작업 영역에서 에이전트 타일을 선택한 다음 Windows Servers를 선택합니다.
Windows 서버 화면에서 적절한 Windows 에이전트 다운로드 버전을 선택하여 Windows 운영 체제의 프로세서 아키텍처에 따라 다운로드합니다.

참고 항목

Windows용 Log Analytics 에이전트를 업그레이드하는 동안 보고할 작업 영역 구성 또는 재구성은 지원되지 않습니다. 에이전트를 구성하려면 작업 영역 추가 또는 제거에 나열된 지원되는 방법 중 하나를 따릅니다.

설치 마법사를 사용하여 업그레이드

관리 권한이 있는 계정으로 컴퓨터에 로그인합니다.
MMASetup-<platform>.exe을 실행하여 설치 마법사를 시작합니다.
설정 마법사의 첫 번째 페이지에서 다음을 선택합니다.
Microsoft Monitoring Agent 설정 대화 상자에서 동의함을 선택하여 라이선스 계약에 동의합니다.
Microsoft Monitoring Agent 설정 대화 상자에서 업그레이드를 선택합니다. 상태 페이지에 업그레이드 진행률이 표시됩니다.
Microsoft Monitoring Agent 구성 완료 페이지가 표시되면 마침을 선택합니다.

명령줄에서 업그레이드

관리 권한이 있는 계정으로 컴퓨터에 로그인합니다.
에이전트 설치 파일을 추출하려면 관리자 권한 명령 프롬프트에서 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 작업 영역 추가 대화 상자에서 작업 영역 ID와 작업 영역 키(기본 키)를 붙여넣습니다. 컴퓨터가 Azure Government 클라우드에서 Log Analytics 작업 영역에 보고해야 하는 경우 Azure Cloud 드롭다운 목록에서 Azure 미국 정부를 선택합니다.
확인 을 선택하여 변경 내용을 저장합니다.

PowerShell을 사용하여 작업 영역 제거

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

PowerShell을 사용하여 Azure 상용에서 작업 영역 추가

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

PowerShell을 사용하여 미국 정부를 위한 Azure에서 작업 영역 추가

$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)

변경 내용을 적용하기 위해 에이전트 서비스를 다시 시작할 필요가 없습니다.

프록시 설정 업데이트

MMA(Log Analytics 에이전트)는 시스템 프록시 설정을 사용하지 않습니다. 결과적으로 MMA를 설치하는 동안 프록시 설정을 전달해야 합니다. 이러한 설정은 VM의 MMA 구성(레지스트리)에 저장됩니다. 배포 후 에이전트가 프록시 서버 또는 Log Analytics 게이트웨이를 통해 서비스와 통신하도록 구성하려면 다음 방법 중 하나를 사용하여 이 작업을 완료합니다.

Windows 에이전트

Windows 에이전트를 사용합니다.

제어판을 사용하여 설정 업데이트

관리 권한이 있는 계정으로 컴퓨터에 로그인합니다.
제어판을 엽니다.
Microsoft Monitoring Agent를 선택한 다음 프록시 설정 탭을 선택합니다.
프록시 서버 사용을 선택하고 프록시 서버 또는 게이트웨이의 URL 및 포트 번호를 제공합니다. 프록시 서버 또는 Log Analytics 게이트웨이에 인증이 필요한 경우 인증할 사용자 이름과 암호를 입력한 다음 확인을 선택합니다.

PowerShell을 사용하여 설정 업데이트

다음 샘플 PowerShell 코드를 복사하고 자신의 환경 관련 정보로 업데이트한 후 PS1 파일 이름 확장명으로 저장합니다. Azure Monitor의 Log Analytics 작업 영역에 직접 연결하는 각 컴퓨터에서 스크립트를 실행합니다.

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이 표시되면 proxy.conf EOF에서 '\n'을 제거하여 실패를 해결할 수 있습니다.

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 에이전트를 사용합니다.

제어판에서 제거

관리 권한이 있는 계정으로 컴퓨터에 로그인합니다.
제어판에서 프로그램 및 기능을 선택합니다.
프로그램 및 기능에서 Microsoft Monitoring Agent>제거>예를 선택합니다.

참고 항목

에이전트 설정 마법사는 Azure Portal의 작업 영역에서 다운로드할 수 있는 MMASetup-\<platform\>.exe를 두 번 클릭하여 실행할 수도 있습니다.

명령줄에서 제거

다운로드한 에이전트용 파일은 IExpress로 만든 자체 포함 설치 패키지입니다. 에이전트용 설치 프로그램 및 지원 파일은 패키지에 포함되어 있으며 다음 예에 표시된 명령줄을 사용하여 제대로 제거하려면 압축을 풀어야 합니다.

관리 권한이 있는 계정으로 컴퓨터에 로그인합니다.
에이전트 설치 파일을 추출하려면 관리자 권한 명령 프롬프트에서 extract MMASetup-<platform>.exe를 실행합니다. 그러면 파일을 추출할 경로를 묻은 메시지가 표시됩니다. extract MMASetup-<platform>.exe /c:<Path> /t:<Path> 인수를 전달하여 경로를 지정할 수도 있습니다. IExpress에서 지원하는 명령줄 스위치에 대한 자세한 내용은 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 에이전트

System Center Operations Manager 관리 그룹에 보고하도록 Windows용 Log Analytics 에이전트를 구성하려면 다음 단계를 수행합니다.

참고 항목

Microsoft Operations Management Suite에서 Azure Monitor로 진행 중인 전환의 일부로 Windows 또는 Linux용 Operations Management Suite 에이전트는 Windows용 Log Analytics 에이전트 및 Linux용 Log Analytics 에이전트로 참조됩니다.

관리 권한이 있는 계정으로 컴퓨터에 로그인합니다.
제어판을 엽니다.
Microsoft Monitoring Agent를 선택한 다음 Operations Manager 탭을 선택합니다.
Operations Manager 서버가 Active Directory와 통합된 경우 AD DS에서 관리 그룹 할당 자동 업데이트를 선택합니다.
추가를 선택하여 관리 그룹 추가 대화 상자를 엽니다.
관리 그룹 이름 입력란에 관리 그룹의 이름을 입력합니다.
기본 관리 서버 입력란에 기본 관리 서버의 컴퓨터 이름을 입력합니다.
관리 서버 포트 입력란에 TCP 포트 번호를 입력합니다.
에이전트 작업 계정에서 로컬 시스템 계정 또는 로컬 도메인 계정을 선택합니다.
확인을 선택하여 관리 그룹 추가 대화 상자를 닫습니다. 그런 다음 확인을 선택하여 Microsoft Monitoring Agent 속성 대화 상자를 닫습니다.

Linux 에이전트

System Center Operations Manager 관리 그룹에 보고하도록 Linux용 Log Analytics 에이전트를 구성하려면 다음 단계를 수행합니다.

참고 항목

/etc/opt/omi/conf/omiserver.conf 파일을 편집합니다.
httpsport=로 시작하는 줄이 포트 1270(예: httpsport=1270)을 정의하는지 확인합니다.
다음 명령을 사용하여 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 에이전트 문제 해결을 검토합니다.

Windows 및 Linux용 Log Analytics 에이전트 관리 및 유지 관리

에이전트 업그레이드

Windows 에이전트 업그레이드

설치 마법사를 사용하여 업그레이드

명령줄에서 업그레이드

Linux 에이전트 업그레이드

Linux 에이전트에 대한 자동 업데이트 사용

작업 영역 추가 또는 제거

Windows 에이전트

제어판에서 설정 업데이트

PowerShell을 사용하여 작업 영역 제거

PowerShell을 사용하여 Azure 상용에서 작업 영역 추가

PowerShell을 사용하여 미국 정부를 위한 Azure에서 작업 영역 추가

Linux 에이전트

프록시 설정 업데이트

Windows 에이전트

제어판을 사용하여 설정 업데이트

PowerShell을 사용하여 설정 업데이트

Linux 에이전트

에이전트 제거

Windows 에이전트

제어판에서 제거

명령줄에서 제거

Linux 에이전트

에이전트에서 Operations Manager 관리 그룹에 보고하도록 구성

Windows 에이전트

Linux 에이전트

자주 묻는 질문

Log Analytics 에이전트에서 Azure Monitor와 통신하지 못하도록 중지하려면 어떻게 해야 하나요?

다음 단계

추가 리소스