개요

본 지침을 활용하여 Datadog OCI 통합 관련 문제를 해결하세요.

통합 문제

OCI 통합 타일의 Issues 탭에서 OCI 통합 관련 구성 문제를 확인하세요.

유효하지 않은 Datadog API 또는 애플리케이션 키 자격 증명

이 문제는 OCI 통합에 구성된 Datadog API 키 또는 애플리케이션 키가 만료되었거나 유효하지 않을 때 발생합니다. 두 키 모두 스택 적용 중에 유효성이 검증됩니다. 확인하려면 ORM 스택의 작업 로그에서 다음 오류를 찾아보세요.

Error: unexpected response code '403': {"errors":["Forbidden"]}

  with module.integration[0].restapi_object.datadog_tenancy_integration,
  on modules/integration/main.tf line 15, in resource "restapi_object" "datadog_tenancy_integration":
  15: resource "restapi_object" "datadog_tenancy_integration" {

이 문제를 해결하려면 새 자격 증명을 생성하고 통합 배포를 업데이트하세요.

1. Datadog 조직 설정에서 API 키로 이동하여 새 API 키를 생성합니다.
2. Datadog 조직 설정에서 애플리케이션 키로 이동하여 새 애플리케이션 키를 생성합니다.
3. 새 키로 통합 배포를 업데이트하고 다시 적용합니다.

필요한 OCI IAM 권한 누락

Datadog이 OCI를 쿼리할 때 403 오류를 수신했으며, 이는 필요한 모든 IAM 권한이 부여되지 않았음을 나타냅니다. OCI의 정책 페이지를 확인하여 dd-svc-policy 및 dd-dynamic-group 정책에 모든 읽기 전용 권한이 올바르게 구성되었는지 확인하세요.

OCI 테넌시가 서비스 커넥터 허브 한도에 도달함

각 테넌시에 대해 5개의 구획마다 최소 하나의 서비스 커넥터 허브가 필요합니다. OCI 계정에서 서비스 한도 증가를 요청하세요.

하나 이상의 구독된 리전에서 데이터를 수집할 수 없음

Datadog 메트릭 및 로그를 전달하는 데 사용되는 애플리케이션 함수가 발견되지 않았습니다. 이를 해결하려면 OCI 테넌시에서 기존 Datadog 통합 ORM 스택을 다시 적용하세요.

참고: 선택적 구성 섹션에 서브넷 OCID를 지정한 경우, 구독된 리전당 하나의 서브넷 OCID가 있는지 확인하세요. 기존 스택을 다시 적용하기 전에 다른 수정 작업을 수행하지 마세요.

메트릭이 수집되지 않음

모니터링되는 각 리전에 대해 다음 사항의 확인을 완료하세요.

1. 통합 구획에서 dd-function-app 함수 애플리케이션이 존재하는지 확인합니다.
2. dd-function-app에서 dd-metrics-forwarder 함수가 존재하는지 확인합니다.
3. 사용자 지정 서브넷을 사용하는 경우, 해당 서브넷이 권한(5단계 이후 참고 사항에 자세히 설명됨)을 충족하는지 확인합니다.
4. Datadog에서 생성한 각 메트릭 서비스 커넥터 허브에 대해 해당 함수 타겟이 dd-function-app의 dd-metrics-forwarder 함수인지 확인합니다. Datadog에서 생성한 메트릭 커넥터 허브는 dd-metrics-connectorhub-<suffix> 형식을 사용합니다. 커넥터 허브가 다른 전달 함수 애플리케이션을 타겟으로 하는 경우, 이를 삭제하고 자동으로 다시 프로비저닝되도록 하세요.

OCI 스택 제거 문제

제거 작업이 실패하거나 실행할 수 없는 경우:

1. OCI 통합 리포지토리를 복제한 후, 리포지토리 디렉터리로 이동합니다.

2. OCI 통합 정리 스크립트를 사용하여 남아 있는 리소스를 제거합니다.

3. 필수 변수를 설정합니다.

4. 드라이 런을 검토합니다.

   export OCI_PROFILE="<YOUR_OCI_PROFILE>"
   export COMPARTMENT_OCID="<YOUR_COMPARTMENT_OCID>"
   export TENANCY_OCID="<YOUR_TENANCY_OCID>"
   
   python3 oci-integration-cleanup/integration_cleanup.py \
     --profile "$OCI_PROFILE" \
     --compartment-ocid "$COMPARTMENT_OCID" \
     --dry-run true
   

5. 드라이 런 출력에서 삭제 예정인 리소스를 검토합니다. 출력이 올바르면 정리를 실행합니다.

   python3 oci-integration-cleanup/integration_cleanup.py \
     --profile "$OCI_PROFILE" \
     --compartment-ocid "$COMPARTMENT_OCID" \
     --confirm-tenancy-id "$TENANCY_OCID" \
     --region-workers <number of regions to be processed in parallel> \
     --dry-run false
   

오래된 통합 버전

이 문제는 Datadog 통합 ORM 스택 또는 Terraform 모듈이 최신 상태가 아닐 때 발생합니다. 이 문제를 해결하려면 배포를 최신 버전으로 업데이트하고 다시 적용하세요. 빠른 시작(ORM 스택) 및 Terraform에 대한 지침은 통합 업데이트를 참조하세요.

도움이 더 필요하신가요? Datadog 지원팀에 문의하세요.