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

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

Compute Engine 인스턴스에 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 에이전트 버전 3.6(최신)을 설치하고 구성하려면 베어메탈 서버 솔루션 서버에 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에 대한 전체 액세스 범위를 허용하도록 컴퓨팅 인스턴스를 구성하고, 인스턴스 서비스 계정의 IAM 권한만 사용하여 Google Cloud 리소스에 대한 액세스를 제어할 것을 권장합니다. 자세한 내용은 사용자 관리 서비스 계정을 사용하는 VM 만들기를 참조하세요.

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

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

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

에이전트 설치

Compute Engine 인스턴스에 SAP용 Google Cloud 에이전트를 설치하려면 운영체제를 선택한 후 다음 단계를 완료하세요.

Linux

Compute Engine 인스턴스에 에이전트를 설치하려면 다음 단계를 따르세요.

  1. 컴퓨팅 인스턴스에 SSH 연결을 설정합니다.
  2. 터미널에서 운영체제와 관련된 명령어를 실행하여 에이전트를 설치합니다.
    • (권장) 에이전트 버전 3.6(최신)을 설치하려면 다음 명령어를 실행합니다.

      RHEL

      sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
      [google-cloud-sap-agent]
      name=Google Cloud Agent for SAP
      baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
      enabled=1
      gpgcheck=1
      repo_gpgcheck=0
      gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
      EOM
      sudo yum install google-cloud-sap-agent

      SLES15

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
      sudo zypper install google-cloud-sap-agent

      SLES 12

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
      sudo zypper install google-cloud-sap-agent
    • 특정 버전의 에이전트를 설치하려면 다음 명령어를 실행합니다.

      RHEL

      sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
      [google-cloud-sap-agent]
      name=Google Cloud Agent for SAP
      baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
      enabled=1
      gpgcheck=1
      repo_gpgcheck=0
      gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
      EOM
      sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      SLES15

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      SLES 12

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      VERSION_NUMBER를 설치하려는 에이전트의 버전 번호로 바꿉니다(예: 3.1-606637668). 설치할 수 있는 에이전트 버전에 대한 자세한 내용은 사용 가능한 모든 에이전트 버전 나열을 참조하세요.

      에이전트를 특정 버전으로 다운그레이드하는 방법에 대한 자세한 내용은 SAP용 Google Cloud 에이전트 다운그레이드를 참조하세요.

Windows

Compute Engine 인스턴스에 에이전트를 설치하려면 다음 단계를 따르세요.

  1. RDP를 사용하여 컴퓨팅 인스턴스에 연결합니다.
  2. 관리자 권한으로 PowerShell에서 다음 명령어를 실행합니다.
    googet addrepo google-cloud-sap-agent https://packages.cloud.google.com/yuck/repos/google-cloud-sap-agent-windows
    googet install google-cloud-sap-agent

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

에이전트 설치 검사

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

Linux

  1. Compute Engine 인스턴스와 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
    

  3. SLES 이미지에서 최신 버전의 Google Cloud SAP용 에이전트를 사용하는지 확인하려면 다음 명령어를 실행합니다.

    sudo zypper remove google-cloud-sap-agent
    sudo zypper addrepo -p 98 --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-\$basearch google-cloud-sap-agent
    sudo zypper install google-cloud-sap-agent

Windows

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

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

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

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

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에서만 지원됩니다. Windows에서는 지원되지 않습니다.

기본 구성 파일

다음 스니펫은 SAP용 Google Cloud 에이전트 버전 3.6(최신)의 기본 구성 예시입니다.

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

기능별 구성 파일 예시를 보려면 해당 기능의 구성 가이드를 참조하세요.

구성 매개변수

다음 표에서는 측정항목 수집과 관련된 매개변수를 포함하여 Compute Engine 인스턴스에서 실행되는 SAP용 Google Cloud 에이전트의 구성 매개변수를 설명합니다. 에이전트의 Backint 기능과 관련된 구성 매개변수는 구성 매개변수를 참조하세요.

매개변수
provide_sap_host_agent_metrics

Boolean

SAP 호스트 에이전트에 필요한 측정항목 수집을 사용 설정하려면 true를 지정합니다. 기본값은 true입니다.
Cloud Customer Care 또는 SAP 지원팀에서 별도의 안내를 받지 않는 한 provide_sap_host_agent_metricsfalse로 설정하지 않도록 하세요.

bare_metal

Boolean

에이전트를 베어메탈 솔루션 서버에 설치할 때 true를 지정합니다. 기본값은 false입니다.

log_level

String

에이전트의 로깅 수준을 설정하려면 필수 값을 설정하세요. 사용 가능한 로그 수준은 다음과 같습니다.

  • DEBUG
  • INFO
  • WARNING
  • ERROR

기본값은 INFO입니다. Cloud Customer Care의 지시가 없는 한 로깅 수준을 변경하지 마세요.

log_to_cloud

Boolean

에이전트 로그를 Cloud Logging으로 리디렉션하려면 true를 지정합니다. 기본값은 true입니다.

cloud_properties.project_id

String

SAP 시스템이 베어메탈 솔루션 서버에서 실행되는 경우 베어메탈 솔루션에서 사용 중인 Google Cloud 프로젝트의 프로젝트 ID를 지정합니다.

에이전트가 Compute Engine 인스턴스에서 실행되면 기본적으로 프로젝트 ID가 자동으로 감지됩니다.

cloud_properties.instance_name

String

Compute Engine 인스턴스의 이름을 지정합니다. 설치 시 에이전트가 자동으로 감지합니다.

cloud_properties.region

String

SAP 시스템이 베어메탈 솔루션 서버에서 실행되는 경우 베어메탈 솔루션 서버의 리전을 지정합니다.

에이전트가 컴퓨팅 인스턴스에서 실행되면 기본적으로 컴퓨팅 인스턴스가 배포된 리전을 사용합니다.

cloud_properties.zone

String

에이전트가 컴퓨팅 인스턴스에서 실행되면 기본적으로 컴퓨팅 인스턴스가 배포된 영역이 사용됩니다.

cloud_properties.image

String

인스턴스의 OS 이미지 이름을 지정합니다.

에이전트가 컴퓨팅 인스턴스에서 실행되면 기본적으로 컴퓨팅 인스턴스에서 사용하는 OS 이미지가 자동으로 감지됩니다.

cloud_properties.numeric_project_id

String

SAP 시스템이 실행 중인 Google Cloud 프로젝트의 숫자 ID를 지정합니다.

에이전트가 컴퓨팅 인스턴스에서 실행되면 기본적으로 프로젝트 번호가 자동으로 감지됩니다.

discovery_configuration.enable_workload_discovery

Boolean

에이전트가 호스트에서 실행되는 SAP 제품의 이름과 버전을 수집하도록 하려면 true를 지정합니다. 기본값은 true입니다.

자세한 내용은 GoogleCloudPlatform/sapagent 아래의 google-cloud-sap-agent GitHub 저장소에서 에이전트 코드베이스를 참조하세요.

discovery_configuration.enable_discovery

Boolean

호스트에서 실행되는 SAP 제품에 대해 에이전트가 수집하는 정보를 Cloud Logging으로 전송하려면 true를 지정합니다. 기본값은 true입니다.

false 값을 지정하면 에이전트가 수집된 정보를 호스트에 저장하고 Cloud Logging으로 전송하지 않습니다.

collection_configuration.collect_process_metrics

Boolean

프로세스 모니터링 측정항목 수집을 사용 설정하려면 true를 지정합니다. 기본값은 false입니다.
이 매개변수는 Linux에만 적용됩니다.

SAP HANA에 대한 프로세스 측정항목 수집을 사용 설정하려면 hana_metrics_config 아래에 나열된 추가 매개변수를 설정해야 합니다.

collection_configuration.process_metrics_frequency

Int

버전 2.6부터 이 매개변수는 변경 속도가 빠른 프로세스 모니터링 측정항목의 수집 빈도(초)를 결정합니다. 변경 속도가 빠른 프로세스 모니터링 측정항목은 sap/hana/availability, sap/hana/ha/availability, sap/nw/availability입니다.

이 매개변수의 기본값은 5초입니다. 이 기본값을 사용하는 것이 좋습니다.

변경 속도가 느린 다른 모든 프로세스 모니터링 측정항목은 기본 빈도인 30초로 수집됩니다. 변경 속도가 느린 프로세스 모니터링 측정항목의 수집 빈도를 변경하려면 slow_process_metrics_frequency 매개변수를 사용하세요.

collection_configuration.slow_process_metrics_frequency

Int

변경 속도가 느린 프로세스 모니터링 측정항목의 수집 빈도를 초 단위로 지정합니다.

이 매개변수의 기본값은 30초입니다.

collection_configuration.process_metrics_to_skip

Array

에이전트가 수집하지 않게 할 프로세스 모니터링 측정항목을 지정합니다. 이 매개변수는 쉼표로 구분된 프로세스 모니터링 측정항목 이름 값을 수락합니다. 예를 들면 "process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"]입니다.

collection_configuration.hana_metrics_config.hana_db_user

String

에이전트가 SAP HANA를 쿼리하는 데 사용할 데이터베이스 사용자 계정을 지정합니다. 기본값은 SYSTEM입니다.

collection_configuration.hana_metrics_config.hana_db_password

String

에이전트가 SAP HANA를 쿼리하는 데 사용하는 데이터베이스 사용자 계정의 일반 텍스트 비밀번호를 지정합니다.

일반 텍스트 비밀번호를 지정하는 대신 다음 옵션 중 하나를 사용하는 것이 좋습니다.

SAP HANA 인증의 경우 에이전트는 다음과 같은 우선순위를 사용합니다. 지정된 경우 hdbuserstore_key 구성 매개변수가 hana_db_password 매개변수보다 우선되고 hana_db_password 매개변수가 hana_db_password_secret_name 매개변수보다 우선됩니다. 구성 파일에서 인증 옵션을 하나만 설정하는 것이 좋습니다.

collection_configuration.hana_metrics_config.hana_db_password_secret_name

String

에이전트가 SAP HANA를 쿼리하는 데 사용하는 데이터베이스 사용자 계정의 비밀번호를 안전하게 제공하려면 데이터베이스 사용자 계정의 보안 사용자 인증 정보가 포함된 보안 비밀의 이름을 지정합니다.

hana_db_password_secret_name, hdbuserstore_key 또는 hana_db_password를 지정하는 경우에만 에이전트에서 SAP HANA 관련 측정항목을 수집합니다.

SAP HANA 인증의 경우 에이전트는 다음과 같은 우선순위를 사용합니다. 지정된 경우 hdbuserstore_key 구성 매개변수가 hana_db_password 매개변수보다 우선되고 hana_db_password 매개변수가 hana_db_password_secret_name 매개변수보다 우선됩니다. 구성 파일에서 인증 옵션을 하나만 설정하는 것이 좋습니다.

collection_configuration.hana_metrics_config.hdbuserstore_key

String

SAP HANA 시스템에 안전하게 연결하려면 해당 시스템에 대해 만든 보안 사용자 저장소(hdbuserstore) 키를 지정합니다.

인증에 hdbuserstore 키를 사용하려면 다음을 확인합니다.

  • SAP 도구 hdbsqlhdbuserstore는 에이전트를 호스팅하는 컴퓨팅 인스턴스에 설치됩니다.
  • hdbuserstore 키는 특정 SAP HANA 인스턴스 하나에 해당합니다. SAP HANA 인스턴스 여러 개의 호스트 이름이 포함된 키를 사용할 수 없습니다.
  • SIDadm 사용자는 이 키를 사용하여 SAP HANA 데이터베이스를 쿼리할 수 있습니다. 여기서 SIDsid 파라미터에 지정한 값을 나타냅니다. SIDadm 사용자로 다음 명령어를 실행하여 이를 확인할 수 있습니다.
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

이 구성 파라미터는 에이전트 버전 3.3부터 지원됩니다.

SAP HANA 인증의 경우 에이전트는 다음과 같은 우선순위를 사용합니다. 지정된 경우 hdbuserstore_key 구성 매개변수가 hana_db_password 매개변수보다 우선되고 hana_db_password 매개변수가 hana_db_password_secret_name 매개변수보다 우선됩니다. 구성 파일에서 인증 옵션을 하나만 설정하는 것이 좋습니다.

collection_configuration.hana_metrics_config.sid

String

SAP HANA 인스턴스의 SID를 지정합니다. hdbuserstore 키를 사용하여 SAP HANA에 인증하는 경우 hdbuserstore_key 섹션을 참고하세요.

collection_configuration.collect_workload_validation_metrics

Boolean

워크로드 관리자 평가 측정항목 수집을 사용 설정하려면 true를 지정합니다. 버전 3.2부터 기본값은 true입니다.
이 매개변수는 Linux에만 적용됩니다.

collection_configuration.workload_validation_metrics_frequency

Int

워크로드 관리자 평가 측정항목의 수집 빈도(초)입니다. 기본값은 300초입니다.

워크로드 관리자 측정항목의 수집 빈도를 수정해야 하는 경우 collection_configuration 섹션 아래에 workload_validation_metrics_frequency 매개변수를 추가하고 필요한 값을 제공합니다.

collection_configuration.workload_validation_collection_definition.fetch_latest_config

Boolean

선택사항입니다. 기본값은 true이며, 에이전트를 업데이트하지 않고도 에이전트가 워크로드 관리자 평가 측정항목의 최신 집합을 수집할 수 있게 해줍니다. 이 동작을 중지하려면 구성 파일에서 이 매개변수를 지정하고 값을 false로 설정합니다.

collection_configuration.workload_validation_db_metrics_config.hana_db_user

String

SAP HANA 인스턴스 쿼리에 사용되는 사용자 계정을 지정합니다. 사용자 계정에 SAP HANA 데이터베이스에 대한 읽기 권한이 있어야 합니다.

collection_configuration.workload_validation_db_metrics_config.hana_db_password

String

SAP HANA 인스턴스 쿼리에 사용되는 사용자 계정의 비밀번호를 지정합니다.

SAP HANA 인증의 경우 에이전트는 다음과 같은 우선순위를 사용합니다. 지정된 경우 hdbuserstore_key 구성 매개변수가 hana_db_password 매개변수보다 우선되고 hana_db_password 매개변수가 hana_db_password_secret_name 매개변수보다 우선됩니다. 구성 파일에서 인증 옵션을 하나만 설정하는 것이 좋습니다.

collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name

String

Secret Manager에서 사용자 계정의 비밀번호를 저장하는 보안 비밀의 이름을 지정합니다.

또는 hdbuserstore_key 구성 매개변수를 지정하여 지정된 SAP HANA 사용자를 인증할 수 있습니다.

SAP HANA 인증의 경우 에이전트는 다음과 같은 우선순위를 사용합니다. 지정된 경우 hdbuserstore_key 구성 매개변수가 hana_db_password 매개변수보다 우선되고 hana_db_password 매개변수가 hana_db_password_secret_name 매개변수보다 우선됩니다. 구성 파일에서 인증 옵션을 하나만 설정하는 것이 좋습니다.

collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key

String

SAP HANA 시스템에 안전하게 연결하려면 해당 시스템에 대해 만든 보안 사용자 저장소(hdbuserstore) 키를 지정합니다.

인증에 hdbuserstore 키를 사용하려면 다음을 확인합니다.

  • SAP 도구 hdbsqlhdbuserstore는 에이전트를 호스팅하는 컴퓨팅 인스턴스에 설치됩니다.
  • hdbuserstore 키는 특정 SAP HANA 인스턴스 하나에 해당합니다. SAP HANA 인스턴스 여러 개의 호스트 이름이 포함된 키를 사용할 수 없습니다.
  • SIDadm 사용자는 이 키를 사용하여 SAP HANA 데이터베이스를 쿼리할 수 있습니다. 여기서 SIDsid 파라미터에 지정한 값을 나타냅니다. SIDadm 사용자로 다음 명령어를 실행하여 이를 확인할 수 있습니다.
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

이 구성 파라미터는 에이전트 버전 3.3부터 지원됩니다.

hdbuserstore_key를 지정하면 hostnameport 매개변수 지정을 건너뛸 수 있습니다.

SAP HANA 인증의 경우 에이전트는 다음과 같은 우선순위를 사용합니다. 지정된 경우 hdbuserstore_key 구성 매개변수가 hana_db_password 매개변수보다 우선되고 hana_db_password 매개변수가 hana_db_password_secret_name 매개변수보다 우선됩니다. 구성 파일에서 인증 옵션을 하나만 설정하는 것이 좋습니다.

collection_configuration.workload_validation_db_metrics_config.sid

String

SAP HANA 인스턴스의 SID를 지정합니다.

collection_configuration.workload_validation_db_metrics_config.hostname

String

SAP HANA 인스턴스를 호스팅하는 로컬 또는 원격의 머신 식별자를 지정합니다. 지원되는 값은 다음과 같습니다.

  • 호스트가 로컬 머신이면 localhost 문자열을 지정하거나 127.0.0.1과 같은 로컬 호스트 루프백 IP 주소를 지정합니다.
  • 호스트가 원격 머신이면 내부 또는 외부 IP 주소를 지정합니다.
collection_configuration.workload_validation_db_metrics_config.port

String

SAP HANA 인스턴스가 쿼리를 허용하는 포트를 지정합니다. 첫 번째 또는 유일한 테넌트 데이터베이스 인스턴스의 경우 포트가 3NN15이고 여기서 NN은 SAP HANA 인스턴스의 인스턴스 번호입니다.

collection_configuration.workload_validation_db_metrics_frequency

Int

워크로드 관리자 평가를 위한 SAP HANA 데이터베이스 측정항목의 수집 빈도(초)입니다. 기본값은 3600초입니다.

SAP HANA 데이터베이스 측정항목의 수집 빈도를 업데이트할 수 있지만 기본값을 사용하는 것이 좋습니다. 기본값을 수정해야 하면 collection_configuration 섹션 아래에 workload_validation_db_metrics_frequency 매개변수를 추가하고 필요한 값을 제공합니다. 수집 빈도를 3600초보다 크게 설정하지 마세요.

hana_monitoring_configuration.enabled

Boolean

선택사항입니다. SAP HANA 모니터링 측정항목을 수집하도록 SAP용 Google Cloud 에이전트를 사용 설정하려면 true를 지정합니다. 기본값은 false입니다.

다음 하위 속성은 hana_monitoring_configuration.enabled: true를 지정할 때만 적용됩니다.
hana_monitoring_configuration.sample_interval_sec

Int

선택사항입니다. SAP용 Google Cloud 에이전트가 SAP HANA 모니터링 측정항목을 수집하기 위해 SAP HANA 인스턴스를 쿼리하는 빈도를 결정하는 샘플 간격(초)을 지정합니다. 기본값은 300초입니다.

SAP용 Google Cloud 에이전트의 구성 파일에 정의된 각 쿼리에 대해 sample_interval_sec 매개변수에 필요한 간격을 지정하여 전역 샘플 간격을 덮어쓸 수 있습니다. 샘플 간격은 5초 이상이어야 합니다.

hana_monitoring_configuration.query_timeout_sec

Int

선택사항입니다. SAP HANA 인스턴스에 수행되는 각 쿼리의 제한 시간을 지정합니다. 기본값은 300초입니다.

hana_monitoring_configuration.execution_threads

Int

선택사항입니다. SAP HANA 인스턴스로 쿼리를 전송하는 데 사용되는 스레드 수를 지정합니다. 각 쿼리는 자체 스레드에서 실행됩니다. 기본값은 10입니다.

hana_monitoring_configuration.hana_instances.name

String

SAP HANA 인스턴스의 이름 식별자를 지정합니다.

hana_monitoring_configuration.hana_instances.sid

String

SAP HANA 인스턴스의 SID를 지정합니다. 이 문자열은 SAP HANA 인스턴스 쿼리에서 발생하는 모든 측정항목에 라벨로 추가됩니다.

hana_monitoring_configuration.hana_instances.host

String

SAP HANA 인스턴스를 호스팅하는 로컬 또는 원격의 머신 식별자를 지정합니다. 지원되는 값은 다음과 같습니다.

  • 호스트가 로컬 머신이면 localhost 문자열을 지정하거나 127.0.0.1과 같은 로컬 호스트 루프백 IP 주소를 지정합니다.
  • 호스트가 원격 머신이면 내부 또는 외부 IP 주소를 지정합니다.
hana_monitoring_configuration.hana_instances.port

String

SAP HANA 인스턴스가 쿼리를 허용하는 포트를 지정합니다. 첫 번째 또는 유일한 테넌트 데이터베이스 인스턴스의 경우 포트가 3NN15이고 여기서 NN은 SAP HANA 인스턴스의 인스턴스 번호입니다.

hana_monitoring_configuration.hana_instances.user

String

SAP HANA 인스턴스 쿼리에 사용되는 사용자 계정을 지정합니다.

이 사용자에게 SAP HANA 데이터베이스의 모니터링 뷰를 읽을 수 있는 권한이 있는지 확인합니다. 이 권한이 부여되지 않으면 모니터링 뷰와 관련된 SAP HANA 모니터링 측정항목에 데이터가 포함되지 않습니다.

hana_monitoring_configuration.hana_instances.password

String

선택사항입니다. SAP HANA 인스턴스 쿼리를 위해 사용자 계정을 인증하는 비밀번호를 일반 텍스트로 지정합니다.

인증을 위해 다음 중 하나를 지정해야 합니다.

  • password 속성에 대한 일반 텍스트 비밀번호
  • (권장사항) Secret Manager를 사용하여 비밀번호를 보안 비밀로 저장하는 경우 secret_name 매개변수에 대해 해당 보안 비밀 이름을 지정해야 합니다.
  • (권장사항) hdbuserstore_key 매개변수에 대한 hdbuserstore입니다.

SAP HANA 인증의 경우 에이전트는 다음과 같은 우선순위를 사용합니다. 지정된 경우 hdbuserstore_key 구성 매개변수가 password 매개변수보다 우선되고 password 매개변수가 secret_name 매개변수보다 우선됩니다. 구성 파일에서 인증 옵션을 하나만 설정하는 것이 좋습니다.

hana_monitoring_configuration.hana_instances.secret_name

String

선택사항입니다. Secret Manager에서 사용자 계정의 비밀번호를 저장하는 보안 비밀의 이름을 지정합니다.

SAP HANA 인증의 경우 에이전트는 다음과 같은 우선순위를 사용합니다. 지정된 경우 hdbuserstore_key 구성 매개변수가 password 매개변수보다 우선되고 password 매개변수가 secret_name 매개변수보다 우선됩니다. 구성 파일에서 인증 옵션을 하나만 설정하는 것이 좋습니다.

hana_monitoring_configuration.hana_instances.hdbuserstore_key

String

SAP HANA 시스템에 안전하게 연결하려면 해당 시스템에 대해 만든 보안 사용자 저장소(hdbuserstore) 키를 지정합니다.

인증에 hdbuserstore 키를 사용하려면 다음을 확인합니다.

  • SAP 도구 hdbsqlhdbuserstore는 에이전트를 호스팅하는 컴퓨팅 인스턴스에 설치됩니다.
  • hdbuserstore 키는 특정 SAP HANA 인스턴스 하나에 해당합니다. SAP HANA 인스턴스 여러 개의 호스트 이름이 포함된 키를 사용할 수 없습니다.
  • SIDadm 사용자는 이 키를 사용하여 SAP HANA 데이터베이스를 쿼리할 수 있습니다. 여기서 SIDsid 파라미터에 지정한 값을 나타냅니다. SIDadm 사용자로 다음 명령어를 실행하여 이를 확인할 수 있습니다.
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

이 구성 파라미터는 에이전트 버전 3.3부터 지원됩니다.

hdbuserstore_key를 지정하면 hostport 매개변수 지정을 건너뛸 수 있습니다.

hana_monitoring_configuration.hana_instances.enable_ssl

Boolean

선택사항입니다. SAP HANA 인스턴스에서 SSL이 사용 설정되었는지 여부를 지정합니다. 기본값은 false입니다.

hana_monitoring_configuration.hana_instances.host_name_in_certificate

String

SAP HANA 인스턴스에 enable_ssl: true를 지정하는 경우 SSL 인증서에 설정된 호스트 이름을 지정해야 합니다.

hana_monitoring_configuration.hana_instances.tls_root_ca_file

String

SAP HANA 인스턴스에 enable_ssl: true를 지정하는 경우 보안 인증서의 경로를 지정해야 합니다.

hana_monitoring_configuration.queries.enabled

Boolean

선택사항입니다. 모든 SAP HANA 인스턴스에 대해 SQL 쿼리를 사용 설정하려면 해당 SQL 쿼리의 enabled 매개변수에 true 값을 지정합니다.

hana_monitoring_configuration.queries.name

String

구성 파일에 커스텀 쿼리를 정의한 경우 각 커스텀 쿼리에 대해 고유 이름을 지정해야 합니다.

쿼리 이름은 모니터링에서 측정항목의 기본 URL을 빌드하는 데 사용되므로 고유해야 합니다.

hana_monitoring_configuration.queries.sql

String

에이전트가 SAP HANA 인스턴스에 대해 실행하는 SQL 문을 지정합니다.

SQL 문은 SAP HANA SQL 및 시스템 보기 참조에서 SAP에서 정의된 SQL 문법과 일치해야 합니다.
hana_monitoring_configuration.queries.sample_interval_sec

Int

선택사항입니다. SQL 쿼리의 샘플 간격을 지정합니다. 이렇게 하면 전역 샘플 간격이 재정의됩니다. 값은 5초 이상이어야 합니다.

hana_monitoring_configuration.queries.columns.name

String

각 열을 고유하게 식별하는 이름을 지정합니다.

열 이름은 Monitoring에서 측정항목의 기본 URL을 빌드하는 데 사용되므로 고유해야 합니다.

hana_monitoring_configuration.queries.columns.metric_type

String

Monitoring에서 처리할 수 있도록 측정 항목 유형을 METRIC_LABEL, METRIC_GAUGE, METRIC_CUMULATIVE 중 하나로 지정합니다.

METRIC_LABEL 유형의 측정 항목은 Monitoring에 전송되는 모든 METRIC_GAUGEMETRIC_CUMULATIVE 측정항목에 라벨로 추가됩니다.

hana_monitoring_configuration.queries.columns.value_type

String

Monitoring에서 처리할 수 있도록 해당 측정항목 유형에서 지원되는 데이터 유형을 지정합니다.

지원되는 데이터 유형은 VALUE_BOOL, VALUE_INT64, VALUE_STRING, VALUE_DOUBLE입니다. 자세한 내용은 지원되는 조합을 참조하세요.

hana_monitoring_configuration.queries.columns.name_override

String

선택사항입니다. Monitoring에서 처리할 수 있도록 쿼리 및 열 이름 대신 측정항목 URL에 표시할 경로를 지정합니다. 예를 들면 다음과 같습니다.

  • 측정항목의 기본 URL: workload.googleapis.com/sap/hanamonitoring/QUERY_NAME/COLUMN_NAME
  • 커스텀 경로를 사용하는 측정항목 URL: workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH

문제 해결

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

지원 받기

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