이 문서에서는 Azure Virtual Machines, 확장 집합 및 Azure Arc 지원 서버에서 Azure Monitor 에이전트를 설치, 제거, 업데이트 및 구성하는 다양한 방법을 자세히 설명합니다.
Important
Azure Monitor 에이전트가 클라이언트 컴퓨터에 설치된 후 데이터 수집을 시작하려면 하나 이상의 DCR(데이터 수집 규칙)이 필요합니다. 사용하는 설치 방법에 따라 DCR이 자동으로 만들어질 수도 있고 만들어지지 않을 수도 있습니다. 그렇지 않은 경우 Azure Monitor 에이전트를 사용하여 데이터 수집의 지침에 따라 데이터 수집을 구성해야 합니다.
필수 조건
Azure Monitor 에이전트에 대한 필수 구성 요소 및 기타 요구 사항은 다음 문서를 참조하세요.
Azure Monitor 에이전트를 설치, 업그레이드 또는 제거하는 데에는 컴퓨터를 다시 시작할 필요가 없습니다.
설치 옵션
다음 표에는 Azure VM 및 Azure Arc 지원 서버에 Azure Monitor 에이전트를 설치하기 위한 다양한 옵션이 나열되어 있습니다. Azure Monitor 에이전트를 설치하려면 먼저 Azure가 아닌 모든 컴퓨터에 Azure Arc 에이전트를 설치해야 합니다.
설치 방법
설명
VM 확장
Azure 확장 프레임워크를 사용하여 에이전트를 설치하려면 아래 방법 중 하나를 사용합니다. 이 방법은 DCR을 만들지 않으므로 데이터 수집이 시작되기 전에 하나 이상의 DCR을 만들어 에이전트와 연결해야 합니다.
Kubernetes 클러스터에서 컨테이너 인사이트를 사용하도록 설정하면 Azure Monitor 에이전트의 컨테이너화된 버전이 클러스터에 설치되고 데이터 수집을 즉시 시작하는 DCR이 만들어집니다. 데이터 수집 규칙을 사용하여 컨테이너 인사이트에서 데이터 수집 및 비용 최적화 구성의 지침을 사용하여 이 DCR을 수정할 수 있습니다.
Azure Policy를 사용하여 Azure Virtual Machines 및 Azure Arc 지원 서버에 에이전트를 자동으로 설치하고 필요한 DCR과 자동으로 연결합니다.
참고 항목
테넌트 간에 데이터를 보내려면 먼저 Azure Lighthouse를 사용하도록 설정해야 합니다.
Azure Monitor 에이전트가 설치된 컴퓨터를 복제하는 것은 지원되지 않습니다. 이러한 상황에 대한 모범 사례는 Azure Policy 또는 인프라를 코드 도구로 사용하여 대규모로 AMA를 배포하는 것입니다.
에이전트 확장 설치
이 섹션에서는 VM 확장을 사용하여 Azure Monitor 에이전트를 설치하는 방법에 대한 세부 정보를 제공합니다.
가상 머신 확장을 추가하는 Azure CLI 명령을 사용하여 Azure Monitor 에이전트를 Azure 가상 머신 및 Azure Arc 사용 서버에 설치할 수 있습니다.
Azure 가상 머신
다음 CLI 명령을 사용하여 Azure 가상 머신에 Azure Monitor 에이전트를 설치합니다. 선택한 인증 방법에 따라 적절한 명령을 선택합니다.
사용자 할당 관리 ID
Windows
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
Windows
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 extension set CLI cmdlet을 사용하여 Azure 가상 머신 확장 집합에 Azure Monitor 에이전트를 설치합니다.
Azure Arc 지원 서버
다음 CLI 명령을 사용하여 Azure Arc 지원 서버에 Azure Monitor 에이전트를 설치합니다.
Azure Portal을 사용하여 Azure Monitor 에이전트를 제거하려면 가상 머신, 확장 집합 또는 Azure Arc 지원 서버로 이동합니다. 확장 탭을 선택하고, AzureMonitorWindowsAgent 또는 AzureMonitorLinuxAgent를 선택합니다. 열리는 대화 상자에서 제거를 선택합니다.
Azure 가상 머신에서 제거
다음 PowerShell 명령을 사용하여 Azure 가상 머신에서 Azure Monitor 에이전트를 제거합니다.
다음 CLI 명령을 사용하여 Azure Arc 지원 서버에서 Azure Monitor 에이전트를 제거합니다.
Windows
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 배포 사례를 따라 최신 버전의 에이전트를 안전하게 배포합니다. 자동 업데이트는 최신 버전을 출시하는 데 몇 주가 걸릴 것으로 예상해야 합니다.
업그레이드는 일괄 처리로 실행되므로 일부 가상 머신, 크기 조정 집합 또는 Arc 지원 서버가 다른 것보다 먼저 업그레이드되는 것을 볼 수 있습니다.
확장을 즉시 업그레이드해야 하는 경우 아래의 수동 지침을 사용할 수 있습니다. 작년에 릴리스된 에이전트만 지원됩니다.
에이전트의 일회성 업데이트를 수행하려면 먼저 기존 에이전트 버전을 제거해야 합니다. 그런 다음, 설명한 대로 새 버전을 설치합니다.
자동 확장 업그레이드 기능을 사용하도록 설정하여 에이전트의 자동 업데이트를 사용하도록 설정하는 것이 좋습니다. 가상 머신 또는 확장 집합으로 이동하여 확장 탭을 선택하고, AzureMonitorWindowsAgent 또는 AzureMonitorLinuxAgent를 선택합니다. 열리는 대화 상자에서 자동 업그레이드 사용을 클릭합니다.
Azure 가상 머신에 업데이트
에이전트의 일회성 업데이트를 수행하려면 먼저 기존 에이전트 버전을 제거한 다음, 설명한 대로 새 버전을 설치해야 합니다.
다음 PowerShell 명령으로 자동 확장 업그레이드 기능을 사용하도록 설정하여 에이전트의 자동 업데이트를 사용하도록 설정하는 것이 좋습니다.
에이전트의 일회성 업데이트를 수행하려면 먼저 기존 에이전트 버전을 제거한 다음, 설명한 대로 새 버전을 설치해야 합니다.
다음 CLI 명령으로 자동 확장 업그레이드 기능을 사용하도록 설정하여 에이전트의 자동 업데이트를 사용하도록 설정하는 것이 좋습니다.
Windows
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 지원 서버에서 업데이트
에이전트의 일회성 업그레이드를 수행하려면 다음 CLI 명령을 사용합니다.
Windows
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>
다음 PowerShell 명령으로 자동 확장 업그레이드 기능을 사용하도록 설정하여 에이전트의 자동 업데이트를 사용하도록 설정하는 것이 좋습니다.
{
"$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')]"
}
}
]
}