SAP용 Google Cloud 에이전트를 사용하여 SAP HANA 모니터링

이 계획 가이드에서는 SAP용 Google Cloud 에이전트의 SAP HANA 모니터링 측정항목 수집 기능만을 집중적으로 다룹니다. 에이전트 및 모든 기능에 대한 자세한 내용은 SAP용 Google Cloud 에이전트 계획 가이드를 참조하세요.

Linux에서 SAP용 Google Cloud 에이전트는 SAP HANA 인스턴스 및 기본 인프라를 모니터링하는 데 도움이 될 수 있습니다. 이 에이전트는 Compute Engine 인스턴스 또는 베어메탈 솔루션 서버에 에이전트를 설치한 후 사용 설정할 수 있는 SAP HANA 모니터링 측정항목 컬렉션을 통해 제공됩니다.

SAP HANA 모니터링 측정항목 수집을 사용 설정하면 에이전트가 SAP HANA 인스턴스를 쿼리하고 수집된 측정항목을Cloud Monitoring에 전송합니다. Monitoring에서 대시보드를 사용하여 수집된 측정항목을 시각화할 수 있습니다. 또한 측정항목 기준점에 따라 Monitoring에서 알림을 설정할 수 있습니다. 대시보드 및 알림 만들기에 대한 자세한 내용은 Cloud Monitoring 문서를 참조하세요.

SAP HANA 모니터링 측정항목을 수집하도록 SAP용 Google Cloud 에이전트를 구성하는 방법에 대한 자세한 설명은 SAP HANA 모니터링 측정항목 수집 구성을 참조하세요.

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

에이전트가 SAP HANA 인스턴스에 측정항목을 쿼리하는 빈도를 결정하는 쿼리의 샘플링 간격은 Monitoring에 전송되는 측정항목의 볼륨에 영향을 줍니다. SAP HANA 모니터링 측정항목은 느리게 변경되는 측정항목으로, 일단 사용 설정되면 기본적으로 5분 간격으로 수집됩니다.

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

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

샘플 비용 예상

SAP용 Google Cloud 에이전트를 사용하여 SAP HANA 모니터링 측정항목을 수집하기 위한 샘플 예상 비용을 보려면 수집된 바이트별로 청구되는 측정항목 가격 책정 예시를 참조하세요.

쿼리 정보

SAP HANA 모니터링 측정항목 수집을 위해 SAP용 Google Cloud 에이전트는 SAP HANA 인스턴스에서 SQL 쿼리를 실행합니다. 이러한 쿼리의 구문은 SAP에서 SAP HANA SQL 및 시스템 뷰 참조에 정의되어 있습니다.

SAP용 Google Cloud 에이전트는 다음 유형의 쿼리를 지원합니다.

• 기본 검색어
• 맞춤 검색어

기본 검색어

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

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

기본 쿼리를 수정할 수는 없지만 필요하지 않은 기본 쿼리를 사용 중지하는 것은 가능합니다. 기본 쿼리를 사용 중지하는 방법은 SQL 쿼리 사용 중지를 참조하세요.

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

맞춤 검색어

SAP HANA 인스턴스에 대해 더 뛰어난 인사이트를 얻기 위해 SAP용 Google Cloud 에이전트를 사용하면 커스텀 쿼리를 정의하고 실행할 수 있습니다.

에이전트 구성 파일의 hana_monitoring_configuration 섹션 아래에 지정된 queries 섹션에서 커스텀 쿼리를 정의하세요.

각 커스텀 쿼리에 대해 기본 sample_interval_sec 매개변수를 재정의하는 sample_interval_sec 매개변수를 지정할 수 있습니다. 자세한 내용은 쿼리 샘플 간격을 참조하세요.

이 문서에 제공된 커스텀 쿼리 예시는 자체 쿼리를 작성하는 데 도움이 될 수 있습니다. 커스텀 쿼리를 만드는 방법에 대한 자세한 내용은 커스텀 쿼리 정의를 참조하세요.

쿼리 샘플 간격

SAP용 Google Cloud의 에이전트를 사용하는 SAP HANA 모니터링 측정항목 수집의 경우 모든 쿼리에 전역 sample interval_sec를 정의하고 각 커스텀 쿼리에 대한 개별 샘플 간격을 정의할 수 있습니다. 샘플 간격에 따라 에이전트가 SAP HANA 인스턴스에 측정항목을 쿼리하는 빈도가 결정됩니다.

모든 쿼리의 기본 샘플 간격은 300초(5분)입니다. 에이전트 구성 파일의 hana_monitoring_configuration 섹션 시작 부분에 sample_interval_sec 매개변수에 대해 다른 값을 지정하여 기본 샘플 간격을 조정할 수 있습니다.

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

설치 아키텍처

Compute Engine 인스턴스 또는 베어메탈 솔루션 서버에 SAP용 Google Cloud 에이전트를 설치할 수 있습니다.

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

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

중앙 Compute Engine 인스턴스에서 원격 수집

다음 다이어그램은 SAP HANA 인스턴스를 실행하는 Compute Engine 인스턴스 또는 베어메탈 솔루션 서버와 다른 Compute Engine 인스턴스에 에이전트가 설치되는 설치 아키텍처를 보여줍니다.

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

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

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

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

SAP HANA 인스턴스를 호스팅하는 Compute Engine 인스턴스에 에이전트를 설치하고 베어메탈 솔루션 서버에서 실행되는 SAP HANA 인스턴스를 모니터링하도록 에이전트를 구성할 수도 있습니다.

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

에이전트의 고가용성 구성

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

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

SSL/TLS 지원

SAP HANA 인스턴스가 SAP HANA 데이터베이스와 SAP HANA SQL 인터페이스를 사용하는 클라이언트 간의 통신을 위해 전송 계층 보안(TLS) 또는 보안 소켓 레이어(SSL) 프로토콜을 사용하는 경우 SAP용 Google Cloud 에이전트에서 TLS/SSL 지원을 사용 설정해야 합니다. 이렇게 하려면 이러한 모든 SAP HANA 인스턴스에 대해 SAP용 Google Cloud 에이전트의 구성 파일에 다음 매개변수를 지정해야 합니다.

• enable_ssl 매개변수를 지정하고 값을 true로 설정합니다.
• host_name_in_certificate 매개변수를 지정하고 TLS/SSL 인증서에 지정된 대로 호스트 이름을 해당 값으로 설정합니다.
• tls_root_ca_file 매개변수를 지정하고 TLS/SSL 인증서가 저장된 경로를 해당 값으로 설정합니다.

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

SSL과 관련된 에이전트 구성 매개변수에 대한 설명은 구성 매개변수를 참조하세요.

커스텀 쿼리 정의

SAP용 Google Cloud 에이전트를 사용하면 커스텀 쿼리를 정의하고 실행할 수 있습니다.

커스텀 쿼리에는 다음 세부정보가 포함됩니다.

• 쿼리를 설명하는 매개변수와 매개변수 값
• SAP HANA 인스턴스에서 데이터를 가져오는 SQL 문
• SQL 문이 반환하는 하나 이상의 측정항목

쿼리 매개변수에 대한 자세한 내용은 구성 매개변수를 참조하세요.

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

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

SAP용 Google Cloud 에이전트가 쿼리에서 열을 순서가 지정된 목록으로 취급하기 때문에 커스텀 쿼리를 정의하는 동안 다음 가이드라인을 준수해야 합니다.

• SQL 문이 쿼리 정의에 포함된 모든 열을 사용해야 합니다.
• SQL 문의 열 순서가 쿼리 정의의 열 순서와 일치해야 합니다.
• 커스텀 쿼리 예시에 언급된 대로 쿼리 블록 내에 enabled: true를 지정하여 커스텀 쿼리를 사용 설정했습니다.

예를 들어 custom_memory_utilization이라는 예제 커스텀 쿼리의 쿼리 정의를 볼 수 있습니다. 쿼리 정의에는 해당 순서로 mem_used 및 resident_mem_used 열이 포함됩니다. 이러한 열 순서는 sql 매개변수에 지정된 SQL 문의 열 순서와 일치합니다.

커스텀 쿼리 예시를 더 보려면 커스텀 쿼리 예시를 참조하세요.

커스텀 쿼리 예시

다음 예시에서는 두 개의 커스텀 쿼리를 보여줍니다. 자체 커스텀 쿼리를 만들 때 예시 쿼리를 모델로 사용할 수 있습니다.

{
  "name": "custom_memory_utilization",
  "enabled": true,
  "sql": "SELECT IFNULL(SUM(TOTAL_MEMORY_USED_SIZE), 0) AS mem_used, IFNULL(SUM(PHYSICAL_MEMORY_SIZE), 0) AS resident_mem_used FROM M_SERVICE_MEMORY;",
  "columns": [
    {
      "name": "mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    },
    {
      "name": "resident_mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    }
  ]
}
{
  "name": "custom_total_memory_usage",
  "enabled": true,
  "sql": "SELECT IFNULL(SUM(MEMORY_SIZE_IN_TOTAL), 0) AS table_mem_used FROM M_CS_TABLES;",
  "columns": [
    {
      "name": "table_mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    }
  ]
}

커스텀 쿼리 오류 처리

SAP용 Google Cloud 에이전트는 쿼리를 SAP HANA 인스턴스에 제출하기 전 커스텀 쿼리의 SQL을 검증하지 않습니다.

커스텀 쿼리가 SQL 예외와 함께 실패하거나 쿼리의 구성된 열이 SAP HANA에서 반환된 결과와 일치하지 않으면 에이전트가 로그에 오류를 작성합니다. 두 경우 모두 에이전트는 에이전트의 쿼리 실행이 중지된 후 실패가 두 번 연속 발생하기 전까지 계속해서 커스텀 쿼리를 실행하고 로그에 오류 메시지를 기록합니다. 이러한 커스텀 쿼리 실행을 재개하려면 에이전트를 다시 시작해야 합니다.

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

SAP HANA 모니터링 측정항목

다음 표에서는 SAP용 Google Cloud 에이전트가 수집할 수 있는 기본 제공 또는 기본 SAP HANA 모니터링 측정항목에 대해 설명합니다. 이 테이블의 측정항목 문자열에는 workload.googleapis.com/을 프리픽스로 추가해야 합니다. 다음 표에서는 항목에 이 프리픽스가 생략되어 있습니다.

Monitoring에서 측정항목 보기

Google Cloud는 SAP용 Google Cloud 에이전트가 수집한 SAP HANA 모니터링 측정항목을 시각화하는 데 도움이 되는 커스텀 대시보드를 제공합니다. GitHub의 GoogleCloudPlatform/monitoring-dashboard-samples 저장소에서 dashboards/google-cloud-agent-for-sap 디렉터리를 확인하세요.

설치 안내를 포함하여 이러한 대시보드에 대한 자세한 내용은 수집된 측정항목 보기를 참조하세요.

모니터링에서 측정항목 데이터를 찾고 알림을 구성하는 방법에 대한 자세한 내용은 모니터링의 측정항목을 참조하세요.

기본 쿼리 참조

SAP용 Google Cloud 에이전트의 기본 제공되는 기본 쿼리는 SAP HANA에서 다음 정보를 반환합니다.

특정 기본 제공되는 또는 기본 쿼리에서 제공된 측정항목이 필요하지 않으면 이를 사용 중지할 수 있습니다. 자세한 내용은 해당 가이드를 참조하세요.

• Compute Engine 인스턴스의 경우 쿼리 사용 중지를 참고하세요.
• 베어메탈 솔루션 서버에 대해서는 쿼리 사용 중지를 참조하세요.

column_queries

기본 제공 쿼리 column_queries는 SAP HANA M_CS_ALL_COLUMNS 시스템 뷰에서 열별 메모리 사용량 정보를 반환합니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

component_queries

기본 제공 쿼리 component_queries는 SAP HANA에서 논리 구성요소의 서비스별 메모리 사용량을 반환합니다. 쿼리는 SAP HANA M_SERVICE_COMPONENT_MEMORY 시스템 뷰를 사용합니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

connection_query

기본 제공 쿼리 connection_query는 SAP HANA M_CONNECTIONS 시스템 뷰를 사용하여 SAP HANA에서 실행 중이거나 유휴 상태인 연결 수를 반환합니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

cpu_queries

기본 제공 쿼리 cpu_queries는 SAP HANA M_HOST_RESOURCE_UTILIZATION 시스템 뷰를 사용하여 SAP HANA에서 CPU 사용량 정보를 반환합니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

alert_query

기본 쿼리 alert_query는 _SYS_STATISTICS 스키마의 SAP HANA STATISTICS_CURRENT_ALERTS 뷰를 사용하여 SAP HANA 통계 서버에서 현재 알림의 수와 등급을 반환합니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

host_queries

기본 제공 쿼리 host_queries는 SAP HANA에서 호스트의 메모리 사용량을 반환합니다. 쿼리는 SAP HANA M_HOST_RESOURCE_UTILIZATION 시스템 뷰를 사용합니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

replication_query

기본 제공되는 쿼리 replication_query는 고가용성 클러스터를 실행하는 SAP HANA에서 복제 지연 시간 정보를 반환합니다. 이 쿼리는 SAP HANA 시스템 뷰 M_SERVICE_REPLICATION을 사용합니다. SAP HANA 배포가 단일 노드에서만 실행되는 경우 이 쿼리가 측정항목을 반환하지 않습니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

rowstore_query

기본 쿼리 rowstore_query는 SAP HANA M_RS_TABLES 시스템 뷰를 사용하여 SAP HANA에서 rowstore 크기를 반환합니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

schema_type_queries

기본 제공 쿼리 schema_type_queries는 SAP HANA M_CS_TABLES 시스템 뷰를 사용하여 SAP HANA에서 메모리 사용량 및 레코드 수 정보를 반환합니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

schema_queries

기본 쿼리 schema_queries는 SAP HANA M_CS_TABLES 시스템 뷰를 사용하여 SAP HANA에서 스키마 사용량 정보를 반환합니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

service_queries

기본 제공 쿼리 service_queries는 서비스에서 사용하는 메모리에 대한 정보를 SAP HANA에서 반환합니다. 쿼리는 SAP HANA M_SERVICE_MEMORY 시스템 뷰를 사용합니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

transaction_query

기본 제공 쿼리 transaction_query는 SAP HANA M_WORKLOAD 시스템 뷰를 사용하여 SAP HANA에서 총 트랜잭션 수(업데이트, 커밋, 롤백)를 반환합니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

blocked_transaction_query

기본 제공 쿼리 blocked_transaction_query는 SAP HANA M_DATABASES, M_SERVICES, M_BLOCKED_TRANSACTIONS 시스템 뷰를 사용하여 SAP HANA에서 차단된 트랜잭션 총개수를 반환합니다.

이 쿼리는 에이전트 버전 3.5부터 지원됩니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

data_backup_state_query

기본 제공 쿼리 data_backup_state_query는 SAP HANA M_BACKUP_CATALOG 시스템 뷰를 사용하여 SAP HANA에서 마지막으로 완료된 데이터 백업의 최신 상태를 반환합니다.

이 쿼리는 에이전트 버전 3.5부터 지원됩니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

log_backup_state_query

기본 제공 쿼리 log_backup_state_query는 SAP HANA M_BACKUP_CATALOG 시스템 뷰를 사용하여 SAP HANA에서 차단된 트랜잭션 총개수를 반환합니다.

이 쿼리는 에이전트 버전 3.5부터 지원됩니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

memory_unloads_query

기본 제공 쿼리 memory_unloads_query는 메모리 부족으로 인해 SAP HANA에서 발생하는 테이블 언로드 총개수를 반환합니다. 이 쿼리는 SAP HANA M_CS_UNLOADS 시스템 뷰를 사용합니다.

이 쿼리는 에이전트 버전 3.5부터 지원됩니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

avg_write_time_queries

기본 제공 쿼리 avg_write_time_queries는 SAP HANA M_VOLUMES 및 M_VOLUME_IO_DETAILED_STATISTICS 시스템 뷰를 사용하여 SAP HANA에서 데이터 및 로그 볼륨의 평균 쓰기 시간을 반환합니다.

이 쿼리는 에이전트 버전 3.5부터 지원됩니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

avg_read_time_queries

기본 제공 쿼리 avg_read_time_queries는 SAP HANA M_VOLUMES 및 M_VOLUME_IO_DETAILED_STATISTICS 시스템 뷰를 사용하여 SAP HANA에서 데이터 볼륨의 평균 읽기 시간을 반환합니다.

이 쿼리는 에이전트 버전 3.5부터 지원됩니다.

쿼리는 다음 측정항목을 Monitoring으로 전송합니다.

data_snapshot_state_queries

기본 제공 쿼리 data_snapshot_state_queries는 SAP HANA M_BACKUP_CATALOG 시스템 뷰를 사용하여 SAP HANA에서 마지막으로 완료된 디스크 스냅샷 기반 데이터 백업의 상태를 반환합니다.

이 쿼리는 에이전트 버전 3.6부터 지원됩니다.

이 쿼리는 다음 측정항목을 Monitoring으로 전송합니다.