Datadog-Amazon CloudFormation
AWS CloudFormation은 설명 및 설정할 수 있는 템플릿을 제공하여 고객님의 환경에서 AWS 리소스를 한 번에 프로비저닝할 수 있도록 도와드립니다. Datadog-AWS CloudFormation 리소스를 사용하면 지원되는 Datadog 리소스와 상호 작용하고, Datadog 데이터센터로 리소스를 전송하고, Datadog 리소스가 존재하는 모든 지역의 확장을 비공개로 등록할 수 있습니다.
해당 리소스에 액세스하려면 AWS 관리 콘솔(UI) 또는 AWS 명령줄 인터페이스(CLI)를 사용하세요.
AWS 관리 콘솔
시작하기:
계정으로 AWS 관리 콘솔에 로그인한 다음 CloudFormation으로 이동합니다.
왼쪽 패널에서 ‘공개 확장 프로그램’을 선택한 다음 ‘타사’로 게시자를 필터링합니다.
검색 바를 사용해 ‘Datadog’ 접두어로 필터링합니다.
참고: 모든 공식 Datadog 리소스는 Datadog::으로 시작하며 Published by Datadog이라고 명시됩니다.
원하는 리소스 이름을 선택하여 해당 스키마에 대한 자세한 정보를 확인하고 활성화를 클릭합니다.
확장 프로그램 세부 정보 페이지에서 다음을 지정합니다.
- 확장 이름
- 실행 역할 ARN
- 부 버전 릴리스에 관한 자동 업데이트
- 설정
- 리소스 설정의 경우, 일반 텍스트 대신 AWS 기밀 정보 관리자(Secrets Manager) 또는 이와 유사한 서비스를 사용하여 Datadog API 및 애플리케이션 키를 저장할 것을 강력히 권장합니다.
AWS 기밀 정보 관리자(Secrets Manager)를 사용하는 경우 설정에서 API 및 애플리케이션 키를 동적 참조할 수 있습니다. 자세한 내용을 확인하려면 AWS 문서를 참조하세요.
예시:
{
"DatadogCredentials": {
"ApiKey": "{{resolve:secretsmanager:MySecret:SecretString:SecretAPIKey}}",
"ApplicationKey": "{{resolve:secretsmanager:MySecret:SecretString:SecretAppKey}}"
}
}
US1 이외의 지역에서 계정을 사용하는 경우 ApiURL을 지정합니다. 예를 들어 EU 지역의 계정인 경우 https://api.datadoghq.eu, US5 지역의 계정인 경우 https://api.us5.datadoghq.com/ 을 사용합니다.
- 리소스를 설정한 후에는 활성화된 Datadog 리소스를 포함하는 AWS 스택을 생성합니다.
사용 가능한 명령어 및 워크플로우에 대한 자세한 내용을 확인하려면 공식 AWS 문서를 참조하세요.
AWS 명령줄 인터페이스
시작하기:
<RESOURCE_DIR>/resource-role.yaml 파일을 기반으로 CloudFormation 리소스에 대한 실행 역할을 생성합니다.
터미널에서 AWS-cli 도구를 사용하여 다음 Datadog 리소스를 등록합니다.
aws cloudformation register-type \
--region "<REGION>" \
--type RESOURCE \
--type-name "<DATADOG_RESOURCE_NAME>" \
--schema-handler-package "<LINK_TO_S3>" \
--execution-role-arn "<ROLE_ARN_FROM_STEP_1>"
터미널에서 다음을 실행하여 새로 등록한 리소스의 버전을 확인합니다.
aws cloudformation list-type-versions \
--region "<REGION>" \
--type RESOURCE \
--type-name "<DATADOG_RESOURCE_NAME>"
터미널에서 다음을 실행하여 새로 등록한 버전을 default로 설정합니다.
aws cloudformation set-type-default-version \
--region "<REGION>" \
--type RESOURCE \
--version-id <VERSION_ID> \
--type-name "<DATADOG_RESOURCE_NAME>"
다음 필수 자리 표시자를 사용합니다.
<REGION>: 고객님의 AWS 지역입니다.<DATADOG_RESOURCE_NAME>: 등록할 리소스 이름입니다. 하단 표를 참조하여 Datadog을 지원하는 리소스를 확인합니다.<LINK_TO_S3>: 리소스에 대한 S3 링크입니다.- S3 링크:
s3://datadog-cloudformation-resources/<RESOURCE_FOLDER>/<RESOURCE_FOLDER>-<RESOURCE_VERSION>.zip - 사용 가능한 리소스 섹션을 참조하세요. 지원되는 최신 S3 링크의 예시로 연결됩니다.
VERSION_ID: 2 단계의 명령이 반환한 리소스의 기본 버전입니다.
터미널에서 다음을 실행하여 새로 등록된 리소스를 설정합니다.
aws cloudformation set-type-configuration \
--type-name "<DATADOG_RESOURCE_NAME>" \
--type RESOURCE \
--configuration '{"DatadogCredentials": {"ApiKey": "{{resolve:secretsmanager:MySecret:SecretString:SecretAPIKey}}", "ApplicationKey": "{{resolve:secretsmanager:MySecret:SecretString:SecretAppKey}}"}}'
AWS 계정에서 등록된 Datadog 리소스를 포함하는 AWS 스택을 생성합니다.
사용 가능한 명령어 및 워크플로우에 대한 자세한 내용을 확인하려면 공식 AWS 문서를 참조하세요.
사용 가능한 리소스
AWS 계정에서 다음 Datadog 리소스를 등록할 수 있습니다. 설정 방법을 알아보려면 해당 문서를 참조하세요.
지원 지역
Datadog-Amazon CloudFormation 리소스는 다음 지역의 CloudFormation 공용 레지스트리에서 사용할 수 있습니다.
| 코드 | 이름 |
|---|
| us-east-1 | 미국 동부(버지니아 북부) |
| us-east-2 | 미국 동부(오하이오) |
| us-west-1 | 미국 서부(캘리포니아 북부) |
| us-west-2 | 미국 서부(오리건) |
| ap-south-1 | 아시아 태평양(뭄바이) |
| ap-northeast-1 | 아시아 태평양(도쿄) |
| ap-northeast-2 | 아시아 태평양(서울) |
| ap-southeast-1 | 아시아 태평양(싱가포르) |
| ap-southeast-2 | 아시아 태평양(시드니) |
| ca-central-1 | 캐나다(중부) |
| eu-central-1 | 유럽(프랑크푸르트) |
| eu-west-1 | 유럽(아일랜드) |
| eu-west-2 | 유럽(런던) |
| eu-west-3 | 유럽(파리) |
| eu-north-1 | 유럽(스톡홀름) |
| sa-east-1 | 남미(상파울루) |
참고: 다른 지역의 리소스를 비공개로 등록하려면 제공된 패키지를 사용하세요.
트러블슈팅
도움이 필요하시면 Datadog 지원팀에 문의하세요.
