Azure Connected Machine 에이전트 개요
Azure Connected Machine 에이전트를 사용하면 Azure 외부에서 회사 네트워크 또는 다른 클라우드 공급자에 호스트되는 Windows 및 Linux 머신을 관리할 수 있습니다.
에이전트 구성 요소
Azure Connected Machine 에이전트 패키지에는 여러 개의 논리적 구성 요소가 함께 포함되어 있습니다.
하이브리드 인스턴스 메타데이터 서비스(HIMDS)는 Azure 및 연결된 머신의 Azure ID에 대한 연결을 관리합니다.
게스트 구성 에이전트는 머신에서 필요한 정책을 준수하는지 평가하고 규정 준수를 시행하는 등의 기능을 제공합니다.
연결되지 않은 머신에 대한 Azure Policy 게스트 구성과 관련된 다음 동작에 유의하세요.
- 연결이 끊어진 컴퓨터를 대상으로 하는 Azure Policy 할당은 영향을 받지 않습니다.
- 게스트 할당은 14일 동안 로컬에 저장됩니다. 14일 기간 내에 연결된 컴퓨터 에이전트가 서비스에 다시 연결하는 경우 정책 할당이 다시 적용됩니다.
- 할당은 14일 후에 삭제되며 14일 기간 이후에는 컴퓨터에 다시 할당되지 않습니다.
확장 에이전트는 설치, 제거 및 업그레이드를 포함하여 VM 확장을 관리합니다. Azure는 확장을 다운로드하여 Windows의
%SystemDrive%\%ProgramFiles%\AzureConnectedMachineAgent\ExtensionService\downloads폴더와 Linux의/opt/GC_Ext/downloads폴더에 복사합니다. Windows에서는 확장이 경로%SystemDrive%\Packages\Plugins\<extension>에 설치되고 Linux에서는 확장이/var/lib/waagent/<extension>에 설치됩니다.
참고 항목
AMA(Azure Monitor 에이전트)는 모니터링 데이터를 수집하는 별도의 에이전트이며 Connected Machine 에이전트를 대체하지는 않습니다. AMA는 Windows 및 Linux 머신 모두에 대한 Log Analytics 에이전트, 진단 확장 및 Telegraf 에이전트만 대체합니다.
에이전트 리소스
다음 정보는 Azure Connected Machine 에이전트에서 사용하는 디렉터리 및 사용자 계정에 대해 설명합니다.
Windows 에이전트 설치 세부 정보
Windows 에이전트는 MSI(Windows Installer 패키지)로 배포됩니다. Microsoft 다운로드 센터에서 Windows 에이전트를 다운로드하세요. Windows용 Connected Machine 에이전트를 설치하면 다음과 같은 시스템 차원 구성 변경 내용이 적용됩니다.
설치 프로세스는 설치하는 동안 다음 폴더를 만듭니다.
디렉터리 설명 %ProgramFiles%\AzureConnectedMachineAgent azcmagent CLI 및 인스턴스 메타데이터 서비스 실행 파일. %ProgramFiles%\AzureConnectedMachineAgent\ExtensionService\GC 확장 서비스 실행 파일. %ProgramFiles%\AzureConnectedMachineAgent\GCArcService\GC 게스트 구성(정책) 서비스 실행 파일. %ProgramData%\AzureConnectedMachineAgent azcmagent CLI 및 인스턴스 메타데이터 서비스에 대한 구성, 로그 및 ID 토큰 파일. %ProgramData%\GuestConfig 확장 패키지 다운로드, 게스트 구성(정책) 정의 다운로드 및 확장 및 게스트 구성 서비스에 대한 로그. %SYSTEMDRIVE%\packages 확장 패키지 실행 파일 에이전트를 설치하면 대상 컴퓨터에 다음 Windows 서비스가 만들어집니다.
Service name 표시 이름 프로세스 이름 설명 himds Azure Hybrid Instance Metadata Service himds.exe메타데이터를 Azure와 동기화하고 확장 및 애플리케이션에 대한 로컬 REST API를 호스트하여 메타데이터에 액세스하고 Microsoft Entra 관리 ID 토큰을 요청합니다 GCArcService 게스트 구성 Arc 서비스 gc_arc_service.exe(버전 1.36 이전의 gc_service.exe)머신에서 Azure 게스트 구성 정책을 감사하고 적용합니다. ExtensionService 게스트 구성 확장 서비스 gc_extension_service.exe(버전 1.36 이전의 gc_service.exe)머신에서 확장을 설치, 업데이트 및 관리합니다. 에이전트 설치는 다음 가상 서비스 계정을 만듭니다.
가상 계정 설명 NT SERVICE\himds Hybrid Instance Metadata Service를 실행하는 데 사용되는 권한 없는 계정입니다. 팁
이 계정에는 “서비스로 로그온” 권한이 필요합니다. 이 권한은 에이전트 설치 중에 자동으로 부여되지만 조직에서 그룹 정책 사용하여 사용자 권한 할당을 구성하는 경우 에이전트가 작동할 수 있도록 “NT SERVICE\himds” 또는 “NT SERVICE\ALL SERVICES”에 대한 권한을 부여하도록 그룹 정책 개체를 조정해야 할 수 있습니다.
에이전트 설치는 다음 로컬 보안 그룹을 만듭니다.
보안 그룹 이름 설명 하이브리드 에이전트 확장 애플리케이션 이 보안 그룹의 구성원은 시스템 할당 관리 ID에 대한 Microsoft Entra 토큰을 요청할 수 있습니다. 에이전트 설치는 다음과 같은 환경 변수를 만듭니다.
이름 기본값 설명 IDENTITY_ENDPOINT http://localhost:40342/metadata/identity/oauth2/tokenIMDS_ENDPOINT http://localhost:40342다음 표에 설명된 문제 해결에 사용할 수 있는 몇 가지 로그 파일이 있습니다.
로그 설명 %ProgramData%\AzureConnectedMachineAgent\Log\himds.log 하트비트 및 ID 에이전트 구성 요소의 세부 정보를 기록합니다. %ProgramData%\AzureConnectedMachineAgent\Log\azcmagent.log azcmagent 도구 명령의 출력을 포함합니다. %ProgramData%\GuestConfig\arc_policy_logs\gc_agent.log 게스트 구성(정책) 에이전트 구성 요소에 대한 세부 정보를 기록합니다. %ProgramData%\GuestConfig\ext_mgr_logs\gc_ext.log 확장 관리자 작업(확장 설치, 제거 및 업그레이드 이벤트)에 대한 세부 정보를 기록합니다. %ProgramData%\GuestConfig\extension_logs 개별 확장에 대한 로그가 포함된 디렉터리입니다. 이 프로세스는 로컬 보안 그룹 하이브리드 에이전트 확장 애플리케이션을 만듭니다.
에이전트를 제거한 후 다음 아티팩트가 남아 있습니다.
- %ProgramData%\AzureConnectedMachineAgent\Log
- %ProgramData%\AzureConnectedMachineAgent
- %ProgramData%\GuestConfig
- %SystemDrive%\packages
Linux 에이전트 설치 세부 정보
Microsoft 패키지 리포지토리에서 호스트되는 배포(.rpm 또는 .deb)에 대한 기본 패키지 형식은 Linux용 Connected Machine 에이전트를 제공합니다. 셸 스크립트 번들 Install_linux_azcmagent.sh는 에이전트를 설치하고 구성합니다.
서버를 다시 시작한 후에는 Connected Machine 에이전트 설치, 업그레이드 및 제거가 필요하지 않습니다.
Linux용 Connected Machine 에이전트를 설치하면 다음과 같은 시스템 차원 구성 변경 내용이 적용됩니다.
설치 프로그램은 다음 설치 폴더를 만듭니다.
디렉터리 설명 /opt/azcmagent/ azcmagent CLI 및 인스턴스 메타데이터 서비스 실행 파일. /opt/GC_Ext/ 확장 서비스 실행 파일. /opt/GC_Service/ 게스트 구성(정책) 서비스 실행 파일. /var/opt/azcmagent/ azcmagent CLI 및 인스턴스 메타데이터 서비스에 대한 구성, 로그 및 ID 토큰 파일. /var/lib/GuestConfig/ 확장 패키지 다운로드, 게스트 구성(정책) 정의 다운로드 및 확장 및 게스트 구성 서비스에 대한 로그. 에이전트를 설치하면 다음 디먼이 만들어집니다.
Service name 표시 이름 프로세스 이름 설명 himdsd.service Azure Connected Machine 에이전트 서비스 himds 이 서비스는 하이브리드 IMDS(인스턴스 메타데이터 서비스)를 구현하여 Azure 및 연결된 머신의 Azure ID에 대한 연결을 관리합니다. gcad.service GC Arc 서비스 gc_linux_service 머신에서 Azure 게스트 구성 정책을 감사하고 적용합니다. extd.service 확장 서비스 gc_linux_service 머신에서 확장을 설치, 업데이트 및 관리합니다. 다음 표에 설명된 문제 해결에 사용할 수 있는 몇 가지 로그 파일이 있습니다.
로그 설명 /var/opt/azcmagent/log/himds.log 하트비트 및 ID 에이전트 구성 요소의 세부 정보를 기록합니다. /var/opt/azcmagent/log/azcmagent.log azcmagent 도구 명령의 출력을 포함합니다. /var/lib/GuestConfig/arc_policy_logs 게스트 구성(정책) 에이전트 구성 요소에 대한 세부 정보를 기록합니다. /var/lib/GuestConfig/ext_mgr_logs 확장 관리자 작업(확장 설치, 제거 및 업그레이드 이벤트)에 대한 세부 정보를 기록합니다. /var/lib/GuestConfig/extension_logs 개별 확장에 대한 로그가 포함된 디렉터리입니다. 에이전트 설치는
/lib/systemd/system.conf.d/azcmagent.conf에 설정된 다음 환경 변수를 만듭니다.이름 기본값 설명 IDENTITY_ENDPOINT http://localhost:40342/metadata/identity/oauth2/tokenIMDS_ENDPOINT http://localhost:40342에이전트를 제거한 후 다음 아티팩트가 남아 있습니다.
- /var/opt/azcmagent
- /var/lib/GuestConfig
에이전트 리소스 거버넌스
Azure Connected Machine 에이전트는 에이전트와 시스템 리소스 사용을 관리하도록 설계되어 있습니다. 에이전트는 다음과 같은 경우에 리소스 거버넌스에 접근합니다.
컴퓨터 구성(이전의 게스트 구성) 서비스는 CPU의 최대 5%를 사용하여 정책을 평가할 수 있습니다.
확장 서비스는 Windows 컴퓨터에서 CPU의 최대 5%, Linux 컴퓨터에서 CPU의 30%를 사용하여 확장을 설치, 업그레이드, 실행 및 삭제할 수 있습니다. 일부 확장은 설치된 후에 더 제한적인 CPU 제한을 적용할 수 있습니다. 다음과 같은 예외가 있습니다.
확장 형식 운영 체제 CPU 제한 AzureMonitorLinuxAgent Linux 60% AzureMonitorWindowsAgent Windows 100% LinuxOsUpdateExtension Linux 60% MDE.Linux Linux 60% MicrosoftDnsAgent Windows 100% MicrosoftMonitoringAgent Windows 60% OmsAgentForLinux Linux 60%
Azure에 연결되어 있고 확장을 적극적으로 수정하거나 정책을 평가하지 않는 Azure Connected Machine 에이전트로 정의된 일반 작업 중에 에이전트는 다음 시스템 리소스를 소비할 것으로 예상할 수 있습니다.
| Windows | Linux | |
|---|---|---|
| CPU 사용량(1 코어로 정규화됨) | 0.07% | 0.02% |
| 메모리 사용량 | 57MB | 42MB |
위의 성능 데이터는 Windows Server 2022 및 Ubuntu 20.04를 실행하는 가상 머신에서 2023년 4월에 수집되었습니다. 실제 에이전트 성능 및 리소스 사용량은 서버의 하드웨어 및 소프트웨어 구성에 따라 달라집니다.
사용자 지정 리소스 제한
기본 리소스 거버넌스 제한은 대부분의 서버에 가장 적합한 선택입니다. 그러나 CPU 리소스가 제한된 소규모 가상 머신 및 서버는 작업을 완료하기에 충분한 CPU 리소스가 없기 때문에 확장을 관리하거나 정책을 평가할 때 시간 초과가 발생할 수 있습니다. 에이전트 버전 1.39부터 확장 관리자 및 Machine Configuration 서비스에 적용되는 CPU 제한을 사용자 지정하여 에이전트가 이러한 작업을 더 빠르게 완료할 수 있도록 할 수 있습니다.
확장 관리자 및 Machine Configuration 서비스에 대한 현재 리소스 제한을 보려면 다음 명령을 실행합니다.
azcmagent config list
출력에는 두 개의 필드 guestconfiguration.agent.cpulimit 가 표시되고 extensions.agent.cpulimit 현재 리소스 제한이 백분율로 지정됩니다. 에이전트를 새로 설치하면 기본 제한이 CPU의 5%이므로 둘 다 표시됩니다 5 .
확장 관리자의 리소스 제한을 80%로 변경하려면 다음 명령을 실행합니다.
azcmagent config set extensions.agent.cpulimit 80
인스턴스 메타데이터
연결된 머신에 대한 메타데이터 정보는 Connected Machine 에이전트에서 Azure Arc 지원 서버를 등록한 후에 수집됩니다. 특별한 사항
- 운영 체제 이름, 유형 및 버전
- 컴퓨터 이름
- 컴퓨터 제조업체 및 모델
- 컴퓨터 FQDN(정규화된 도메인 이름)
- 도메인 이름(Active Directory 도메인에 조인된 경우)
- Active Directory 및 DNS FQDN(정규화된 도메인 이름)
- UUID(BIOS ID)
- Connected Machine 에이전트 하트비트
- Connected Machine 에이전트 버전
- 관리 ID에 대한 퍼블릭 키
- 정책 준수 상태 및 세부 정보(게스트 구성 정책을 사용하는 경우)
- SQL Server 설치(부울 값)
- 클러스터 리소스 ID(Azure Stack HCI 노드의 경우)
- 하드웨어 제조업체
- 하드웨어 모델
- CPU 제품군, 소켓, 물리적 코어 및 논리적 코어 수
- 총 실제 메모리
- 일련 번호
- SMBIOS 자산 태그
- 클라우드 공급자
- AWS(Amazon Web Services) 메타데이터(AWS에서 실행할 때):
- 계정 ID
- Instance ID
- 지역
- GCP(Google Cloud Platform) 메타데이터(GCP에서 실행할 때):
- Instance ID
- 이미지
- 머신 형식
- 프로젝트 ID
- 프로젝트 번호
- 서비스 계정
- 존
- OCI에서 실행되는 경우 Oracle 클라우드 인프라 메타데이터:
- 표시 이름
에이전트는 Azure에서 다음 메타데이터 정보를 요청합니다.
- 리소스 위치(지역)
- 가상 머신 ID
- 태그
- Microsoft Entra 관리 ID 인증서
- 게스트 구성 정책 할당
- 확장 요청 - 설치, 업데이트 및 삭제
참고 항목
Azure Arc 지원 서버에서는 고객이 서비스 인스턴스를 배포하는 지역 외부에서 고객 데이터를 저장/처리하지 않습니다.
배포 옵션 및 요구 사항
에이전트 배포 및 컴퓨터 연결에는 특정 필수 구성 요소가 필요합니다. 알아야 할 네트워킹 요구 사항도 있습니다.
에이전트를 배포하기 위한 몇 가지 옵션을 제공합니다. 자세한 내용은 배포 계획 및 배포 옵션을 참조하세요.
다음 단계
- Azure Arc 지원 서버를 평가하려면 빠른 시작: Azure Arc 지원 서버와 하이브리드 머신 연결을 참조하세요.
- Azure Connected Machine 에이전트를 배포하고 다른 Azure 관리 및 모니터링 서비스와 통합하기 전에 계획 및 배포 가이드를 검토합니다.
- 에이전트 연결 문제 해결 가이드에서 문제 해결 정보를 검토하세요.