버전 2: SAP용 Google Cloud 에이전트 작업 가이드

이 가이드에서는 Compute Engine VM 인스턴스 및 베어메탈 솔루션 서버에서 SAP용 Google Cloud 에이전트 버전 2 실행과 관련된 운영 고려사항 및 절차에 대해 설명합니다.

에이전트 수명 주기 이해

SAP용 Google Cloud 에이전트의 작업을 관리할 때 에이전트가 수행하는 작업을 이해하는 것이 도움이 됩니다. 일반적인 작동 방식은 다음과 같습니다.

  • SAP 시스템을 호스팅하는 각 Compute Engine VM 인스턴스 또는 베어메탈 솔루션 서버에 SAP용 Google Cloud 에이전트를 설치해야 합니다. 에이전트는 Linux 서비스 또는 Windows 서비스로 실행됩니다.
  • Compute Engine VM 인스턴스에서 에이전트는 Monitoring 및 Compute Engine API의 모니터링 데이터를 결합합니다.
  • 베어메탈 솔루션 서버에서 에이전트는 SAP 호스트 에이전트 측정항목만을 수집하기 위해 Google Cloud API에 액세스하지 않습니다.
  • SAP 호스트 에이전트는 HTTP를 통해 캐시된 데이터에 대해 SAP용 Google Cloud 에이전트를 폴링합니다. SAP 호스트 에이전트 측정항목을 집계하고 이를 보고하며 SAP NetWeaver 데이터베이스에 저장합니다.
  • SAP의 트랜잭션 ST06 또는 saposcol 명령줄 인터페이스는 집계된 SAP 호스트 에이전트 측정항목을 표시합니다.
  • 터미널 창에서 명령어를 실행하면 SAP용 Google Cloud 에이전트의 SAP 호스트 에이전트 측정항목을 볼 수 있습니다.

에이전트가 실행 중인지 확인

에이전트를 설치하거나 다시 시작한 후 에이전트가 예상대로 실행 중인지 확인할 수 있습니다.

에이전트가 실행 중인지 확인하려면 다음 단계를 따릅니다.

Linux

  1. 베어메탈 솔루션 서버 또는 VM 인스턴스에 SSH 연결을 설정합니다.

  2. 다음 명령어를 실행합니다. 

    systemctl status google-cloud-sap-agent

    에이전트가 올바르게 작동하는 경우 출력에 active (running)이 포함됩니다. 예를 들면 다음과 같습니다. 

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Windows

  1. RDP를 사용하여 VM 인스턴스에 연결합니다.

  2. 관리자 권한으로 PowerShell에서 다음 명령어를 실행합니다.

    $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
    에이전트가 실행 중이면 상태는 Running으로 표시됩니다.

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

에이전트 버전 확인

SAP용 Google Cloud 에이전트를 설치하거나 다시 시작한 후 에이전트 버전을 확인할 수 있습니다.

에이전트 버전을 확인하려면 다음 단계를 수행합니다.

Linux

RHEL의 경우 다음 단계를 수행합니다.

  1. SSH를 사용하여 호스트 머신에 연결합니다.
  2. 다음 명령어를 실행합니다. 
    yum info google-cloud-sap-agent

SLES의 경우 다음 단계를 수행합니다.

  1. SSH를 사용하여 호스트 머신에 연결합니다.
  2. 다음 명령어를 실행합니다. 
    zypper info google-cloud-sap-agent

Windows

  1. RDP를 사용하여 호스트 머신에 연결합니다.
  2. 관리자 권한으로 PowerShell에서 다음 명령어를 실행합니다.
    googet installed google-cloud-sap-agent

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

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

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

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

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

SAP 호스트 에이전트 측정항목 보기

SAP용 Google Cloud 에이전트의 구성을 설치하거나 업데이트한 후 수집된 SAP 호스트 에이전트 측정항목을 볼 수 있습니다.

SAP용 Google Cloud 에이전트에서 수집된 SAP 호스트 에이전트 측정항목을 보려면 다음 단계를 수행합니다.

Linux

  1. 베어메탈 솔루션 서버의 호스트 VM 인스턴스에 SSH 연결을 설정합니다.

  2. 다음 명령어를 실행합니다. 

    curl http://localhost:18181

    측정항목을 사용할 수 있는 경우 시스템에 대한 정보가 포함된 XML 출력이 수신됩니다. 예를 들면 다음과 같습니다.

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>0.0</value>
  </metric>

Windows

  1. RDP를 사용하여 VM 인스턴스에 연결합니다.

  2. 관리자는 PowerShell에서 다음 명령어를 실행합니다. 

    (Invoke-WebRequest -Uri 'http://localhost:18181').RawContent

    측정항목을 사용할 수 있는 경우 시스템에 대한 정보가 포함된 XML 출력이 표시됩니다. 예를 들면 다음과 같습니다.

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>10.0</value>
  </metric>

다른 측정항목 보기

프로세스 모니터링 측정항목, 워크로드 관리자 평가 측정항목, SAP HANA 모니터링 측정항목을 수집하도록 SAP용 Google Cloud 에이전트 구성을 업데이트한 후에는 에이전트가 예상한 대로 측정항목을 수집하는지 확인해야 합니다.

다음 단계를 완료하여 Cloud Monitoring에서 SAP용 Google Cloud 에이전트로 수집된 측정항목 및 정보를 볼 수 있습니다.

  1. Google Cloud 콘솔에서 Monitoring 측정항목 탐색기 페이지로 이동합니다.

    측정항목 탐색기로 이동

  2. 구성 탭을 선택합니다.

  3. 측정항목 선택 메뉴를 확장합니다.

  4. 리소스 메뉴에서 VM 인스턴스를 선택합니다.

  5. 측정항목 카테고리 메뉴에서 sap를 선택합니다.

  6. 측정항목 메뉴에서 차트로 작성할 metric: workload.googleapis.com/sap/service/active 또는 새 측정항목을 선택합니다.

  7. 적용을 클릭합니다.

시계열 측정항목 값이 있는 차트가 표시됩니다.

에이전트 다시 시작

SAP용 Google Cloud의 에이전트 작동이 중지되거나 구성을 업데이트할 경우 에이전트를 다시 시작합니다.

운영체제를 선택한 후 다음 단계를 수행합니다.

Linux

  1. 호스트 VM 인스턴스 또는 베어메탈 솔루션 서버와 SSH 연결을 설정합니다.

  2. 다음 명령어를 실행합니다. 

    sudo systemctl restart google-cloud-sap-agent

Windows

  1. 호스트 VM 인스턴스와의 RDP 연결을 설정합니다.

  2. 관리자 권한으로 PowerShell에서 다음 명령어를 실행합니다.

    Restart-Service -Name 'google-cloud-sap-agent' -Force

다른 Google Cloud 에이전트에서 SAP용 Google Cloud 에이전트로 업그레이드

SAP용 Google Cloud 에이전트를 설치하면 이전 버전의 SAP NetWeaver용 모니터링 에이전트 및 SAP HANA용 모니터링 에이전트가 자동으로 감지되고 설치 중 호스트 머신에서 해당 에이전트가 삭제됩니다.

이러한 Google Cloud 에이전트가 삭제되면 해당 구성 파일에 포함된 구성도 설치 중 SAP용 Google Cloud 에이전트로 마이그레이션됩니다. 백업 및 참조 목적으로 SAP HANA용 모니터링 에이전트의 구성이 다음 파일에 복사됩니다.

/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

SAP용 Google Cloud의 에이전트 설치 및 구성에 대한 안내는 SAP용 Google Cloud 에이전트 설치 및 구성 선택 가이드를 참조하세요.

SSL이 사용 설정된 인스턴스 업그레이드

SAP HANA 인스턴스와 통신에 SSL 인증서를 사용하도록 SAP HANA용 모니터링 에이전트를 구성한 경우 SAP용 Google Cloud 에이전트를 설치하면 SSL 구성을 제외한 모든 SAP HANA 모니터링 구성이 SAP용 Google Cloud 에이전트로 마이그레이션됩니다. 이러한 경우 SAP HANA 인스턴스를 모니터링하는 데 SAP용 Google Cloud 에이전트를 사용하려면 다음 단계를 완료해야 합니다.

  1. 호스트 VM 인스턴스 또는 베어메탈 솔루션 서버와 SSH 연결을 설정합니다.

  2. SAP용 Google Cloud 에이전트의 구성 파일을 엽니다.

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

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

  4. hana_monitoring_configuration.hana_instances 섹션에서 보안 통신을 위해 TLS/SSL 프로토콜을 사용하는 각 SAP HANA 인스턴스에 대해 다음을 수행합니다.

    1. enable_ssl 매개변수를 지정하고 값을 true로 설정합니다.

    2. host_name_in_certificate 매개변수를 지정하고 SAP HANA 호스트 이름을 TLS/SSL 인증서에 지정된 대로 해당 값으로 설정합니다.

    3. tls_root_ca_file 매개변수를 지정하고 TLS/SSL 인증서가 저장된 경로를 해당 값으로 설정합니다.

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

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

    sudo systemctl restart google-cloud-sap-agent

  7. 에이전트가 SAP HANA 모니터링 측정항목을 수집하는지 확인합니다. 자세한 내용은 다른 측정항목 보기를 참조하세요.

  8. SAP HANA용 모니터링 에이전트를 설치 제거합니다.

이 업그레이드 후 SAP HANA 인스턴스에 연결 문제가 발생하면 Logging에서 에이전트 로그를 확인하고 문제 해결 가이드를 사용해서 문제를 해결할 수 있습니다.

SAP용 Google Cloud 에이전트 업데이트

이 섹션에서는 SAP용 Google Cloud 에이전트의 업데이트 버전을 사용할 수 있는지 확인하는 단계를 설명하고 SAP용 Google Cloud 에이전트의 버전 3.2(최신)로 업데이트하는 방법을 설명합니다.

최신 버전이 아닌 에이전트로 업데이트해야 할 경우에는 Cloud Customer Care에 문의하세요.

업데이트 확인

운영체제를 선택한 후 다음 단계를 수행합니다.

RHEL

  1. 호스트 VM 인스턴스 또는 베어메탈 솔루션 서버와 SSH 연결을 설정합니다.

  2. 다음 명령어를 실행합니다. 

    sudo yum check-update google-cloud-sap-agent

SLES

  1. 호스트 VM 인스턴스 또는 베어메탈 솔루션 서버와 SSH 연결을 설정합니다.

  2. 다음 명령어를 실행합니다. 

    sudo zypper list-updates -r google-cloud-sap-agent

Windows

  1. 호스트 VM 인스턴스와의 RDP 연결을 설정합니다.

  2. 관리자 권한으로 PowerShell에서 다음 명령어를 실행합니다.

    googet latest google-cloud-sap-agent

업데이트 설치

SAP용 Google Cloud 에이전트 인스턴스를 버전 3.2(최신)로 업데이트하려면 운영체제를 선택한 후 단계를 수행합니다.

최신 버전이 아닌 에이전트를 설치해야 할 경우에는 Cloud Customer Care에 문의하세요.

RHEL

  1. 호스트 VM 인스턴스 또는 베어메탈 솔루션 서버와 SSH 연결을 설정합니다.

  2. 다음 명령어를 실행합니다. 

    sudo yum --nogpgcheck update google-cloud-sap-agent

SLES

  1. 호스트 VM 인스턴스 또는 베어메탈 솔루션 서버와 SSH 연결을 설정합니다.

  2. 다음 명령어를 실행합니다. 

    sudo zypper --no-gpg-checks update google-cloud-sap-agent

Windows

  1. 호스트 VM 인스턴스와의 RDP 연결을 설정합니다.

  2. 관리자 권한으로 PowerShell에서 다음 명령어를 실행합니다.

    googet install google-cloud-sap-agent

SAP HANA용 모니터링 에이전트 사용으로 롤백

SAP HANA용 모니터링 에이전트를 사용하도록 롤백하고 SAP용 Google Cloud 에이전트의 SAP HANA 모니터링 기능 사용을 중지하려면 다음 단계를 수행합니다.

RHEL

  1. 호스트 VM 인스턴스 또는 베어메탈 솔루션 서버와 SSH 연결을 설정합니다.

  2. 중복 측정항목 수집을 방지하려면 SAP용 Google Cloud 에이전트의 SAP HANA 모니터링 측정항목 수집을 사용 중지합니다.

    1. SAP용 Google Cloud 에이전트의 구성 파일을 엽니다.

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

    2. hana_monitoring_configuration 섹션에서 enabled 매개변수를 false로 설정합니다.

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

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

      sudo systemctl restart google-cloud-sap-agent

  3. 다음 파일에서 SAP HANA용 모니터링 에이전트 구성을 복사합니다.

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. SAP HANA용 모니터링 버전 2를 설치합니다. 설치 안내는 SAP HANA용 모니터링 에이전트 V2.0 설치 및 운영 가이드를 참조하세요.

  5. 다음 파일에서 이전 단계에 복사한 SAP HANA의 모니터링 에이전트 구성을 붙여넣습니다.

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. SAP HANA용 모니터링 에이전트를 다시 시작합니다.

    sudo systemctl start google-saphanamonitoring-agent

SLES

  1. 호스트 VM 인스턴스 또는 베어메탈 솔루션 서버와 SSH 연결을 설정합니다.

  2. 중복 측정항목 수집을 방지하려면 SAP용 Google Cloud 에이전트의 SAP HANA 모니터링 측정항목 수집을 사용 중지합니다.

    1. SAP용 Google Cloud 에이전트의 구성 파일을 엽니다.

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

    2. hana_monitoring_configuration 섹션에서 enabled 매개변수를 false로 설정합니다.

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

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

      sudo systemctl restart google-cloud-sap-agent

  3. 다음 파일에서 SAP HANA용 모니터링 에이전트 구성을 복사합니다.

    /etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

  4. SAP HANA용 모니터링 버전 2를 설치합니다. 설치 안내는 SAP HANA용 모니터링 에이전트 V2.0 설치 및 운영 가이드를 참조하세요.

  5. 다음 파일에서 이전 단계에 복사한 SAP HANA의 모니터링 에이전트 구성을 붙여넣습니다.

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. SAP HANA용 모니터링 에이전트를 다시 시작합니다.

    sudo systemctl start google-saphanamonitoring-agent

Cloud Logging에서 에이전트 로그 보기

기본적으로 SAP용 Google Cloud 에이전트의 로그는 VM 인스턴스 및 베어메탈 솔루션 서버에서 Cloud Logging으로 리디렉션됩니다.

Logging에서 에이전트 로그를 보려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.

    로그 탐색기로 이동

  2. 쿼리 창으로 이동합니다.

  3. 리소스 드롭다운 메뉴에서 전역을 선택한 후 적용을 클릭합니다.

  4. 쿼리 편집기에 google-cloud-sap-agent를 입력합니다.

  5. 쿼리 실행을 클릭합니다.

모든 VM 인스턴스 또는 베어메탈 솔루션 서버에서 실행 중인 에이전트 인스턴스에서 생성한 로그가 표시됩니다. 특정 머신에서 로그를 필터링하려면 인터페이스에서 사용할 수 있는 필터를 사용합니다.

에이전트 로그의 기본 리디렉션을 중지할 수 있습니다. 방법은 다음과 같습니다.

  1. 베어메탈 솔루션 서버의 호스트 VM 인스턴스와 SSH 연결을 설정합니다.

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

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

  3. log_to_cloud 매개변수의 경우 값을 false로 업데이트합니다.

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

  5. 이 변경사항을 적용하려면 에이전트를 다시 시작합니다.