Google Cloud의 SAP용 에이전트 진단 정보

SAP용Google Cloud에이전트 버전 3.8(최신)과 관련된 문제의 경우 가능한 한 빨리 다음 진단 정보를 Cloud Customer Care에 제공하세요.

문제에 대한 자세한 설명

에이전트 버전, 문제가 발생한 날짜와 시간 등 문제에 대한 완전하고 자세한 설명을 제공합니다.

에이전트 버전을 확인하려면 다음 단계를 수행합니다.

Linux

RHEL의 경우 다음 단계를 수행합니다.

  1. SSH를 사용하여 호스트 Compute Engine 인스턴스나 베어메탈 솔루션 서버에 연결합니다.
  2. 다음 명령어를 실행합니다.
    yum info google-cloud-sap-agent

SLES의 경우 다음 단계를 수행합니다.

  1. SSH를 사용하여 호스트 Compute Engine 인스턴스나 베어메탈 솔루션 서버에 연결합니다.
  2. 다음 명령어를 실행합니다.
    zypper info google-cloud-sap-agent

Windows

  1. RDP를 사용하여 호스트 Compute Engine 인스턴스나 베어메탈 솔루션 서버에 연결합니다.
  2. 관리자 권한으로 PowerShell에서 다음 명령어를 실행합니다.
    googet installed google-cloud-sap-agent

지원 번들

지원 번들은 Customer Care에서 문제 해결 지원을 제공하는 데 도움이 되는 SAP용 Google Cloud에이전트의 정보 모음입니다. SAP용 Google Cloud에이전트 버전 2.1 이상에서 이 기능을 사용할 수 있습니다.

에이전트 버전 3.4부터 result-bucket 옵션을 사용하여 supportbundle 명령어 출력을 업로드할 수 있습니다. 이렇게 하려면 에이전트에서 사용하는 서비스 계정에 storage.objects.create IAM 권한이 있는지 확인해야 합니다.

지원 번들에 포함된 내용

  • 에이전트의 로그 및 구성 파일

    에이전트 버전 3.0부터는 여기에 에이전트의 Backint디스크 스냅샷 기능과 관련된 로그 및 구성 파일이 포함됩니다.

  • 특정 호스트 이름 및 SID의 SAP HANA trace 및 토폴로지 파일

  • SAP HANA용 Cloud Storage Backint 에이전트 구성 파일 및 로그입니다.

  • RHEL의 고가용성(HA) 클러스터인 경우 pacemaker-diagnosis="true"를 지정하면 sosreport의 출력이 /tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP 디렉터리에 저장됩니다. sosreport 명령어 실행에 실패하면 crm_report의 출력이 지정된 디렉터리에 저장됩니다.

  • SUSE의 HA 클러스터인 경우 pacemaker-diagnosis=true를 지정하면 hb_reportsupportconfig 유틸리티의 출력이 /tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP 디렉터리에 저장됩니다. 이러한 유틸리티 실행이 실패하면 hb_reportcrm_report의 출력이 지정된 디렉터리에 저장됩니다.

  • /var/log/messages 파일. Linux 시스템 작업에 대한 유용한 정보를 제공합니다.

  • 에이전트 버전 3.8부터 sapdiscovery.json 파일이 기본적으로 포함됩니다. 이 파일에는 컴퓨팅 인스턴스에서 실행 중인 SAP 제품과 관련 구성요소에 대한 정보가 포함됩니다. 이 정보는 Customer Care에 SAP 시스템의 역할과 구성에 대한 더 우수한 컨텍스트를 제공합니다.

    에이전트에서 이 정보를 수집할 수 있게 하려면 다음 요구사항을 충족해야 합니다.

    • 에이전트의 구성 파일에서 "log_to_cloud": true를 지정합니다.
    • 에이전트에서 사용하는 서비스 계정에 logging.logEntries.list IAM 권한을 부여합니다.
  • 에이전트 버전 3.8부터 metrics 옵션을 지정하면 번들에 사전 정의된 SAP 이벤트 발생에 대한 정보와 특정 기간 동안 프로세스 모니터링 측정항목SAP HANA 모니터링 측정항목 값의 변경사항이 포함됩니다.

    • 에이전트가 Cloud Logging 로그에서 사전 정의된 SAP 이벤트 발생에 대한 정보를 수집할 수 있게 하려면 다음 요구사항을 충족해야 합니다.
      • 에이전트의 구성 파일에서 "log_to_cloud": true를 지정합니다.
      • 에이전트에서 사용하는 서비스 계정에 logging.logEntries.list IAM 권한을 부여합니다.
    • 에이전트가 Cloud Monitoring에서 측정항목 값 변경사항에 대한 정보를 수집할 수 있게 하려면 다음 요구사항을 충족해야 합니다.
      • 에이전트의 구성 파일에서 "send_metrics_to_monitoring": true를 지정합니다.
      • 에이전트에서 사용하는 서비스 계정에 monitoring.metricDescriptors.get, monitoring.metricDescriptors.list, monitoring.monitoredResourceDescriptors.get, monitoring.monitoredResourceDescriptors.list, monitoring.timeSeries.list IAM 권한을 부여합니다.
    • 에이전트에서 Cloud Logging 로그와 Cloud Monitoring 항목을 필터링하는 기간은 다음 옵션 동작에 따라 결정됩니다.
      • timestamp: 사전 정의된 SAP 이벤트 유형 발생과 측정항목 값 변경사항에 대한 정보를 수집하려는 시점 주변의 타임스탬프로, YYYY-MM-DD HH:MM:SS 형식입니다. 기본값은 supportbundle 명령어를 실행한 시간입니다.
      • before-duration: timestamp 전에 에이전트에서 사전 정의된 SAP 이벤트 발생과 측정항목 값 변경사항을 검색하는 시간(초)입니다. 기본값은 3600초입니다.
      • after-duration: timestamp 이후에 에이전트에서 사전 정의된 SAP 이벤트 발생과 측정항목 값 변경사항을 검색하는 시간(초)입니다. 기본값은 1800초입니다.
    • 수집된 정보는 발생한 각 SAP 이벤트 유형과 값을 변경한 각 측정항목의 JSON 파일이 포함된 폴더로 구성됩니다. 다음은 출력이 표시되는 방식의 예시입니다.

      supportbundle/
      |--- process_metrics/
        |--- pm_sap_control_cpu_utilization.json
        |--- pm_sap_control_memory_utilization.json
      |--- hana_monitoring_metrics/
        |--- hm_sap_hanamonitoring_disk_readtime.json
        |--- hm_sap_hanamonitoring_disk_writetime.json
      |--- sap_events/
        |--- se_HA_Availability.json
        |--- se_HA_Replication.json

지원 번들 생성

Linux에서 실행되는 에이전트 인스턴스에 대한 지원 번들을 생성하려면 컴퓨팅 인스턴스에서 다음 명령어를 실행합니다.

sudo /usr/bin/google_cloud_sap_agent supportbundle --sid="SID" --instance-numbers="INSTANCE_NUMBERS" --hostname="HOST_NAME" [--pacemaker-diagnosis="BOOLEAN_VALUE"] [--result-bucket="BUCKET_NAME"] [--metrics] [--timestamp="TIMESTAMP"] [-before-duration=BEFORE_DURATION] [-after-duration=AFTER_DURATION]

다음을 바꿉니다.

  • SID: SAP 시스템 ID
  • INSTANCE_NUMBERS: 지원 번들을 생성하려는 SAP 인스턴스 번호

    여러 인스턴스 번호를 지정하려면 공백을 사용하여 구분합니다. 예를 들면 00 11 22입니다. SAP 인스턴스 번호를 2개 이상 지정하면 이 명령어는 지정된 인스턴스에 대한 하나의 지원 번들을 생성합니다.

  • HOST_NAME: 명령어를 실행할 호스트의 이름
  • BOOLEAN_VALUE: Pacemaker 관련 진단이 실행되는지 여부를 결정하는 true 또는 false 값으로 기본값은 false입니다.
  • BUCKET_NAME: supportbundle 명령어 출력을 업로드할 Cloud Storage 버킷의 이름입니다.
  • TIMESTAMP: 사전 정의된 SAP 이벤트 유형 발생과 측정항목 값 변경사항에 대한 정보를 수집하려는 시점 주변의 타임스탬프로, YYYY-MM-DD HH:MM:SS 형식입니다. 기본값은 supportbundle 명령어를 실행한 시간입니다.
  • BEFORE_DURATION: timestamp 옵션의 값 이전에 에이전트에서 사전 정의된 SAP 이벤트 발생과 측정항목 값 변경사항을 검색하는 시간(초)입니다. 기본값은 3600초입니다.
  • AFTER_DURATION: timestamp 옵션 값 이후에 에이전트에서 사전 정의된 SAP 이벤트 발생과 측정항목 값 변경사항을 검색하는 시간(초)입니다. 기본값은 1800초입니다.

에이전트가 수집한 최신 데이터

에이전트가 수집한 최신 데이터를 제공합니다. 에이전트가 수집한 최신 데이터를 파일에 저장하고 파일을 지원 케이스에 첨부합니다.

에이전트가 수집한 최신 데이터를 보려면 다음 단계를 수행합니다.

Linux

  1. SSH를 사용하여 호스트 머신에 연결합니다.
  2. 다음 명령어를 실행합니다.
    curl http://localhost:18181/

Windows

  1. RDP를 사용하여 호스트 머신에 연결합니다.
  2. 관리자 권한으로 PowerShell에서 다음 명령어를 실행합니다.
    "(Invoke-WebRequest -Uri 'http://localhost:18181').RawContent"

구성 파일

SAP HANA 데이터베이스 사용자 이름 및 비밀번호와 같은 사용자 인증 정보를 삭제한 후 SAP용 Google Cloud에이전트 구성 파일을 제공합니다.

에이전트의 구성 파일을 찾으려면 다음 경로로 이동합니다.

Linux

/etc/google-cloud-sap-agent/configuration.json

Windows

C:\Program Files\Google\google-cloud-sap-agent\conf\configuration.json

로그 파일

SAP용 Google Cloud에이전트 로그 파일을 제공합니다.

에이전트의 로그 파일을 찾으려면 다음 경로로 이동합니다.

Linux

/var/log/google-cloud-sap-agent.log

Windows

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log