SAP용 Google Cloud 에이전트의 구성 명령어

이 문서에서는 SAP용 Google Cloud 에이전트 구성을 수정하는 데 사용할 수 있는 명령어를 보여줍니다. 이러한 명령어는 에이전트 버전 3.2에서 지원됩니다.

에이전트 구성 파일 /etc/google-cloud-sap-agent/configuration.json을 수정하는 대안으로 구성 명령어를 사용할 수 있습니다. 또한 각 구성 명령어는 변경사항이 적용되도록 에이전트를 다시 시작합니다.

에이전트 재시작 한도

60초 동안 SAP용 Google Cloud 에이전트를 최대 3회까지 다시 시작할 수 있습니다. 이 기간 동안 구성 명령어를 실행하여 에이전트를 계속 구성할 수 있지만 이 한도를 초과하는 모든 자동 다시 시작 작업은 실패하고 Could not restart the agent가 출력됩니다.

이 출력이 표시되면 모든 필수 구성 명령어를 실행한 후 변경사항이 적용되도록 에이전트를 수동으로 다시 시작해야 합니다. 자세한 안내는 에이전트 다시 시작을 참조하세요.

도움말 명령어

에이전트의 google_cloud_sap_agent configure 명령어에 대한 요약 도움말을 출력하고 종료하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -help
```
에이전트 인스턴스의 기능 상태를 출력하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -showall
```
에이전트 인스턴스의 버전을 출력하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -version
```

google_cloud_sap_agent configure 명령어에서 지원하는 인수는 지원되는 인수를 참조하세요.

최상위 설정

베어메탈 솔루션 서버의 에이전트를 구성하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -enable
```
Compute Engine VM 인스턴스의 에이전트를 구성하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -disable
```
에이전트의 로깅 수준을 설정하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -loglevel=LOG_LEVEL
```
LOG_LEVEL을 지원되는 로그 수준인 debug, info, warn 또는 error 중 하나로 바꿉니다.

SAP 시스템 검색

에이전트가 SAP 시스템에서 사용하는 SAP 제품의 이름과 버전을 수집하게 하려면 다음 안내를 따르세요.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable
```
에이전트가 SAP 시스템에서 사용하는 SAP 제품의 이름과 버전을 수집하지 못하게 하려면 다음 안내를 따르세요.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -disable
```
에이전트에서 검색된 SAP 시스템 정보를 Cloud Logging으로 전송하고 Google Cloud 프로젝트에서 Workload Manager API가 사용 설정된 경우에 Workload Manager로 전송하게 하려면 다음 안내를 따르세요.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
```
에이전트에서 검색한 정보를 Cloud Logging 및 워크로드 관리자로 전송하지 못하게 하려면 다음 안내를 따르세요.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -disable
```

SAP 호스트 에이전트 측정항목 수집

에이전트가 SAP 호스트 에이전트 측정항목을 수집하도록 허용하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=host_metrics -enable
```
SAP 호스트 에이전트 측정항목 수집을 중지하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=host_metrics -disable
```

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

에이전트 상태 측정항목 수집을 사용 설정하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -enable
```
에이전트 상태 측정항목 수집을 중지하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -disable
```
에이전트에서 데몬 프로세스의 CPU 및 메모리 사용량을 수집하고 Cloud Monitoring으로 전송하는 빈도를 수정하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_metrics_frequency=FREQUENCY
```
FREQUENCY를 필수 값(초)으로 바꿉니다. 빈도는 5초 이상이어야 합니다.
에이전트에서 운영 상태를 검사하고 해당 정보를 Cloud Monitoring으로 전송하는 빈도를 수정하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY
```

프로세스 모니터링 측정항목 수집

에이전트에서 프로세스 모니터링 측정항목을 수집하도록 허용하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
```
프로세스 모니터링 측정항목 수집을 중지하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -disable
```
에이전트에서 빠르게 변경되는 프로세스 모니터링 측정항목을 수집해야 하는 빈도를 수정하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_frequency=FREQUENCY
```
에이전트에서 느리게 변경되는 프로세스 모니터링 측정항목을 수집해야 하는 빈도를 수정하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -slow_process_metrics_frequency=FREQUENCY
```
FREQUENCY를 에이전트에서 측정항목을 수집해야 하는 빈도(초)로 바꿉니다.
모든 프로세스 모니터링 측정항목 수집을 중지하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -add
```
에이전트에서 중지한 프로세스 모니터링 측정항목 수집을 계속하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -remove
```
LIST_OF_METRICS를 에이전트에서 수집을 계속하려는 프로세스 모니터링 측정항목의 이름으로 바꿉니다. 측정항목 이름을 구분하려면 쉼표를 사용합니다.

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

에이전트에서 워크로드 관리자 평가 측정항목을 수집하게 하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable
```
워크로드 관리자 평가 측정항목 수집을 중지하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -disable
```
에이전트에서 워크로드 관리자 평가 측정항목을 수집해야 하는 빈도를 수정하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -workload_evaluation_metrics_frequency=FREQUENCY
```
FREQUENCY를 에이전트에서 워크로드 관리자 평가 측정항목을 수집해야 하는 빈도(초)로 바꿉니다.
워크로드 관리자 평가를 위해 에이전트에서 SAP HANA 데이터베이스 측정항목을 수집해야 하는 빈도를 수정하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -workload_evaluation_db_metrics_frequency=FREQUENCY
```
워크로드 관리자 평가를 위해 FREQUENCY를 에이전트에서 SAP HANA 데이터베이스 측정항목을 수집해야 하는 빈도(초)로 바꿉니다.

SAP HANA 모니터링 측정항목 수집

에이전트에서 SAP HANA 모니터링 측정항목을 수집하도록 허용하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
```
SAP HANA 모니터링 측정항목 수집을 중지하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -disable
```
에이전트에서 SAP HANA 모니터링 측정항목을 수집해야 하는 샘플 간격을 수정하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -sample_interval_sec=SAMPLE_INTERNAL
```
SAMPLE_INTERNAL을 간격(초)로 바꿉니다. 간격은 5초 이상이어야 합니다.
SAP HANA 인스턴스에 수행된 쿼리의 제한 시간 값을 수정하려면 다음 명령어를 실행합니다.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -query_timeout_sec=QUERY_TIMEOUT
```
QUERY_TIMEOUT을 값(초)으로 바꿉니다.

지원되는 인수

다음 표에서는 google_cloud_sap_agent configure 명령어와 함께 사용할 수 있는 인수를 설명합니다.

인수	설명
`-add`	이 인수를 사용하면 에이전트에서 개발자가 `-process_metrics_to_skip` 인수에 지정하는 프로세스 모니터링 측정항목 수집을 중지합니다.
`-disable`	에이전트의 지정된 기능이나 매개변수를 중지합니다.
`-enable`	에이전트의 지정된 기능이나 매개변수를 사용 설정합니다.
`-f`=`FEATURE_NAME` 또는 `-feature`=`FEATURE_NAME`	`STRING` 구성하려는 에이전트 기능을 설정합니다. 지원되는 값은 다음과 같습니다. `host_metrics` `process_metrics` `agent_metrics` `hana_monitoring` `workload_evaluation` `sap_discovery`
`-h` 또는 `-help`	명령어의 도움말 정보를 표시합니다.
`-loglevel`=`LOG_LEVEL`	`STRING` 에이전트의 로깅 수준을 설정합니다. 지원되는 값은 `debug`, `info`, `warn`, `error`입니다.
`-path`=`PATH`	`STRING` 에이전트 구성 파일의 경로(`/etc/google-cloud-sap-agent/configuration.json`)를 설정합니다.
`-process_metrics_to_skip`="`LIST_OF_METRICS`"	`STRING` 에이전트에서 수집을 중지해야 하는 프로세스 모니터링 측정항목을 지정합니다. 측정항목 이름을 구분하려면 쉼표를 사용합니다. `-add` 및 `-remove` 인수를 `-process_metrics_to_skip`과 함께 사용합니다.
`-process_metrics_frequency`=`FREQUENCY`	`INT` 에이전트에서 빠르게 변경되는 프로세스 모니터링 측정항목을 수집하는 빈도를 설정합니다. 기본값은 `5`초입니다.
`-slow_process_metrics_frequency`=`FREQUENCY`	`INT` 에이전트에서 느리게 변경되는 프로세스 모니터링 측정항목을 수집하는 빈도를 설정합니다. 기본값은 `30`초입니다.
`-query_timeout_sec`=`TIMEOUT`	`INT` SAP HANA 모니터링 측정항목 수집에 대한 쿼리 제한 시간(초)을 설정합니다.
`-remove`	이 인수를 사용하면 에이전트에서 개발자가 `-process_metrics_to_skip` 인수 사용을 중지한 프로세스 모니터링 측정항목 수집을 다시 시작합니다.
`-sample_interval_sec`=`INTERVAL`	`INT` 에이전트에서 SAP HANA 인스턴스를 쿼리하고 SAP HANA 모니터링 측정항목을 수집하는 빈도(초)를 설정합니다.
`-setting`=`SETTING`	`STRING` 구성할 에이전트 설정을 지정합니다.
`-showall`	에이전트 인스턴스의 기능 상태를 출력합니다.
`-slow_process_metrics_frequency`=`FREQUENCY`	`INT` 느리게 변경되는 프로세스 모니터링 측정항목의 수집 빈도(초)를 지정합니다.
`-v` 또는 `-version`	에이전트 버전을 출력합니다.
`-workload_evaluation_metrics_frequency`=`FREQUENCY`	`INT` 에이전트에서 워크로드 관리자 평가 측정항목을 수집하는 빈도를 설정합니다.
`-workload_evaluation_db_metrics_frequency`=`FREQUENCY`	`INT` 워크로드 관리자 평가를 위해 에이전트에서 SAP HANA 데이터베이스 측정항목을 수집하는 빈도를 설정합니다.