이 문서에서는 Azure 가상 머신, 가상 머신 확장 집합 및 Azure Arc 지원 서버에서 Azure Monitor 에이전트를 설치, 제거, 업데이트 및 구성하는 데 사용할 수 있는 다양한 방법을 설명합니다.
Important
Azure Monitor 에이전트는 클라이언트 컴퓨터에 설치된 후 데이터 수집을 시작하기 위해 하나 이상의 DCR(데이터 수집 규칙)이 필요합니다. 설치 방법은 DCR이 자동으로 만들어지는지 여부를 결정합니다. 설치하는 동안 DCR이 자동으로 만들어지지 않는 경우 Azure Monitor 에이전트를 사용하여 데이터 수집의 지침에 따라 데이터 수집을 구성해야 합니다.
필수 조건
Azure Monitor 에이전트를 사용하기 위한 필수 구성 요소 및 기타 요구 사항은 다음 문서를 참조하세요.
Kubernetes 클러스터에서 컨테이너 인사이트를 사용하도록 설정하면 컨테이너화된 버전의 Azure Monitor 에이전트가 클러스터에 설치되고 DCR이 만들어지고 즉시 데이터 수집을 시작합니다. DCR을 사용하여 컨테이너 인사이트에서 데이터 수집 및 비용 최적화 구성의 지침을 사용하여 DCR을 수정할 수 있습니다.
가상 머신 확장을 추가하기 위해 Azure CLI 명령을 사용하여 Azure 가상 머신 또는 Azure Arc 지원 서버에 Azure Monitor 에이전트를 설치할 수 있습니다.
Azure 가상 머신
다음 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 확장 집합 Azure CLI cmdlet을 사용하여 Azure 가상 머신 확장 집합에 Azure Monitor 에이전트를 설치합니다.
Azure Arc 지원 서버
다음 Azure CLI 명령을 사용하여 Azure Arc 지원 서버에 Azure Monitor 에이전트를 설치합니다.
Azure Portal을 사용하여 Azure Monitor 에이전트를 제거하려면 가상 머신, 확장 집합 또는 Azure Arc 지원 서버로 이동합니다. 확장 탭을 선택한 다음, AzureMonitorWindowsAgent 또는 AzureMonitorLinuxAgent를 선택합니다. 열리는 대화 상자에서 제거를 선택합니다.
Azure 가상 머신에서 제거
다음 PowerShell 명령을 사용하여 Azure 가상 머신에서 Azure Monitor 에이전트를 제거합니다.
에이전트의 일회성 업데이트를 수행하려면 먼저 기존 에이전트 버전을 제거해야 합니다. 그런 다음, 설명한 대로 새 버전을 설치합니다.
자동 확장 업그레이드를 사용하도록 설정하여 에이전트의 자동 업데이트를 사용하도록 설정하는 것이 좋습니다. 가상 머신 또는 확장 집합으로 이동하여 확장 탭을 선택한 다음, AzureMonitorWindowsAgent 또는 AzureMonitorLinuxAgent를 선택합니다. 열리는 대화 상자에서 자동 업그레이드 사용을 클릭합니다.
Azure 가상 머신에 업데이트
에이전트의 일회성 업데이트를 수행하려면 설명된 대로 새 버전을 설치합니다.
자동 확장 업그레이드를 옵트인하여 에이전트의 자동 업데이트를 사용하도록 설정하는 것이 좋습니다.
에이전트의 일회성 업데이트를 수행하려면 먼저 기존 에이전트 버전을 제거해야 합니다. 그런 다음, 이 문서에 설명된 대로 새 버전을 설치합니다.
다음 Azure 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 지원 서버에서 업데이트
에이전트를 일회성으로 업그레이드하려면 다음 Azure 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>
자동 확장 업그레이드를 옵트인하여 에이전트의 자동 업데이트를 사용하도록 설정하는 것이 좋습니다.
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: 1025 to 51199 Windows: 4000 to 51199
UseTimeReceivedForForwardedEvents
데이터 대신 사용할 TimeReceived Microsoft Sentinel WEF(Windows 이벤트 전달) 테이블의 TimeGenerated WEF 열을 변경합니다.
{
"$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')]"
}
}
]
}