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 인스턴스의 에이전트를 구성하려면 다음 명령어를 실행합니다.

  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 명령어와 함께 사용할 수 있는 인수를 설명합니다.