측정항목 수집을 위해 SAP용 에이전트 구성

Google Cloud의 SAP용 에이전트는 Compute Engine 인스턴스에서 실행되는 SAP 워크로드 모니터링을 지원하며 Google Cloud에서 SAP 시스템을 효율적으로 실행하는 데 도움이 됩니다. SAP 시스템을 실행하는 모든 VM에 Google Cloud의 SAP용 에이전트를 설치해야 합니다. 이 에이전트는 SAP에서 지정한 대로 필요한 모든 정보를 수집하고 SAP 호스트 에이전트로 전송합니다. 자세한 내용은 SAP Note 2469354를 참고하세요.

관측 가능성에 사용되는 기본 인프라 및 애플리케이션 측정항목을 수집하려면 SAP용 에이전트에 추가 기능을 사용 설정해야 합니다.

이 문서에서는 SAP용 Agent에서 이러한 기능을 사용 설정하는 방법을 설명합니다.

SAP용 에이전트 체크리스트

다음 체크리스트에는 관측 가능성을 위해 SAP용 에이전트가 올바르게 설정되었는지 확인하기 위해 수행해야 하는 작업이 요약되어 있습니다.

SAP용 에이전트 설치 및 구성
모니터링하려는 각 Compute Engine VM에 Google Cloud의 SAP용 에이전트를 설치하고 구성합니다.
SAP용 에이전트는 다음과 같은 'SAP용' 공개 OS 이미지와 함께 패키징됩니다.
  • RHEL: 모든 'SAP용' 이미지
  • SLES: SAP용 SLES 15 SP4 이상 버전

자세한 내용은 VM에 SAP용 에이전트 설치 및 구성을 참고하세요.

SAP용 에이전트 업데이트
SAP용 에이전트의 버전 3.5에는 SAP의 관측 가능성을 설정하는 데 필요한 모든 기능이 포함되어 있습니다. 이전에 에이전트를 설치한 경우 최신 버전으로 업데이트하는 것이 좋습니다.

자세한 내용은 SAP용 Google Cloud에이전트 업데이트를 참고하세요.

SAP용 에이전트의 시스템 검색 기능 사용 설정
에이전트의 구성 파일에서 다음 매개변수를 true로 설정해야 합니다. 2024년 2월 14일 이후에 에이전트를 설치한 경우 이러한 플래그는 기본적으로 true로 설정되며 변경할 필요가 없습니다.
  • discovery_configuration.enable_workload_discovery
  • discovery_configuration.enable_discovery
2024년 2월 14일 이전에 에이전트를 설치했거나 시스템의 검색 기능을 사용 중지한 경우 다음 명령어를 실행합니다.
         sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable 
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable

자세한 내용은 SAP용 Google Cloud에이전트 구성을 참고하세요.

SAP용 에이전트의 프로세스 모니터링 측정항목 수집 사용 설정
에이전트의 구성 파일에서 collection_configuration.collect_process_metrics 매개변수를 true로 설정해야 합니다. 이 기능을 사용 설정하려면 다음 명령어를 실행합니다.
         sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable

자세한 내용은 프로세스 모니터링 측정항목 수집 구성을 참고하세요.

SAP HANA 모니터링 측정항목 수집을 위한 에이전트 사용 설정
HANA VM에서는 HANA 프로세스 모니터링 측정항목 수집을 사용 설정해야 합니다. 이 기능을 사용 설정하려면 다음 명령어를 실행합니다.
         sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable

에이전트의 구성 파일에서 hana_monitoring_configuration 섹션을 수정하여 HANA 인스턴스 이름, SID, 호스트, 포트, 사용자, 비밀번호를 제공합니다 (보안 비밀 또는 hdbuserstore 키 사용).

지정된 HANA 사용자에게 기본 쿼리로 쿼리되는 테이블에 대한 읽기 액세스 권한이 있어야 합니다.

자세한 내용은 SAP HANA 모니터링 측정항목 수집 구성을 참고하세요.

에이전트 구성 및 설정 확인 Google Cloud
다음 명령어를 실행하여 에이전트가 올바르게 구성되었는지 확인합니다.
         sudo /usr/bin/google_cloud_sap_agent status

자세한 내용은 워크로드 관리자 관측 가능성 설정 검증을 참고하세요.

SAP용 에이전트 다시 시작
다음 명령어를 실행하여 변경사항이 적용되도록 에이전트를 다시 시작합니다.
         sudo systemctl restart google-cloud-sap-agent

자세한 내용은 에이전트 다시 시작을 참고하세요.

워크로드 관리자 관측 가능성 설정 검증

에이전트의 status 명령어를 실행하여 워크로드 관리자 관측성 서비스를 사용하기 위한 올바른 설정이 있는지 확인할 수 있습니다. Google Cloud 이 명령어는 에이전트 버전 3.7부터 지원됩니다.

Google Cloud 설정을 확인하려면 다음 단계를 완료하세요.

  1. Compute Engine 인스턴스와 SSH 연결을 설정합니다.
  2. 다음 명령어를 실행합니다.

    sudo /usr/bin/google_cloud_sap_agent status
    

    워크로드 관리자 관측 가능성 서비스를 사용하기 위한 Google Cloud 설정이 올바르면 출력에 다음이 포함됩니다. 구성에 default 값 이외의 값이 있을 수 있습니다.

    Agent Status:
        Installed version: 3.7-....
        ...
        Systemd Service Enabled: True
        Systemd Service Running: True
        Cloud API Full Scopes: True
        Configuration File: /etc/google-cloud-sap-agent/configuration.json
        Configuration Valid: True
    ...
    ----------------------------------------------------------------------------
    Process Metrics: Enabled
        Status: Fully Functional
        IAM Permissions: All granted
        Configuration:
            collect_process_metrics:        true (configuration file)
            process_metrics_frequency:      5    (default)
            process_metrics_to_skip:        []   (default)
            slow_process_metrics_frequency: 30   (default)
    ...
    ----------------------------------------------------------------------------
    HANA Monitoring Metrics: Enabled
        Status: Fully Functional
        IAM Permissions: All granted
        Configuration:
            connection_timeout:       120   (default)
            enabled:                  true  (configuration file)
            execution_threads:        10    (default)
            max_connect_retries:      1     (default)
            query_timeout_sec:        300   (default)
            sample_interval_sec:      300   (default)
            send_query_response_time: false (default)
    ...
    ----------------------------------------------------------------------------
    System Discovery: Enabled
        Status: Fully Functional
        IAM Permissions: All granted
        Configuration:
            enable_discovery:                  true  (default)
            enable_workload_discovery:         true  (default)
            sap_instances_update_frequency:    60    (default)
            system_discovery_update_frequency: 14400 (default)
    ...
    
  3. 출력에서 일부 설정이 누락되었다고 표시되면 이전 섹션에 제공된 정보를 검토하고 필요한 작업을 실행한 후 status 명령어를 다시 실행하여 설정을 다시 검증합니다.

구성 파일 예시

관측 가능성 기능을 사용 설정하면 SAP용 에이전트의 구성 파일이 다음과 같이 표시됩니다.

  {
    "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": true
  },
  "discovery_configuration": {
     "enable_workload_discovery": true,
     "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": true,
    "hana_instances": [
      {
        "name": "local",
        "sid": "DEH",
        "host": "localhost",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      },
    ],
   }
  }
  

다음 단계