Azure Monitor 에이전트 설치 및 관리

2025-06-19

이 문서에서는 Azure 가상 머신, 가상 머신 확장 집합 및 Azure Arc 지원 서버에서 Azure Monitor 에이전트를 설치, 제거, 업데이트 및 구성하는 데 사용할 수 있는 다양한 방법을 설명합니다.

필수 조건

Azure Monitor 에이전트를 사용하기 위한 필수 구성 요소 및 기타 요구 사항은 다음 문서를 참조하세요.

중요

Azure Monitor 에이전트를 설치, 업그레이드 또는 제거해도 컴퓨터를 다시 시작할 필요가 없습니다.

설치 옵션

다음 표에서는 Azure VM 및 Azure Arc 지원 서버에 Azure Monitor 에이전트를 설치하는 옵션을 나열합니다.

Azure에 없는 컴퓨터의 경우 Azure Monitor 에이전트를 설치하려면 먼저 Azure Arc 에이전트를 컴퓨터에 설치해야 합니다.

설치 방법	설명
VM(가상 머신) 확장	이 문서에 설명된 방법을 사용하여 Azure 확장 프레임워크를 통해 에이전트를 설치합니다. 이 메서드는 DCR을 만들지 않으므로 데이터 수집이 시작되기 전에 하나 이상의 DCR을 만들고 에이전트와 연결해야 합니다.
DCR 만들기	Azure Portal에서 DCR을 만들 때 Azure Monitor 에이전트는 DCR에 대한 리소스로 추가된 모든 컴퓨터에 설치됩니다. 에이전트는 DCR에 정의된 대로 즉시 데이터 수집을 시작합니다.
VM 인사이트	컴퓨터에서 VM 인사이트를 사용하도록 설정하면 Azure Monitor 에이전트가 설치되고 미리 정의된 데이터 집합을 수집하기 위해 DCR이 만들어집니다. 이 DCR을 수정해서는 안 되지만 더 많은 DCR을 만들어 더 많은 데이터를 수집할 수 있습니다.
컨테이너 인사이트	Kubernetes 클러스터에서 컨테이너 인사이트를 사용하도록 설정하면 컨테이너화된 버전의 Azure Monitor 에이전트가 클러스터에 설치되고 DCR이 만들어지고 즉시 데이터 수집을 시작합니다. DCR을 사용하여 컨테이너 인사이트에서 데이터 수집 및 비용 최적화 구성의 지침을 사용하여 DCR을 수정할 수 있습니다.
클라이언트 설치 프로그램	Windows 11 및 Windows 10 클라이언트용 Windows MSI 설치 관리자를 사용하여 에이전트를 설치합니다.
Azure Policy	Azure Policy를 사용하여 Azure 가상 머신 및 Azure Arc 지원 서버에 에이전트를 자동으로 설치하고 필요한 DCR과 자동으로 연결합니다.

참고

테넌트 간에 데이터를 보내려면 먼저 Azure Lighthouse를 사용하도록 설정해야 합니다.
Azure Monitor 에이전트가 설치된 컴퓨터 복제는 지원되지 않습니다. 이 시나리오의 모범 사례는 Azure Policy 또는 IaaC(인프라를 코드) 도구로 사용하여 대규모로 Azure Monitor 에이전트를 배포하는 것입니다.

에이전트 확장 설치

에이전트를 설치하고 Azure Portal을 사용하여 데이터를 수집하는 DCR을 만들려면 Azure Monitor 에이전트를 사용하여 데이터 수집의 지침을 사용합니다.

가상 머신 확장을 추가하기 위해 PowerShell 명령을 사용하여 Azure 가상 머신 또는 Azure Arc 지원 서버에 Azure Monitor 에이전트를 설치할 수 있습니다.

Azure 가상 머신

다음 PowerShell 명령을 사용하여 Azure 가상 머신에 Azure Monitor 에이전트를 설치합니다. 사용하는 인증 방법에 따라 적절한 명령을 선택합니다.

윈도우즈

## User-assigned managed identity
Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'

## System-assigned managed identity
Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true

Linux

## User-assigned managed identity
Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'

## System-assigned managed identity
Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true

Azure 가상 머신 확장 집합

Add-AzVmssExtension PowerShell cmdlet을 사용하여 Azure 가상 머신 확장 집합에 Azure Monitor 에이전트를 설치합니다.

Azure Arc 지원 서버

다음 PowerShell 명령을 사용하여 Azure Arc 지원 서버에 Azure Monitor 에이전트를 설치합니다.

윈도우즈

New-AzConnectedMachineExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade

Linux

New-AzConnectedMachineExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade

가상 머신 확장을 추가하기 위해 Azure CLI 명령을 사용하여 Azure 가상 머신 또는 Azure Arc 지원 서버에 Azure Monitor 에이전트를 설치할 수 있습니다.

Azure 가상 머신

다음 Azure CLI 명령을 사용하여 Azure 가상 머신에 Azure Monitor 에이전트를 설치합니다. 사용하는 인증 방법에 따라 적절한 명령을 선택합니다.

사용자 할당 관리 ID

윈도우즈

az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'

Linux

az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'

시스템 할당 관리 ID

윈도우즈

az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true

Linux

az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true

Azure Virtual Machines 확장 집합

az vmss 확장 집합 Azure CLI cmdlet을 사용하여 Azure 가상 머신 확장 집합에 Azure Monitor 에이전트를 설치합니다.

Azure Arc 지원 서버

다음 Azure CLI 명령을 사용하여 Azure Arc 지원 서버에 Azure Monitor 에이전트를 설치합니다.

윈도우즈

az connectedmachine extension create --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true

Linux

az connectedmachine extension create --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true

Azure Resource Manager 템플릿을 사용하여 Azure 가상 머신 또는 Azure Arc 지원 서버에 Azure Monitor 에이전트를 설치하고 DCR과의 연결을 만들 수 있습니다. DCR에 대한 연결을 만들기 전에 DCR을 먼저 만들어야 합니다.

에이전트를 설치하고 다음 리소스에서 연결을 만드는 샘플 템플릿을 가져옵니다.

다음 명령을 포함하여 Resource Manager 템플릿에 대한 배포 방법을 사용하여 템플릿을 설치합니다.

PowerShell

New-AzResourceGroupDeployment -ResourceGroupName "<resource-group-name>" -TemplateFile "<template-filename.json>" -TemplateParameterFile "<parameter-filename.json>"

Azure 커맨드 라인 인터페이스 (CLI)

az deployment group create --resource-group "<resource-group-name>" --template-file "<path-to-template>" --parameters "@<parameter-filename.json>"

제거

Azure Portal을 사용하여 Azure Monitor 에이전트를 제거하려면 가상 머신, 확장 집합 또는 Azure Arc 지원 서버로 이동합니다. 확장 탭을 선택한 다음, AzureMonitorWindowsAgent 또는 AzureMonitorLinuxAgent를 선택합니다. 열리는 대화 상자에서 제거를 선택합니다.

Azure 가상 머신에서 제거

다음 PowerShell 명령을 사용하여 Azure 가상 머신에서 Azure Monitor 에이전트를 제거합니다.

윈도우즈

Remove-AzVMExtension -Name AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name>

Linux

Remove-AzVMExtension -Name AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name>

Azure Virtual Machines 확장 집합에서 제거

Remove-AzVmssExtension PowerShell cmdlet을 사용하여 Azure 가상 머신 확장 집합에서 Azure Monitor 에이전트를 제거합니다.

Azure Arc 지원 서버에서 제거

다음 PowerShell 명령을 사용하여 Azure Arc 지원 서버에서 Azure Monitor 에이전트를 제거합니다.

윈도우즈

Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorWindowsAgent

Linux

Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorLinuxAgent

Azure 가상 머신에서 제거

다음 Azure CLI 명령을 사용하여 Azure 가상 머신에서 Azure Monitor 에이전트를 제거합니다.

윈도우즈

az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorWindowsAgent

Linux

az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorLinuxAgent

Azure 가상 머신 확장 집합에서 제거

az vmss extension delete Azure CLI cmdlet을 사용하여 Azure 가상 머신 확장 집합에서 Azure Monitor 에이전트를 제거합니다.

Azure Arc 지원 서버에서 제거

다음 Azure CLI 명령을 사용하여 Azure Arc 지원 서버에서 Azure Monitor 에이전트를 제거합니다.

윈도우즈

az connectedmachine extension delete --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name>

Linux

az connectedmachine extension delete --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name>

업데이트

참고

항상 최신 버전의 에이전트로 업데이트하거나 자동 확장 업그레이드를 옵트인하는 것이 좋습니다.

자동 확장 롤아웃은 표준 Azure 배포 사례를 따라 최신 버전의 에이전트를 안전하게 배포합니다. 자동 업데이트는 최신 버전을 출시하는 데 몇 주가 걸릴 것으로 예상해야 합니다.

업그레이드는 일괄 처리로 실행되므로 일부 가상 머신, 확장 집합 또는 Azure Arc 지원 서버가 다른 서버 이전에 업그레이드될 수 있습니다.

확장을 즉시 업그레이드해야 하는 경우 이 문서에 설명된 수동 지침을 사용할 수 있습니다. 지난 해에 릴리스된 에이전트만 지원됩니다.

에이전트의 일회성 업데이트를 수행하려면 먼저 기존 에이전트 버전을 제거해야 합니다. 그런 다음, 설명한 대로 새 버전을 설치합니다.

에이전트의 자동 업데이트를 위해 자동 확장 업그레이드를 사용하도록 설정할 것을 권장합니다. 가상 머신 또는 확장 집합으로 이동하여 확장 탭을 선택한 다음, AzureMonitorWindowsAgent 또는 AzureMonitorLinuxAgent를 선택합니다. 열리는 대화 상자에서 자동 업그레이드 사용을 클릭합니다.

Azure 가상 머신에 업데이트

에이전트의 일회성 업데이트를 수행하려면 설명된 대로 새 버전을 설치합니다.

자동 확장 업그레이드를 옵트인하여 에이전트의 자동 업데이트를 사용하도록 설정하는 것이 좋습니다.

다음 PowerShell 명령을 사용합니다.

윈도우즈

Set-AzVMExtension -ExtensionName AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorWindowsAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true

Linux

Set-AzVMExtension -ExtensionName AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorLinuxAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true

Azure Arc 지원 서버에서 업데이트

에이전트를 일회성으로 업그레이드하려면 다음 PowerShell 명령을 사용합니다.

윈도우즈

$target = @{"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent" = @{"targetVersion"=<target-version-number>}}
Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target

Linux

$target = @{"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent" = @{"targetVersion"=<target-version-number>}}
Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target

자동 확장 업그레이드를 옵트인하여 에이전트의 자동 업데이트를 사용하도록 설정하는 것이 좋습니다.

다음 PowerShell 명령을 사용합니다.

윈도우즈

Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorWindowsAgent -EnableAutomaticUpgrade

Linux

Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorLinuxAgent -EnableAutomaticUpgrade

Azure 가상 머신에 업데이트

에이전트의 일회성 업데이트를 수행하려면 먼저 기존 에이전트 버전을 제거해야 합니다. 그런 다음, 이 문서에 설명된 대로 새 버전을 설치합니다.

다음 Azure CLI 명령을 사용하여 자동 확장 업그레이드 기능을 옵트인하여 에이전트의 자동 업데이트를 사용하도록 설정하는 것이 좋습니다.

윈도우즈

az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true

Linux

az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true

Azure Arc 지원 서버에서 업데이트

에이전트를 일회성으로 업그레이드하려면 다음 Azure CLI 명령을 사용합니다.

윈도우즈

az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>

Linux

az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>

자동 확장 업그레이드를 옵트인하여 에이전트의 자동 업데이트를 사용하도록 설정하는 것이 좋습니다.

다음 Azure CLI 명령을 사용합니다.

윈도우즈

az connectedmachine extension update --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true

Linux

az connectedmachine extension update --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true

구성(미리 보기)

DCR(데이터 수집 규칙) 은 컴퓨터의 Azure Monitor 에이전트에 대한 관리 도구 역할을 합니다. AgentSettings DCR을 사용하여 특정 모니터링 요구 사항에 맞게 에이전트를 구성하도록 특정 Azure Monitor 에이전트 매개 변수를 구성할 수 있습니다.

참고

AgentSettings DCR로 작업할 때 중요한 고려 사항:

현재 AgentSettings DCR은 Azure Resource Manager 템플릿을 사용해야만 구성할 수 있습니다.
AgentSettings는 다른 설정이 없는 단일 DCR이어야 합니다.
가상 머신과 AgentSettings DCR은 동일한 지역에 있어야 합니다.

지원되는 매개 변수

AgentSettings DCR은 현재 다음 매개 변수 설정을 지원합니다.

매개 변수	설명	유효한 값
`MaxDiskQuotaInMB`	복원력을 제공하기 위해 에이전트는 에이전트가 데이터를 보낼 수 없는 경우 로컬 캐시에서 데이터를 수집합니다. 에이전트는 연결이 복원된 후 캐시에 데이터를 보냅니다. 이 매개 변수는 Azure Monitor 에이전트 로그 파일 및 캐시에서 사용되는 디스크 공간(MB)입니다.	Linux: `4,000`에서 `1,000,000`까지 Windows: `4000`에서 `1,000,000`까지
`UseTimeReceivedForForwardedEvents`	Microsoft Sentinel Windows 이벤트 전달(WEF) 테이블의 WEF 열을 대신 `TimeReceived` 데이터를 사용하도록 변경합니다.	`0` 또는 `1`

AgentSettings DCR 설정

현재 지원되지 않습니다.

VM에 Azure Monitor 에이전트를 설치하여 환경을 준비합니다.

DCR을 만듭니다.

다음은 Azure Monitor 에이전트 캐시에서 사용하는 디스크 공간의 최대 크기를 5,000MB로 설정하는 예제입니다.

{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {},
"resources": [
    {
    "type": "Microsoft.Insights/dataCollectionRules",
    "name": "dcr-contoso-01",
    "apiVersion": "2023-03-11",
    "properties": 
        {
        "description": "A simple agent settings",
        "agentSettings": 
            {
            "logs": [
                {
                "name": "MaxDiskQuotaInMB",
                "value": "5000"
                }
            ]
            }
        },
    "kind": "AgentSettings",
    "location": "eastus"
    }
]
}

DCR을 머신과 연결합니다. 다음 Resource Manager 파일을 사용합니다.

템플릿 파일:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "metadata": {
        "description": "The name of the virtual machine."
      }
    },
    "dataCollectionRuleId": {
      "type": "string",
      "metadata": {
        "description": "The resource ID of the data collection rule."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Insights/dataCollectionRuleAssociations",
      "apiVersion": "2021-09-01-preview",
      "scope": "[format('Microsoft.Compute/virtualMachines/{0}', parameters('vmName'))]",
      "name": "agentSettings",
      "properties": {
        "description": "Association of data collection rule. Deleting this association will break the data collection for this virtual machine.",
        "dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
      }
    }
  ]
}

매개 변수 파일:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "value": "my-azure-vm"
    },
    "dataCollectionRuleId": {
      "value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
    }
   }
}

변경 내용을 적용하려면 Azure Monitor 에이전트를 다시 시작합니다.

에이전트에서 데이터를 수집하고 Azure Monitor로 보내기 위한 데이터 수집 규칙을 만듭니다.

다음을 통해 공유

Azure Monitor 에이전트 설치 및 관리

필수 조건

설치 옵션

에이전트 확장 설치

제거

업데이트

구성(미리 보기)

지원되는 매개 변수

AgentSettings DCR 설정

관련 콘텐츠

피드백

추가 리소스