운영 에이전트를 관리하는 VM 확장 프로그램 관리자 정책의 문제를 진단하려면 이 문서에 설명된 문제 해결 기법을 사용하세요. 운영 에이전트 문제 해결에 대한 자세한 내용은 운영 에이전트 문제 해결을 참조하세요.
gcloud compute zone-vm-extension-policies
gcloud compute zone-vm-extension-policiesgcloud compute zone-vm-extension-policies
명령어 출력에 IAM 권한이 부족하다고 언급된 경우 VM 확장 프로그램 관리자를 사용하는 데 필요한 역할 부여에 설명된 필요한 역할과 권한을 검토합니다.
확장 프로그램 정책이 생성되었지만 운영 에이전트 상태가 '감지되지 않음'임
확장 프로그램 정책을 만들었지만 운영 에이전트가 VM에서 '감지되지 않음' 상태를 표시합니다.
다음 중 하나가 발생하면 운영 에이전트가 '감지되지 않음'으로 표시될 수 있습니다.
- 확장 프로그램 정책에서 운영 에이전트를 설치할 수 없습니다.
- 설치된 운영 에이전트에서 실행을 방지하는 오류 조건이 발생합니다.
다음 섹션에서는 이러한 사례를 진단하는 방법을 설명합니다.
정책에 따라 운영 에이전트가 설치되었는지 확인
VM 확장 프로그램 관리자 정책은 Compute Engine 게스트 에이전트를 사용하여 운영 에이전트를 VM 확장 프로그램으로 관리합니다.
확장 프로그램 정책에 의해 운영 에이전트가 설치되었는지 확인하려면 다음 중 하나를 사용하여 게스트 에이전트의 로그 항목을 찾습니다.
로그 탐색기
-
Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Logging인 결과를 선택합니다.
다음 쿼리를 입력하고 쿼리 실행을 클릭합니다.
log_id("GCEGuestAgentManager")
Linux
Compute Engine VM에서 다음 명령어를 실행합니다.
journalctl -u google-guest-agent-manager
Windows
Compute Engine VM에서 다음 명령어를 실행합니다.
Get-Eventlog -Source google_guest_agent_manager -LogName Application
Failed to install plugin
"ops-agent-plugin" ...와 같은 문자열이 포함된 로그가 표시되거나 쿼리에서 로그가 반환되지 않으면 확장 프로그램 정책에서 운영 에이전트를 설치하지 못한 것입니다. 다음 단계는 확장 프로그램 정책에서 운영 에이전트를 설치할 수 없음을 참조하세요.
Successfully installed plugin
"ops-agent_nnnnnnnn"와 같은 문자열이 포함된 로그가 표시되면 확장 프로그램 정책이 운영 에이전트를 성공적으로 설치한 것입니다. 다음 단계는 설치된 운영 에이전트가 '감지되지 않음'을 참조하세요.
확장 프로그램 정책에서 운영 에이전트를 설치할 수 없음
다음 중 하나에 해당하는 경우 확장 프로그램 정책이 적용되지 않을 수 있습니다.
게스트 에이전트가 VM에 설치되어 있지 않습니다. 이 상태를 진단하고 해결하려면 다음을 수행합니다.
VM이 Compute Engine 게스트 환경에 지원되는 운영체제 중 하나를 사용하고 있는지 확인합니다.
VM에 설치된 패키지를 확인하여
google-guest-agent가 포함되어 있는지 확인합니다.google-guest-agent가 설치되지 않은 경우 게스트 에이전트를 설치합니다.
게스트 에이전트가 설치되어 있지만 오래되었습니다. 이 상태를 진단하고 해결하려면 다음을 수행합니다.
게스트 환경을 검증하여
google-guest-agent패키지 버전을 확인합니다. VM 확장 프로그램 관리자에는 버전20241209.01이상이 필요합니다.google-guest-agent버전이20241209.01보다 이전 버전이면 게스트 환경을 업데이트합니다.
VM의 운영체제가 VM 확장 프로그램 관리자에서 지원되지 않습니다. 자세한 내용은 지원되는 운영체제 검토를 참조하세요.
설치된 운영 에이전트의 상태가 '감지되지 않음'임
다음 중 하나에 해당하는 경우 운영 에이전트의 상태가 '감지되지 않음'일 수 있습니다.
VM에 모니터링 가능성 에이전트가 이미 설치되어 있습니다. 기존 에이전트로 인해 충돌이 발생할 수 있으므로 제거해야 합니다. 자세한 내용은 모니터링 가능성 에이전트 제거를 참조하세요.
이전에 설치된 에이전트를 제거한 후 운영 에이전트를 다시 시작할 수 있습니다.
운영 에이전트에 Cloud Logging 및 Cloud Monitoring으로 데이터를 전송할 수 있는 권한이 부족합니다. 자세한 내용은 원격 분석 전송 실패의 일반적인 이유를 참조하세요.
운영 에이전트 구성이 유효한지 확인
확장 프로그램 정책을 만들거나 업데이트하여 운영 에이전트에 커스텀 구성을 제공했지만 에이전트 상태가 '감지되지 않음'입니다. 커스텀 구성에 오류가 있을 수 있습니다. 게스트 에이전트 디버그 로그를 사용하여 구성 오류를 찾습니다.
게스트 에이전트 디버그 로깅 사용 설정
게스트 에이전트의 디버그 로깅을 사용 설정하는 방법은 게스트 에이전트의 디버그 로그 보기를 참조하세요.
디버그 로그 검사
로그 탐색기
-
Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Logging인 결과를 선택합니다.
다음 쿼리를 입력하고 쿼리 실행을 클릭합니다.
severity>=DEBUG log_id("GCEGuestAgentManager") "The agent config file is not valid"
Linux
Linux Compute Engine VM에서 다음 명령어를 실행합니다.
journalctl -u google-guest-agent-manager | grep "The agent config file is not valid"
Windows
Windows Compute Engine VM에서 다음 명령어를 실행합니다.
Get-Eventlog -Source google_guest_agent_manager -LogName Application |
Where-Object {$_.Message -like "*The agent config file is not valid*"}
The agent config file is not valid 문자열이 포함된 로그가 표시되면 확장 프로그램 정책을 만들거나 업데이트할 때 제공한 운영 에이전트의 커스텀 구성이 잘못된 것입니다.
이 문제를 해결하려면 다음 단계를 따르세요.
운영 에이전트 구성을 참조하여 구성을 수정합니다. 운영 에이전트 구성 파일의 구조에 대한 정보입니다.
수정된 구성으로 확장 프로그램 정책을 업데이트합니다.
Linux systemctl status 및 Windows Get-Service 명령어가 운영 에이전트에서 작동하지 않음
sudo systemctl status google-cloud-ops-agent"*"와 같은 명령어를 실행하지만 정보가 반환되지 않습니다.
운영 에이전트가 VM 확장 프로그램 관리자에 의해 설치되고 관리되는 경우 운영 에이전트는 운영체제의 시스템 관리 서비스(Linux의 systemd 또는 Windows의 Windows 서비스 관리자)에서 관리되지 않습니다.
VM 확장 프로그램 관리자가 관리하는 운영 에이전트의 상태 정보를 찾으려면 다음을 참고하세요.
Linux systemctl restart 및 Windows Restart-Service 명령어가 운영 에이전트에서 작동하지 않음
sudo systemctl restart google-cloud-ops-agent과 같은 명령어를 실행하지만 운영 에이전트가 다시 시작되지 않습니다.
운영 에이전트가 VM 확장 프로그램 관리자에 의해 설치되고 관리되는 경우 운영 에이전트는 운영체제의 시스템 관리 서비스(Linux의 systemd 또는 Windows의 Windows 서비스 관리자)에서 관리되지 않습니다. 따라서 운영 에이전트를 수동으로 중지하거나 시작할 수 없으며 다음과 같은 명령어는 운영 에이전트에서 작동하지 않습니다.
- Linux:
sudo systemctl [stop|start|restart] - Windows:
Stop-Service,Start-Service,Restart-Service
VM 확장 프로그램 관리자가 관리하는 운영 에이전트를 중지하거나 다시 시작하려면 확장 프로그램 정책을 삭제하여 에이전트를 제거해야 합니다. 운영 에이전트 중지 또는 다시 시작에 대한 자세한 내용은 확장 프로그램 정책으로 설치된 운영 에이전트 다시 시작을 참조하세요.
추가 문제 해결 정보
VM 확장 프로그램 관리자 정책의 생성 및 사용 문제 해결에 대한 자세한 내용은 VM 확장 프로그램 문제 해결을 참조하세요.
운영 에이전트 문제 해결에 대한 자세한 내용은 운영 에이전트 문제 해결을 참조하세요.