Windows용 Azure Monitor 종속성 가상 머신 확장

아티클
03/05/2024

VM용 Azure Monitor 맵 기능은 Microsoft Dependency Agent에서 해당 데이터를 가져옵니다. Windows용 Azure VM 종속성 에이전트 가상 머신 확장은 Azure 가상 머신에 종속성 에이전트를 설치합니다. 이 문서에서는 Windows용 Azure VM 종속성 에이전트 가상 머신 확장에 대해 지원되는 플랫폼, 구성 및 배포 옵션을 자세히 설명합니다.

운영 체제

Windows용 Azure VM 종속성 에이전트 확장은 다음 표에 나열된 지원되는 운영 체제에 대해 실행할 수 있습니다. 다음 표의 모든 운영 체제는 x64로 간주됩니다. x86은 모든 운영 체제에서 지원되지 않습니다.

운영 체제	Azure VM 종속성 에이전트
Windows Server 2022	✓
Windows Server 2022 Core	✓
Windows Server 2019	✓
Windows Server 2019 Core	✓
Windows Server 2016	✓
Windows Server 2016 Core	✓
Windows Server 2012 R2	✓
Windows Server 2012	✓
Windows 11 Client 및 Pro	✓¹, ²
Windows 11 Enterprise (다중 세션 포함)	✓
Windows 10 1803(RS4) 이상	✓¹
Windows 10 Enterprise (다중 세션 포함) 및 Pro (서버 시나리오에만 해당)	✓
Windows 8 Enterprise 및 Pro (서버 시나리오에만 해당)
Windows 7 SP1 (서버 시나리오에만 해당)
Azure Stack HCI
Windows IoT Enterprise	✓

¹ Azure Monitor 에이전트 클라이언트 설치 관리자 사용.
² Arm64 기반 컴퓨터에서도 지원됩니다.

확장 스키마

다음 JSON은 Azure Windows VM에서 Azure VM 종속성 에이전트 확장에 대한 스키마를 보여 줍니다.

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "metadata": {
        "description": "The name of existing Azure VM. Supported Windows Server versions:  2008 R2 and above (x64)."
      }
    }
  },
  "variables": {
    "vmExtensionsApiVersion": "2017-03-30"
  },
  "resources": [
    {
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "name": "[concat(parameters('vmName'),'/DAExtension')]",
      "apiVersion": "[variables('vmExtensionsApiVersion')]",
      "location": "[resourceGroup().location]",
      "dependsOn": [],
      "properties": {
          "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
          "type": "DependencyAgentWindows",
          "typeHandlerVersion": "9.10",
          "autoUpgradeMinorVersion": true,
          "settings": {
                "enableAMA": "true"
		    }
      }
    }
  ],
    "outputs": {
    }
}

속성 값

이름	값/예제
apiVersion	2015-01-01
publisher	Microsoft.Azure.Monitoring.DependencyAgent
type	DependencyAgentWindows
typeHandlerVersion	9.10
autoUpgradeMinorVersion	true
설정	"enableAMA": "true"

Important

Azure Monitor 에이전트를 사용하는 경우 템플릿에 enableAMA을(를) 추가해야 합니다. 그렇지 않으면 종속성 에이전트가 레거시 Log Analytics 에이전트로 데이터를 보내려고 시도합니다. 로그아웃 서비스 URL 텍스트 상자에 로그아웃 URL 값을 붙여넣습니다.

템플릿 배포

Azure Resource Manager 템플릿을 사용하여 Azure VM 확장을 배포할 수 있습니다. Azure Resource Manager 템플릿의 이전 섹션에서 자세히 설명한 JSON 스키마를 사용하여 Azure Resource Manager 템플릿 배포 중에 Azure VM 종속성 에이전트 확장을 실행할 수 있습니다.

가상 머신 확장에 대한 JSON은 가상 머신 리소스 내에 중첩될 수 있습니다. 또는 Resource Manager JSON 템플릿의 루트 또는 최상위 수준에 배치할 수 있습니다. JSON의 배치는 리소스 이름 및 형식 값에 영향을 줍니다. 자세한 내용은 자식 리소스의 이름 및 형식 설정을 참조하세요.

다음 예제에서는 종속성 에이전트 확장이 가상 머신 리소스 내에 중첩되어 있다고 가정합니다. 확장 리소스를 중첩하면 JSON이 가상 머신의 개체에 배치 "resources": [] 됩니다.

{
	"type": "extensions",
	"name": "DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
    }
}

확장 JSON을 템플릿의 루트에 배치하면 리소스 이름에 부모 가상 머신에 대한 참조가 포함됩니다. 형식은 중첩된 구성을 반영합니다.

{
	"type": "Microsoft.Compute/virtualMachines/extensions",
	"name": "<parentVmResource>/DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
	}
}

PowerShell 배포

Set-AzVMExtension 명령을 사용하여 종속성 에이전트 가상 머신 확장을 기존 가상 머신에 배포할 수 있습니다. 명령을 실행하기 전에 공용 및 프라이빗 구성을 PowerShell 해시 테이블에 저장해야 합니다.


Set-AzVMExtension -ExtensionName "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ExtensionType "DependencyAgentWindows" `
    -TypeHandlerVersion 9.10 `
    -Location WestUS

자동 확장 업그레이드

이제 부 버전의 종속성 확장을 자동으로 업그레이드하는 새로운 기능을 사용할 수 있습니다.

확장에 대해 자동 확장 업그레이드를 사용하도록 설정하려면 속성 enableAutomaticUpgrade 이 확장 템플릿으로 true 설정되고 확장 템플릿에 추가되었는지 확인해야 합니다. 이 속성은 모든 VM 또는 VM 확장 집합에서 개별적으로 사용하도록 설정해야 합니다. 사용 섹션에 설명된 방법 중 하나를 사용하여 VM 또는 VM 확장 집합에 대한 기능을 사용하도록 설정합니다.

VM 또는 VM 확장 집합에서 자동 확장 업그레이드를 사용하도록 설정하면 확장 게시자가 해당 확장에 대한 새 버전을 릴리스할 때마다 확장이 자동으로 업그레이드됩니다. 업그레이드는 여기에 설명된 대로 가용성 우선 원칙에 따라 안전하게 적용됩니다.

enableAutomaticUpgrade 특성의 기능은 .의 기능과 autoUpgradeMinorVersion다릅니다. 확장 게시자가 새 버전을 릴리스할 때 autoUpgradeMinorVersion 특성은 부 버전 업데이트를 자동으로 트리거하지 않습니다. 이 특성은 autoUpgradeMinorVersion 배포 시 사용할 수 있는 경우 확장에서 최신 부 버전을 사용해야 하는지 여부를 나타냅니다. 그러나 일단 배포되면 이 속성이 true로 설정된 경우에도 확장이 재배포되지 않는 한 부 버전을 업그레이드하지 않습니다.

확장 버전을 업데이트된 상태로 유지하려면 확장 배포와 함께 사용하는 enableAutomaticUpgrade 것이 좋습니다.

Important

템플릿에 enableAutomaticUpgrade 추가하는 경우 API 버전 2019-12-01 이상에서 사용해야 합니다.

문제 해결 및 지원

문제 해결

확장 배포 상태에 대한 데이터는 Azure Portal에서 Azure PowerShell 모듈을 사용하여 검색할 수 있습니다. 지정된 VM에 대한 확장의 배포 상태를 보려면 Azure PowerShell 모듈을 사용하여 다음 명령을 실행합니다.

Get-AzVMExtension -ResourceGroupName myResourceGroup -VMName myVM -Name myExtensionName

확장 실행 출력은 다음 디렉터리에 있는 파일에 기록됩니다.

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitoring.DependencyAgent\

지원

이 문서의 어느 시점에서든 도움이 필요한 경우 Microsoft Q & A 및 Stack Overflow 포럼에서 Azure 전문가에게 문의할 수 있습니다. 또는 Azure 지원 인시던트를 제출할 수 있습니다. Azure 지원 사이트 로 가서 지원 받기를 선택합니다. Azure 지원을 사용하는 방법에 대한 자세한 내용은 Microsoft Azure 지원 FAQ를 참조하세요.