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

아티클
08/25/2024

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

필수 조건

운영 체제

Azure VM Dependency Agent는 커널 수준에서 작동하므로 운영 체제 지원도 커널 버전에 따라 달라집니다. 종속성 에이전트 버전 9.10.*을 기준으로 에이전트는 * 커널을 지원합니다. 다음 표에는 종속성 에이전트에 대한 주 및 부 Linux OS 릴리스와 지원되는 커널 버전이 나와 있습니다.

참고 항목

Dependency Agent 9.10.15 이상에서는 지원되지 않는 커널 버전에 대한 설치가 차단되지 않지만 에이전트는 성능 저하 모드에서 실행됩니다. 이 모드에서는 VMConnection 및 VMBoundport 테이블에 저장된 연결 및 포트 데이터가 수집되지 않습니다. VMProcess 테이블에는 일부 데이터가 있을 수 있지만 최소한의 데이터일 수 있습니다.

배포	OS 버전	커널 버전
Red Hat Linux 8	8.6	4.18.0-372.el8.x86_64, 4.18.0-372.el8_6.x86_64
	8.5	4.18.0-348.el8_5.x86_644.18.0-348.el8.x86_64
	8.4	4.18.0-305.el8.x86_64, 4.18.0-305.el8_4.x86_64
	8.3	4.18.0-240.*el8_3.x86_64
	8.2	4.18.0-193.*el8_2.x86_64
	8.1	4.18.0-147.*el8_1.x86_64
	8.0	4.18.0-80.el8.x86_64 4.18.0-80.el8_0.x86_64
Red Hat Linux 7	7.9	3.10.0-1160
	7.8	3.10.0-1136
	7.7	3.10.0-1062
	7.6	3.10.0-957
	7.5	3.10.0-862
	7.4	3.10.0-693
Red Hat Linux 6	6.10	2.6.32-754
	6.9	2.6.32-696
CentOS Linux 8	8.6	4.18.0-372.el8.x86_64, 4.18.0-372.el8_6.x86_64
	8.5	4.18.0-348.el8_5.x86_644.18.0-348.el8.x86_64
	8.4	4.18.0-305.el8.x86_64, 4.18.0-305.el8_4.x86_64
	8.3	4.18.0-240.*el8_3.x86_64
	8.2	4.18.0-193.*el8_2.x86_64
	8.1	4.18.0-147.*el8_1.x86_64
	8.0	4.18.0-80.el8.x86_64 4.18.0-80.el8_0.x86_64
CentOS Linux 7	7.9	3.10.0-1160
	7.8	3.10.0-1136
	7.7	3.10.0-1062
CentOS Linux 6	6.10	2.6.32-754.3.5 2.6.32-696.30.1
	6.9	2.6.32-696.30.1 2.6.32-696.18.7
Ubuntu Server	20.04	5.8 5.4*
	18.04	5.3.0-1020 5.0(Azure 조정 커널 포함) 4.18* 4.15*
	16.04.3	4.15.*
	16.04	4.13.* 4.11.* 4.10.* 4.8.* 4.4.*
	14.04	3.13.-generic 4.4.-generic
SUSE Linux 12 Enterprise Server	12 SP5	4.12.14-122.-기본값, 4.12.14-16.-Azure
	12 SP4	4.12.*(Azure 조정 커널 포함)
	12 SP3	4.4.*
	12 SP2	4.4.*
SUSE Linux 15 Enterprise Server	15 SP1	4.12.14-197.-기본값, 4.12.14-8.-Azure
	15	4.12.14-150.*-기본값
Debian	9	4.9

참고 항목

Ampere Altra ARM 기반 프로세서를 사용하는 Azure Virtual Machines에 대한 종속성 에이전트는 지원되지 않습니다.

확장 스키마

다음 JSON은 Azure Linux 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 Linux Azure VM."
      }
    }
  },
  "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": "DependencyAgentLinux",
          "typeHandlerVersion": "9.5",
          "autoUpgradeMinorVersion": true,
          "settings": {
              "enableAMA": "true"
        }
      }
    }
  ],
    "outputs": {
    }
}

속성 값

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

Important

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

템플릿 배포

Azure Resource Manager 템플릿을 사용하여 Azure VM 확장을 배포할 수 있습니다. 이전 섹션에서 자세히 설명한 JSON 스키마를 Azure Resource Manager 템플릿에서 사용하여 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": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "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": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "enableAMA": "true"
        }
	}
}

Azure CLI 배포

Azure CLI를 사용하여 종속성 에이전트 VM 확장을 기존 가상 머신에 배포할 수 있습니다.


az vm extension set \
    --resource-group myResourceGroup \
    --vm-name myVM \
    --name DependencyAgentLinux \
    --publisher Microsoft.Azure.Monitoring.DependencyAgent \
    --version 9.5

자동 확장 업그레이드

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

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

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

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

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

Important

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

문제 해결 및 지원

문제 해결

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

az vm extension list --resource-group myResourceGroup --vm-name myVM -o table

확장 실행 출력은 다음 파일에 기록됩니다.

/var/opt/microsoft/dependency-agent/log/install.log

지원

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

다음을 통해 공유