SAP HANA용 모니터링 에이전트 V2.0 설치 및 운영 가이드

이 가이드에서는 SAP HANA용 Google Cloud 모니터링 에이전트 버전 2.0의 설치, 운영, 문제 해결에 대한 안내를 제공합니다.

SAP HANA용 모니터링 에이전트와 관련 옵션에 대한 개요는 SAP HANA용 모니터링 에이전트 V2.0 계획 가이드를 참조하세요.

기본 요건

SAP HANA용 모니터링 에이전트를 사용하려면 SAP HANA 연결 드라이버와 특정 버전의 자바 런타임 환경(JRE)이 필요합니다.

에이전트를 설치하는 서버가 인터넷에 액세스할 수 있는 경우 에이전트가 설치 중에 자동으로 파일을 다운로드합니다.

서버가 인터넷에 액세스할 수 없는 경우 파일을 서버에 직접 업로드할 수 있습니다.

직접 업로드해야 하는 경우 에이전트를 설치하기 전에 /tmp/gcloudsapdeps/ 디렉터리에 다음 파일을 업로드합니다.

  • https://github.com/SAP/SapMachine/releases/download/sapmachine-11.0.11/sapmachine-jre-11.0.11_linux-x64_bin.tar.gz
  • https://repo1.maven.org/maven2/com/sap/cloud/db/jdbc/ngdbc/2.5.50/ngdbc-2.5.50.jar

또한 이 가이드에서는 다음 작업을 이미 완료했다고 가정합니다.

  • Google 계정
  • Google Cloud 프로젝트
  • Google Cloud 결제 계정
  • 하나 이상 배포된 SAP HANA 인스턴스. Google Cloud에 SAP HANA를 배포하는 방법은 SAP HANA 배포 가이드를 참조하세요.

필수 IAM 역할 설정

적어도 SAP HANA용 모니터링 에이전트에 사용되는 서비스 계정에는 Monitoring Metric Writer 역할이 포함되어야 합니다. 그렇지 않으면 서비스 계정에 Monitoring Metric Writer 역할을 부여해야 합니다.

또한 Secret Manager를 사용하여 SAP HANA 시스템 데이터베이스 사용자 비밀번호를 저장하는 경우 서비스 계정에 Secret Manager Secret Accessor 역할이 포함되어야 합니다.

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

  1. Cloud Console에서 IAM 및 관리자 페이지로 이동합니다.

    IAM 및 관리자 페이지로 이동

  2. 프로젝트를 선택하고 계속을 클릭합니다.

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

    • 서비스 계정이 구성원 목록에 아직 없는 경우 어떠한 역할도 할당되지 않은 것입니다. 구성원 추가를 클릭하고 서비스 계정의 이메일 주소를 입력합니다.
    • 서비스 계정이 구성원 목록에 이미 있는 경우 기존 역할이 있는 것입니다. 수정할 서비스 계정의 현재 역할 드롭다운 목록을 클릭합니다.
  4. 사용 가능한 역할 목록에서 필요한 역할을 선택합니다.

    • 모니터링 > 모니터링 측정항목 작성자
    • Secret Manager > Secret Manager 보안 비밀 접근자
  5. 추가 또는 저장을 클릭하여 서비스 계정에 역할을 적용합니다.

Secret Manager에 액세스하는 데 필요한 IAM 역할 및 범위에 대한 자세한 내용은 Secret Manager 액세스 제어를 참조하세요.

SAP HANA용 모니터링 에이전트 설치

OS 저장소 목록에 Google Cloud RPM 저장소 추가

에이전트의 Google Cloud RPM 저장소 URL을 운영체제의 패키지 저장소 목록에 추가해야 합니다. 저장소를 추가하는 방법은 Red Hat 또는 SUSE 운영체제를 사용하는지에 따라 다릅니다.

RHEL에 저장소 추가

RHEL에 Google Cloud RPM 저장소를 추가하려면 버전을 선택하고 절차를 따릅니다.

RHEL 7

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

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

    sudo tee /etc/yum.repos.d/google-saphanamonitoring-agent.repo << EOM
    [google-saphanamonitoring-agent]
    name=Google SAP HANA Monitoring Agent
    baseurl=https://packages.cloud.google.com/yum/repos/google-saphanamonitoring-agent-el7-\$basearch
    enabled=1
    gpgcheck=0
    repo_gpgcheck=0
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
    EOM

RHEL 8

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

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

    sudo tee /etc/yum.repos.d/google-saphanamonitoring-agent.repo << EOM
    [google-saphanamonitoring-agent]
    name=Google SAP HANA Monitoring Agent
    baseurl=https://packages.cloud.google.com/yum/repos/google-saphanamonitoring-agent-el8-\$basearch
    enabled=1
    gpgcheck=0
    repo_gpgcheck=0
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
    EOM

SLES에 저장소 추가

SLES에 Google Cloud RPM 저장소를 추가하려면 버전을 선택하고 절차를 따릅니다.

SLES 12

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

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

    sudo zypper addrepo --gpgcheck-allow-unsigned-package --refresh \
    https://packages.cloud.google.com/yum/repos/google-saphanamonitoring-agent-sles12-\$basearch google-saphanamonitoring-agent

SLES 15

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

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

    sudo zypper addrepo --gpgcheck-allow-unsigned-package --refresh \
    https://packages.cloud.google.com/yum/repos/google-saphanamonitoring-agent-sles15-\$basearch google-saphanamonitoring-agent

에이전트 설치

OS 패키지 관리자를 사용하여 SAP HANA용 모니터링 에이전트를 설치합니다.

에이전트를 설치하려면 운영체제를 선택하고 절차를 따릅니다.

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

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

    RHEL

    sudo yum install google-saphanamonitoring-agent

    SLES

    sudo zypper install google-saphanamonitoring-agent

에이전트는 /usr/sap/google-saphanamonitoring-agent 디렉터리에 설치됩니다.

에이전트 구성

에이전트 구성 파일 /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml을 수정하여 에이전트를 구성합니다.

자동으로 감지되는 서버 속성 값

기본적으로 다음 예시와 같이 configuration.yaml 파일의 cloud_properties 섹션이 주석 처리되며 SAP HANA용 모니터링 에이전트는 프로젝트 ID, 인스턴스 ID, 에이전트가 실행 중인 VM 인스턴스 영역을 사용합니다.

  # cloud_properties:
     # project_id: MONITORED_INSTANCE_PROJECT_ID
     # instance_id: MONITORED_VM_ID
     # zone: MONITORED_VM_ZONE

에이전트가 SAP HANA와 동일한 VM에서 실행되는 경우 cloud_properties 섹션을 주석 처리된 상태로 둘 수 있습니다.

에이전트가 SAP HANA와 다른 VM에서 실행되는 경우 cloud_properties 섹션의 각 줄에서 주석 문자 #를 삭제하고 project_id, instance_idzone 속성을 프로젝트 ID, 인스턴스 ID, SAP HANA 호스트 VM의 영역으로 업데이트합니다.

SAP HANA가 베어메탈 솔루션 서버에서 실행되는 경우 cloud_propertiesproject_id 줄에서만 주석 문자인 #을 삭제하고 베어메탈 솔루션에 사용하는 프로젝트의 프로젝트 ID를 지정해야 합니다. instance_idzone 속성은 주석 처리된 상태로 둡니다.

자동으로 감지되는 SAP HANA 속성 값

기본적으로 configuration.yaml 파일의 sid 속성이 주석 처리되고 에이전트는 SAP HANA M_DATABASE 테이블에서 SAP HANA 시스템 ID(SID)를 검색합니다. 다른 SID를 지정해야 하는 경우 sid 줄에서 주석 문자를 삭제하고 필요한 SID를 지정합니다.

구성 절차

다음 단계에서는 일반적으로 사용되는 구성 속성을 지정합니다. 모든 구성 속성에 대한 설명은 구성 속성 설명을 참조하세요.

  1. 원하는 텍스트 편집기를 사용하여 수정할 구성 파일을 엽니다. 예를 들면 다음과 같습니다.

    sudo vi /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
  2. 원하는 경우 gcloud_auth에서 주석 문자인 #을 삭제하고 에이전트의 IAM 서비스 계정 키가 포함된 JSON 파일 경로를 지정합니다. 예를 들면 다음과 같습니다.

    gcloud_auth:
    # If defined this service account will be used for API calls or else the default VM credentials
    # will be used.
    service_account_json: /usr/sap/google-saphanamonitoring-agent/auth/example-project-id-abcdef123456.json
  3. 에이전트가 모니터링할 SAP HANA 인스턴스를 하나 이상 지정합니다.

    SAP HANA 데이터베이스를 두 개 이상 지정하려면 - name에서 trust_store_secret_name까지 해당하는 모든 hana_instances 속성을 복사하여 새로운 속성 집합을 만듭니다. SSL, 인증서, 키 저장소, 트러스트 저장소 속성은 추가 SAP HANA 인스턴스에서 이를 사용하는 경우에만 복사해야 합니다. 추가 인스턴스 속성 집합을 첫 번째 집합 바로 뒤에, queries 앞에 붙여넣습니다.

    SAP HANA 인스턴스를 정의하려면 다음 안내를 따르세요.

    1. SAP HANA 인스턴스가 실행 중인 호스트 이름을 지정합니다. 이 값은 로그와 Monitoring에 표시됩니다. 예를 들면 다음과 같습니다.

      - name: example-hana-vm
    2. SAP HANA 인스턴스가 실행 중인 호스트의 IP 주소를 지정합니다.

      • SAP HANA 인스턴스가 에이전트와 다른 호스트 VM에서 실행되는 경우 호스트 VM의 내부 IP 주소를 지정합니다. 예를 들면 다음과 같습니다.

        host: 10.1.0.100
      • SAP HANA 인스턴스가 에이전트와 동일한 Google Cloud 프로젝트에 포함되지 않은 호스트에서 실행되는 경우 호스트 VM의 공개 IP 주소를 지정합니다.

      • 에이전트가 SAP HANA와 동일한 호스트에서 실행되는 경우에는 기본값인 localhost 루프백 IP 주소 127.0.0.1을 수락하면 됩니다.

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

      port: 30015
    4. 에이전트가 SAP HANA를 쿼리하는 데 사용할 SAP HANA 사용자 계정을 지정합니다. 기본적으로 SYSTEM 사용자 계정이 지정됩니다.

      user: SYSTEM
    5. 에이전트가 SAP HANA를 쿼리하는 데 사용할 SAP HANA 사용자 계정의 비밀번호를 지정합니다. 예를 들면 다음과 같습니다.

      password: TempPa55word
    6. SAP HANA 시스템이 전송 계층 보안(TLS)/보안 소켓 레이어(SSL)를 사용하는 경우 SSL 지원을 사용 설정합니다.

      enable_ssl: true
    7. SAP HANA가 TLS/SSL을 사용할 때 인증서의 유효성을 검증하려면 인증서 확인을 사용 설정하고 필요에 따라 인증서 이름, 키 저장소, trustore 속성을 지정합니다.

      validate_certificate: true

      인증서 이름, 키 저장소, 트러스트 저장소 속성에 대한 설명은 구성 속성 설명을 참조하세요.

  4. 저장하고 configuration.yaml 파일을 닫습니다.

구성 속성 설명

다음 표에서는 SAP HANA 인스턴스, 연결, TLS/SSL 지원, 인증서 유효성 검사 지원을 정의하는 데 사용할 수 있는 모든 속성을 보여줍니다.

쿼리의 전역 기본값을 정의하는 sample_intervalquery_timeout을 제외한 개별 쿼리를 정의하거나 사용 설정하는 데 사용되는 다른 모든 속성은 SAP HANA 용 모니터링 에이전트 계획 가이드에 설명되어 있습니다.

속성 데이터 유형 설명
sample_interval 정수 쿼리 간의 기본 간격(초 단위)을 정의합니다. 쿼리 정의에서 sample_interval을 지정하면 개별 쿼리에 지정된 값을 재정의할 수 있습니다. 기본값은 300(5분)입니다.
query_timeout 정수 쿼리 실행에 허용되는 시간(초 단위)으로서 기본값은 5분입니다.
cloud_properties 에이전트가 실행 중인 환경을 식별하는 속성입니다. 이러한 값은 자동으로 감지되지만 수정할 수 있습니다.
project_id 문자열

SAP HANA가 실행 중인 Google Cloud 프로젝트의 ID입니다.

Monitoring에서 이 값은 데이터를 필터링하는 데 사용할 수 있는 리소스 라벨입니다.

SAP HANA가 에이전트와 다른 VM 또는 베어메탈 솔루션 서버에서 실행되는 경우 이 속성을 지정합니다.

에이전트가 SAP HANA와 동일한 VM에서 실행되는 경우 기본적으로 에이전트는 프로젝트 ID를 자동으로 감지합니다. 속성 값을 지정하여 기본 동작을 재정의할 수 있습니다.

instance_id 문자열

SAP HANA가 에이전트와 다른 Compute Engine VM에서 실행되는 경우 SAP HANA 호스트 VM의 인스턴스 ID 번호를 지정합니다.

Monitoring에서 이 값은 데이터를 필터링하는 데 사용할 수 있는 리소스 라벨입니다.

SAP HANA가 베어메탈 솔루션 서버에서 실행되는 경우 항상 instance_id를 주석 처리된 상태로 둡니다.

기본적으로 에이전트는 에이전트가 설치된 VM의 인스턴스 ID를 사용합니다.

zone 문자열

SAP HANA가 에이전트와 다른 영역의 Compute Engine VM에서 실행되는 경우 SAP HANA 호스트 VM의 영역을 지정합니다.

Monitoring에서 이 값은 데이터를 필터링하는 데 사용할 수 있는 리소스 라벨입니다.

SAP HANA가 베어메탈 솔루션 서버에서 실행 중인 경우 항상 zone을 주석 처리된 상태로 둡니다.

기본적으로 에이전트는 에이전트가 설치된 VM의 영역을 사용합니다.

gcloud_auth 에이전트가 ID 및 액세스 관리에 사용하는 서비스 계정과 관련된 속성입니다.
service_account_json 문자열 사용자가 만든 커스텀 서비스 계정의 키가 포함된 JSON 파일의 경로를 지정합니다. Google Cloud는 서비스 계정을 사용하여 에이전트를 인증하고 에이전트가 액세스하도록 인증된 Google Cloud API와 리소스를 파악합니다. service_account_json이 생략되면 에이전트에서 호스트 VM의 서비스 계정을 사용합니다.
hana_instances 모니터링할 SAP HANA 데이터베이스를 식별하는 속성입니다. SAP HANA 데이터베이스를 두 개 이상 지정하려면 기존 인스턴스 속성을 - name에서 enable_ssl(포함)로 복사하고 첫 번째 집합 바로 뒤에 붙여넣어 새로운 속성 집합을 만듭니다. 새로운 속성 집합으로 추가 데이터베이스를 정의합니다.
- name 문자열

SAP HANA가 실행 중인 호스트의 이름입니다. 이 값은 SAP HANA 인스턴스를 식별합니다.

Monitoring에서 이 값은 데이터를 필터링하는 데 사용할 수 있는 측정항목 라벨입니다.

데이터베이스를 두 개 이상 모니터링하는 경우 데이터베이스를 구별하기 위해 이 값을 수정합니다.

sid 문자열 에이전트가 모니터링하는 SAP HANA 인스턴스의 SID를 지정하는 선택적 속성입니다.

에이전트는 일반적으로 SAP HANA에서 이 값을 자동으로 검색하므로 지정할 필요가 없습니다. 다른 값을 지정해야 하거나 에이전트가 SID를 자동으로 감지하지 못하는 경우 sid 속성을 주석 처리 삭제하고 필요한 값을 지정합니다.

host 문자열 SAP HANA 호스트의 IP 주소입니다. 에이전트가 SAP HANA와 동일한 호스트에서 실행되는 경우에는 기본값인 localhost 루프백 IP 주소를 수락하면 됩니다.
port 정수 SAP에서 정의한 SAP HANA 서버의 포트 번호입니다. 첫 번째 또는 유일한 테넌트 데이터베이스의 경우 3nn15를 지정합니다. 여기서 nn은 SAP HANA 인스턴스 번호입니다. SAP HANA 포트에 대한 자세한 내용은 모든 SAP 제품의 TCP/IP 포트를 참조하세요.
connections 정수 연결 풀링을 위해 연결 풀에서 유지할 연결 수입니다. Google Cloud 지원팀에서 별도로 요청하지 않는 한 이 속성을 수정하지 마세요.
user 문자열 에이전트가 SAP HANA를 쿼리하는 데 사용하는 SAP HANA 데이터베이스 사용자 계정입니다. 기본값은 SYSTEM입니다.
password 문자열 모니터링 에이전트가 SAP HANA를 쿼리하는 데 사용하는 데이터베이스 사용자 계정의 비밀번호입니다. Secret Manager를 사용하여 데이터베이스 사용자 인증 정보를 저장하는 경우에는 비밀번호를 지정하지 마세요.
secret_name 문자열 Secret Manager를 사용하여 데이터베이스 사용자 인증 정보를 저장하는 경우 보안 사용자 인증 정보가 포함된 보안 비밀의 이름을 지정합니다.
enable_ssl 부울 SAP HANA에서 SSL 또는 TSL을 사용 설정할지 여부를 지정합니다. 유효한 값은 true 또는 false입니다.
validate_certificate 부울 에이전트가 서버 인증서를 확인할지 여부를 지정합니다. 유효한 값은 true 또는 false입니다.
host_name_in_certificate 인증서에 포함된 SAP HANA 호스트 이름을 지정합니다. 이 속성은 SAP HANA용 모니터링 에이전트가 SAP HANA와 동일한 호스트 VM에서 실행되고 SAP HANA 호스트 VM이 실제 호스트 이름이 아니라 `localhost`를 사용하여 에이전트와 호스트 VM 간의 연결을 완료하는 데 필요합니다.
key_store JKS 또는 PKCS12 자바 키 저장소의 경로를 지정합니다. 이 속성을 지정하지 않으면 SAP HANA용 모니터링 에이전트가 JVM 기본값을 사용합니다.

키 저장소가 비밀번호로 보호되는 경우 key_store_password 또는 key_store_secret_name을 지정해야 합니다.

key_store_password 키 저장소가 비밀번호로 보호되는 경우 키 저장소의 일반 텍스트 비밀번호를 지정합니다. key_store_password 사양은 key_store_secret_name 사양과 상호 배타적입니다.
key_store_secret_name 키 저장소가 비밀번호로 보호되는 경우 Secret Manager에 키 저장소의 비밀번호가 포함된 보안 비밀의 이름을 지정합니다. key_store_secret_name 사양은 key_store_password 사양과 상호 배타적입니다.
trust_store SAP HANA 서버의 공개 인증서가 포함된 트러스트 저장소 JKS 파일의 경로를 지정합니다. 일반적으로 트러스트 저장소에는 SAP HANA 서버의 인증서에 서명한 루트 인증서 또는 인증 기관의 인증서가 포함되어 있습니다. trust_store가 생략되면 에이전트에서 JVM의 기본 트러스트 저장소를 사용합니다.
trust_store_password truststore가 비밀번호로 보호되는 경우 truststore의 일반 텍스트 비밀번호를 지정합니다. trust_store_password 사양은 trust_store_secret_name 사양과 상호 배타적입니다.
trust_store_secret_name truststore가 비밀번호로 보호되는 경우 Secret Manager에 truststore의 비밀번호가 포함된 보안 비밀의 이름을 지정합니다. trust_store_secret_name 사양은 trust_store_password 사양과 상호 배타적입니다.

에이전트 사용 설정

SAP HANA용 모니터링 에이전트를 구성한 후 시작하기 전에 VM 인스턴스가 재부팅될 때마다 서비스가 다시 시작하도록 에이전트를 systemd 서비스로 사용 설정합니다.

에이전트를 사용 설정하려면 다음 안내를 따르세요.

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

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

    sudo systemctl enable google-saphanamonitoring-agent

    다음 예시와 비슷한 출력이 표시됩니다.

    Created symlink /etc/systemd/system/multi-user.target.wants/google-saphanamonitoring-agent.service → /usr/sap/google-saphanamonitoring-agent/service/google-saphanamonitoring-agent.service.
    Created symlink /etc/systemd/system/google-saphanamonitoring-agent.service → /usr/sap/google-saphanamonitoring-agent/service/google-saphanamonitoring-agent.service.
    

에이전트 시작

에이전트를 시작하려면 다음 안내를 따르세요.

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

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

    sudo systemctl start google-saphanamonitoring-agent
  3. 에이전트 상태를 확인합니다.

    sudo systemctl status google-saphanamonitoring-agent

정상적으로 시작되면 몇 초 후 에이전트가 SAP HANA를 쿼리하고 측정항목을 Monitoring으로 전송하기 시작합니다.

Monitoring에서 측정항목을 보는 방법에 대한 자세한 내용은 측정항목을 보려면 커스텀 대시보드 설치를 참조하세요.

로그 확인

로그를 확인하려면 다음 명령어를 실행합니다.

tail -n 100 -f /var/log/google-saphanamonitoring-agent.log

에이전트가 시작되면 시작 이벤트가 로그에 기록됩니다. 시작, 쿼리 예약, Monitoring으로 측정항목 전송이 로그에 기록됩니다.

다음 예시는 처음으로 성공한 SAP HANA에 대한 쿼리의 시작 로그와 로그 항목을 보여줍니다.

2021-04-26T20:42:53.392UTC [INFO] ******  Starting Google SAP HANA Custom Metrics Agent ******
2021-04-26T20:42:53.413UTC [INFO] Controller initializing...
2021-04-26T20:42:53.414UTC [INFO] Configuring dependencies...
2021-04-26T20:42:53.677UTC [INFO] Configuration of dependencies complete.
2021-04-26T20:42:53.678UTC [INFO] Configuration loading...
2021-04-26T20:42:53.704UTC [INFO] Loading system level metric definitions...
2021-04-26T20:42:53.767UTC [INFO] Loading conf/configuration.yaml...
2021-04-26T20:42:53.836UTC [INFO] Default Cloud Properties: projectId=example-project-id, instanceId=8254335046206112691, zone=us-central1-f
2021-04-26T20:42:53.843UTC [INFO] No "cloud_properties" field found in the config file, so using default cloud properties.
2021-04-26T20:42:53.850UTC [INFO] Configuration loaded and validated.
2021-04-26T20:42:53.865UTC [INFO] Configuration load complete.
2021-04-26T20:42:53.865UTC [INFO] Controller initialization complete
2021-04-26T20:42:53.865UTC [INFO] Starting sampling of HANA metrics...
2021-04-26T20:42:53.875UTC [INFO] Creating connection pool of size 10 for SAP HANA instance "example-hana-vm"
2021-04-26T20:42:54.289UTC [INFO] The SAP HANA agent has completed initial setup. Metrics will start being sent to Cloud Monitoring in 30 seconds.
2021-04-26T20:43:24.278UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.281UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.292UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.292UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.294UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.295UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.295UTC [INFO] Scheduling another execution for query "replication_query" and instance "example-hana-vm" in 300 seconds

에이전트 중지

커스텀 쿼리를 추가하거나 에이전트의 구성을 변경하는 경우 새 쿼리 또는 기타 구성 변경사항이 적용되기 전에 에이전트를 중지했다가 시작해야 합니다.

  1. 에이전트를 중지합니다.

    sudo systemctl stop google-saphanamonitoring-agent
  2. 에이전트를 다시 시작합니다.

    sudo systemctl start google-saphanamonitoring-agent

측정항목을 보려면 커스텀 대시보드 설치

GitHub 저장소에서 Monitoring으로 SAP HANA 커스텀 대시보드를 설치하려면 다음을 수행합니다.

  1. Cloud Shell을 엽니다.

    Cloud Shell로 이동

  2. Cloud Shell에서 저장소를 클론 또는 다운로드합니다.

    git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git
  3. Cloud Shell에서 SAP HANA performance.json 대시보드를 설치합니다.

    gcloud monitoring dashboards create /
    --config-from-file=monitoring-dashboard-samples/dashboards/sap-hana/performance.json

Cloud 프로젝트에서 사용 가능한 대시보드에 'SAP HANA 성능' 대시보드가 추가됩니다. 대시보드를 보려면 설치된 대시보드 보기의 안내를 따르세요.

자세한 내용은 다음을 참고하세요.

설치된 대시보드 보기

저장소의 performance.json 파일은 제목이 'SAP HANA 성능'인 새 커스텀 대시보드를 만듭니다.

  1. Cloud Console에서 Monitoring을 선택하거나 다음 버튼을 클릭합니다.

    모니터링으로 이동

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

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

다음 화면 캡처는 Monitoring에서 SAP HANA용 커스텀 대시보드의 일부를 보여줍니다.

Monitoring에서 커스텀 SAP HANA 성능 대시보드의 상위 2개 차트를 보여주는 화면 캡처

SAP HANA용 모니터링 에이전트 업데이트

최신 버전의 SAP HANA용 모니터링 에이전트를 사용하도록 정기적으로 업데이트를 확인합니다. Google Cloud 기반 SAP 출시 노트 페이지에 관련 업데이트가 공지됩니다.

업데이트 확인

운영체제를 선택합니다.

RHEL

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

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

    sudo yum check-update google-saphanamonitoring-agent

SLES

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

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

    sudo zypper list-updates -r google-saphanamonitoring-agent

업데이트 설치

운영체제를 선택합니다.

RHEL

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

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

    sudo yum update google-saphanamonitoring-agent

SLES

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

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

    sudo zypper update google-saphanamonitoring-agent

버전 1에서 버전 2 이상으로 업데이트

SAP HANA용 모니터링 에이전트 버전 2의 설치 스크립트에서 버전 1을 확인하고 버전 1 구성 파일에 있는 SAP HANA 인스턴스 정의를 버전 2 구성 파일에 자동으로 추가합니다.

버전 1에서 사용한 커스텀 쿼리를 버전 2 커스텀 쿼리 형식으로 configuration.yaml 파일에 추가하여 커스텀 쿼리를 다시 만들어야 합니다.

특정한 버전 2 구성 옵션을 사용하려면 구성 파일에 속성을 직접 추가해야 할 수 있습니다.

버전 1에서 버전 2 이상으로 업데이트하려면 다음 안내를 따르세요.

  1. 버전 1 에이전트의 호스트 VM에 SSH로 연결합니다.

  2. OS 저장소 목록에 Google Cloud RPM 저장소를 추가합니다.

  3. 운영체제를 선택하고 해당하는 install 명령어를 실행하여 새 에이전트를 설치합니다.

    RHEL

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

    sudo yum install google-saphanamonitoring-agent

    SLES

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

    sudo zypper install google-saphanamonitoring-agent

    버전 2를 설치하는 동안 설치 스크립트에서 다음 작업을 수행합니다.

    • 에이전트 버전 1을 확인합니다.
    • 버전 1을 중지합니다.
    • 버전 1 구성 파일의 인스턴스 정의와 버전 2의 기본 쿼리 문이 포함된 버전 2 구성 파일 /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml을 만듭니다. 버전 1의 쿼리는 복사되지 않습니다. 다른 버전 2 구성 속성은 수동으로 추가해야 합니다.
    • 기본 버전 2 구성 파일의 사본을 /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml.original로 저장합니다.
    • 버전 1 구성 파일을 /etc/default/gcm.save로 저장합니다.
  4. 버전 2 configuration.yaml 파일에서 인스턴스 정의를 검증하고 기타 필요한 사항을 변경합니다. 버전 2의 모든 구성 속성 목록은 구성 속성 설명을 참조하세요.

    1. 버전 1 구성 파일 /etc/default/gcm에서 새 구성 파일 /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml로 인스턴스 정의를 올바르게 가져왔는지 확인합니다.

    2. Secret Manager를 사용하는 경우 password 값을 secret_name 값으로 바꿉니다.

    3. SAP HANA 인스턴스에서 SSL/TLS를 사용하는 경우 SSL/TLS 속성을 설정합니다.

    4. 기본 쿼리 집합을 검토하고 필요하지 않은 쿼리를 사용 중지합니다. 버전 2에서 수집하는 기본 측정항목은 버전 1의 기본 측정항목과 다릅니다. 버전 2 기본 쿼리에 대한 자세한 내용은 기본 쿼리 참조를 참조하세요.

    5. 버전 1에서 사용한 커스텀 쿼리를 버전 2 configuration.yaml 파일에 다시 만듭니다. 버전 2의 커스텀 쿼리 정의에 대한 자세한 내용은 커스텀 쿼리 정의를 참조하세요.

  5. 에이전트를 systemd 서비스로 사용 설정합니다.

    sudo systemctl enable google-saphanamonitoring-agent
  6. 에이전트를 시작합니다.

    sudo systemctl start google-saphanamonitoring-agent
  7. 로그를 확인하여 에이전트가 Monitoring에 측정항목을 기록하는지 확인합니다.

    tail -n 100 -f /var/log/google-saphanamonitoring-agent.log
  8. Monitoring 대시보드, 그래프와 새 측정항목, 변경된 측정항목 또는 중단된 측정항목에 대한 알림을 업데이트합니다.

    모니터링으로 이동

문제 해결

다음 섹션에서는 설치, 쿼리 또는 Monitoring 측정항목 전송과 관련된 문제가 발생할 경우 취해야 할 단계를 설명합니다.

설치 실패

SAP HANA용 모니터링 에이전트가 지원하는 운영체제를 사용하고 있는지 확인합니다. 자세한 내용은 지원되는 운영체제를 참조하세요.

셸에서 에이전트를 설치하는 데 사용한 오류 메시지를 확인합니다.

OS 저장소 목록에 Google Cloud RPM 저장소 추가의 설명대로 에이전트의 Google Cloud RPM 저장소가 운영체제의 저장소 목록에 추가되었는지 확인합니다.

기본 쿼리 실패

호스트 VM에서 로그 파일 /var/log/google-saphanamonitoring-agent.log의 오류 메시지를 확인합니다.

호스트 VM에서 configuration.yaml 파일에 포함된 각 SAP HANA 인스턴스 정의의 port 속성에 올바른 포트가 지정되었는지 확인합니다. SAP가 SAP HANA SQL 쿼리에 사용할 포트에 대한 자세한 내용은 모든 SAP 제품의 TCP/IP 포트를 참조하세요.

SAP HANA 데이터베이스 사용자가 다음 SAP HANA 시스템 뷰에 액세스할 수 있는지 확인합니다.

  • M_CONNECTIONS
  • M_CS_ALL_COLUMNS
  • M_CS_TABLES
  • M_HOST_RESOURCE_UTILIZATION
  • M_RS_TABLES
  • M_SERVICE_COMPONENT_MEMORY
  • M_SERVICE_MEMORY
  • M_SERVICE_REPLICATION
  • M_WORKLOAD
  • _SYS_STATISTICS 스키마의 STATISTICS_CURRENT_ALERTS

Monitoring으로 측정항목이 전송되지 않음

호스트 VM에서 로그 파일 /var/log/google-saphanamonitoring-agent.log의 오류 메시지를 확인합니다.

에이전트에서 호스트 VM의 서비스 계정을 사용하지 않는 경우 JSON 서비스 계정 키의 경로가 configuration.yaml 파일의 service_account_json 속성에 올바르게 지정되어 있는지 확인합니다.

IAM 및 관리자 홈페이지에서 에이전트가 사용 중인 서비스 계정에 Monitoring Metric Writer 역할(roles/monitoring.metricWriter)이 있는지 확인합니다. 자세한 내용은 필수 IAM 역할 설정을 참조하세요.

지원

Google Cloud 인프라 또는 서비스 관련 문제인 경우 Google Cloud 지원에 문의하세요. Google Cloud Console의 지원 개요 페이지에서 연락처 정보를 확인할 수 있습니다. Google Cloud 지원에서 SAP 시스템에 문제가 있다고 판단하면 SAP 지원으로 지원을 요청하세요.

SAP 제품 관련 문제가 발생하면 SAP 지원으로 지원을 요청하세요. SAP가 지원 티켓을 평가한 후 Google Cloud 인프라 문제로 판단되면 해당 티켓을 Google Cloud 구성요소 BC-OP-LNX-GOOGLE 또는 BC-OP-NT-GOOGLE로 전송합니다.

지원 요구사항

SAP 시스템과 사용 중인 Google Cloud 인프라 및 서비스에 대한 지원을 받으려면 최소 지원 요금제 요구사항을 충족해야 합니다.

Google Cloud 기반 SAP에 대한 최소 지원 요구사항에 대한 자세한 내용은 다음을 참조하세요.

다음 단계