SAP HANA

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

SAP HANA 통합은 SAP HANA 측정항목 및 로그를 수집합니다. 측정항목은 관련 모니터링 뷰를 쿼리하여 수집됩니다. 이 통합은 구조화된 trace 로그를 작성합니다.

HANA에 대한 자세한 내용은 SAP HANA 문서를 참조하세요.

기본 요건

HANA 원격 분석을 수집하려면 운영 에이전트 버전 2.18.1 이상을 설치해야 합니다.

이 통합은 HANA 버전 2.0을 지원합니다.

HANA 인스턴스 구성

측정항목을 수집하려면 모니터링 사용자에게 관련 모니터링 뷰에 대한 SELECT 액세스가 필요합니다. 다음 SQL 스크립트는 모니터링 역할을 만들고 SAP HANA 인스턴스에 연결된 충분한 권한이 있는 사용자가 실행하는 경우 모니터링 사용자에게 적용합니다.

--Create the user
CREATE RESTRICTED USER otel_monitoring_user PASSWORD ;
--Enable user login
ALTER USER otel_monitoring_user ENABLE CLIENT CONNECT;
--Create the monitoring role
CREATE ROLE OTEL_MONITORING;
--Grant permissions to the relevant views
GRANT CATALOG READ TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_BACKUP_CATALOG TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_BLOCKED_TRANSACTIONS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_CONNECTIONS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_CS_ALL_COLUMNS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_CS_TABLES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_DATABASE TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_DISKS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_HOST_RESOURCE_UTILIZATION TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_LICENSES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_RS_TABLES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_COMPONENT_MEMORY TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_MEMORY TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_REPLICATION TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_STATISTICS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICE_THREADS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_SERVICES TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_VOLUME_IO_TOTAL_STATISTICS TO OTEL_MONITORING;
GRANT SELECT ON SYS.M_WORKLOAD TO OTEL_MONITORING;
GRANT SELECT ON _SYS_STATISTICS.STATISTICS_CURRENT_ALERTS TO OTEL_MONITORING;
--Add the OTEL_MONITOR role to the monitoring user
GRANT OTEL_MONITORING TO otel_monitoring_user;

HANA용 운영 에이전트 구성

작업 에이전트 구성 가이드를 수행하여 HANA 인스턴스에서 원격 분석을 수집하는 데 필요한 요소를 추가하고 에이전트를 다시 시작합니다.

구성 예시

다음 명령어는 HANA용 원격 분석을 수집하고 처리하는 구성을 만들고 작업 에이전트를 다시 시작합니다.

# Configures Ops Agent to collect telemetry from the app and restart Ops Agent.

set -e

sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
logging:
  receivers:
    saphana:
      type: saphana
      include_paths:
      - /usr/sap/*/HDB*/saphanamon/trace/*.trc
      exclude_paths:
      - /usr/sap/*/HDB*/saphanamon/trace/nameserver_history*.trc
      - /usr/sap/*/HDB*/saphanamon/trace/nameserver*loads*.trc
      - /usr/sap/*/HDB*/saphanamon/trace/nameserver*executed_statements*.trc
  service:
    pipelines:
      saphana:
        receivers:
          - saphana
metrics:
  receivers:
    saphana:
      type: saphana
      username: SYSTEM
      password: G00g3l21
      endpoint: localhost:30015
  service:
    pipelines:
      saphana:
        receivers:
          - saphana
EOF

sudo service google-cloud-ops-agent restart

로그 수집 구성

HANA에서 로그를 수집하려면 HANA에서 생성하는 로그의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다.

saphana 로그의 수신자를 구성하려면 다음 필드를 지정합니다.

필드 기본값 설명
exclude_paths [/usr/sap/*/HDB*/${HOSTNAME}/trace/nameserver_history*.trc, /usr/sap/*/HDB*/${HOSTNAME}/trace/nameserver*loads*.trc, /usr/sap/*/HDB*/${HOSTNAME}/trace/nameserver*executed_statements*.trc] include_paths 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.
include_paths [/usr/sap/*/HDB*/${HOSTNAME}/trace/*.trc] 각 파일을 테일링하여 읽을 파일 시스템 경로의 목록입니다. 와일드 카드(*)를 경로에 사용할 수 있습니다.
record_log_file_path false true로 설정된 경우 로그 레코드를 가져온 특정 파일의 경로가 출력 로그 항목에 agent.googleapis.com/log_file_path 라벨 값으로 표시됩니다. 와일드 카드를 사용할 경우 레코드를 가져온 파일의 경로만 기록됩니다.
type 값은 saphana.여야 합니다.
wildcard_refresh_interval 60s include_paths의 와일드 카드 파일 경로가 새로 고쳐지는 간격입니다. 기간(예: 30s 또는 2m)으로 지정됩니다. 이 속성은 로그 파일이 기본 간격보다 빠르게 순환되는 높은 로깅 처리량에서 유용할 수 있습니다.

로깅되는 내용

logName은 구성에 지정된 수신자 ID에서 파생됩니다. LogEntry 내의 자세한 필드는 다음과 같습니다.

saphana 로그에는 LogEntry의 다음 필드가 포함됩니다.

필드 유형 설명
jsonPayload.component 문자열 SAP HANA 구성요소
jsonPayload.thread_id 숫자 메시지를 로깅하는 스레드의 ID
jsonPayload.connection_id 숫자 메시지가 연결 범위 내에서 로깅된 경우 메시지가 시작된 연결의 ID
jsonPayload.transaction_id 숫자 메시지가 트랜잭션 범위 내에서 로깅된 경우 메시지가 시작된 트랜잭션의 ID
jsonPayload.update_transaction_id 숫자 메시지가 업데이트 트랜잭션 범위 내에서 로깅된 경우 메시지가 시작된 업데이트 트랜잭션의 ID
jsonPayload.message 문자열 로그 메시지
sourceLocation.file 문자열 소스 파일 이름
sourceLocation.line 숫자 소스 파일 내 줄

측정항목 수집 구성

HANA에서 측정항목을 수집하려면 HANA에서 생성하는 측정항목의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다.

saphana 측정항목의 수신자를 구성하려면 다음 필드를 지정합니다.

필드 기본값 설명
ca_file CA 인증서의 경로입니다. 클라이언트로서 서버 인증서를 확인합니다. 비어있으면 수신자는 시스템 루트 CA를 사용합니다.
cert_file mTLS 필수 연결에 사용할 TLS 인증서의 경로입니다.
collection_interval 60s time.Duration 값(예: 30s 또는 5m)입니다.
endpoint localhost:30015 saphana 인스턴스에 연결하는 데 사용되는 호스트 이름:포트입니다.
insecure true 보안 TLS 연결을 사용할지 여부를 설정합니다. false로 설정하면 TLS가 사용 설정됩니다.
insecure_skip_verify false 인증서 확인을 건너뛸지 여부를 설정합니다. insecure이 true로 설정된 경우 insecure_skip_verify value 값이 사용되지 않습니다.
key_file mTLS 필수 연결에 사용할 TLS 키의 경로입니다.
password 인스턴스 연결에 사용되는 비밀번호입니다.
type 값은 saphana여야 합니다.
username 인스턴스 연결에 사용되는 시용자 이름입니다.

모니터링 대상

다음 표에서는 작업 에이전트가 HANA 인스턴스에서 수집하는 측정항목 목록을 보여줍니다.

측정항목 유형
종류, 유형
모니터링 리소스		 라벨
workload.googleapis.com/saphana.alert.count
GAUGE, INT64
gce_instance 		rating
workload.googleapis.com/saphana.backup.latest
GAUGE, INT64
gce_instance 		 
workload.googleapis.com/saphana.column.memory.used
GAUGE, INT64
gce_instance 		host
subtype
type
workload.googleapis.com/saphana.component.memory.used
GAUGE, INT64
gce_instance 		component
host
workload.googleapis.com/saphana.connection.count
GAUGE, INT64
gce_instance 		host
status
workload.googleapis.com/saphana.cpu.used
CUMULATIVE, INT64
gce_instance 		host
type
workload.googleapis.com/saphana.disk.size.current
GAUGE, INT64
gce_instance 		host
path
state
usage_type
workload.googleapis.com/saphana.host.memory.current
GAUGE, INT64
gce_instance 		host
state
workload.googleapis.com/saphana.host.swap.current
GAUGE, INT64
gce_instance 		host
state
workload.googleapis.com/saphana.instance.code_size
GAUGE, INT64
gce_instance 		host
workload.googleapis.com/saphana.instance.memory.current
GAUGE, INT64
gce_instance 		host
state
workload.googleapis.com/saphana.instance.memory.shared.allocated
GAUGE, INT64
gce_instance 		host
workload.googleapis.com/saphana.instance.memory.used.peak
GAUGE, INT64
gce_instance 		host
workload.googleapis.com/saphana.license.expiration.time
GAUGE, INT64
gce_instance 		product
system
workload.googleapis.com/saphana.license.limit
GAUGE, INT64
gce_instance 		product
system
workload.googleapis.com/saphana.license.peak
GAUGE, INT64
gce_instance 		product
system
workload.googleapis.com/saphana.network.request.average_time
GAUGE, DOUBLE
gce_instance 		host
workload.googleapis.com/saphana.network.request.count
GAUGE, INT64
gce_instance 		host
state
workload.googleapis.com/saphana.network.request.finished.count
CUMULATIVE, INT64
gce_instance 		host
type
workload.googleapis.com/saphana.replication.average_time
GAUGE, DOUBLE
gce_instance 		mode
port
primary
secondary
workload.googleapis.com/saphana.replication.backlog.size
GAUGE, INT64
gce_instance 		mode
port
primary
secondary
workload.googleapis.com/saphana.replication.backlog.time
GAUGE, INT64
gce_instance 		mode
port
primary
secondary
workload.googleapis.com/saphana.row_store.memory.used
GAUGE, INT64
gce_instance 		host
type
workload.googleapis.com/saphana.schema.memory.used.current
GAUGE, INT64
gce_instance 		host
schema
type
workload.googleapis.com/saphana.schema.memory.used.max
GAUGE, INT64
gce_instance 		host
schema
workload.googleapis.com/saphana.schema.operation.count
CUMULATIVE, INT64
gce_instance 		host
schema
type
workload.googleapis.com/saphana.schema.record.compressed.count
GAUGE, INT64
gce_instance 		host
schema
workload.googleapis.com/saphana.schema.record.count
GAUGE, INT64
gce_instance 		host
schema
type
workload.googleapis.com/saphana.service.code_size
GAUGE, INT64
gce_instance 		host
service
workload.googleapis.com/saphana.service.count
GAUGE, INT64
gce_instance 		host
status
workload.googleapis.com/saphana.service.memory.compactors.allocated
GAUGE, INT64
gce_instance 		host
service
workload.googleapis.com/saphana.service.memory.compactors.freeable
GAUGE, INT64
gce_instance 		host
service
workload.googleapis.com/saphana.service.memory.effective_limit
GAUGE, INT64
gce_instance 		host
service
workload.googleapis.com/saphana.service.memory.heap.current
GAUGE, INT64
gce_instance 		host
service
state
workload.googleapis.com/saphana.service.memory.limit
GAUGE, INT64
gce_instance 		host
service
workload.googleapis.com/saphana.service.memory.shared.current
GAUGE, INT64
gce_instance 		host
service
state
workload.googleapis.com/saphana.service.memory.used
GAUGE, INT64
gce_instance 		host
service
type
workload.googleapis.com/saphana.service.stack_size
GAUGE, INT64
gce_instance 		host
service
workload.googleapis.com/saphana.service.thread.count
GAUGE, INT64
gce_instance 		host
status
workload.googleapis.com/saphana.transaction.blocked
GAUGE, INT64
gce_instance 		host
workload.googleapis.com/saphana.transaction.count
CUMULATIVE, INT64
gce_instance 		host
type
workload.googleapis.com/saphana.volume.operation.count
CUMULATIVE, INT64
gce_instance 		host
path
type
usage_type
workload.googleapis.com/saphana.volume.operation.size
CUMULATIVE, INT64
gce_instance 		host
path
type
usage_type
workload.googleapis.com/saphana.volume.operation.time
CUMULATIVE, INT64
gce_instance 		host
path
type
usage_type

샘플 대시보드

HANA 측정항목을 보려면 차트 또는 대시보드가 구성되어 있어야 합니다. Cloud Monitoring은 사전 구성된 차트가 포함된 통합용 샘플 대시보드 라이브러리를 제공합니다. 이러한 대시보드 설치에 대한 자세한 내용은 샘플 대시보드 설치를 참조하세요.

구성 확인

이 섹션에서는 HANA 수신자를 올바르게 구성했는지 확인하는 방법을 설명합니다. 작업 에이전트에서 원격 분석 수집을 시작하려면 1~2분 정도 걸릴 수 있습니다.

로그가 수집되었는지 확인하려면 로그 탐색기로 이동하고 다음 쿼리를 실행하여 HANA 로그를 확인합니다.

resource.type="gce_instance"
log_id("saphana")

측정항목이 수집되었는지 확인하려면 측정항목 탐색기로 이동하고 MQL 탭에서 다음 쿼리를 실행합니다.

fetch gce_instance
| metric 'workload.googleapis.com/saphana.connection.count'
| every 1m

다음 단계

Ansible을 사용하여 운영 에이전트를 설치하고, 타사 애플리케이션을 구성하고, 샘플 대시보드를 설치하는 방법은 운영 에이전트를 설치하여 타사 애플리케이션 문제 해결 동영상을 참조하세요.