보존 필터로 데이터 보존

문서 > RUM 및 Session Replay > RUM without Limits > 보존 필터로 데이터 보존

학습 센터에서 RUM 보존 필터 사용해 보기

RUM 보존 필터를 사용하여 저장할 세션 데이터를 제어하고 관측 가능성 예산을 최적화하는 방법을 알아보세요.

개요

보존 필터는 RUM 세션 탐색기에서 사용되는 것과 유사한 쿼리 집합으로, RUM 이벤트(세션, 조회, 액션, 리소스 등)가 수집될 때 해당 이벤트에 대해 실행됩니다. 이러한 필터는 세션을 30일의 표준 RUM 보존 기간 동안 저장할지, 아니면 삭제할지 결정합니다.

보존율은 보존하려는 일치 세션의 백분율을 지정하며, 이를 통해 더 나은 비용 제어가 가능합니다. 필터는 개별 이벤트를 기준으로 매칭되지만 샘플링 결정이 내려지면 기본 세션의 모든 이벤트가 유지되어 사용자 세션에 대한 엔드투엔드 가시성이 보장됩니다.

작동 방식

세션은 사전 정의된 쿼리를 기반으로 구성 이벤트 중 하나와 보존 필터가 일치하는 즉시 저장되며 구성된 보존율에 따라 샘플링됩니다.

보존 필터의 논리적 흐름과 이것이 최종적으로 보존되는 세션 수에 미치는 영향을 보여주는 다이어그램입니다.

보존 필터의 논리적 흐름은 다음과 같습니다.

모든 RUM 이벤트가 첫 번째로 수신된 필터부터 시작하여 각 필터에 대해 순차적으로 평가됩니다.
이벤트 A가 필터와 일치하면 보존율에 따라 전체 세션을 샘플링할지, 아니면 향후 이벤트가 평가될 때까지 기다릴지 결정됩니다. 두 경우 모두 이벤트 A가 후속 보존 필터에 대해 더 이상 평가되지 않습니다. 보존 필터의 순서가 중요한 이유는 바로 이 때문입니다.
보존된 세션이 저장되어 세션 탐색기 및 기타 RUM 페이지에서 액세스할 수 있습니다. 이 세션에서 발생하는 새로운 이벤트는 보존 필터 목록을 거치지 않지만 완전한 가시성을 보장하기 위해 자동으로 유지됩니다.

참고:

이벤트가 어떤 필터와도 일치하지 않거나 필터와 일치하더라도 구성된 보존율에 따라 세션을 보존하지 않기로 결정된 경우, 동일한 세션의 향후 이벤트는 계속해서 평가됩니다. 결과적으로 세션이 보존될 수 있습니다.
시간이 지남에 따라 업데이트되는 이벤트 속성에서 필터를 정의할 때는 주의하세요. 예를 들어, 오류가 2개 미만인 세션을 보존하는 필터는 오류 수가 실시간으로 업데이트되고 모든 세션이 0에서 시작하기 때문에 실수로 세션을 보존할 수 있습니다. 업데이트되는 필드에는 ‘크거나 같음’(≥) 조건을 사용하세요(예: @session.error.count >= 2). 아니면 @session.is_active: false 또는 @view.is_active: false를 추가하여 변경 가능한 세션 및 조회 객체가 보존 필터에 대해 평가되기 전에 완료되도록 하세요.
저희의 SDK는 이벤트를 Datadog으로 보내기 전에 일괄 처리 및 압축하며, 업로드에 실패한 이벤트는 기기의 대기열 끝으로 돌아갑니다. 따라서 이벤트 B가 이벤트 A보다 먼저 평가될 수 있지만 모든 이벤트는 누락을 방지하기 위해 결국 보존 필터 목록에 대해 평가됩니다.

보존 필터가 리플레이와 함께 작동하는 방식

보존 필터를 사용하여 리플레이가 포함된 세션 샘플링을 관리할 수 있습니다. 리플레이가 포함된 세션에 요금이 청구될 때마다 세션 이벤트와 비디오 녹화본이 모두 유지되고 해당 요금이 청구됩니다. 즉, SDK에서 세션의 100%와 리플레이의 100%를 수집하는 경우, 보존 필터가 세션을 유지할 때마다 Datadog은 세션과 리플레이를 모두 유지하고 해당 요금을 청구합니다.

참고: Datadog의 모바일 SDK도 고정 샘플 속도에 의존하는 대신 조건부로 녹화를 시작하고 중지하는 API를 제공하지만 기본적으로 Browser SDK에 의해 강제로 녹화된 리플레이만 보존됩니다.

영구 보존 필터

영구 보존 필터는 수정, 비활성화 또는 삭제할 수 없는 사전 정의된 보존 필터입니다. 이 필터는 보존 필터 목록의 맨 위에 위치합니다.

세 가지 영구 보존 필터가 있습니다.

RUM-APM Flat Sampling: 수집된 분산 트레이스가 포함된 세션의 1%를 보존하고 APM에서 해당 트레이스를 인덱싱합니다. 이러한 세션 및 해당 트레이스는 RUM 청구 또는 APM 청구 대상이 아닙니다.
Synthetics Sessions: Synthetic Monitoring에 의해 생성된 모든 세션을 보존합니다. 이러한 세션은 Synthetic Monitoring에 따라 청구되며 RUM 청구 대상이 아닙니다.
Sessions with forced replays: 강제 수집 메커니즘을 통해 리플레이가 강제로 수집된 모든 세션을 보존합니다.

RUM-APM 고정 샘플링 영구 보존 필터는 다음 SDK에만 적용됩니다.
- Browser 6.5.0+
- Android 3.0.0+
- iOS 3.3.0+
- React Native 3.0.0+
- Flutter 3.0.0+

보존 필터 생성

보존 필터를 생성하려면 다음 단계를 따르세요.

Digital Experience > Manage Applications로 이동합니다.
RUM 애플리케이션을 생성하거나 기존 애플리케이션을 클릭합니다.
‘Product Settings’에서 Retention Filters 페이지로 이동합니다.
- Add Retention Filter
버튼을 클릭합니다.
보존 필터에 설명이 포함된 이름을 지정합니다.
드롭다운에서 이벤트 유형을 선택하고 쿼리를 입력합니다. RUM 탐색기에서 작성할 수 있는 모든 쿼리는 보존 필터에서 작동합니다.
선택적으로, 보존 쿼리와 일치하는 세션에 대한 보존율을 설정합니다. Generate Estimate를 클릭하여 이 비율을 설정하는 데 도움을 받을 수 있습니다.

새 필터가 보존 필터 목록의 맨 아래에 추가됩니다. Datadog이 새 필터를 전파하고 샘플링 결정을 시작하는 데에는 몇 초 정도 걸립니다.

필터 수정

필터 편집

기존 필터를 수정하려면 다음 단계를 따르세요.

필터 위에 마우스를 올리고 Edit 아이콘을 클릭합니다.
Save Changes를 클릭합니다.

필터 복제

필터를 복제하려면 다음 단계를 따르세요.

필터 위에 마우스를 올리고 Duplicate 아이콘을 클릭합니다.
필터를 원하는 대로 수정한 다음 Save Changes를 클릭합니다.

필터 삭제

보존 필터를 삭제하려면 다음 단계를 따르세요.

필터 위에 마우스를 올리고 Delete 아이콘을 클릭합니다.
Confirm을 클릭합니다.

필터 비활성화

비활성화된 필터는 단순히 이벤트를 무시하며 샘플링 결정을 내리지 않습니다. 목록으로 들어오는 이벤트는 비활성화된 필터를 건너뜁니다.

필터 오른쪽에 있는 토글을 사용하여 필터를 비활성화하거나 활성화하세요.

필터 재정렬

필터를 끌어다 놓아 원하는 위치로 재정렬하세요.

보존 필터를 사용하여 세션 제외

RUM without Limits는 보존 필터를 사용하여 제외할 세션이 아닌 유지할 세션을 지정합니다. 보존 비율을 0%로 설정할 수 없습니다(기본값: 1%). 또한 낮은 보존 비율을 설정하는 것은 효과적인 제외 전략이 아닙니다. 구성 내의 다른 필터에 의해 세션이 계속 보존될 수 있기 때문입니다.

특정 환경, 애플리케이션 버전, 기기 유형 또는 기타 기준의 세션이 보존되지 않도록 하려면 모든 필터의 쿼리 내에 제외 항목을 명시적으로 추가하세요. 예를 들면 다음과 같습니다.

모든 보존 필터에 -version:(1* OR 2*)를 추가하면 애플리케이션의 이전 버전 1 및 2에서 발생한 이벤트가 절대 유지되지 않습니다.
모든 보존 필터에 -@device.type:Bot을 추가하면 검색 엔진 크롤러 및 기타 자체 선언된 봇이 제외됩니다.
모든 보존 필터에 -@geo.country:"South Korea"를 추가하면 대한민국에서 발생하는 모든 세션이 제외됩니다.

예를 들어, 대한민국에서 발생하는 세션을 제외하고 다른 모든 세션은 보존하려면 쿼리 -@geo.country:"South Korea"를 사용하는 필터를 생성하고 보존 비율을 100%로 설정합니다.

참고: 특정 이벤트가 보존되는 것을 방지할 방법은 없습니다. 부정 쿼리(예: RUM 오류를 타겟팅하는 보존 필터에 -@error.message:"Script error." 추가)를 사용하여 원치 않는 이벤트의 볼륨을 최소화할 수 있지만 다른 보존 필터가 필터링하려는 이벤트가 포함된 세션에 대해 긍정적인 보존 결정을 내릴 수도 있습니다.