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

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

중요

레거시 Log Analytics 에이전트는 2024년 8월에 지원 중단됩니다. 데이터 수집을 계속하려면 2024년 8월 이전에 Azure Monitor 에이전트로 마이그레이션하세요.

에이전트 업그레이드

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

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

Windows 에이전트 업그레이드

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

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

  1. Azure Portal에 로그인합니다.

  2. Azure Portal에서 모든 서비스를 선택합니다. 리소스 목록에서 Log Analytics를 입력합니다. 입력을 시작하면 입력한 내용을 바탕으로 목록이 필터링됩니다. Log Analytics 작업 영역을 선택합니다.

  3. Log Analytics 작업 영역 목록에서 작업 영역을 선택합니다.

  4. Log Analytics 작업 영역에서 에이전트 관리 타일을 선택한 다음 , Windows Server를 선택합니다.

  5. Windows Server 화면에서 Windows 운영 체제의 프로세서 아키텍처에 따라 다운로드할 적절한 Windows 에이전트 버전 다운로드를 선택합니다.

참고

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

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

  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 에이전트 또는 Linux 에이전트를 사용하여 작업 영역을 추가하거나 제거합니다.

Windows 에이전트

이 섹션의 단계는 Windows 에이전트를 다시 구성하여 다른 작업 영역에 보고하거나 구성에서 작업 영역을 제거하려는 경우뿐만 아니라 둘 이상의 작업 영역에 보고하도록 에이전트를 구성하려는 경우에도 필요합니다. (이 방법을 일반적으로 멀티호밍이라고 합니다.) 여러 작업 영역에 보고하도록 Windows 에이전트를 구성하는 작업은 에이전트를 처음 설정한 후에 이 섹션에 설명된 방법을 사용하여 수행할 수 있습니다.

제어판에서 설정 업데이트

  1. 관리 권한이 있는 계정으로 컴퓨터에 로그인합니다.

  2. 제어판을 엽니다.

  3. Microsoft Monitoring Agent를 선택한 다음, Azure Log Analytics 탭을 선택합니다.

  4. 작업 영역을 제거하는 경우 작업 영역을 선택한 다음 제거를 선택합니다. 에이전트에서 보고를 중지할 다른 작업 영역에 대해 이 단계를 반복합니다.

  5. 작업 영역을 추가하는 경우 추가를 선택합니다. Log Analytics 작업 영역 추가 대화 상자에서 작업 영역 ID 및 작업 영역 키(기본 키)를 붙여넣습니다. 컴퓨터가 Azure Government 클라우드에서 Log Analytics 작업 영역에 보고해야 하는 경우 Azure Cloud 드롭다운 목록에서 Azure 미국 정부를 선택합니다.

  6. 확인을 선택하여 변경 내용을 저장합니다.

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

참고

이전에 명령줄 또는 스크립트를 사용하여 에이전트를 설치 또는 구성한 경우 EnableAzureOperationalInsightsAddCloudWorkspaceRemoveCloudWorkspace로 바뀌었습니다.

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)

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

프록시 설정 업데이트

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

Windows 에이전트

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

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

  1. 관리 권한이 있는 계정으로 컴퓨터에 로그인합니다.

  2. 제어판을 엽니다.

  3. Microsoft Monitoring Agent를 선택한 다음 프록시 설정 탭을 선택합니다.

  4. 프록시 서버 사용을 선택하고 프록시 서버 또는 게이트웨이의 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 주소를 허용합니다.

  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 경우 EOF에서 proxy.conf 제거를 시도하여 '\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 에이전트를 사용합니다.

제어판에서 제거

  1. 관리 권한이 있는 계정으로 컴퓨터에 로그인합니다.

  2. 제어판 프로그램 및 기능을 선택합니다.

  3. 프로그램 및 기능에서 Microsoft Monitoring Agent>제거>예를 선택합니다.

참고

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

명령줄에서 제거

다운로드한 에이전트용 파일은 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 에이전트

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

참고

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

  1. 관리 권한이 있는 계정으로 컴퓨터에 로그인합니다.

  2. 제어판을 엽니다.

  3. Microsoft Monitoring Agent를 선택한 다음 Operations Manager 탭을 선택합니다.

  4. Operations Manager 서버가 Active Directory와 통합된 경우 AD DS에서 관리 그룹 할당 자동 업데이트를 선택합니다.

  5. 추가를 선택하여 관리 그룹 추가 대화 상자를 엽니다.

  6. 관리 그룹 이름 필드에 관리 그룹의 이름을 입력합니다.

  7. 기본 관리 서버 필드에 기본 관리 서버의 컴퓨터 이름을 입력합니다.

  8. 관리 서버 포트 필드에 TCP 포트 번호를 입력합니다.

  9. 에이전트 작업 계정에서 로컬 시스템 계정 또는 로컬 도메인 계정을 선택합니다.

  10. 확인을 선택하여 관리 그룹 추가 대화 상자를 닫습니다. 그런 다음 확인을 선택하여 Microsoft Monitoring Agent 속성 대화 상자를 닫습니다.

Linux 에이전트

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

참고

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

  1. /etc/opt/omi/conf/omiserver.conf 파일을 편집합니다.

  2. 로 시작하는 httpsport= 줄이 포트 1270을 정의하는지 확인합니다(예: .) httpsport=1270.

  3. 다음 명령을 사용하여 OMI 서버를 다시 시작합니다.

    sudo /opt/omi/bin/service_control restart

다음 단계

  • Linux 에이전트를 설치하거나 관리하는 동안 문제가 발생하는 경우 Linux 에이전트 문제 해결을 검토합니다.
  • Windows 에이전트를 설치하거나 관리하는 동안 문제가 발생하는 경우 Windows 에이전트 문제 해결을 검토합니다.