View a markdown version of this page

AWSSupport-CollectSAPHANALogs - AWS Systems Manager Automation 런북 참조

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWSSupport-CollectSAPHANALogs

설명

AWSSupport-CollectSAPHANALogs 실행서는 AWS 배포 시 SAP의 일부인 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스의 SAP HANA에서 시스템 로그를 수집합니다. Amazon EC2 인스턴스는 AWS Systems Manager (Systems Manager)에서 관리해야 합니다. 실행서는 필수 패키지를 확인하고 누락된 경우 이를 설치하며, 감지된 운영 체제에 적합한 로그 수집 도구를 실행하고, 선택적으로 수집된 로그를 Amazon Simple Storage Service(Amazon S3) 버킷에 업로드합니다.

중요

이 실행서는 /var/log 파티션에 최소 200MB의 사용 가능한 디스크 공간이 필요합니다. 이 실행서를 실행하면 대상 Amazon EC2 인스턴스에 추가 패키지가 설치될 수 있습니다. Acknowledgement 파라미터를 로 설정하여 이를 승인해야 합니다Yes. Amazon S3에 로그를 저장하면 표준 Amazon S3 스토리지 및 요청 요금이 발생합니다.

지원되는 운영 체제

  • Red Hat Enterprise Linux 8.4 이상

  • SUSE Linux Enterprise Server 12 SP5

  • SUSE Linux Enterprise Server 15 SP3 이상

누락된 경우 설치된 패키지

SUSE Linux Enterprise Server:

  • supportutils

  • yast2-support

  • supportutils-plugin-suse-public-cloud

  • supportutils-plugin-ha-sap

  • crmsh

  • unzip

  • curl

  • aws-cli (선택 사항, InstallAWSCLI가 로 설정된 경우 설치됨Yes)

Red Hat Enterprise Linux:

  • sos

  • crm_report

  • unzip

  • curl

  • aws-cli (선택 사항, InstallAWSCLI가 로 설정된 경우 설치됨Yes)

이 자동화 실행(콘솔)

문서 유형

자동화

소유자

Amazon

플랫폼

Linux

파라미터

  • AutomationAssumeRole

    유형: 문자열

    설명: (선택 사항) 사용자를 대신하여 Systems Manager Automation을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름(ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.

  • InstanceID

    유형: AWS::EC2::Instance::Id

    설명: (필수) 로그를 수집해야 하는 SAP 워크로드를 실행하는 Amazon EC2 인스턴스의 ID입니다.

  • 확인

    유형: 문자열

    유효한 값: Yes

    설명: (필수)이 실행서는 로그 수집을 위해 대상 Amazon EC2 인스턴스에 추가 패키지를 설치할 수 있음을 확인합니다.

  • S3LogDestination

    유형: AWS::S3::Bucket::Name

    설명: (선택 사항) 로그가 업로드되는 Amazon S3 버킷의 이름입니다. 버킷은 퍼블릭이 아니어야 하며 동일한 AWS 계정에 속해야 합니다. 제공되지 않으면 로그가 인스턴스 로컬 스토리지에 저장됩니다.

  • S3Prefix

    유형: 문자열

    기본값: AWSSupport-CollectSAPHANALogs

    허용되는 패턴: ^$|^[a-zA-Z0-9][-./a-zA-Z0-9]{0,255}$

    설명: (선택 사항) 로그가 저장되는 Amazon S3 버킷 접두사입니다. 제공되지 않은 경우 기본값은 입니다AWSSupport-CollectSAPHANALogs.

  • InstallAWSCLI

    유형: 문자열

    유효한 값: Yes | No

    기본값: 아니요

    설명: (선택 사항) 인스턴스에 AWS CLI를 설치할지 여부입니다. Yes인 경우 실행서는 아직 없는 경우 AWS CLI를 설치합니다.

필수 IAM 권한

실행서를 성공적으로 사용하려면 AutomationAssumeRole 파라미터에 다음 작업이 필요합니다.

  • ssm:DescribeInstanceInformation

  • ssm:SendCommand

  • ssm:GetCommandInvocation

  • s3:GetBucketPublicAccessBlock

  • s3:GetBucketAcl

  • s3:GetBucketLocation

  • s3:GetBucketOwnershipControls

  • s3:GetEncryptionConfiguration

  • s3:PutObject

문서 단계

  1. AssertInstanceIsSSMManaged - 대상 Amazon EC2 인스턴스가 Systems Manager에서 관리되고 PingStatus의가 있는지 확인합니다Online. 인스턴스를 관리하지 않으면 실행서가 취소됩니다.

  2. GetInstanceInformation - 적절한 로그 수집 방법을 결정하는 데 사용되는 플랫폼 이름을 포함하여 지정된 Amazon EC2 인스턴스에 대한 정보를 검색합니다.

  3. CollectLogs - 인스턴스에서 셸 스크립트를 실행하여 로그를 수집합니다. SUSE Linux Enterprise Server 인스턴스의 경우 스크립트는를 사용합니다supportconfig. Red Hat Enterprise Linux 인스턴스의 경우를 사용합니다sos report. HA 클러스터의 경우 스크립트는 crm report 명령을 사용하여 지난 7일 동안의 추가 HA 로그도 수집합니다. 누락된 경우 필수 패키지가 설치됩니다.

  4. BranchOnS3BucketProvided - Amazon S3 버킷이에 제공되었는지 여부에 따라 실행을 분기합니다S3LogDestination. 버킷이 제공되지 않은 경우 실행서는 로 건너뜁니다GenerateReport. 그렇지 않으면 로 진행됩니다CheckS3BucketPublicStatus.

  5. CheckS3BucketPublicStatus -에 지정된 Amazon S3 버킷S3LogDestination이 서버 측 암호화(SSE)로 구성되어 있는지, 익명 또는 퍼블릭 읽기 또는 쓰기 액세스 권한을 허용하는지 확인합니다. 또한 실제 버킷 소유자가 예상 버킷 소유자와 동일한지 확인합니다. 이 단계가 실패하면 런북은 업로드GenerateReport하지 않고 계속됩니다.

  6. UploadLogsToS3 - 수집된 로그를 지정된 Amazon S3 버킷에 업로드합니다. InstallAWSCLI이 로 설정되어 Yes 있고 AWS CLI가 설치되지 않은 경우 스크립트는 업로드하기 전에 AWS CLI를 설치합니다.

  7. GenerateReport - 로그 수집 프로세스에 대한 보고서를 생성합니다. Amazon S3 버킷이 제공된 경우 로그가 업로드된 Amazon S3 버킷 이름과 접두사가 포함됩니다. 그렇지 않으면 로그가 인스턴스에 로컬로 저장되었음을 나타냅니다. 또한 이전 단계가 실패한 이유도 보고합니다.

출력

GenerateReport.Summary - 로그 수집 결과의 요약입니다.

GenerateReport.LogLocation - 로그가 저장된 위치, 인스턴스의 로컬 경로 또는 Amazon S3 URI.

GenerateReport.Status - 로그 수집 실행의 전체 상태입니다.

지침

다음 단계에 따라 자동화를 구성합니다.

  1. Systems ManagerAWSSupport-CollectSAPHANALogs의 문서로 이동합니다.

  2. Execute automation(자동화 실행)을 선택합니다.

  3. 입력 파라미터에 다음을 입력합니다.

    • AutomationAssumeRole(선택 사항):

      Systems Manager Automation이 사용자를 대신하여 작업을 수행할 수 있도록 허용하는 IAM 역할의 ARN입니다. 역할이 지정되지 않은 경우 Systems Manager Automation은이 실행서를 시작하는 사용자의 권한을 사용합니다.

    • InstanceID(필수):

      SAP 워크로드를 실행하는 Amazon EC2 인스턴스의 ID입니다.

    • 승인(필수):

      를 입력하여 실행서가 대상 Amazon EC2 인스턴스에 추가 패키지를 설치할 수 있음을 Yes 확인합니다.

    • S3LogDestination(선택 사항):

      로그를 업로드할 Amazon S3 버킷의 이름입니다. 제공되지 않으면 로그가 인스턴스에 로컬로 저장됩니다.

    • S3Prefix(선택 사항):

      저장된 로그의 Amazon S3 버킷 접두사입니다. 기본값은 AWSSupport-CollectSAPHANALogs입니다.

    • InstallAWSCLI(선택 사항):

      인스턴스에 없는 경우 AWS CLI를 자동으로 설치Yes하려면 선택합니다. 기본값은 No입니다.

  4. 실행을 선택합니다.

  5. 자동화가 시작됩니다.

  6. 문서는 다음 단계를 수행합니다.

    • AssertInstanceIsSSMManaged

      대상 Amazon EC2 인스턴스가 Systems Manager에서 관리되고 PingStatus의가 있는지 확인합니다Online.

    • GetInstanceInformation

      플랫폼 이름을 포함하여 지정된 Amazon EC2 인스턴스에 대한 정보를 검색합니다.

    • CollectLogs

      셸 스크립트를 실행하여 용 SLES 또는 supportconfig용를 사용하여 로그sos report를 수집합니다RHEL. HA 클러스터의 경우는를 사용하여 지난 7일간의 HA 로그도 수집합니다crm report.

    • BranchOnS3BucketProvided

      Amazon S3 버킷이 제공되지 않은 GenerateReport 경우 로 건너뛰고, 그렇지 않으면 로 진행합니다CheckS3BucketPublicStatus.

    • CheckS3BucketPublicStatus

      Amazon S3 버킷에 SSE가 활성화되어 있고, 퍼블릭 액세스를 허용하지 않으며, 동일한 AWS 계정이 소유하고 있는지 확인합니다.

    • UploadLogsToS3

      수집된 로그를 지정된 Amazon S3 버킷에 업로드합니다. InstallAWSCLI가 Yes 있고 아직 없는 경우 AWS CLI를 설치합니다.

    • GenerateReport

      로그 위치 및 모든 단계 실패를 포함하여 로그 수집 결과의 요약을 생성합니다.

  7. 완료 후 출력 섹션에서 실행의 자세한 결과를 검토합니다.

참조

Systems Manager Automation