버전 1: Compute Engine 인스턴스에 SAP용 Google Cloud 에이전트 설치 및 구성

SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB 등 Google Cloud에서 실행되는 SAP 시스템에 대한 SAP 지원을 받으려면 SAP용 Google Cloud 에이전트가 필요합니다.

Compute Engine VM 인스턴스에 SAP용 Google Cloud 에이전트를 설치하면 SAP 호스트 에이전트 측정항목의 경우 에이전트가 Cloud Monitoring과 Compute Engine API의 모니터링 데이터를 결합하고 SAP 호스트 에이전트에 해당 데이터를 제공합니다.

Google Cloud에서 제공하는 다음 RHEL 또는 SLES 'SAP용' OS 이미지를 사용하는 경우 SAP용 Google Cloud 에이전트가 OS 이미지와 함께 패키징됩니다.

• RHEL: 모든 'SAP용' 이미지
• SLES: SAP용 SLES 15 SP4 이상 버전

SAP용 Google Cloud 에이전트에서 지원하는 운영체제에 대한 자세한 내용은 지원되는 운영체제를 참조하세요.

베어메탈 솔루션 서버에 SAP용 Google Cloud 에이전트 버전 1을 설치하고 구성하려면 베어메탈 서버 솔루션 서버에 SAP용 Google Cloud 에이전트 설치를 참조하세요.

설치 개요

Linux에서는 표준 운영체제 패키지 관리 명령어(RHEL에서는 yum 명령어, SLES에서는 zypper 명령어)를 사용하여 Google Cloud의 SAP용 에이전트를 설치합니다. 패키지 관리 명령어는 다음 태스크를 완료합니다.

• SAP용 Google Cloud의 에이전트를 다운로드합니다.
• google-cloud-sap-agent라는 Linux systemd 서비스로 에이전트를 만듭니다.
• google-cloud-sap-agent 서비스를 사용 설정하고 시작합니다.

Windows에서는 GooGet 패키지 관리 명령어인 googet를 사용하여 Google Cloud의 SAP용 에이전트를 설치합니다. 패키지 관리 명령어는 다음 태스크를 완료합니다.

• SAP용 Google Cloud의 에이전트를 다운로드합니다.

• google-cloud-sap-agent라는 Windows 서비스와 1분마다 실행되는 예약 태스크를 만들어 서비스가 계속 실행 중인지 확인하고 필요한 경우 다시 시작합니다.

에이전트 기본 요건

SAP용 Google Cloud 에이전트를 설치하기 전에 다음 기본 요건을 충족해야 합니다.

필수 IAM 역할 설정

최소한 SAP용 Google Cloud 에이전트에서 사용하는 서비스 계정에는 Compute 뷰어(roles/compute.viewer), Monitoring 뷰어(roles/monitoring.viewer), 워크로드 관리자 통계 작성자(roles/workloadmanager.insightWriter) 역할이 있어야 합니다.

서비스 계정에 필요한 역할을 추가하려면 다음 단계를 따르세요.

1. Google Cloud 콘솔에서 IAM 페이지로 이동합니다.

   IAM으로 이동

2. Google Cloud 프로젝트를 선택합니다.

3. 역할을 추가할 서비스 계정을 찾습니다.

   • 서비스 계정이 주 구성원 목록에 아직 없는 경우 어떠한 역할도 할당되지 않은 것입니다. 추가를 클릭하고 서비스 계정의 이메일 주소를 클릭하세요.
   • 서비스 계정이 주 구성원 목록에 이미 있는 경우 기존 역할이 있는 것입니다. 수정하려는 서비스 계정에서 수정 버튼을 클릭하세요.

4. 사용 가능한 역할 목록에서 필요한 역할을 선택합니다.

   • Compute Engine > Compute 뷰어
   • Monitoring > Monitoring 뷰어
   • 워크로드 관리자 > 워크로드 관리자 통계 작성자

5. 추가 또는 저장을 클릭하여 서비스 계정에 역할을 적용합니다.

Google Cloud API 액세스 사용 설정

Compute Engine은 모든 Cloud API에 대한 전체 액세스 범위를 허용하도록 VM 인스턴스를 구성하고, 인스턴스 서비스 계정의 IAM 권한만 사용하여 Google Cloud 리소스에 대한 액세스를 제어할 것을 권장합니다. 자세한 내용은 사용자 관리 서비스 계정을 사용하는 VM 만들기를 참조하세요.

Cloud API로 액세스를 제한할 경우 SAP용 Google Cloud 에이전트에는 호스트 VM 인스턴스에 대해 다음과 같은 최소 Cloud API 액세스 범위가 필요합니다.

• Cloud Platform: 사용 설정
• Compute Engine: 읽기 전용
• Stackdriver Monitoring API: 읽기 전용

외부 IP 주소가 없는 VM 인스턴스에서 SAP 애플리케이션이 실행되는 경우 SAP용 Google Cloud 에이전트에서 Google API 및 서비스에 액세스할 수 있도록 VM의 서브넷에서 비공개 Google 액세스를 사용 설정해야 합니다. 서브넷에서 비공개 Google 액세스를 사용 설정하려면 비공개 Google 액세스 구성을 참조하세요.

에이전트 설치

더 많은 기능을 지원하는 최신 버전의 SAP용 Google Cloud 에이전트를 설치하는 것이 좋습니다. 자세한 내용은 Compute Engine 인스턴스에 SAP용 Google Cloud 에이전트 설치 및 구성을 참조하세요.

SAP용 Google Cloud 에이전트의 버전 1을 설치하려면 Cloud Customer Care에 문의하세요.

SAP용 Google Cloud 에이전트 및 SAP 호스트 에이전트를 설치한 후 에이전트 설치 검증에 설명된 대로 SAP용 Google Cloud 에이전트 설치를 검증합니다.

에이전트 설치 검사

에이전트가 실행 중인지 확인하려면 운영체제를 선택한 후 다음 단계를 수행합니다.

에이전트가 실행되고 있지 않으면 에이전트를 다시 시작합니다.

SAP 호스트 에이전트가 측정항목을 수신하는지 확인

SAP용 Google Cloud 에이전트가 인프라 측정항목을 수집하고 SAP 호스트 에이전트로 올바르게 전송하는지 확인하려면 다음 단계를 수행하세요.

1. SAP 시스템에서 ST06 트랜잭션을 입력합니다.

2. 개요 창에서 다음 필드의 가용성과 콘텐츠를 확인하여 SAP 및 Google 모니터링 인프라의 엔드 투 엔드 설정이 올바른지 확인합니다.

   • 클라우드 제공업체: Google Cloud Platform
   • 향상된 모니터링 액세스: TRUE
   • 향상된 모니터링 세부정보: ACTIVE

Linux에 SAP용 Google Cloud 에이전트 구성

SAP용 Google Cloud 에이전트를 설치한 후 필요에 따라 프로세스 모니터링 측정항목 및 워크로드 관리자 평가 측정항목을 수집하도록 에이전트를 구성할 수 있습니다. 기본적으로 SAP 호스트 에이전트 측정항목 수집만 사용 설정됩니다.

프로세스 모니터링 측정항목 및 워크로드 관리자 평가 측정항목 수집은 Linux에서만 지원됩니다.

프로세스 모니터링 측정항목 및 워크로드 관리자 평가 측정항목 수집을 사용 설정하면 호스트 컴퓨팅 인스턴스의 서비스 계정에 IAM 모니터링 측정항목 작성자(roles/monitoring.metricWriter) 역할이 포함되어야 합니다.

Secret Manager를 사용하여 SAP HANA 데이터베이스 비밀번호를 저장하는 경우 호스트 컴퓨팅 인스턴스의 서비스 계정에 IAM Secret Manager 보안 비밀 접근자(roles/secretmanager.secretAccessor) 역할이 반드시 있어야 합니다.

호스트 컴퓨팅 인스턴스의 액세스 범위에 측정항목 데이터를 Google Cloud 프로젝트에 게시할 수 있는 쓰기 액세스 권한이 있어야 합니다. 새 Compute Engine 컴퓨팅 인스턴스를 만들 때 쓰기 액세스 범위(https://www.googleapis.com/auth/monitoring.write)를 통해 자동으로 구성됩니다.

필수 IAM 역할 설정

서비스 계정에 필요한 역할을 추가하려면 다음 단계를 따르세요.

1. Google Cloud 콘솔에서 IAM 페이지로 이동합니다.

   IAM으로 이동

2. Google Cloud 프로젝트를 선택합니다.

3. 역할을 추가할 서비스 계정을 찾습니다.

   • 서비스 계정이 주 구성원 목록에 아직 없는 경우 어떠한 역할도 할당되지 않은 것입니다. 추가를 클릭하고 서비스 계정의 이메일 주소를 클릭하세요.
   • 서비스 계정이 주 구성원 목록에 이미 있는 경우 기존 역할이 있는 것입니다. 수정하려는 서비스 계정에서 수정 버튼을 클릭합니다.

4. 사용 가능한 역할 목록에서 필요한 역할을 선택합니다.

   • 모니터링 > 모니터링 측정항목 작성자
   • Secret Manager > Secret Manager 보안 비밀 접근자

5. 추가 또는 저장을 클릭하여 서비스 계정에 역할을 적용합니다.

프로세스 모니터링 측정항목 및 워크로드 관리자 평가 측정항목 수집 사용 설정

프로세스 모니터링 측정항목 및 워크로드 관리자 평가 측정항목 수집을 사용 설정하려면 다음 단계를 수행하세요.

1. 호스트 컴퓨팅 인스턴스에서 SSH 연결을 설정합니다.

2. 다음 구성 파일을 엽니다.

   /etc/google-cloud-sap-agent/configuration.json

3. collection_configuration 섹션에서 다음 매개변수를 true로 설정합니다.

   • collect_process_metrics: 에이전트가 프로세스 모니터링 측정항목을 수집할 수 있게 합니다. SAP HANA 데이터베이스 측정항목 수집의 경우 SAP HANA 데이터베이스에 액세스하고 쿼리하려면 hana_metrics_config 섹션에서 추가 매개변수를 설정해야 합니다.
   • collect_workload_validation_metrics: 에이전트가 워크로드 관리자 평가 측정항목을 수집할 수 있게 합니다.

   매개변수에 대한 자세한 내용은 다음 표를 참조하세요.

4. 필요한 경우 cloud_properties에서 자동으로 설정된 매개변수 값을 업데이트할 수 있습니다. 이렇게 하려면 구성 파일에 cloud_properties 섹션을 추가한 다음 필수 매개변수 및 해당 값을 지정합니다.

5. 구성 파일을 저장합니다.

6. 새 설정이 적용되도록 에이전트를 다시 시작합니다.

   sudo systemctl restart google-cloud-sap-agent

구성 매개변수

다음 표에서는 SAP용 Google Cloud 에이전트 버전 1의 구성 매개변수를 설명합니다.

기본 구성

{
  "provide_sap_host_agent_metrics": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": false
  }
}

구성 예시

Compute Engine 인스턴스에 에이전트를 설치하는 경우 모든 구성 매개변수와 값은 선택사항입니다. 구성 파일을 수정하지 않으면 기본 구성이 사용됩니다. 다음 예에서는 컴퓨팅 인스턴스에 에이전트를 설치하기 위한 완료된 구성 파일을 보여줍니다.

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": false,
    "collect_process_metrics": true,
    "hana_metrics_config": {
      "hana_db_user": "user",
      "hana_db_password_secret_name": "secret-name"
      }
    }
}

수집된 측정항목 보기

에이전트에서 수집하는 프로세스 모니터링 측정항목을 시각화하려면 Google Cloud에서 제공하는 다음 커스텀 대시보드를 사용하면 됩니다.

• SAP용 에이전트 - HANA 개요: 이 대시보드는 SAP HANA 가용성, SAP HANA HA 가용성, SAP HANA HA 복제, SAP HANA 서비스 상태, HA 클러스터 - 노드 상태, HA 클러스터 - SAP 인스턴스용 리소스 상태 등의 측정항목 상태 개요를 표시하는 차트를 제공합니다.

  이 대시보드의 JSON 파일은 sap-agent-status-overview.json입니다.

• SAP용 에이전트 - HANA 원시 측정항목: 이 대시보드는 SAP HANA 가용성, SAP HANA HA 가용성, SAP HANA HA 복제, SAP HANA 서비스 상태, HA 클러스터 - 노드 상태, HA 클러스터 - SAP 인스턴스 리소스 상태 등의 측정항목에 대한 원시 측정항목 값을 표시하는 차트를 제공합니다.

  이 대시보드의 JSON 파일은 sap-agent-raw-metrics.json입니다.

대시보드 설치

커스텀 대시보드를 설치하려면 다음 단계를 완료합니다.

설치된 대시보드 보기

설치된 대시보드를 보려면 다음 단계를 수행하세요.

1. Google Cloud 콘솔에서 Monitoring 페이지로 이동합니다.

   Monitoring으로 이동

2. Monitoring 탐색창에서 대시보드를 클릭합니다.

3. 목록에서 대시보드 이름을 클릭합니다.

대시보드가 많으면 커스텀 대시보드 또는 새 대시보드 이름으로 필터링할 수 있습니다. 이 목록 필터링에 대한 자세한 내용은 커스텀 대시보드 보기를 참조하세요.

다음 이미지는 Monitoring에서 SAP HANA 측정항목의 커스텀 대시보드 일부를 보여주는 예시입니다.

문제 해결

Google Cloud의 SAP용 에이전트를 설치하고 구성할 때 발생할 수 있는 문제의 진단 및 해결에 대한 자세한 내용은 Google Cloud의 SAP용 에이전트 문제 해결 가이드를 참조하세요.

지원 받기

SAP용 Google Cloud 에이전트 문제를 해결하는 데 도움이 필요한 경우 사용 가능한 모든 진단 정보를 수집한 후 Cloud Customer Care에 문의하세요. 고객 관리에 연락하려면 Google Cloud 기반 SAP 지원 받기를 참조하세요.