이 가이드에서는 SAP 시스템에서 워크로드 관리자 평가 측정항목을 수집하도록 SAP용 Google Cloud에이전트를 구성하는 방법을 보여줍니다.
이 기능에 대한 자세한 내용은 SAP용 Google Cloud에이전트를 사용하여 워크로드 관리자 평가를 참조하세요.
시작하기 전에
- SAP용 Google Cloud에이전트 설치를 검증합니다. 자세한 내용은 시나리오별 설치 가이드를 참조하세요.
- 베어메탈 솔루션 서버에 에이전트를 설치했다면, 필요한 기본 요건을 완료하고 서비스 계정을 설정했는지 확인합니다. 자세한 내용은 Linux에서 SAP용 Google Cloud에이전트 구성을 참조하세요.
Google Cloud 프로젝트에 Workload Manager API가 사용 설정되어 있는지 확인합니다.
필요한 IAM 역할
서비스 계정에 SAP용 Google Cloud에이전트에서 워크로드 관리자 평가 측정항목을 수집할 수 있게 하는 데 필요한 권한이 있는지 확인하려면 관리자에게 서비스 계정에 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
Compute 뷰어(
roles/compute.viewer
): SAP 시스템을 호스팅하는 Compute Engine 인스턴스에서 워크로드 관리자 평가 측정항목을 수집합니다. -
워크로드 관리자 통계 작성자(
roles/workloadmanager.insightWriter
): 수집된 측정항목을 워크로드 관리자 데이터 웨어하우스에 씁니다. -
(선택사항) Secret Manager 보안 비밀 접근자(
roles/secretmanager.secretAccessor
): Secret Manager를 사용하여 SAP HANA 데이터베이스에 연결할 비밀번호를 저장하는 경우입니다.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이러한 사전 정의된 역할에는 SAP용 Google Cloud에이전트가 워크로드 관리자 평가 측정항목을 수집할 수 있게 하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
SAP용 Google Cloud에이전트에서 워크로드 관리자 평가 측정항목을 수집할 수 있게 하려면 다음 권한이 필요합니다.
-
호스트 Compute Engine 인스턴스에서 워크로드 관리자 평가 측정항목을 수집하고 워크로드 관리자 데이터 웨어하우스에 쓰려면 다음 권한이 필요합니다.
-
monitoring.timeSeries.create
-
compute.zoneOperations.list
-
compute.disks.list
-
compute.nodeGroups.get
-
workloadmanager.insights.write
-
-
Secret Manager를 사용하여 SAP HANA 데이터베이스에 연결할 비밀번호를 저장하는 경우 보안 비밀에 액세스하려면 다음 권한이 필요합니다.
secretmanager.versions.access
관리자는 커스텀 역할이나 다른 사전 정의된 역할을 사용하여 서비스 계정에 이러한 권한을 부여할 수도 있습니다.
필수 SAP HANA 역할
에이전트가 SAP HANA 데이터베이스에서 측정항목을 수집할 수 있게 하려면 에이전트 구성 파일에 지정된 SAP HANA 사용자에게 MONITORING
역할이 있는지 확인합니다.
이 역할에 대한 자세한 내용은 SAP 문서 표준 데이터베이스 역할을 참조하세요.
에이전트 버전 확인
Google Cloud 에서는 SAP 워크로드를 정확하게 평가할 수 있도록 최신 버전의 SAP용 에이전트를 설치할 것을 권장합니다. SAP용 에이전트 출시 버전이 정기적으로 출시될 때마다 평가에 사용되는 측정항목이 추가되거나 변경될 수 있기 때문입니다.
최신 버전의 SAP용 Google Cloud에이전트를 사용하려면 업데이트를 정기적으로 확인하고 에이전트를 업데이트해야 합니다.
업데이트 설치
운영체제를 선택한 후 다음 단계를 수행합니다.
RHEL
- 인스턴스와 SSH 연결을 설정합니다.
- 에이전트 인스턴스를 업데이트합니다.
- (권장) 에이전트 버전 3.8(최신)로 업데이트하려면 다음 명령어를 실행합니다.
sudo yum --nogpgcheck update google-cloud-sap-agent
- 특정 버전의 에이전트로 업데이트하려면 다음 명령어를 실행합니다.
sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64
VERSION_NUMBER
를 설치하려는 에이전트의 버전 번호로 바꿉니다(예:3.1-606637668
). 설치할 수 있는 에이전트 버전에 대한 자세한 내용은 사용 가능한 모든 에이전트 버전 나열을 참조하세요.
- (권장) 에이전트 버전 3.8(최신)로 업데이트하려면 다음 명령어를 실행합니다.
SLES
- 인스턴스와 SSH 연결을 설정합니다.
- 에이전트 인스턴스를 업데이트합니다.
- (권장) 에이전트 버전 3.8(최신)로 업데이트하려면 다음 명령어를 실행합니다.
sudo zypper --no-gpg-checks update google-cloud-sap-agent
- 특정 버전의 에이전트로 업데이트하려면 다음 명령어를 실행합니다.
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64
VERSION_NUMBER
를 설치하려는 에이전트의 버전 번호로 바꿉니다(예:3.1-606637668
). 설치할 수 있는 에이전트 버전에 대한 자세한 내용은 사용 가능한 모든 에이전트 버전 나열을 참조하세요.
- (권장) 에이전트 버전 3.8(최신)로 업데이트하려면 다음 명령어를 실행합니다.
워크로드 관리자 평가 측정항목 수집 사용 설정
버전 3.2부터는 기본적으로 새로 설치한 SAP용 Google Cloud에이전트가 워크로드 관리자 평가 측정항목을 수집하도록 사용 설정됩니다. 이전 버전에서 버전 3.2로 업데이트하는 경우 이 기능을 명시적으로 사용 설정할 수도 있습니다. 그러려면 다음 단계를 완료하세요.
Compute Engine 인스턴스나 베어메탈 솔루션 서버를 사용하여 SSH 연결을 설정합니다.
에이전트에서 워크로드 관리자 평가 측정항목을 수집하게 하려면 다음 명령어를 실행합니다.
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable
'SAP HANA 통계' 및 'SAP HANA 보안 권장사항' 측정항목 수집을 사용 설정하려면 다음 안내를 따르세요.
에이전트의 구성 파일을 엽니다.
/etc/google-cloud-sap-agent/configuration.json
또는 명령어를 실행하여 이 구성을 수행할 수도 있습니다. 자세한 내용은 SAP용 Google Cloud에이전트 구성 명령어를 참조하세요.
collect_workload_validation_metrics
뒤에workload_validation_db_metrics_config
섹션을 추가한 후 다음 매개변수를 지정합니다.hana_db_user
: SAP HANA 인스턴스 쿼리에 사용되는 SAP HANA 데이터베이스 사용자 계정을 지정합니다.hostname
: SAP HANA 인스턴스를 호스팅하는 로컬 또는 원격의 머신 식별자를 지정합니다.port
: SAP HANA 인스턴스에서 쿼리를 허용하는 데이터베이스 포트를 지정합니다. 예를 들어 테넌트 데이터베이스가 포트30015
에서 리슨하는 경우30015
를 입력합니다.sid
: SAP HANA 인스턴스의 SID를 지정합니다.hana_db_password_secret_name
: Secret Manager에서 사용자 계정의 비밀번호를 저장하는 보안 비밀의 이름을 지정합니다.보안 비밀 대신
hdbuserstore_key
구성 매개변수를 사용할 수 있습니다.hdbuserstore_key
:hana_db_user
에 지정한 사용자를 인증하는hdbuserstore
키를 지정합니다.hdbuserstore_key
를 지정할 경우hostname
및port
매개변수 지정을 건너뜁니다.
이러한 매개변수에 대한 자세한 내용은 구성 매개변수를 참조하세요.
선택적으로
cloud_properties
섹션에서 자동으로 설정되는 매개변수 값을 업데이트할 수 있습니다. 이렇게 하려면 구성 파일에cloud_properties
섹션을 추가한 다음 필수 매개변수 및 해당 값을 지정합니다.구성 파일을 저장합니다.
새 설정이 적용되도록 에이전트를 다시 시작합니다.
sudo systemctl restart google-cloud-sap-agent
구성 파일 예시
Compute Engine 인스턴스
다음 예시는 워크로드 관리자 평가 측정항목 수집이 사용 설정된Compute Engine 인스턴스에서 실행되는 SAP용Google Cloud에이전트의 완료된 구성 파일입니다.
SAP HANA 인증의 경우 에이전트는 다음과 같은 우선순위를 사용합니다. 지정된 경우 hdbuserstore_key
구성 파라미터, hana_db_password
파라미터, hana_db_password_secret_name
파라미터 순으로 적용됩니다. 구성 파일에서 인증 옵션 하나만 설정하는 것이 좋습니다.
- 다음 예시에서는 SAP HANA 인증에 보안 사용자 스토어(
hdbuserstore
) 키를 사용합니다.{ "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" }, "collect_process_metrics": false }, "discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
- 다음 예시에서는 SAP HANA 인증에 사용자 이름과 Secret Manager 보안 비밀을 사용합니다.
{ "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", "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 } }
- 다음 예시에서는 SAP HANA 인증에 사용자 이름과 비밀번호를 사용합니다. 대신 SAP HANA 인증에 Secret Manager 보안 비밀이나 보안 사용자 스토어(
hdbuserstore
) 키를 사용하는 것이 좋습니다.{ "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", "hana_db_password": "TempPa55word", "hostname": "localhost", "port": "30015" }, "collect_process_metrics": false }, "discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
베어메탈 솔루션 서버
다음 예시는 워크로드 관리자 평가 측정항목 수집이 사용 설정된베어메탈 솔루션 서버에서 실행되는 SAP용Google Cloud에이전트의 완료된 구성 파일입니다.
SAP HANA 인증의 경우 에이전트는 다음과 같은 우선순위를 사용합니다. 지정된 경우 hdbuserstore_key
구성 파라미터, hana_db_password
파라미터, hana_db_password_secret_name
파라미터 순으로 적용됩니다. 구성 파일에서 인증 옵션 하나만 설정하는 것이 좋습니다.
- 다음 예시에서는 SAP HANA 인증에 보안 사용자 스토어(
hdbuserstore
) 키를 사용합니다.{ "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" }, "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 HANA 인증에 사용자 이름과 Secret Manager 보안 비밀을 사용합니다.
{ "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", "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 HANA 인증에 사용자 이름과 비밀번호를 사용합니다. 대신 SAP HANA 인증에 Secret Manager 보안 비밀이나 보안 사용자 스토어(
hdbuserstore
) 키를 사용하는 것이 좋습니다.{ "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", "hana_db_password": "TempPa55word", "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에이전트의 구성 파라미터를 설명합니다.
매개변수 | |
---|---|
provide_sap_host_agent_metrics |
SAP 호스트 에이전트에 필요한 측정항목 수집을 사용 설정하려면 |
bare_metal |
에이전트를 베어메탈 솔루션 서버에 설치할 때 |
log_level |
에이전트의 로깅 수준을 설정하려면 필수 값을 설정하세요. 사용 가능한 로그 수준은 다음과 같습니다.
기본값은 |
log_to_cloud |
에이전트 로그를 Cloud Logging으로 리디렉션하려면 |
cloud_properties.project_id |
SAP 시스템이 베어메탈 솔루션 서버에서 실행되는 경우 베어메탈 솔루션에서 사용 중인 Google Cloud 프로젝트의 프로젝트 ID를 지정합니다. |
cloud_properties.instance_name
|
SAP 시스템이 Compute Engine 인스턴스에서 실행되는 경우 해당 컴퓨팅 인스턴스 이름을 지정합니다. 에이전트에서 설치 시 자동으로 컴퓨팅 인스턴스 이름을 감지합니다. SAP 시스템이 베어메탈 솔루션 서버에서 실행되는 경우 해당 서버의 이름을 지정합니다. |
cloud_properties.region |
SAP 시스템이 베어메탈 솔루션 서버에서 실행되는 경우 베어메탈 솔루션 서버의 리전을 지정합니다. |
cloud_properties.zone |
에이전트가 컴퓨팅 인스턴스에서 실행되면 기본적으로 에이전트에서 컴퓨팅 인스턴스가 배포된 영역을 사용합니다. |
cloud_properties.image |
인스턴스의 OS 이미지 이름을 지정합니다. |
cloud_properties.numeric_project_id |
SAP 시스템이 실행 중인 Google Cloud 프로젝트의 숫자 ID를 지정합니다. |
discovery_configuration.enable_workload_discovery |
에이전트가 호스트에서 실행되는 SAP 제품의 이름과 버전을 수집하도록 하려면 자세한 내용은 GoogleCloudPlatform/sapagent 아래의 |
discovery_configuration.enable_discovery |
호스트에서 실행되는 SAP 제품에 대해 에이전트가 수집하는 정보를 Cloud Logging으로 전송하려면
|
collection_configuration.collect_workload_validation_metrics |
워크로드 관리자 평가 측정항목 수집을 사용 설정하려면 |
collection_configuration.workload_validation_metrics_frequency |
워크로드 관리자 평가 측정항목의 수집 빈도(초)입니다. 기본값은 워크로드 관리자 측정항목 수집 빈도를 수정해야 하는 경우 |
collection_configuration.workload_validation_collection_definition.fetch_latest_config |
(선택사항) 기본값은 |
collection_configuration.workload_validation_db_metrics_config.hana_db_user |
SAP HANA 인스턴스 쿼리에 사용되는 사용자 계정을 지정합니다. 사용자 계정에 SAP HANA 데이터베이스에 대한 읽기 권한이 있어야 합니다. |
collection_configuration.workload_validation_db_metrics_config.hana_db_password |
SAP HANA 인스턴스를 쿼리하는 데 사용되는 사용자 계정의 비밀번호를 지정합니다. SAP HANA 인증의 경우 에이전트는 다음과 같은 우선순위를 사용합니다. 지정된 경우 |
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name |
Secret Manager에서 사용자 계정의 비밀번호를 저장하는 보안 비밀의 이름을 지정합니다. 또는 SAP HANA 인증의 경우 에이전트는 다음과 같은 우선순위를 사용합니다. 지정된 경우 |
collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key
|
SAP HANA 시스템에 안전하게 연결하려면 해당 시스템에 대해 만든 보안 사용자 저장소( 인증에
이 구성 매개변수는 에이전트 버전 3.3부터 지원됩니다.
SAP HANA 인증의 경우 에이전트는 다음과 같은 우선순위를 사용합니다. 지정된 경우 |
collection_configuration.workload_validation_db_metrics_config.sid |
SAP HANA 인스턴스의 SID를 지정합니다. |
collection_configuration.workload_validation_db_metrics_config.hostname |
SAP HANA 인스턴스를 호스팅하는 로컬 또는 원격의 머신 식별자를 지정합니다. 지원되는 값은 다음과 같습니다.
|
collection_configuration.workload_validation_db_metrics_config.port |
SAP HANA 인스턴스가 쿼리를 허용하는 포트를 지정합니다. 첫 번째 또는 유일한 테넌트 데이터베이스 인스턴스의 경우 포트가 |
collection_configuration.workload_validation_db_metrics_frequency |
워크로드 관리자 평가를 위한 SAP HANA 데이터베이스 측정항목의 수집 빈도(초)입니다.
기본값은 |
워크로드 관리자 평가 측정항목 수집 설정 확인
에이전트의 status
명령어를 실행하여 워크로드 관리자 평가 측정항목 수집에 올바른 Google Cloud 설정이 적용되었는지 확인할 수 있습니다. 이 명령어는 에이전트 버전 3.7부터 지원됩니다.
Google Cloud 설정을 확인하려면 다음 단계를 완료합니다.
- Compute Engine 인스턴스와 SSH 연결을 설정합니다.
- 다음 명령어를 실행합니다.
sudo /usr/bin/google_cloud_sap_agent status
워크로드 관리자 평가 측정항목 수집의 Google Cloud 설정이 올바르면 출력에 다음이 포함됩니다. 구성에
default
값이 아닌 다른 값이 있을 수 있습니다.Agent Status: ... 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 ... ---------------------------------------------------------------------------- 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) ---------------------------------------------------------------------------- Workload Manager Evaluation: Enabled Status: Fully Functional IAM Permissions: All granted Configuration: collect_workload_validation_metrics: true (default) config_target_environment: PRODUCTION (default) fetch_latest_config: true (default) workload_validation_db_metrics_frequency: 3600 (default) workload_validation_metrics_frequency: 300 (default) ...
- 출력에 일부 설정이 누락되었다고 표시되면 이전 섹션에 제공된 정보를 검토하고 필요한 작업을 수행한 후
status
명령어를 다시 실행하여 설정을 다시 검증합니다.
수집된 측정항목 보기
에이전트가 수집하는 워크로드 관리자 평가 측정항목을 보려면 다음을 수행하면 됩니다.
에이전트의 로그 파일을 확인합니다.
에이전트의 로그 수준을
DEBUG
로 설정합니다.sudo /usr/bin/google_cloud_sap_agent configure -loglevel=debug
에이전트가 다시 시작하여 새 로그 수준이 적용된 후 에이전트의 로그 파일을 확인합니다.
/var/log/google-cloud-sap-agent.log
로그 파일에서 다음이 포함된 항목을 찾습니다.
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용 워크로드 관리자 권장사항을 참조하세요.