에이전트 상태 측정항목 수집 구성

이 가이드에서는 Compute Engine VM 인스턴스나 베어메탈 솔루션 서버의 에이전트 데몬 프로세스에서 상태 측정항목을 수집하도록 SAP용 Google Cloud 에이전트를 구성하는 방법을 보여줍니다.

이 기능에 대한 자세한 내용은 에이전트 상태 측정항목 수집을 참조하세요.

시작하기 전에

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

IAM 역할 설정

SAP용 Google Cloud 에이전트에서 상태 측정항목을 수집하게 하려면 Compute Engine VM 인스턴스나 베어메탈 솔루션 서버에서 사용 중인 서비스 계정에 다음 역할이 포함되어 있는지 확인해야 합니다.

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

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

IAM으로 이동
Google Cloud 프로젝트를 선택합니다.
역할을 추가할 서비스 계정을 찾습니다.
- 서비스 계정이 주 구성원 목록에 아직 없는 경우 어떠한 역할도 할당되지 않은 것입니다. 액세스 권한 부여를 클릭하고 서비스 계정의 이메일 주소를 입력합니다.
- 서비스 계정이 주 구성원 목록에 이미 있는 경우 기존 역할이 있는 것입니다. 수정하려는 서비스 계정에서 수정 버튼을 클릭합니다.
사용 가능한 역할 목록에서 필요한 역할을 선택합니다.
- Compute Engine > Compute 뷰어
- 모니터링 > 모니터링 측정항목 작성자
저장을 클릭하여 서비스 계정에 역할을 적용합니다.

에이전트 상태 측정항목 수집 사용 설정

SAP용 Google Cloud 에이전트가 호스트에서 데몬 프로세스의 상태 측정항목을 수집하게 하려면 다음 단계를 수행합니다.

호스트 VM 인스턴스 또는 베어메탈 솔루션 서버와 SSH 연결을 설정합니다.
에이전트 상태 측정항목 수집을 사용 설정합니다.
명령어 실행
1. 에이전트 상태 측정항목 수집을 사용 설정하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -enable
```
2. 원하는 경우 에이전트에서 데몬 프로세스의 CPU 및 메모리 사용량을 수집하여 Cloud Monitoring으로 전송하는 빈도를 수정할 수 있습니다. 기본 빈도는 60초입니다.
  
  이 빈도를 수정하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_metrics_frequency=FREQUENCY
```
  FREQUENCY를 필수 값(초)으로 바꿉니다. 빈도는 5초 이상이어야 합니다.
3. 원하는 경우 에이전트에서 운영 상태를 확인하고 해당 정보를 Cloud Monitoring으로 전송하는 빈도를 수정할 수 있습니다. 기본 빈도는 60초입니다.
  
  이 빈도를 수정하려면 다음 명령어를 실행합니다. 빈도는 5초 이상이어야 합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY
```
구성 파일 수정
에이전트 명령어를 실행하는 대신 다음과 같이 에이전트 구성을 수동으로 수정할 수 있습니다.
1. Backint 구성 파일을 엽니다.
```
/etc/google-cloud-sap-agent/configuration.json
```
2. collection_configuration 섹션에 다음을 포함합니다.
```
"collect_agent_metrics": true
```
3. 원하는 경우 에이전트에서 데몬 프로세스의 CPU 및 메모리 사용량을 수집하여 Cloud Monitoring으로 전송하는 빈도를 수정할 수 있습니다. 기본 빈도는 60초입니다.
  
  이 빈도를 수정하려면 collection_configuration 섹션에 다음을 포함합니다.
```
"agent_metrics_frequency": FREQUENCY
```
  FREQUENCY를 필수 값(초)으로 바꿉니다. 빈도는 5초 이상이어야 합니다.
4. 원하는 경우 에이전트에서 운영 상태를 확인하고 해당 정보를 Cloud Monitoring으로 전송하는 빈도를 수정할 수 있습니다. 기본 빈도는 60초입니다.
  
  이 빈도를 수정하려면 collection_configuration 섹션에 다음을 포함합니다. 빈도는 5초 이상이어야 합니다.
```
"agent_health_frequency": FREQUENCY
```
5. 구성 파일을 저장합니다.
6. 새 설정이 적용되도록 에이전트를 다시 시작합니다.
```
sudo systemctl restart google-cloud-sap-agent
```

구성 파일 예시

Compute Engine VM 인스턴스

다음은 에이전트 상태 측정항목 수집이 사용 설정된Compute Engine VM 인스턴스에서 실행되는 SAP용 Google Cloud 에이전트의 완료된 구성 파일의 예시입니다.

{
  "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": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

베어메탈 솔루션 서버

다음은 에이전트 상태 측정항목 수집이 사용 설정된베어메탈 솔루션 서버에서 실행되는 SAP용 Google Cloud 에이전트의 완료된 구성 파일의 예시입니다.

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1"
    "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

구성 매개변수

다음 표에서는 에이전트 상태 측정항목 수집과 관련된 SAP용 Google Cloud 에이전트의 구성 매개변수를 설명합니다.

매개변수

매개변수
`collection_configuration.collect_agent_metrics`	`Boolean` 선택사항입니다. 에이전트에서 다음 정보를 수집하고 Cloud Monitoring으로 전송할 수 있게 하려면 `true`를 지정합니다. 호스트의 에이전트 데몬 프로세스에서 사용하는 CPU 및 메모리 사용량입니다. 호스트의 에이전트 데몬 프로세스 운영 상태입니다. 기본값은 `false`입니다.
`collection_configuration.agent_metrics_frequency`	`Int` 선택사항입니다. 에이전트가 호스트에서 데몬 프로세스의 CPU 및 메모리 사용량을 수집하여 Cloud Monitoring으로 전송하는 빈도를 지정합니다. 이 정보는 `sap/agent/cpu/utilization` 및 `sap/agent/memory/utilization` 측정항목에서 캡처됩니다. 기본값은 `60`초입니다. 빈도는 5초 이상이어야 합니다.
`collection_configuration.agent_health_frequency`	`Int` 선택사항입니다. 에이전트에서 운영 상태를 확인하고 해당 정보를 Cloud Monitoring으로 전송하는 빈도를 지정합니다. 이 정보는 `sap/agent/health` 측정항목에서 캡처됩니다. 기본값은 `60`초입니다. 빈도는 5초 이상이어야 합니다.

collection_configuration.collect_agent_metrics

Boolean

선택사항입니다. 에이전트에서 다음 정보를 수집하고 Cloud Monitoring으로 전송할 수 있게 하려면 true를 지정합니다.

호스트의 에이전트 데몬 프로세스에서 사용하는 CPU 및 메모리 사용량입니다.
호스트의 에이전트 데몬 프로세스 운영 상태입니다.

기본값은 false입니다.

collection_configuration.agent_metrics_frequency

Int

선택사항입니다. 에이전트가 호스트에서 데몬 프로세스의 CPU 및 메모리 사용량을 수집하여 Cloud Monitoring으로 전송하는 빈도를 지정합니다. 이 정보는 sap/agent/cpu/utilization 및 sap/agent/memory/utilization 측정항목에서 캡처됩니다. 기본값은 60초입니다. 빈도는 5초 이상이어야 합니다.

collection_configuration.agent_health_frequency