환경 리매핑 규칙 (Env Remapping Rules)
트레이서 구성을 변경하거나 코드를 재배포하지 않고 APM 스팬의 환경을 이름 변경, 병합 또는 분할하는 방법을 안내해요.
출처: 문서
본문
참고: 환경 리매핑은 프리뷰 상태예요. 액세스를 요청하려면 이 양식을 작성해요.
개요
환경 리매핑 규칙을 사용하면 Datadog에서 환경의 이름을 변경, 병합 또는 분할할 수 있어요. 이 규칙은 트레이서 구성을 변경하거나 코드를 재배포하지 않고 APM 스팬의 env 값을 업데이트해요.
사전 요구 사항
환경 리매핑 규칙을 생성, 편집 또는 삭제하려면 APM Service Remapping Write 권한(apm_service_renaming_write)이 필요해요. Datadog 역할 권한을 참조하세요.
환경 리매핑 규칙 생성
-
Datadog에서 APM > Catalog > Manage > Service Tags Remapping으로 이동해요.
-
Add Env Rule을 클릭해요.
-
검색 창을 사용해 리매핑할 환경을 하나 이상 선택해요.
-
텍스트 상자에 고유한 환경 이름을 입력해요. 입력하면서 환경 이름의 미리 보기가 나타나요.
태그를 기반으로 환경 이름을 지정하려면 {{tagName}} 구문을 사용해요. 태그 값이 패턴을 따른다면 이름에 원하는 부분을 추출하도록 정규식을 적용해요.
참고: 태그에 여러 값이 있으면 미리 보기는 스팬이 가장 많은 값만 보여줘요.
-
선택 사항으로, 나중에 식별할 수 있도록 리매핑 규칙의 설명 이름을 입력해요.
-
리매핑 규칙을 검토하고 저장해요.
규칙을 저장한 후 적용되는 데 약 1분이 걸릴 수 있어요.
환경 리매핑 규칙 동작
환경 리매핑 규칙은 수집 시점에 env 태그를 덮어써요. 규칙을 생성해도 환경 이름을 지정하는 기존 구성은 변경되지 않아요. 환경 리매핑 규칙은 다른 모든 환경 이름 구성보다 우선해요.
- 영향받는 데이터: 환경 리매핑은 APM 스팬에만 적용돼요.
- 기존 데이터: 환경 리매핑 규칙은 규칙이 활성화된 동안 수집된 스팬에만 적용돼요. 과거 데이터는 소급 업데이트되지 않아요. 규칙을 삭제하거나 수정하면 새 스팬에 적용이 중지되지만 이전에 수집된 데이터는 업데이트되지 않아요.
- 규칙 처리 순서: 환경 리매핑 규칙은 생성된 순서대로 적용돼요. 환경 리매핑 목록 상단의 규칙이 그 아래 규칙보다 우선해요. 규칙의 순서를 변경할 수 있어요.
- 정규식: 새 환경 이름을 정의하려면 정규식을 사용해요. 캡처 그룹 내부에는 탐욕 양자(greedy quantifier)가 허용되지 않아요.
- 서비스 리매핑 규칙과의 상호 작용: 환경 리매핑 규칙은 서비스 리매핑 규칙 이후에 적용돼요. 서비스 리매핑 규칙이
service태그를 수정하면 환경 리매핑은 환경 리매핑 규칙을 적용할 때 업데이트된 서비스 이름을 사용해요.