Datadog의 OCI 빠른 시작은 몇 번의 클릭만으로 OCI 인프라 및 애플리케이션을 모니터링할 수 있도록 지원하는 완전 관리형 단일 흐름 설정 경험입니다. OCI 빠른 시작은 메트릭, 로그 및 리소스 데이터를 Datadog으로 포워딩하는 데 필요한 인프라를 생성하며, 데이터 수집을 위해 새로운 리소스나 OCI 컴파트먼트를 자동으로 검색합니다.

다음과 같은 경우 빠른 시작 설정을 선택하세요.

• OCI 통합을 처음 설정하는 경우
• UI 기반 워크플로를 선호하며, 필요한 리소스를 생성하고 구성하는 데 걸리는 시간을 최소화하려는 경우
• 스크립트나 CI/CD 파이프라인에서 설정 단계를 자동화하려는 경우

빠른 시작 설정 전제 조건

• 다음 단계를 완료하려면 OCI 사용자 계정에 Identity Domain Administrator 역할이 필요합니다.
• 통합하려는 테넌시의 OCI에 로그인되어 있어야 합니다.
• 화면 오른쪽 상단에서 ‘홈 리전’이 선택된 상태로 OCI에 로그인되어 있어야 합니다.
• 로그인된 ID 도메인 또는 대상 도메인(지정된 경우)에서 OCI 사용자 계정이 사용자, 사용자 그룹 및 동적 그룹을 생성할 수 있어야 합니다. 대상 도메인 OCID를 제공하는 경우, OCI 사용자 계정에 해당 도메인에 대한 관리자 권한이 있어야 합니다.
• OCI 사용자 계정이 루트 컴파트먼트에서 정책을 생성할 수 있어야 합니다.

빠른 시작 설정 지침

Datadog에 대한 메트릭 및 로그 포워딩용 인프라를 설정하려면 다음 단계를 따르세요.

• Datadog OCI 통합 타일 구성
• 빠른 시작 ORM 스택 배포
• Datadog에서 설정 완료
• 메트릭 흐름 확인
• 메트릭 또는 로그 수집 구성(선택 사항)
• 리소스 수집 구성(선택 사항)

이 통합에서는 Oracle Service Connector Hubs를 사용하여 Datadog으로 데이터를 포워딩해야 합니다. 설정을 완료하기 전에 서비스 제한 상향 조정을 요청하는 것이 좋습니다. 필요한 Service Connector Hubs의 대략적인 수는 다음과 같습니다.

$$\text"Service Connector Hubs" = \text"테넌시의 컴파트먼트 수" / \text"5"$$

Datadog OCI 통합 타일 구성

1. Datadog OCI 통합 타일로 이동하고 Add New Tenancy를 클릭합니다.

2. 통합에 사용할 Datadog API 키를 선택하거나 생성합니다.

3. Datadog 애플리케이션 키를 생성합니다.

4. 토글을 사용하여 로그를 활성화하거나 비활성화합니다.

5. 토글을 사용하여 이벤트 수집을 활성화하거나 비활성화합니다.

6. Create OCI Stack을 클릭합니다. 이렇게 하면 배포를 완료할 수 있도록 ORM(Oracle Resource Manager) 스택으로 이동합니다.
   참고: 이 스택은 테넌시당 한 번만 배포하세요.

빠른 시작 ORM 스택 배포

1. Oracle 이용 약관에 동의합니다.

2. 사용자 지정 Terraform 공급자 사용 옵션을 선택되지 않은 상태로 둡니다.

3. 기본 작업 디렉터리를 사용하여 스택을 배포하거나 선택적으로 다른 디렉터리를 선택합니다.

4. Next를 클릭합니다.

5. Datadog은 이 테넌시의 각 리전에 새로운 가상 클라우드 네트워크(VCN) 및 서브넷을 생성하기 위해 (Optional) Choose specific subnet(s) 섹션을 비워둘 것을 권장합니다.

   선택적으로 Datadog 빠른 시작 스택에 대해 기존 서브넷(OCI 리전당 최대 하나)을 선택할 수 있으며, 이 경우 스택에 서브넷 OCID를 제공해야 합니다. 쉼표 없이 한 줄에 하나의 OCID를 입력하세요. 그러면 Datadog 빠른 시작 스택이 각 서브넷에 해당하는 리전에 배포됩니다. 각 서브넷 OCID는 ocid1.subnet.oc[0-9].* 형식이어야 합니다. 예: ocid1.subnet.oc1.iad.abcedfgh.
   참고: 기존 VCN 및 서브넷을 사용하는 경우 각 리전의 VCN이 다음과 같은지 확인하세요.

   • NAT 게이트웨이를 통해 HTTP 송신 호출을 실행할 수 있습니다.
   • ‘Oracle Services Network의 모든 서비스’를 지원하는 서비스 게이트웨이가 있습니다.
   • NAT 게이트웨이 및 서비스 게이트웨이를 허용하는 라우팅 테이블 규칙이 있습니다.
   • HTTP 요청을 전송하는 보안 규칙이 있습니다.

6. Datadog은 새로운 사용자 및 그룹을 생성하기 위해 (Optional) Choose a User 섹션을 비워둘 것을 권장합니다. 그룹 및 사용자는 현재 로그인되어 있는 OCI ID 도메인(기본 도메인일 필요 없음)에 생성됩니다.
   선택적으로 Datadog 빠른 시작 스택에 대해 기존 사용자 및 그룹을 선택할 수 있습니다. 이 경우 Datadog은 사용자 및 그룹의 도메인을 자동으로 유추하고 이를 동적 그룹 생성에 사용합니다.
   a. Group ID: Datadog 인증을 위한 기존 OCI 그룹의 OCID를 제공합니다. 제공할 경우 User ID를 비워둘 수 없습니다.
   b. User ID: Datadog 인증을 위한 기존 OCI 사용자의 OCID를 제공합니다. 사용자는 지정된 그룹의 구성원이어야 합니다. 제공할 경우 Group ID를 비워둘 수 없습니다.

7. Datadog은 이러한 사용 사례가 흔하지 않으므로 (Optional) Advanced configuration 섹션을 비워둘 것을 권장합니다.
   선택적으로 Datadog 빠른 시작 스택에 대해 기존 컴파트먼트 및 도메인을 선택할 수 있습니다.
   a. Compartment: Datadog에 의해 생성된 모든 리소스를 배치할 기존 컴파트먼트를 선택합니다.
   b. Domain: 사용자 및 그룹이 생성되는 위치를 재정의하기 위한 기존 ID 도메인의 OCID를 제공합니다. 이 필드는 6단계에서 기존 사용자 및 그룹을 지정하지 않은 경우에만 표시됩니다. 제공할 경우 User Email을 비워둘 수 없습니다. 참고: 대상 도메인에서 OCI 사용자 계정에 Identity Domain Administrator 역할이 있어야 합니다.
   c. Resource tags: Datadog 빠른 시작 스택에 의해 배포되는 모든 OCI 리소스에 추가할 정의된 태그의 목록을 제공합니다. 한 줄에 하나의 태그를 입력하세요. 쉼표를 추가해서는 안 됩니다. 각 정의된 태그는 namespace.key:value 형식이어야 합니다. 예: CostCenter.Environment:prod. 비워두면 Datadog 빠른 시작 스택에 의해 배포되는 OCI 리소스에 정의된 태그가 추가되지 않습니다.
   

8. Next를 클릭합니다.

9. Create를 클릭하고 배포가 완료될 때까지 최대 30분을 기다립니다.

Datadog에서 설정 완료

Datadog OCI 통합 타일로 돌아가 **Ready!**를 클릭합니다.

다음과 같은 경우 Terraform 설정을 선택하세요.

• 코드형 인프라를 관리하고 Datadog OCI 통합에 대한 버전 관리를 유지하려는 경우
• 재사용 가능한 공급자 블록으로 여러 폴더 또는 프로젝트를 일관되게 구성해야 하는 경우
• Terraform 관리 환경에 적합한 반복 가능하고 감사 가능한 배포 프로세스를 원하는 경우

Terraform을 사용하여 Datadog OCI 통합을 프로비저닝할 수 있습니다. 이 가이드에는 전제 조건, 필수 변수, 정확한 초기화, 계획, 적용 단계가 나와 있습니다.

Terraform 설정 전제 조건

시작하기 전에 다음을 준비하세요.

• Terraform 1.x를 설치합니다.
• 유효한 Datadog API 키를 받습니다.
• 대상 도메인에서 OCI에 Identity Domain Administrator 역할을 할당합니다.

Terraform 설정 지침

Datadog에 대한 메트릭 및 로그 포워딩용 인프라를 설정하려면 다음 단계를 따르세요.

• OCI 구성 파일 생성
• Terraform 모듈 구성
• Terraform으로 배포
• 메트릭 흐름 확인
• 메트릭 또는 로그 수집 구성(선택 사항)
• 리소스 수집 구성(선택 사항)

OCI 구성 파일 생성

~/.oci/config 파일은 OCI에서 리소스를 생성할 수 있는 권한을 Terraform에 부여합니다. API 키를 생성하여 구성에 추가하거나 Oracle 문서를 따르세요. 파일은 다음과 같아야 합니다.

[DEFAULT]
user=<USER_OCID>
fingerprint=<USER_FINGERPRINT>
tenancy=<TENANCY_OCID>
region=<HOME_REGION>
key_file=<PATH_TO_PRIVATE_KEY_FILE>

Terraform 모듈 구성

다음 입력은 Datadog OCI 통합 모듈을 구성합니다. 필수 필드는 표시되어 있습니다. 사용 가능한 전체 구성 옵션 목록은 테넌시 추가 페이지를 참조하세요.

1. Datadog API 키를 추가합니다.

Select API Key를 클릭하고 사용할 API 키를 선택합니다.

2. Datadog 애플리케이션 키를 생성합니다.

Create를 클릭하면 애플리케이션 키가 생성되어 필드에 추가됩니다. 이 값을 복사하여 안전한 위치에 저장하세요. 이 화면을 나간 후 값에 다시 액세스할 수 없습니다.

3. OCI 테넌시 OCID를 추가합니다.

1. Datadog을 통해 모니터링할 테넌시의 OCID를 입력합니다. cloud.oracle.com/tenancy에서 찾을 수 있습니다.
2. 선택적으로 특정 OCI 컴파트먼트 및 서브넷을 선택합니다. Datadog은 테넌시의 각 리전에 새로운 OCI 컴파트먼트 및 OCI 가상 클라우드 네트워크(VCN)를 생성하기 위해 이 섹션을 비워둘 것을 권장합니다.

4. OCI 사용자 OCID를 추가합니다.

사용자 OCID를 입력합니다. 이 사용자에게는 Identity Domain Administrator 역할이 있어야 합니다. cloud.oracle.com/identity/domains/my-profile에서 찾을 수 있습니다.

5. 로그 수집을 구성합니다(선택 사항).

테넌시에서 모든 로그 수집을 비활성화하려면 토글을 클릭합니다. 특정 OCI 서비스에 대한 로그 수집을 비활성화하려면 설정 후 Datadog OCI 통합 타일에서 구성을 편집하세요.

6. 이벤트 수집을 구성합니다(선택 사항).

테넌시에서 모든 이벤트 수집을 비활성화하려면 토글을 클릭합니다. 설정 후 이벤트 수집을 비활성화하려면 Datadog OCI 통합 타일에서 구성을 편집하세요.

7. 생성된 Terraform 모듈의 구성 세부 정보를 확인합니다.

생성된 Terraform 모듈은 아래에 표시된 형식을 따라야 합니다.

module "datadog_oci" {
  source = "github.com/DataDog/oracle-cloud-integration//datadog-terraform-onboarding"

  datadog_api_key = <API_KEY>
  datadog_app_key = <APP_KEY>
  datadog_site    = <DATADOG_SITE>

  tenancy_ocid      = "<TENANCY_OCID>"
  current_user_ocid = "<CURRENT_USER_OCID>"

  logs_enabled              = true
  events_collection_enabled = true
}

Terraform으로 배포

1. 생성된 Terraform 모듈을 복사하여 .tf 파일에 붙여넣습니다.
2. terraform init && terraform apply를 실행하여 Terraform을 초기화하고 통합을 생성합니다. 변경 사항을 미리 보려면 apply를 plan으로 대체하세요.

문제 해결

시간 초과

구성을 변경하지 않고 Terraform 명령을 다시 실행하세요.

공급자 충돌

terraform init 명령에서 공급자 충돌이 발생하면 모듈의 필수 버전과 일치하도록 로컬 공급자 구성을 업데이트하세요.

설정 직후 Datadog의 경고

경고가 사라질 때까지 최대 15분을 기다리세요.

Compartment Tags 및 Limit Collection to Specific Resources 섹션 모두 쉼표로 구분된 key:value OCI 태그를 허용합니다. 태그 앞에 !를 추가하면 태그가 무효화됩니다. 쉼표 구분 기호는 사용되는 태그 유형에 따라 다르게 동작합니다.

• 긍정 태그만: OR 로직 - OCI 객체(컴파트먼트 또는 특정 리소스)에 나열된 태그 중 하나라도 있으면 포함됩니다.
• 부정 태그만(앞에 !가 추가됨): OR 로직 - 무효화된 태그 중 하나라도 있으면 제외됩니다.
• 긍정 및 부정 태그 혼합: AND 로직 - 포함되려면 나열된 모든 조건을 충족해야 합니다.

예를 들면 다음과 같습니다.

• datadog:monitored,env:prod*: 태그 중 하나라도 있으면 포함합니다.
• !env:staging,!testing:true: 태그 중 하나라도 있으면 제외합니다.
• datadog:monitored,!region:us-phoenix-1: datadog:monitored 태그가 있는 동시에 region:us-phoenix-1 태그가 없는 경우에만 포함합니다.

태그 키 형식: Datadog은 일치 여부를 확인하기 전에 OCI 태그 키를 소문자 snake_case로 정규화합니다. camelCase 또는 PascalCase를 사용하여 OCI에 설정된 키(예: deploymentType 또는 DeploymentType)는 소문자 snake_case 형식(deployment_type)으로 저장되고 일치 여부가 확인됩니다. 통합 타일에서 태그 필터를 지정할 때는 소문자 snake_case를 사용하세요.

전제 조건: 업데이트를 적용하기 전에 OCI 스택에 구성된 Datadog 애플리케이션 키가 여전히 유효한지 확인하세요. 키가 만료되었거나 취소된 경우, 제거 작업이 실패합니다. 키를 업데이트하려면 OCI 콘솔에서 스택 변수 datadog_app_key를 편집하고 계속 진행하기 전에 유효한 애플리케이션 키를 제공하세요.

OCI Cloud Shell에서 다음 명령을 실행하여 스택을 최신 버전으로 업데이트하고 변경 사항을 적용합니다.

curl -fL -o datadog-integration.zip \
  "https://github.com/DataDog/oracle-cloud-integration/releases/latest/download/datadog-integration.zip"

export STACK_ID="<YOUR_STACK_OCID>"
export OCI_CLI_REGION="<YOUR_HOME_OR_STACK_REGION>"

oci resource-manager stack update \
  --stack-id "$STACK_ID" \
  --config-source datadog-integration.zip \
  --region "$OCI_CLI_REGION" \
  --force

oci resource-manager job create-apply-job \
  --stack-id "$STACK_ID" \
  --execution-plan-strategy AUTO_APPROVED \
  --region "$OCI_CLI_REGION" \
  --wait-for-state SUCCEEDED

자리 표시자 값을 다음과 같이 바꾸세요.

• <YOUR_STACK_OCID>: Datadog ORM 스택의 OCID. cloud.oracle.com/resourcemanager/stacks에서 찾을 수 있습니다.

• <YOUR_HOME_OR_STACK_REGION>: 테넌시의 홈 리전(예: us-ashburn-1)

전제 조건: Terraform을 다시 적용하기 전에 Terraform 구성의 datadog_app_key 변수에 유효한 Datadog 애플리케이션 키가 포함되어 있는지 확인하세요. 키가 만료되었거나 취소된 경우, 제거 명령이 실패합니다. 계속 진행하기 전에 .tf 파일에서 또는 terraform.tfvars 파일을 통해 값을 업데이트하세요.

Terraform을 다시 실행하여 업데이트된 모듈을 초기화하고 최신 변경 사항을 적용합니다.

terraform init -upgrade && terraform apply

선택적으로, apply 전에 terraform plan을 실행하여 변경 사항을 미리 봅니다.

전제 조건: 제거 작업을 실행하기 전에 OCI 스택에 구성된 Datadog 애플리케이션 키가 여전히 유효한지 확인하세요. 키가 만료되었거나 취소된 경우, 제거 작업이 실패합니다. 키를 업데이트하려면 OCI 콘솔에서 스택 변수를 편집하고 계속 진행하기 전에 유효한 애플리케이션 키를 제공하세요.

1. OCI 콘솔에서 ORM(Oracle Resource Manager)으로 이동합니다.

2. 설치 중 생성된 Datadog 빠른 시작 스택을 찾습니다. 기본적으로 이 스택에는 datadog-integration.zip-<NUMBER> 레이블이 지정되지만 배포 중 사용자 지정 이름으로 구성되었을 수 있습니다.

3. 스택에서 Destroy 작업을 실행하여 모든 리전에서 통합에 의해 생성된 모든 리소스를 제거합니다.

   

4. 선택적으로, 제거가 완료된 후 Datadog OCI 스택을 삭제합니다.

참고: 빠른 시작 스택에서 제거 작업을 한 번 실행하면 통합이 배포된 모든 리전의 모든 리소스가 자동으로 정리됩니다.

전제 조건: 제거 명령을 실행하기 전에 Terraform 구성의 datadog_app_key 변수에 유효한 Datadog 애플리케이션 키가 포함되어 있는지 확인하세요. 키가 만료되었거나 취소된 경우, 제거 명령이 실패합니다. 계속 진행하기 전에 .tf 파일에서 또는 terraform.tfvars 파일을 통해 값을 업데이트하세요.

~/.oci/config의 DEFAULT 프로필에 해당 테넌시의 리소스를 관리하기 위한 사용자 자격 증명이 있는지 확인하고 다음을 실행하세요.

terraform destroy

- Allow dd-svc-admin to read all-resources in tenancy
- Allow dd-svc-admin to use tag-namespaces in tenancy
- Allow dd-svc-admin to manage serviceconnectors in Datadog compartment
- Allow dd-svc-admin to manage functions-family in Datadog compartment
- Allow dd-svc-admin to use fn-invocation in Datadog compartment
- Allow dd-svc-admin to manage buckets in Datadog compartment where target.bucket.name=/dd-*/
- Allow dd-svc-admin to manage object-family in Datadog compartment where target.bucket.name=/dd-*/
- Endorse dd-svc-admin to read objects in tenancy usage-report
- Allow dd-svc-admin to manage cloudevents-rules in tenancy where any {request.permission = 'EVENTRULE_CREATE', target.resource.tag.DatadogManaged.marker = 'true'}
- Allow dd-svc-admin to manage streams in Datadog compartment where any {request.permission = 'STREAM_CREATE', target.resource.tag.DatadogManaged.marker = 'true'}
- Allow service objectstorage-<REGION> to manage object-family in Datadog compartment where target.bucket.name=/dd-*/

참고: 구독된 리전마다 Allow service objectstorage-<REGION> 문을 한 번씩 추가해야 합니다(예: objectstorage-us-ashburn-1, objectstorage-ap-batam-1). 이렇게 하면 Datadog이 객체 수명 주기 정책을 통해 Datadog이 관리하는 버킷의 오래된 데이터를 자동으로 정리할 수 있게 됩니다.