SAP용Google Cloud에이전트 버전 3.8(최신)과 관련된 문제의 경우 가능한 한 빨리 다음 진단 정보를 Cloud Customer Care에 제공하세요.
문제에 대한 자세한 설명
에이전트 버전, 문제가 발생한 날짜와 시간 등 문제에 대한 완전하고 자세한 설명을 제공합니다.
에이전트 버전을 확인하려면 다음 단계를 수행합니다.
Linux
RHEL의 경우 다음 단계를 수행합니다.
- SSH를 사용하여 호스트 Compute Engine 인스턴스나 베어메탈 솔루션 서버에 연결합니다.
- 다음 명령어를 실행합니다.
yum info google-cloud-sap-agent
SLES의 경우 다음 단계를 수행합니다.
- SSH를 사용하여 호스트 Compute Engine 인스턴스나 베어메탈 솔루션 서버에 연결합니다.
- 다음 명령어를 실행합니다.
zypper info google-cloud-sap-agent
Windows
- RDP를 사용하여 호스트 Compute Engine 인스턴스나 베어메탈 솔루션 서버에 연결합니다.
- 관리자 권한으로 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_report
및supportconfig
유틸리티의 출력이/tmp/google-cloud-sap-agent/pacemaker-TIMESTAMP
디렉터리에 저장됩니다. 이러한 유틸리티 실행이 실패하면hb_report
및crm_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
- 에이전트가 Cloud Logging 로그에서 사전 정의된 SAP 이벤트 발생에 대한 정보를 수집할 수 있게 하려면 다음 요구사항을 충족해야 합니다.
지원 번들 생성
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 시스템 IDINSTANCE_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
- SSH를 사용하여 호스트 머신에 연결합니다.
- 다음 명령어를 실행합니다.
curl http://localhost:18181/
Windows
- RDP를 사용하여 호스트 머신에 연결합니다.
- 관리자 권한으로 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