관측 가능성을 설정하도록 SAP용 에이전트 구성

이 문서에서는 워크로드 관리자를 사용하여 SAP 워크로드의 관측 가능성을 설정하도록 SAP용 Google Cloud에이전트를 구성하는 방법을 설명합니다.

워크로드 관리자 관측 가능성 서비스에는 에이전트가 SAP 워크로드 및 기본 인프라에서 측정항목을 수집해야 합니다. 자세한 내용은 SAP 모니터링 가능성 개요를 참고하세요.

시작하기 전에

관측 가능성을 설정하려는 SAP 워크로드를 실행하는 모든 Compute Engine 인스턴스에서 SAP용 Google Cloud에이전트 설치를 검증합니다.

에이전트 설치를 검증하는 방법은 에이전트 설치 검증을 참고하세요.
SAP 관측 가능성을 위한 기본 요건을 완료했는지 확인합니다.

단일 영역 워크로드의 에이전트 구성

VM 확장 프로그램 관리자

Compute Engine 인스턴스 Fleet에서 에이전트를 구성하고 관리하려면 해당 인스턴스에 대한 VM 확장 프로그램 관리자 정책을 만들어야 합니다.

단일 영역에서 실행되는 SAP 워크로드의 관측 가능성을 설정하도록 에이전트를 구성하려면 다음 단계를 완료하세요.

VM 확장 프로그램 관리자를 설정합니다.
- VM 확장 프로그램 관리자 문서에서 시작하기 전에 섹션을 검토합니다.
- VM 확장 프로그램 관리자 정책을 만들고 관리하는 데 필요한 IAM 역할을 설정합니다. 자세한 내용은 다음을 참조하세요.
SAP 워크로드를 실행하는 컴퓨팅 인스턴스에 SAP용 Google Cloud에이전트를 설치하고 관리하는 VM 확장 프로그램 정책을 만듭니다.
- SAP 워크로드가 실행 중인 영역에서 VM 확장 프로그램 정책을 만듭니다. 이러한 VM 확장 프로그램 정책을 만드는 방법에 대한 자세한 내용은 영역 VM 확장 프로그램 정책 만들기를 참고하세요.
- 관측 가능성을 위한 에이전트 구성의 예시를 보려면 에이전트 구성 예시를 참고하세요.

패키지 관리자

VM 확장 프로그램 관리자를 사용하는 대신 에이전트 수명 주기를 수동으로 관리하는 경우 패키지 관리자를 사용하여 SAP용 Google Cloud에이전트를 구성할 수 있습니다.

SAP 워크로드를 실행하는 컴퓨팅 인스턴스와 SSH 연결을 설정합니다.
최신 버전의 SAP용 에이전트를 실행 중인지 확인합니다.

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

에이전트가 SAP 워크로드에 관한 세부정보를 조회하고 Workload Manager로 전송하도록 하려면 다음 단계를 따르세요.

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 워크로드에서 실행되는 프로세스에서 측정항목을 수집하도록 사용 설정합니다.
1. 에이전트의 프로세스 모니터링 기능을 사용 설정합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
```
1. 에이전트가 SAP HANA 데이터베이스 인스턴스와 관련된 프로세스 측정항목을 수집할 수 있게 하려면 hana_metrics_config 섹션에서 추가 매개변수를 구성해야 합니다.
자세한 내용은 프로세스 모니터링 측정항목 수집 구성을 참고하세요.
에이전트가 SAP 워크로드에서 실행되는 SAP HANA 인스턴스에서 측정항목을 수집하도록 사용 설정합니다.
1. 에이전트의 SAP HANA 모니터링 기능을 사용 설정합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
```
1. 에이전트가 SAP HANA 인스턴스에 연결하고 측정항목을 수집하도록 하려면 추가 매개변수를 구성해야 합니다.
자세한 내용은 SAP HANA 모니터링 측정항목 수집 구성을 참고하세요.
구성 파일을 저장합니다.

관측 가능성을 위한 에이전트 구성의 예시를 보려면 에이전트 구성 예시를 참고하세요.

다중 영역 워크로드의 에이전트 구성

VM 확장 프로그램 관리자

Compute Engine 인스턴스 Fleet에서 에이전트를 구성하고 관리하려면 해당 인스턴스에 대한 VM 확장 프로그램 관리자 정책을 만들어야 합니다.

두 개 이상의 영역에서 실행되는 SAP 워크로드의 관측 가능성을 설정하도록 에이전트를 구성하려면 다음 단계를 완료하세요.

VM 확장 프로그램 관리자를 설정합니다.
- VM 확장 프로그램 관리자 문서에서 시작하기 전에 섹션을 검토합니다.
- VM 확장 프로그램 관리자 정책을 만들고 관리하는 데 필요한 IAM 역할을 설정합니다. 자세한 내용은 다음을 참조하세요.
SAP 워크로드의 기본 사이트를 실행하는 컴퓨팅 인스턴스에 SAP용 Google Cloud에이전트를 설치하고 관리하는 VM 확장 프로그램 정책을 만듭니다.
- SAP 워크로드의 기본 사이트가 실행되는 영역에서 VM 확장 프로그램 정책을 만듭니다. 이러한 VM 확장 프로그램 정책을 만드는 방법에 대한 자세한 내용은 영역 VM 확장 프로그램 정책 만들기를 참고하세요.
- 관측 가능성을 위한 에이전트 구성의 예시를 보려면 에이전트 구성 예시를 참고하세요.
고가용성 SAP 워크로드를 실행하거나 SAP 워크로드의 재해 복구 (DR) 사이트가 있는 경우 SAP 워크로드의 보조 또는 DR 사이트를 실행하는 컴퓨팅 인스턴스에 SAP용 Google Cloud에이전트를 설치하고 관리하는 VM 확장 프로그램 정책을 만듭니다.

패키지 관리자

SAP 워크로드를 실행하는 컴퓨팅 인스턴스와 SSH 연결을 설정합니다.
최신 버전의 SAP용 에이전트를 실행 중인지 확인합니다.

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

에이전트가 SAP 워크로드에 관한 세부정보를 수집하여 워크로드 관리자로 전송하도록 하려면 다음 단계를 따르세요.

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 워크로드에서 실행되는 프로세스에서 측정항목을 수집하도록 사용 설정합니다.
1. 에이전트의 프로세스 모니터링 기능을 사용 설정합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
```
1. 에이전트가 SAP HANA 데이터베이스 인스턴스와 관련된 프로세스 측정항목을 수집할 수 있게 하려면 hana_metrics_config 섹션에서 추가 매개변수를 구성해야 합니다.
자세한 내용은 프로세스 모니터링 측정항목 수집 구성을 참고하세요.
에이전트가 SAP 워크로드에서 실행되는 SAP HANA 인스턴스에서 측정항목을 수집하도록 사용 설정합니다.
1. 에이전트의 SAP HANA 모니터링 기능을 사용 설정합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
```
1. 에이전트가 SAP HANA 인스턴스에 연결하고 측정항목을 수집하도록 하려면 추가 매개변수를 구성해야 합니다.
자세한 내용은 SAP HANA 모니터링 측정항목 수집 구성을 참고하세요.
구성 파일을 저장합니다.
고가용성 SAP 워크로드를 실행 중이거나 SAP 워크로드의 재해 복구 (DR) 사이트가 있는 경우 SAP 워크로드를 실행하는 다른 모든 컴퓨팅 인스턴스에 대해 이 절차를 반복합니다.

관측 가능성을 위한 에이전트 구성의 예시를 보려면 에이전트 구성 예시를 참고하세요.

워크로드 관리자 관측 가능성 설정 확인

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

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

SAP 워크로드를 실행하는 Compute Engine 인스턴스와 SSH 연결을 설정합니다.

관측 가능성을 위한 Google Cloud 설정을 확인합니다.

sudo /usr/bin/google_cloud_sap_agent status

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

Agent Status:
    Installed version: 3.10-....
    ...
    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:      30    (default)
        process_metrics_to_skip:        []   (default)
        slow_process_metrics_frequency: 120   (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)
...

출력에 일부 설정이 누락되었다고 표시되면 이전 섹션에 제공된 정보를 검토하고 필요한 작업을 수행한 후 status 명령어를 다시 실행하여 설정을 다시 검증합니다.
워크로드를 실행하는 데 2개 이상의 컴퓨팅 인스턴스를 사용하는 경우 워크로드를 실행하는 다른 모든 컴퓨팅 인스턴스에 대해 이 절차를 반복합니다.

에이전트 구성 예시

다음은 SAP HANA 워크로드의 관측 가능성을 지원하도록 구성된 SAP용 Google Cloud에이전트의 완료된 구성 파일의 예시입니다.

다음 예시에서는 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,
      "collect_process_metrics": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hdbuserstore_key": "user_store_key"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        }
      ]
    }
  }

다음 예시에서는 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,
      "collect_process_metrics": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password_secret_name": "db_pwd_secret_name"
      }
    },
    "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": "db_user_name",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "secret_name": "db_pwd_secret_name"
        }
      ]
    }
  }

다음 예시에서는 SAP HANA 인증에 사용자 이름과 비밀번호를 사용합니다. 대신 SAP HANA 인증에 보안 사용자 스토어 (hdbuserstore) 키나 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,
      "collect_process_metrics": true,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password": "TempPa55word"
      }
    },
    "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": "db_user_name",
          "password": "TempPa55word"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "password": "TempPa55word"
        }
      ]
    }
  }

에이전트에서 지원하는 구성 매개변수에 대한 자세한 내용은 구성 매개변수를 참고하세요.

다음 단계

SAP 워크로드의 관측 가능성 설정을 완료한 후 해당 워크로드가 Google Cloud 콘솔의 워크로드 관리자 관측 가능성 페이지에 표시되는 데 최대 15분이 걸릴 수 있습니다.

SAP 워크로드를 관찰하는 방법에 대한 자세한 내용은 SAP 관측 가능성 측정항목 보기를 참고하세요.

관측 가능성을 설정하도록 SAP용 에이전트 구성 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

시작하기 전에

단일 영역 워크로드의 에이전트 구성

VM 확장 프로그램 관리자

패키지 관리자

다중 영역 워크로드의 에이전트 구성

VM 확장 프로그램 관리자

패키지 관리자

워크로드 관리자 관측 가능성 설정 확인

에이전트 구성 예시

다음 단계

관측 가능성을 설정하도록 SAP용 에이전트 구성