워크로드 관리자 평가 측정항목 수집 구성

이 가이드에서는 SAP 시스템에서 워크로드 관리자 평가 측정항목을 수집하도록 SAP용 Google Cloud 에이전트를 구성하는 방법을 보여줍니다.

이 기능에 대한 자세한 내용은 SAP용 Google Cloud 에이전트를 사용하여 워크로드 관리자 평가를 참조하세요.

시작하기 전에

• SAP용 Google Cloud 에이전트 설치를 검증합니다. 자세한 내용은 시나리오별 설치 가이드를 참조하세요.
• 베어메탈 솔루션 서버에 에이전트를 설치했다면, 필요한 기본 요건을 완료하고 서비스 계정을 설정했는지 확인합니다. 자세한 내용은 Linux에서 SAP용 Google Cloud 에이전트 구성을 참조하세요.

• Google Cloud 프로젝트에 대해 Workload Manager API가 사용 설정되어 있는지 확인합니다.

  Workload Manager API 사용 설정

IAM 역할 설정

SAP용 Google Cloud 에이전트가 워크로드 관리자 평가 측정항목을 수집하도록 허용하려면 Compute Engine VM 인스턴스 또는 베어메탈 솔루션 서버에서 사용 중인 서비스 계정에 다음 역할이 포함되어 있는지 확인해야 합니다.

• Compute 뷰어(roles/compute.viewer)
• 워크로드 관리자 통계 작성자(roles/workloadmanager.insightWriter)
• Secret Manager 보안 비밀 접근자(roles/secretmanager.secretAccessor)(SAP HANA 데이터베이스 비밀번호를 저장하는 데 Secret Manager를 사용하는 경우)

서비스 계정에 이러한 필수 역할을 추가하려면 다음 단계를 수행합니다.

1. Google Cloud 콘솔에서 IAM 페이지로 이동합니다.

   IAM으로 이동

2. Google Cloud 프로젝트를 선택합니다.

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

   • 서비스 계정이 주 구성원 목록에 아직 없는 경우 어떠한 역할도 할당되지 않은 것입니다. 추가를 클릭하고 서비스 계정의 이메일 주소를 클릭하세요.
   • 서비스 계정이 주 구성원 목록에 이미 있는 경우 기존 역할이 있는 것입니다. 수정하려는 서비스 계정에서 수정 버튼을 클릭합니다.

4. 사용 가능한 역할 목록에서 필요한 역할을 선택합니다.

   • Compute 뷰어
   • 워크로드 관리자 > 워크로드 관리자 통계 작성자
   • Secret Manager > Secret Manager 보안 비밀 접근자

5. 추가 또는 저장을 클릭하여 서비스 계정에 역할을 적용합니다.

에이전트 버전 확인

Google Cloud에서는 SAP 워크로드의 정확한 평가를 위해 최신 버전의 SAP용 에이전트를 설치하는 것이 좋습니다. SAP용 에이전트가 정기적으로 출시될 때마다 평가에 사용되는 측정항목이 추가되거나 변경될 수 있기 때문입니다.

최신 버전의 SAP용 Google Cloud 에이전트를 사용하려면 에이전트에 대한 업데이트를 정기적으로 확인하고 업데이트해야 합니다.

업데이트 설치

운영체제를 선택한 후 다음 단계를 수행합니다.

워크로드 관리자 평가 측정항목 수집 사용 설정

버전 3.2부터는 기본적으로 새로 설치한 SAP용 Google Cloud 에이전트가 워크로드 관리자 평가 측정항목을 수집하도록 사용 설정됩니다. 이전 버전에서 버전 3.2로 업데이트하는 경우 이 기능을 명시적으로 사용 설정할 수도 있습니다. 그러려면 다음 절차를 완료하세요.

1. Compute Engine VM 인스턴스 또는 베어메탈 솔루션 서버를 사용하여 SSH 연결을 설정합니다.

2. 에이전트에서 워크로드 관리자 평가 측정항목을 수집하게 하려면 다음 명령어를 실행합니다.

   sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable

3. 'SAP HANA 통계' 및 'SAP HANA 보안 권장사항' 측정항목 수집을 사용 설정하려면 다음 안내를 따르세요.

   1. 에이전트의 구성 파일을 엽니다.

      /etc/google-cloud-sap-agent/configuration.json

      또는 명령어를 실행하여 이 구성을 수행할 수도 있습니다. 자세한 내용은 SAP용 Google Cloud 에이전트의 구성 명령어를 참조하세요.

   2. collect_workload_validation_metrics 뒤에 workload_validation_db_metrics_config 섹션을 추가한 후 다음 매개변수를 지정합니다.

      • hana_db_user: SAP HANA 인스턴스 쿼리에 사용되는 SAP HANA 데이터베이스 사용자 계정을 지정합니다.
      • hostname: SAP HANA 인스턴스를 호스팅하는 로컬 또는 원격의 머신 식별자를 지정합니다.
      • port: SAP HANA 인스턴스가 쿼리를 허용하는 포트를 지정합니다.
      • sid: SAP HANA 인스턴스의 SID를 지정합니다.

      • hana_db_password_secret_name: Secret Manager에서 사용자 계정의 비밀번호를 저장하는 보안 비밀의 이름을 지정합니다.

        보안 비밀 대신 hdbuserstore_key 구성 매개변수를 사용할 수 있습니다.

      • hdbuserstore_key: hana_db_user에 지정한 사용자를 인증하는 hdbuserstore 키를 지정합니다.

        hdbuserstore_key를 지정할 경우 hostname 및 port 매개변수 지정을 건너뜁니다.

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

4. 선택적으로 cloud_properties 섹션에서 자동으로 설정되는 매개변수 값을 업데이트할 수 있습니다. 이렇게 하려면 구성 파일에 cloud_properties 섹션을 추가한 다음 필수 매개변수 및 해당 값을 지정합니다.

5. 구성 파일을 저장합니다.

6. 새 설정이 적용되도록 에이전트를 다시 시작합니다.

   sudo systemctl restart google-cloud-sap-agent

구성 파일 예시

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1",
    "region": "us-central1"
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

구성 매개변수

다음 표에서는 워크로드 관리자 평가 측정항목 수집과 관련된 SAP용 Google Cloud 에이전트의 구성 매개변수를 설명합니다.

수집된 측정항목 보기

에이전트가 수집하는 워크로드 관리자 평가 측정항목을 보려면 다음을 수행하면 됩니다.

• 에이전트의 로그 파일을 확인합니다.

  1. 에이전트의 로그 수준을 DEBUG로 설정합니다.

     sudo /usr/bin/google_cloud_sap_agent configure -loglevel=debug

  2. 에이전트가 다시 시작하여 새 로그 수준이 적용된 후 에이전트의 로그 파일을 확인합니다.

     /var/log/google-cloud-sap-agent.log

  3. 로그 파일에서 다음이 포함된 항목을 찾습니다.

     workload.googleapis.com/sap/validation/

     다음은 에이전트의 로그 파일에 있는 워크로드 관리자 평가 측정항목을 보여주는 예시입니다.

     {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
     "metric":"workload.googleapis.com/sap/validation/system","value":1}
     {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
     "key":"instance_name","value":"n1-hana-sles15"}
     {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
     "key":"os","value":"sles-15-SP4"}
     ...
     {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
     "metric":"workload.googleapis.com/sap/validation/corosync","value":0}
     ...

• 에이전트 인스턴스가 Cloud Logging으로 로그를 보내도록 구성된 경우 Cloud Logging에서 에이전트의 로그를 볼 수 있습니다.

• 워크로드 관리자에서 SAP 워크로드에 대한 평가를 만들고 실행합니다. 자세한 내용은 평가 만들기 및 실행을 참조하세요.

  Google Cloud에서 실행되는 SAP 워크로드를 평가할 수 있도록 워크로드 관리자가 지원하는 권장사항에 대한 자세한 내용은 SAP용 워크로드 관리자 권장사항을 참조하세요.