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

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

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

시작하기 전에

필요한 역할

서비스 계정에 SAP용 Google Cloud에이전트가 에이전트 상태 측정항목을 수집하도록 허용하는 데 필요한 권한이 있는지 확인하려면 관리자에게 서비스 계정에 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 Google Cloud의 SAP용 상담사가 상담사 상태 측정항목을 수집하도록 허용하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

Google Cloud의 SAP용 에이전트가 에이전트 상태 측정항목을 수집하도록 허용하려면 다음 권한이 필요합니다.

  • 호스트 Compute Engine 인스턴스에서 에이전트 상태 측정항목을 수집하여 Cloud Monitoring에 쓰려면 다음 단계를 따르세요. monitoring.timeSeries.create

관리자는 커스텀 역할이나 다른 사전 정의된 역할을 사용하여 서비스 계정에 이러한 권한을 부여할 수도 있습니다.

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

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

  1. 호스트 Compute Engine 인스턴스 또는 베어메탈 솔루션 서버와 SSH 연결을 설정합니다.

  2. 에이전트 상태 측정항목 수집을 사용 설정합니다.

    명령어 실행

    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 인스턴스

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

{
  "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
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

베어메탈 솔루션 서버

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

{
  "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, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }

구성 매개변수

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

매개변수
collection_configuration.collect_agent_metrics

Boolean

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

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

기본값은 false입니다.

collection_configuration.agent_metrics_frequency

Int

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

collection_configuration.agent_health_frequency

Int

선택사항. 에이전트에서 운영 상태를 확인하고 해당 정보를 Cloud Monitoring으로 전송하는 빈도를 지정합니다. 이 정보는 sap/agent/health 측정항목에서 캡처됩니다. 기본값은 60초입니다. 빈도는 5초 이상이어야 합니다.