버전 1: SAP용 Google Cloud 에이전트 문제 해결 가이드

이 가이드에서는 SAP용 Google Cloud 에이전트 버전 1 관련 문제를 해결하는 방법을 보여줍니다.

로깅

운영체제에 해당하는 디렉터리에서 로그를 확인합니다.

SAP용 Google Cloud 에이전트 로그를 보려면 다음 경로로 이동합니다.

Linux

/var/log/google-cloud-sap-agent.log

Windows

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log

일반적인 문제

문제: IAM 권한 부족

문제: SAP용 Google Cloud 에이전트에 IAM 권한 부족 오류가 표시됩니다.

원인: 서비스 계정에 Cloud Monitoring API에 액세스하는 데 필요한 IAM 권한이 없습니다.

해결 방법: Google Cloud 콘솔의 VM 인스턴스 세부정보 페이지에서 VM 서비스 계정 이름을 확인합니다. 예를 들면 sap-example@example-project-123456.iam.gserviceaccount.com입니다. IAM 및 관리자 홈 페이지에서 서비스 계정에 다음 IAM 역할이 포함되었는지 확인합니다.

기능	필요한 IAM 역할
SAP 호스트 에이전트 측정항목 수집	Compute 뷰어(`roles/compute.viewer`) Monitoring 뷰어(`roles/monitoring.viewer`)
프로세스 모니터링 측정항목 수집	Compute 뷰어(`roles/compute.viewer`) Monitoring 측정항목 작성자(`roles/monitoring.metricWriter`) Secret Manager 보안 접근자(`roles/secretmanager.secretAccessor`) (Secret Manager를 사용하여 SAP HANA에 대해 데이터베이스 사용자 계정을 인증할 때 필요)
워크로드 관리자 평가 측정항목 수집	Compute 뷰어(`roles/compute.viewer`) Monitoring 측정항목 작성자(`roles/monitoring.metricWriter`) Secret Manager 보안 접근자(`roles/secretmanager.secretAccessor`) (Secret Manager를 사용하여 SAP HANA에 대해 데이터베이스 사용자 계정을 인증할 때 필요)

SAP용 Google Cloud 에이전트에 필요한 인증은 인증 및 액세스를 참조하세요.

Cloud Monitoring 에이전트에 필요한 권한을 확인하려면 다음 Monitoring 문서를 참조하세요.

문제: VM 서비스 계정의 잘못된 액세스 범위

문제: 호스트 VM 인스턴스에서 액세스 범위를 제한하는 경우 SAP용 Google Cloud 에이전트에 IAM 권한 부족 오류가 표시될 수 있습니다.

원인: SAP용 Google Cloud 에이전트에는 호스트 VM 인스턴스에서 최소한의 Cloud API 액세스 범위가 필요합니다. 이 오류는 서비스 계정에 필요한 액세스 범위가 없을 때 발생합니다.

해결 방법: 액세스 범위는 VM 인스턴스 권한을 지정하는 기존 방법입니다. Compute Engine은 모든 Cloud API에 대한 전체 액세스 범위를 허용하도록 VM 인스턴스를 구성하고, VM 서비스 계정의 IAM 권한만 사용하여 Google Cloud 리소스에 대한 액세스를 제어할 것을 권장합니다.

이 문제를 해결하려면 권장사항에 따라 VM 인스턴스에서 모든 cloud-platform 액세스 범위를 설정한 후 IAM 역할로 서비스 계정의 API 액세스를 안전하게 제한합니다. 예를 들면 다음과 같습니다.

https://www.googleapis.com/auth/cloud-platform

VM 인스턴스의 액세스 범위를 제한하는 경우 호스트 VM 인스턴스의 액세스 범위가 다음과 같아야 합니다.

https://www.googleapis.com/auth/source.read_write
https://www.googleapis.com/auth/compute
https://www.googleapis.com/auth/servicecontrol
https://www.googleapis.com/auth/service.management.readonly
https://www.googleapis.com/auth/logging.admin
https://www.googleapis.com/auth/monitoring
https://www.googleapis.com/auth/trace.append
https://www.googleapis.com/auth/devstorage.full_control

프로세스 모니터링 측정항목 수집 또는 워크로드 관리자 검증 측정항목 수집을 사용 설정한 경우 호스트 VM 인스턴스의 액세스 범위에 Google Cloud 프로젝트에 측정항목 데이터를 게시하기 위한 쓰기 액세스도 있어야 합니다.

https://www.googleapis.com/auth/monitoring.write

액세스 범위를 변경하려면 VM 인스턴스를 중지하고 변경한 다음 VM 인스턴스를 다시 시작해야 합니다. 자세한 내용은 Compute Engine 문서를 참조하세요. 이 문제에 대한 IAM 역할 권한을 변경할 필요가 없습니다.

문제: 누락되거나 잘못된 SAP 호스트 에이전트

문제: SAP용 Google Cloud 에이전트 로그에 누락되었거나 잘못된 SAP 호스트 에이전트 오류가 표시됩니다.

원인: SAP 호스트 에이전트 또는 SAP 호스트 에이전트에 필요한 최소 패치 수준이 설치되지 않았습니다. SAP용 Google Cloud 에이전트가 작동하려면 SAP 시스템에 SAP 호스트 에이전트를 설치하고 호스트 에이전트에 필요한 최소 패치 수준을 유지해야 합니다.

해결 방법: 이 문제를 해결하려면 SAP 호스트 에이전트의 필수 버전을 설치합니다. SAP Host Agent 설치에 대한 자세한 내용은 SAP 문서를 참조하세요.

SAP 호스트 에이전트 버전 요구 사항은 다음 SAP Note를 참조하세요.

Linux: SAP Note 2460297 - Google Cloud Platform의 Linux용 SAP: 향상된 모니터링
Windows: SAP Note 1409604 - Windows의 가상화: 향상된 모니터링

문제: SAP용 Google Cloud 에이전트 설치 실패

문제: 패키지 관리자 설치 명령어(yum, zypper, googet)를 실행할 때 에이전트 설치가 실패합니다.

원인: 에이전트를 실행 중인 호스트 서버가 공개 또는 외부 IP 주소 없이 생성되었기 때문에 에이전트 설치가 실패합니다.

해결 방법: 이 문제를 해결하려면 호스트 서버에 인터넷 아웃바운드 액세스를 부여하는 NAT 게이트웨이를 설정합니다. NAT 게이트웨이를 설정하는 방법은 SAP 시스템에 대한 배포 가이드를 참조하세요. 예를 들어 SAP NetWeaver의 경우 다음을 사용합니다.

문제: 연결 거부 오류

문제: SAP 호스트 에이전트 로그에 연결 거부 오류가 표시됩니다.

원인: 포트 18181을 사용할 수 없으므로 SAP용 Google Cloud 에이전트를 시작할 수 없습니다. SAP용 Google Cloud 에이전트는 포트 18181에서 요청을 리슨합니다. 에이전트를 시작하려면 이 포트를 사용할 수 있어야 합니다.

해결 방법: 이 문제를 해결하려면 SAP용 Google Cloud 에이전트에 포트 18181을 사용할 수 있어야 합니다. 다른 서비스가 포트 18181을 사용하는 경우 다른 서비스를 다시 시작해야 합니다. 아니면 다른 포트를 사용하도록 재구성해야 합니다.

SAP용 Google Cloud 에이전트 지원 받기

SAP용 Google Cloud 에이전트 문제를 해결하는 데 도움이 필요하면 필요한 진단 정보를 수집하고 Cloud Customer Care에 문의하세요. 자세한 내용은 SAP용 Google Cloud 에이전트 진단 정보를 참조하세요.