통합 재정의 제거 (Integration Override Removal)

Datadog에서 통합 재정의(integration override)를 제거하는 방법을 알아봐요. 통합 재정의는 다른 서비스에 대한 호출을 나타내기 위해 통합별 서비스 이름을 사용해요. 개념적 배경은 기본 서비스, 통합 재정의, 커스텀 재정의와 추론 서비스 (Inferred Services)를 참고하세요.

출처: 문서

본문

{% callout %}

다음 Datadog 사이트 사용자에게 중요한 안내: app.ddog-gov.com, us2.ddog-gov.com

{% alert level="danger" %} 이 제품은 사용자가 선택한 Datadog 사이트에서는 지원되지 않아요. ({% placeholder "user-datadog-site-name" /%}). {% /alert %}

{% /callout %}

이 페이지는 통합 재정의를 제거하는 방법을 설명해요. 통합 재정의는 다른 서비스에 대한 호출을 나타내기 위해 통합별 서비스 이름을 사용해요. 개념적 배경은 기본 서비스, 통합 재정의, 커스텀 재정의와 추론 서비스를 참고하세요.

사전 요구 사항 (Prerequisites)

통합 재정의를 제거하기 전에:

1. apm_service_renaming_write 권한이 있어야 해요.
2. Datadog SDK 버전이 재정의 제거를 지원해야 해요. SDK 버전 요구 사항을 참고하세요.

SDK 버전 요구 사항 (SDK version requirements)

통합 재정의 제거하기 (Remove integration overrides)

Datadog에서 통합 재정의를 제거하려면:

1. Catalog > Manage > 재매핑 규칙 관리 (Manage Remapping Rules)로 이동해 Manage Overrides를 클릭해요.

   {% image source="https://docs.dd-static.net/images/tracing/guide/base_service/SO_removal_page.f6f674f922ccf60cb2066057652308b1.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/guide/base_service/SO_removal_page.f6f674f922ccf60cb2066057652308b1.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Integration Overrides page showing migration progress and removal options" /%}

2. 제거할 각 재정의에 대해 관련 모니터와 대시보드를 검토해요.

이 자산들은 재정의된 서비스 이름을 참조하므로 제거 후에는 더 이상 일치하지 않아요. 기능을 유지하려면 기본 서비스 이름(service:<DD_SERVICE>)을 사용하도록 업데이트하세요.

{% image source="https://docs.dd-static.net/images/tracing/guide/base_service/SO_removal_page_sidepanel.c20c8dc302159b7ecc12eec56842a2d5.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/guide/base_service/SO_removal_page_sidepanel.c20c8dc302159b7ecc12eec56842a2d5.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Service override side panel showing affected monitors and dashboards" /%}

1. 재정의를 개별적으로 또는 일괄로 제거해요:

   • 제거할 특정 재정의를 선택: 제거할 개별 통합 재정의를 선택해요. 재정의를 제거할 때 마이그레이션 진행률(Migration Progress) 막대가 진행 상황을 보여줘요.
   • 모든 재정의 제거: Finish Migration을 선택해 모든 통합 재정의를 제거하고 APM 사용량이 늘어남에 따라 향후 재정의가 나타나지 않도록 해요. 커스텀 재정의에는 영향을 주지 않아요.

재정의 제거는 되돌릴 수 있어요.

예시: 제거 후 서비스 이름 지정 (Examples: Service naming after removal)

통합 재정의를 제거하면 클라이언트 스팬이 태그되는 방식과 다운스트림 종속성이 식별되는 방식이 바뀌어요. 재정의가 제거된 후 클라이언트 스팬은 통합별 이름 대신 호출 서비스의 이름(service:<DD_SERVICE>)을 사용해요. 호출되는 종속성은 peer.* 속성(예: 데이터베이스 또는 큐)을 사용해 식별돼요.

gRPC 예시:

MySQL 예시:

구성 기반 제거 (Configuration-based removal)

애플리케이션 구성에 환경 변수를 설정해 통합 재정의를 제거할 수도 있어요. 이 방법은 Datadog UI에 접근할 수 없을 때 유용해요.

1. SDK가 최소 버전 요구 사항을 충족하는지 확인해요.
2. 다음 환경 변수를 설정해요:

   DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED=true
   

이렇게 하면 service 속성이 통합 이름(예: *-postgres, *-http-client)을 추가하는 대신 항상 기본 서비스 이름을 사용하게 돼요. 커스텀 재정의는 영향을 받지 않으며 코드에서 직접 제거해야 해요.

더 알아보기 (Learn more)

도움이 되는 추가 문서, 링크, 아티클이에요:

• 서비스 재정의 (Service Overrides)
• 추론 서비스 (Inferred Services)