이 페이지는 Cloud Translation API를 통해 번역되었습니다.

SAP HANA용 모니터링 에이전트 V2.0 계획 가이드

SAP HANA용 Google Cloud 모니터링 에이전트를 사용하면 Cloud Monitoring을 사용하여 Google Cloud 콘솔에 SAP HANA 시스템 측정항목을 표시할 수 있습니다. 에이전트는 호스트 머신에서 systemd 서비스로 실행됩니다.

측정항목을 수집하기 위해 SAP HANA용 모니터링 에이전트는 SAP HANA SQL 및 시스템 뷰 참조에서 SAP에서 정의한 SQL 문법 및 시스템 뷰를 사용하여 SAP HANA를 쿼리합니다.

SAP HANA 메모리 사용률 측정항목을 사용하여 용량을 계획하거나 메모리 기반 SAP HANA 라이선스를 관리할 수 있습니다. SAP HANA 측정항목과 Compute Engine 측정항목을 연관시켜 사용량 및 성능 트렌드를 파악할 수 있습니다.

SAP HANA 설치에 대해 더 자세히 알아보려면 커스텀 쿼리를 정의하여 추가 측정항목을 캡처하면 됩니다.

Cloud Monitoring을 사용하면 대시보드를 만들어 SAP HANA 측정항목을 시각화하고 측정항목 기준을 토대로 알림을 설정할 수 있습니다. 대시보드 및 알림을 설정하는 방법에 대한 자세한 내용은 Cloud Monitoring 문서를 참조하세요.

측정항목에 대한 Cloud Monitoring 가격 책정

SAP HANA용 모니터링 에이전트가 수집하여 Monitoring으로 전송하는 측정항목은 Monitoring에서 청구 가능한 측정항목으로 분류됩니다. Monitoring은 수집된 볼륨을 기준으로 청구 가능한 측정항목 가격을 책정합니다.

SAP HANA용 모니터링 에이전트가 측정항목에 대해 SAP HANA를 쿼리하는 빈도를 결정하는 쿼리 샘플링 간격은 Monitoring으로 전송되는 측정항목 볼륨에 영향을 줍니다.

Monitoring 가격 책정에 대한 자세한 내용은 Google Cloud Observability 가격 책정을 참조하세요.

쿼리 샘플링 간격에 대한 자세한 내용은 쿼리 샘플 간격을 참조하세요.

쿼리: 기본값 및 커스텀

SAP HANA용 모니터링 에이전트는 SQL 쿼리를 사용하여 SAP HANA에서 측정항목을 수집합니다. 에이전트에 기본 쿼리 집합이 포함되어 있으며 커스텀 쿼리를 추가할 수 있습니다.

기본 쿼리와 커스텀 쿼리는 모두 SAP HANA SQL 및 시스템 뷰 참조에 설명된 SAP HANA 시스템 뷰에서 정의한 측정항목을 검색합니다.

기본 쿼리 유형

기본 쿼리는 가장 일반적으로 사용되는 SAP HANA 측정항목을 수집하는 기본 제공 쿼리입니다.

기본 쿼리의 빈도는 configuration.yaml 파일 시작 부분의 전역 sample_interval 속성에 따라 결정됩니다. 기본적으로 이 값은 300초(5분)로 설정됩니다. 이 전역 기본값을 수정할 수 있습니다. 커스텀 쿼리와 달리 개별 기본 쿼리에는 샘플링 간격을 설정할 수 없습니다.

기본 쿼리를 수정할 수는 없지만 에이전트 구성 파일인 configuration.yaml에서 필요 없는 기본 쿼리를 사용 중지할 수 있습니다.

기본 쿼리, 쿼리가 수집하는 측정항목, 쿼리가 사용하는 기본 SQL 문에 대한 자세한 내용은 기본 쿼리 참조를 참조하세요.

커스텀 쿼리 유형

SAP HANA용 모니터링 에이전트의 configuration.yaml 파일에 커스텀 쿼리를 정의하여 만들 수 있습니다.

커스텀 쿼리의 경우 모든 쿼리의 기본 샘플 간격을 재정의하는 각 쿼리에 _sample_interval_을 지정할 수 있습니다. 자세한 내용은 쿼리 샘플 간격을 참조하세요.

configuration.yaml 파일에는 기본적으로 사용 중지된 두 가지 커스텀 쿼리가 포함되어 있습니다. 제공된 커스텀 쿼리를 자체 커스텀 쿼리의 모델로 사용할 수 있습니다. 커스텀 쿼리 예시는 아래의 커스텀 쿼리 예시를 참조하세요.

커스텀 쿼리 오류 처리

에이전트는 SAP HANA에 쿼리를 제출하기 전에 커스텀 쿼리에서 SQL의 유효성을 검사하지 않습니다.

커스텀 쿼리가 SQL 예외와 함께 실패하거나 쿼리의 구성된 열이 SAP HANA에서 반환된 결과와 일치하지 않으면 에이전트가 로그에 오류를 작성합니다. 두 경우 모두 에이전트는 커스텀 쿼리가 수정될 때까지 커스텀 쿼리를 계속 실행하고 오류 메시지를 로그에 작성합니다.

커스텀 쿼리에 필요한 SQL 문법에 대한 자세한 내용은 SAP HANA SQL 및 시스템 뷰 참조를 참조하세요.

쿼리 샘플 간격

모든 쿼리에 전역 샘플 간격을 정의하고 커스텀 쿼리의 개별 샘플 간격을 정의할 수 있습니다. 샘플 간격은 모니터링 에이전트가 SAP HANA에 대해 측정항목을 쿼리하는 빈도를 결정합니다.

모든 쿼리의 기본 샘플 간격은 300초(5분)입니다. configuration.yaml 파일 시작 부분의 sample_interval 속성에 다른 값을 지정하여 기본 샘플 간격을 조정할 수 있습니다.

쿼리 정의에서 sample_interval 속성을 지정하여 개별 커스텀 쿼리의 기본 샘플 간격을 재정의할 수 있습니다.

설치 아키텍처

Compute Engine VM 또는 베어메탈 솔루션 서버에 SAP HANA용 Monitoring 에이전트를 설치합니다.

SAP HANA와 동일한 호스트 또는 다른 호스트에 에이전트를 설치할 수 있습니다.

호스트가 적절하게 구성된 서비스 계정으로 Google Cloud API에 액세스할 수 있는 한 이 에이전트가 온프레미스 호스트 또는 다른 클라우드 플랫폼의 호스트에서 실행되는 SAP HANA 인스턴스를 모니터링할 수도 있습니다.

중앙 Compute Engine VM에서 원격 수집

다음 다이어그램은 SAP HANA 인스턴스를 실행하는 VM 또는 서버와 다른 호스트 VM에 에이전트가 설치되는 설치 아키텍처를 보여줍니다.

HANA 모니터링 에이전트 설정 1

Compute Engine VM 및 베어메탈 솔루션 서버의 로컬 컬렉션

방화벽 규칙으로 환경 액세스가 제한될 경우 동일한 Compute Engine VM 또는 베어메탈 솔루션 서버에 SAP HANA 인스턴스와 함께 에이전트를 설치할 수 있습니다.

다음 다이어그램은 에이전트가 Compute Engine VM 및 베어메탈 솔루션 서버에 개별적으로 설치되는 설치 아키텍처를 보여줍니다.

HANA 모니터링 에이전트 설정 2

하이브리드 컬렉션 아키텍처

SAP HANA 인스턴스와 동일한 호스트 VM에 에이전트를 설치하고 베어메탈 솔루션 서버에서 SAP HANA 인스턴스를 모니터링하도록 에이전트를 구성할 수 있습니다.

HANA 모니터링 에이전트 설정 3

여러 Google Cloud 프로젝트에서 SAP HANA 인스턴스를 모니터링하는 경우, 모니터링하는 SAP HANA 인스턴스가 포함된 각 Google Cloud 프로젝트에 SAP HANA용 모니터링 에이전트를 최소 한 개 이상 설치해야 합니다.

SAP HANA용 모니터링 에이전트의 고가용성 구성

고가용성 클러스터에서 SAP HANA 인스턴스를 모니터링하는 경우 에이전트가 장애 조치의 영향을 받지 않도록 클러스터의 노드가 아닌 호스트에 에이전트를 설치합니다.

구성 파일 configuration.yaml에서는 유동 IP 주소에 대해 모니터링을 구성하는 것이 좋습니다. 이 구성을 사용하면 현재 활성 노드의 측정항목만 수집됩니다.

HANA 모니터링 에이전트 설정 4

지원되는 운영체제

SAP HANA용 모니터링 에이전트는 다음 운영체제의 일반 및 SAP 제품을 모두 지원합니다.

Red Hat Enterprise Linux(RHEL) 7, 8, 9 ^참고
SUSE Linux Enterprise Server(SLES) 12, 15

참고: RHEL for SAP 9.x에 SAP 소프트웨어를 설치하기 전에 호스트 머신, 특히 chkconfig 및 compat-openssl11에 추가 패키지를 설치해야 합니다. Compute Engine에서 제공하는 이미지를 사용하는 경우에는 이러한 패키지가 자동으로 설치됩니다. SAP의 자세한 내용은 SAP Note 3108316 - Red Hat Enterprise Linux 9.x: 설치 및 구성을 참조하세요.

인증 및 액세스

SAP HANA용 모니터링 에이전트에는 Google Cloud 인증 및 Google Cloud 리소스에 대한 액세스 권한을 위해 Identity and Access Management(IAM) 서비스 계정이 필요합니다.

서비스 계정에 할당된 IAM 역할은 에이전트가 상호작용할 수 있는 Google Cloud 리소스를 결정합니다.

기존 또는 기본 서비스 계정을 사용하지 않는 한, Google Cloud 프로젝트에서 서비스 계정을 만들고 서비스 계정에 역할을 한 개 이상 할당해야 합니다.

필요한 IAM 역할

새 서비스 계정, 기존 서비스 계정, 기본 서비스 계정 중 무엇을 사용하든 SAP HANA용 모니터링 에이전트에 필요한 권한을 부여하는 역할이 서비스 계정에 포함되어야 합니다.

사전 정의된 IAM 모니터링 측정항목 작성자 역할(roles/monitoring.metricWriter)은 Monitoring에 측정항목을 작성할 수 있는 권한을 부여합니다.

Secret Manager를 사용하여 비밀번호를 저장하는 경우 다음이 필요합니다.

Secret Manager에 저장된 보안 비밀에 대한 액세스 권한을 부여하는 사전 정의된 역할인 Secret Manager 보안 비밀 접근자(roles/secretmanager.secretAccessor)가 서비스 계정에 포함되어야 합니다.
VM 인스턴스에 Secret Manager API에 대한 액세스를 허용하는 cloud-platform 액세스 범위가 있어야 합니다. 자세한 내용은 Secret Manager API 액세스를 참조하세요.

서비스 계정 지정

에이전트가 Compute Engine VM에서 실행되는 경우 에이전트는 기본적으로 호스트 VM의 서비스 계정을 사용합니다. 구성 파일에서 서비스 계정을 지정할 필요가 없습니다.

일반적으로 호스트 VM 서비스 계정은 사용자 또는 동료가 만든 제한된 역할을 가진 서비스 계정이지만 기본적으로 광범위한 권한이 있는 Compute Engine 기본 서비스 계정이 될 수 있습니다.

호스트 VM 서비스 계정 이외의 서비스 계정을 사용해야 하거나 에이전트가 Compute Engine VM에서 실행되지 않는 경우 JSON 서비스 계정 키로 서비스 계정을 만들어야 합니다. JSON 키 파일을 액세스 가능한 위치에 저장하고 에이전트의 configuration.yaml 파일에 있는 service_account_json 속성에 JSON 파일 경로를 지정합니다.

서비스 계정, 역할, 권한에 대한 자세한 내용은 다음을 참조하세요.

Google Cloud API 액세스

에이전트가 Compute Engine VM에서 실행되지 않으면 Google Cloud API 연결을 설정해야 합니다. 자세한 내용은 온프레미스 호스트의 비공개 Google 액세스 구성을 참조하세요.

Cloud Monitoring의 SAP HANA 측정항목

SAP HANA용 모니터링 에이전트는 SAP HANA에서 검색하는 데이터를 커스텀 측정항목 데이터로 Monitoring에 전송합니다. 에이전트는 데이터 전송을 위해 Google Cloud 프로젝트를 만들 때 기본적으로 사용 설정되는 Cloud Monitoring API를 사용합니다.

Monitoring 개요는 Cloud Monitoring 소개를 참조하세요.

Cloud Monitoring에서 SAP HANA 데이터 찾기

SAP HANA의 측정항목 데이터는 Monitoring에서 수신하는 즉시 볼 수 있습니다.

Monitoring에서 SAP HANA 데이터를 보려면 대시보드 편집기 또는 측정항목 탐색기 도구를 사용하여 Google Cloud 콘솔에서 차트를 만들고 측정항목 필드에 sap_hana를 입력합니다. 그런 다음 sap_hana를 포함한 사용 가능한 모든 측정항목 유형의 드롭다운 목록에서 측정항목 유형별로 데이터를 선택할 수 있습니다.

Monitoring에서 특정 SAP HANA 인스턴스의 데이터만 표시하려면 예를 들어 SAP HANA 호스트 VM 이름(Monitoring에서 측정항목 라벨에 해당함)을 참조하세요.

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

GitHub의 SAP HANA용 대시보드 정의

GitHub에서 Google Cloud 프로젝트에 설치할 수 있는 SAP HANA의 커스텀 대시보드 정의를 찾을 수 있습니다. GitHub의 GoogleCloudPlatform/monitoring-dashboard-samples 저장소를 참조하세요. SAP HANA 대시보드 정의 파일, performance.json, README.md 파일은 /dashboards/sap-hana 하위 디렉터리에 있습니다.

SAP HANA용 커스텀 대시보드를 설치한 후 그대로 사용하거나 Google Cloud 콘솔에서 추가로 맞춤설정할 수 있습니다.

SAP HANA용 커스텀 대시보드를 설치하려면 설치 가능한 대시보드를 참조하세요.

알림

측정항목이 사용자가 정의한 기준에 도달하면 알림을 받도록 Monitoring에서 알림을 구성할 수 있습니다.

자세한 내용은 알림 소개를 참조하세요.

비밀번호 관리

기본적으로 SAP HANA용 모니터링 에이전트는 사전 정의된 SAP HANA SYSTEM 데이터베이스 사용자 계정을 사용하여 SAP HANA 측정항목을 쿼리합니다. 에이전트가 모니터링하는 각 SAP HANA 데이터베이스의 데이터베이스 사용자 계정에 비밀번호를 제공해야 합니다.

Google Cloud의 유료 서비스인 Secret Manager를 사용하면 SAP HANA용 모니터링 에이전트에 비밀번호를 안전하게 제공할 수 있습니다.

또는 configuration.yaml 파일에 있는 각 인스턴스 정의의 password 속성에 일반 텍스트로 데이터베이스 사용자 비밀번호를 지정할 수 있습니다.

Secret Manager 가격 책정에 대한 자세한 내용은 가격 책정을 참조하세요.

SSL/TLS 지원

SAP HANA 인스턴스가 전송 계층 보안(TLS)/보안 소켓 레이어(SSL) 프로토콜을 사용하여 SAP HANA SQL 인터페이스를 사용하는 클라이언트와 SAP HANA 데이터베이스 간의 통신을 보호하는 경우 enable_ssl: true 파일의 인스턴스 정의에 configuration.yaml를 지정하여 SAP HANA용 모니터링 에이전트에서 TLS/SSL 지원을 사용 설정하여야 합니다.

또한 SAP HANA가 인증서를 검증하도록 구성된 경우 에이전트가 인증서 검증을 지원하고 키 저장소 및 트러스트 저장소의 경로와 비밀번호를 지정하도록 구성할 수 있습니다.

SSL 및 인증서 확인을 위한 에이전트 구성 속성 설명은 구성 속성 설명을 참조하세요.

로깅

SAP HANA용 모니터링 에이전트를 처음 시작하면 에이전트가 로컬 호스트에 모든 로그 항목이 작성되는 로그 파일 /var/log/google-saphanamonitoring-agent.log를 만듭니다.

기본적으로 로그 파일이 10.5MB에 도달하면 이전 로그가 삭제되며 새 로그가 파일에 추가됩니다.

에이전트에 대한 로깅은 conf/logging.properties 파일로 구성됩니다.

지원

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

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

지원 요구사항

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

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

Google Cloud 기반 SAP 지원 받기
SAP Note 2456406 - SAP on Google Cloud Platform: Support Prerequisites(SAP 사용자 계정이 필요함)

커스텀 쿼리 정의

configuration.yaml 파일에서 커스텀 쿼리를 정의합니다.

커스텀 쿼리 정의는 쿼리 및 반환된 측정항목을 설명하는 속성 값과 SAP HANA에서 데이터를 검색하는 SQL 문으로 구성됩니다.

SAP HANA에서 쿼리에 사용할 수 있는 시스템 뷰의 전체 목록은 SAP HANA SQL 및 시스템 뷰 참조를 참조하세요.

커스텀 쿼리를 만들 때 Monitoring은 요약 또는 합산 데이터에 가장 적합하며 카디널리티가 높은 데이터 포인트를 저장하기 위한 것이 아님을 유의하세요. SUM, AVG, COUNT, MIN, MAX와 같은 SQL 집계 함수를 사용하여 반환되는 레코드 수를 제한합니다.

커스텀 쿼리의 예시는 커스텀 쿼리 예시를 참조하세요.

커스텀 쿼리 속성

다음 표에서는 커스텀 쿼리를 정의하는 데 사용하는 속성을 설명합니다.

속성	값	설명
`sample_interval`	Int	`configuration.yaml` 파일 맨 위 쿼리 간 기본 간격(초)을 정의합니다. 커스텀 쿼리의 정의에서 속성은 해당 쿼리의 샘플 간격만 정의하며 기본값은 재정의됩니다.
`query_timeout`	Int	쿼리가 실패하기 전에 쿼리 실행을 할 수 있는 시간(초)입니다. 기본값은 300초(5분)입니다.
`queries`	다음 속성 설명은 커스텀 쿼리에만 적용됩니다.
`- name`	문자열	쿼리 이름입니다.
`enabled`	불리언	에이전트가 쿼리를 SAP HANA에 제출할지 여부를 결정합니다. 유효한 값은 `true` 또는 `false`입니다.
`description`	문자열	쿼리가 검색하는 측정항목에 대한 설명입니다.
`sql`	문자열	에이전트가 SAP HANA에 발행하도록 지정하는 SQL 문입니다. SQL 문은 SAP가 정의한 SQL 문법을 준수해야 합니다. 자세한 내용은 SAP HANA SQL 및 시스템 뷰 참조를 참조하세요.
`columns`	각 열 정의는 Monitoring에서 처리할 측정항목을 설명합니다.
`- name`	문자열	Monitoring에서 측정항목 유형을 정의하는 측정항목 이름입니다.
`metric_type`	문자열	Monitoring에서 처리하는 경우 측정항목의 유형, GAUGE 또는 CUMULATIVE입니다.
`value_type`	문자열	Monitoring에서 처리하는 경우 측정항목의 데이터 유형, BOOL, INT64, DOUBLE입니다. 측정항목 유형에서 지원하는 데이터 유형을 지정합니다. 자세한 내용은 지원되는 조합을 참조하세요.
`description`	문자열	측정항목의 설명입니다.
`units`	문자열	측정항목 값이 보고되는 단위입니다. 자세한 내용은 `unit` 필드 문서를 참조하세요.

커스텀 쿼리 예시

다음 예시에서는 두 개의 커스텀 쿼리를 보여줍니다. 이러한 쿼리는 SAP HANA용 모니터링 에이전트를 설치할 때 /usr/sap/google-saphanamonitoring-agent/conf/ 디렉터리에 생성된 configuration.yaml 파일에도 포함됩니다. 예시 쿼리는 커스텀 쿼리의 모델로 사용됩니다.

- name: custom_memory_utilization
  enabled: false
  # sample_interval: 120
  description: |
    Custom Total memory utilization by services
  sql: |
    SELECT
           SUM(TOTAL_MEMORY_USED_SIZE) AS "mem_used",
           SUM(PHYSICAL_MEMORY_SIZE) AS "resident_mem_used"
    FROM M_SERVICE_MEMORY;
  columns:
  - name: mem_used
    metric_type: GAUGE
    value_type: INT64
    description: |
      Amount of memory from the memory pool.
    units: By
  - name: resident_mem_used
    metric_type: GAUGE
    value_type: INT64
    description: |
      Amount of memory used in total by all the services.
    units: By
- name: custom_total_memory_usage
  enabled: false
  # sample_interval: 120
  description: |
    Custom Amount of memory used in total by all column-tables
  sql: |
    SELECT
           SUM(MEMORY_SIZE_IN_TOTAL) AS "table_mem_used"
    FROM M_CS_TABLES;
  columns:
  - name: table_mem_used
    metric_type: GAUGE
    value_type: INT64
    description: |
      Amount of memory used in total (sum of memory size in the main, delta, and history
      parts) by all column-tables.
    units: By
# Add additional queries for custom metrics

기본 쿼리 참조

SAP HANA용 모니터링 에이전트의 기본 제공 쿼리는 SAP HANA에서 다음 정보를 검색합니다.

특정 기본 쿼리에서 제공하는 측정항목이 필요하지 않으면 configuration.yaml 파일에서 쿼리 이름 다음에 enabled: false를 지정하여 쿼리를 사용 중지할 수 있습니다.