AWS CDK를 사용하여 여러 AWS 지역, 계정 및 DevOps OU에서 Amazon Guru를 활성화하여 운영 성능을 개선하십시오.

AWS 네임드 프로필을 구성

다중 계정 환경에서 스택을 배포하려면 다음과 같이 AWS 네임드 프로필을 설정하세요.

관리자 계정의 경우

$aws configure --profile administrator
AWS Access Key ID [****]: <your-administrator-access-key-ID>
AWS Secret Access Key [****]: <your-administrator-secret-access-key>
Default region name [None]: <your-administrator-region>
Default output format [None]: json

대상 계정의 경우

$aws configure --profile target
AWS Access Key ID [****: <your-target-access-key-ID>
AWS Secret Access Key [****]: <your-target-secret-access-key>
Default region name [None]: <your-target-region>
Default output format [None]: json

자세한 내용은 AWS CLI 설명서에서 네임드 프로파일 사용을 참조하세요.

AWS 프로필 구성 확인

(선택 사항) AWS CLI 설명서의 설정 및 보기 구성 설정에 있는 지침에 따라 credentials 및 config 파일에서 AWS 프로필 구성을 확인할 수 있습니다.

AWS CDK 버전을 확인합니다.

다음 명령을 실행하여 AWS CDK Toolkit 버전을 확인하세요.

$cdk --version

이 패턴을 사용하려면 버전 1.107.0 이상이 필요합니다. 이전 버전의 AWS CDK를 사용 중이면 AWS CDK 문서에 있는 지침에 따라 업데이트하세요.

프로젝트 코드 복제

다음 명령을 사용하여 이 패턴의 GitHub 저장소를 복제합니다.

$git clone https://github.com/aws-samples/amazon-devopsguru-cdk-samples.git

패키지 종속성을 설치하고 파일을 컴파일합니다. TypeScript

다음 명령을 실행하여 패키지 종속성을 설치하고 TypeScript 파일을 컴파일합니다.

$cd amazon-devopsguru-cdk-samples
$npm install
$npm fund

이 명령은 샘플 저장소의 모든 패키지를 설치합니다.

중요: 누락된 패키지와 관련된 오류가 발생하면 다음 명령 중 하나를 사용하세요.

$npm ci

—또는—

$npm install -g @aws-cdk/<package-name>

패키지 이름과 버전 목록은 /amazon-devopsguru-cdk-samples/package.json 파일의 Dependencies 섹션에서 확인할 수 있습니다. 자세한 내용은 npm 설명서에 있는 npm ci와 npm install을 참조하세요.

Amazon SNS 알림 이메일 주소를 구성합니다.

Amazon SNS 알림 이메일 주소를 제공하려면 다음 단계를 따르세요.

프로젝트 코드를 작성합니다.

명령을 실행하여 프로젝트 코드를 작성하고 스택을 합성하세요.

npm run build && cdk synth 

다음과 유사한 출력 화면이 표시되어야 합니다. 

$npm run build && cdk synth
> cdk-devopsguru@0.1.0 build
> tsc
Successfully synthesized to ~/amazon-devopsguru-cdk-samples/cdk.out
Supply a stack id (CdkDevopsGuruStackMultiAccReg,CdkDevopsGuruStackMultiAccRegSpecStacks, CdkDevopsguruStackOrgUnit, CdkInfrastructureStack, CdkStackSetAdminRole, CdkStackSetExecRole) to display its template.

자세한 정보와 절차는 AWS CDK 문서에서 첫 번째 AWS CDK 앱을 참조하세요.

AWS CDK 스택을 나열합니다.

다음 명령을 실행하여 모든 AWS CDK 스택을 나열하세요.

$cdk list

이 명령은 다음 목록을 표시합니다.

CdkDevopsGuruStackMultiAccReg
CdkDevopsGuruStackMultiAccRegSpecStacks
CdkDevopsguruStackOrgUnit
CdkInfrastructureStack
CdkStackSetAdminRole
CdkStackSetExecRole

IAM 역할 생성에 필요한 AWS CDK 스택을 배포합니다.

이 패턴은 CloudFormation StackSetsAWS를 사용하여 여러 계정에서 스택 작업을 수행합니다. 첫 번째 스택 집합을 생성하는 경우, AWS 계정에 필요한 권한을 설정하려면 다음 IAM 역할을 만들어야 합니다.

참고: 역할에는 다음과 같은 정확한 이름이 있어야 합니다.

자세한 내용은 AWS CloudFormation 설명서의 자체 관리 권한 부여를 참조하십시오.

AWS CDK 스택을 배포하여 여러 계정에 DevOps Guru를 활성화하십시오.

AWS CDK CdkDevopsGuruStackMultiAccReg 스택은 여러 계정과 리전에 걸쳐 스택 인스턴스를 배포하기 위한 스택 세트를 생성합니다. 스택을 배포하려면 지정된 매개변수와 함께 다음 CLI 명령을 실행합니다.

$cdk deploy CdkDevopsGuruStackMultiAccReg \
  --profile administrator \
  --parameters AdministratorAccountId=<administrator-account-ID> \
  --parameters TargetAccountId=<target-account-ID> \
  --parameters RegionIds="<region-1>,<region-2>"

현재 Amazon DevOps Guru는 Guru FAQ에 나열된 AWS 지역에서 사용할 수 있습니다. DevOps

OU ID를 추출합니다.

AWS Organizations 콘솔에서 DevOps Guru를 활성화하려는 조직 단위의 ID를 식별합니다.

OU에 대한 서비스 관리형 권한을 활성화합니다.

계정 관리에 AWS Organizations를 사용하는 경우 서비스 관리 권한을 부여하여 Guru를 DevOps 활성화해야 합니다. IAM 역할을 수동으로 만드는 대신 조직 기반 신뢰할 수 있는 액세스 및 서비스 연결 역할(SLR)을 사용하세요.

AWS CDK 스택을 배포하여 DevOps OU 전체에 Guru를 활성화하십시오.

AWS CDK CdkDevopsguruStackOrgUnit 스택은 OU 전반에 걸쳐 DevOps Guru 서비스를 지원합니다. 스택을 배포하려면 지정된 매개변수와 함께 다음 명령을 실행하세요.

$cdk deploy CdkDevopsguruStackOrgUnit \
  --profile administrator \ 
  --parameters RegionIds="<region-1>,<region-2>" \
  --parameters OrganizationalUnitIds="<OU-1>,<OU-2>"

IAM 역할 생성에 필요한 AWS CDK 스택을 배포합니다.

첫 번째 옵션에 표시된 필수 IAM 역할을 아직 만들지 않았다면 먼저 만들어야 합니다.

자세한 내용은 AWS CloudFormation 설명서의 자체 관리 권한 부여를 참조하십시오.

기존 스택을 삭제하세요.

모든 스택 리소스에 대해 DevOps Guru를 활성화하는 첫 번째 옵션을 이미 사용한 경우 다음 명령을 사용하여 이전 스택을 삭제할 수 있습니다.

$cdk destroy CdkDevopsGuruStackMultiAccReg --profile administrator 

또는 스택을 다시 배포할 때  RegionIds 매개변수를 변경하여 스택이 이미 존재함 오류를 방지할 수 있습니다.

스택 목록으로 AWS CDK 스택을 업데이트하세요.

DevOps Guru가 여러 계정의 특정 스택 리소스를 사용할 수 있도록 AWS CDK 스택을 배포하십시오.

AWS CDK CdkDevopsGuruStackMultiAccRegSpecStacks 스택을 사용하면 DevOps Guru가 여러 계정의 특정 스택 리소스를 사용할 수 있습니다. 스택을 배포하려면 다음 명령을 실행하세요.

$cdk deploy CdkDevopsGuruStackMultiAccRegSpecStacks \
  --profile administrator  \
  --parameters AdministratorAccountId=<administrator-account-ID> \
  --parameters TargetAccountId=<target-account-ID> \
  --parameters RegionIds="<region-1>,<region-2>"

참고: 이전에 옵션 1을 위해 이 스택을 배포했다면 RegionIds 매개변수를 변경(사용 가능한 리전 중에서 선택)하여 스택이 이미 존재함 오류를 방지하세요.

샘플 서버리스 인프라 스택을 배포하세요.

AWS CDK CdkInfrastructureStack 스택은 API Gateway, Lambda 및 DynamoDB 테이블과 같은 서버리스 구성 요소를 배포하여 Guru 통찰력을 입증합니다. DevOps 스택을 배포하려면 다음 명령을 실행하세요. 

$cdk deploy CdkInfrastructureStack --profile administrator

DynamoDB에 샘플 레코드를 삽입하세요.

다음 명령을 실행하여 샘플 레코드로 DynamoDB 테이블을 채웁니다. populate-shops-dynamodb-table.json 스크립트의 올바른 경로를 입력합니다.

$aws dynamodb batch-write-item \
  --request-items file://scripts/populate-shops-dynamodb-table.json \
  --profile administrator

이 명령은 다음 출력을 표시합니다.

{
    "UnprocessedItems": {}
}

DynamoDB에서 삽입된 레코드를 확인하세요.

DynamoDB 테이블에 populate-shops-dynamodb-table.json 파일의 샘플 레코드가 포함되어 있는지 확인하려면 AWS CDK 스택의 출력으로 게시되는 ListRestApiEndpointMonitorOperator API의 URL에 액세스합니다. CdkInfrastructureStack스택용 AWS CloudFormation 콘솔의 출력 탭에서도 이 URL을 찾을 수 있습니다. AWS CDK 출력은 다음과 유사하게 표시됩니다.

CdkInfrastructureStack.CreateRestApiMonitorOperatorEndpointD1D00045 = https://oure17c5vob.execute-api.<your-region>.amazonaws.com/prod/

CdkInfrastructureStack.ListRestApiMonitorOperatorEndpointABBDB8D8 = https://cdff8icfrn4.execute-api.<your-region>.amazonaws.com/prod/

리소스가 기준선 설정을 완료할 때까지 기다립니다.

이 서버리스 스택에는 몇 가지 리소스가 있습니다. 다음 단계를 수행하기 전에 2시간 정도 기다리는 것이 좋습니다. 프로덕션 환경에 이 스택을 배포한 경우 Guru에서 DevOps 모니터링하도록 선택한 리소스 수에 따라 기준 설정을 완료하는 데 최대 24시간이 걸릴 수 있습니다.

AWS CDK 인프라 스택을 업데이트하세요.

DevOps Guru Insights를 사용해 보려면 구성을 일부 변경하여 일반적인 운영 문제를 재현할 수 있습니다.

API에 HTTP 요청을 삽입합니다.

ListRestApiMonitorOperatorEndpointxxxx API에 HTTP 요청 형태로 인그레스 트래픽을 삽입합니다.

DevOps Guru 인사이트를 검토하세요.

표준 조건에서 DevOps Guru 대시보드는 진행 중인 인사이트 카운터에 0을 표시합니다. 이상 징후가 감지되면 인사이트 형태로 경보를 발령합니다. 탐색 창에서 인사이트를 선택하여 개요, 집계된 메트릭, 관련 이벤트, 권장 사항 등 이상 징후에 대한 세부 정보를 확인합니다. 인사이트 검토에 대한 자세한 내용은 Amazon DevOps Guru를 사용하여 AIOps로 운영 인사이트 확보하기 블로그 게시물을 참조하십시오.

리소스를 정리하고 삭제합니다.

이 패턴을 수행한 다음에는 추가 요금이 발생하지 않도록 생성한 리소스를 제거해야 합니다. 명령을 실행합니다.

$cdk destroy CdkDevopsGuruStackMultiAccReg --profile administrator
$cdk destroy CdkDevopsguruStackOrgUnit --profile administrator
$cdk destroy CdkDevopsGuruStackMultiAccRegSpecStacks --profile administrator
$cdk destroy CdkInfrastructureStack --profile administrator
$cdk destroy CdkStackSetAdminRole --profile administrator
$cdk destroy CdkStackSetExecRole --profile administrator
$cdk destroy CdkStackSetExecRole --profile target