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

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

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

시작하기 전에

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

IAM 권한 설정

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

서비스 계정에 이러한 필수 권한을 추가하려면 다음 단계를 따르세요.

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

   IAM으로 이동

2. Google Cloud 프로젝트를 선택합니다.

3. 역할을 추가할 서비스 계정을 찾습니다.

   • 서비스 계정이 주 구성원 목록에 아직 없는 경우 어떠한 역할도 할당되지 않은 것입니다. 액세스 권한 부여를 클릭하고 서비스 계정의 이메일 주소를 입력합니다.
   • 서비스 계정이 주 구성원 목록에 이미 있는 경우 기존 역할이 있는 것입니다. 수정하려는 서비스 계정에서 수정 버튼을 클릭합니다.

4. 사용 가능한 역할 목록에서 필요한 역할을 선택합니다.

   • 모니터링 > 모니터링 측정항목 작성자

5. 저장을 클릭하여 서비스 계정에 역할을 적용합니다.

세분화된 액세스 수준의 경우 다음 IAM 권한을 자체 커스텀 역할에 설정할 수 있습니다.

• 측정항목 수집:
  • 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

구성 파일 예시

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

{
  "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
  }
}

구성 매개변수

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