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

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

에이전트 수명 주기 이해

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 호스트 에이전트가 측정항목을 수신하는지 확인

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

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

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

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

모니터링되는 측정항목 보기

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

모니터링된 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>

프로세스 모니터링 측정항목 및 워크로드 관리자 평가 측정항목 확인

구성을 업데이트한 후 프로세스 모니터링 측정항목 및 워크로드 관리자 평가 측정항목을 사용할 수 있는지 확인해야 합니다. Cloud Monitoring에서 SAP용 Google Cloud 에이전트가 수집하는 측정항목 및 정보에 액세스할 수 있습니다.

Monitoring에서 측정항목을 확인하려면 다음 단계를 수행하세요.

  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

SAP NetWeaver용 모니터링 에이전트에서 SAP용 Google Cloud 에이전트로 업그레이드

SAP용 Google Cloud 에이전트를 설치하면 SAP NetWeaver용 모니터링 에이전트의 이전 버전이 자동으로 감지되고, 해당 에이전트는 사용 중지되며 설치 프로세스 동안 호스트 서버에서 삭제됩니다.

SAP NetWeaver용 모니터링 에이전트가 감지되고 설치 중에 기존 구성 파일이 발견되면 설치 프로세스가 기존 구성을 SAP용 Google Cloud 에이전트로 자동으로 마이그레이션합니다.

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

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용 Google Cloud 에이전트 버전 1을 SAP NetWeaver용 모니터링 에이전트 버전 2로 롤백할 수 있습니다.

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

RHEL

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

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

    sudo yum remove google-cloud-sap-agent

  3. SAP NetWeaver 버전 2의 모니터링 에이전트를 설치합니다. SAP NetWeaver용 모니터링 에이전트를 설치하는 방법은 SAP NetWeaver용 모니터링 에이전트 설치 선택 가이드를 참조하세요.

SLES

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

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

    sudo zypper remove google-cloud-sap-agent

  3. SAP NetWeaver 버전 2의 모니터링 에이전트를 설치합니다. SAP NetWeaver용 모니터링 에이전트를 설치하는 방법은 SAP NetWeaver용 모니터링 에이전트 설치 선택 가이드를 참조하세요.

Windows

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

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

    googet remove google-cloud-sap-agent

  3. SAP NetWeaver 버전 2의 모니터링 에이전트를 설치합니다. SAP NetWeaver용 모니터링 에이전트를 설치하는 방법은 SAP NetWeaver용 모니터링 에이전트 설치 선택 가이드를 참조하세요.

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. 이 변경사항을 적용하려면 에이전트를 다시 시작합니다.