모바일 모니터링에 사용자 지정 데이터 추가

New Relic 모바일 모니터링에는 모바일 앱이 보고하는 데이터를 사용자 지정하고 확장하는 다양한 방법이 포함되어 있습니다. 이러한 유형의 구현을 "커스텀 계측"이라고 합니다. 이 문서에서는 New Relic에 추가 데이터를 가져오는 방법과 UI에서 새 데이터를 보는 방법에 대해 설명합니다.

사용자 지정 데이터 유형 선택

이러한 옵션을 사용하여 모바일 앱용 사용자 정의 계측을 위한 고유한 데이터 유형을 생성할 수 있습니다. 이 네 가지 옵션을 사용하면 앱 요구 사항에 따라 광범위한 데이터를 얻을 수 있습니다.

세션 수준 사용자 정의 속성 추가

사용자 정의 속성은 모바일 모니터링 데이터에 주석을 추가(또는 "태그")합니다. 사용자 정의 속성은 키-값 쌍으로 구성됩니다. 예를 들어, alice@bigcorp.test 및 bob@example.com 와 같은 값을 사용하여 userEmail 키를 생성할 수 있습니다. 에이전트는 기본 모바일 모니터링 데이터 및 생성한 이동 경로 또는 사용자 지정 이벤트에 사용자 지정 속성을 자동으로 첨부합니다.

사용자 정의 속성을 사용하여 비즈니스와 관련된 사용 데이터를 캡처할 수 있습니다. 일반적인 예로는 계정 이름 또는 ID, 사용자 이메일 및 구독 수준이 있습니다. 그런 다음 크래시 분석 페이지 에서 NRQL 쿼리를 통해 필터링하고 패싯할 수 있습니다.

사용자 정의 속성을 설정하면 세션 수준에서 키-값 쌍 정보가 추가됩니다. 모든 기본 모바일 모니터링 이벤트 는 이러한 세션 수준 사용자 정의 속성을 상속합니다.

모범 사례로 사용자 정의 속성을 사용하여 세션 전체에서 true일 수 있는 단일 키 값을 추적합니다(예: 사용자의 구독 수준 또는 로그인에 SAML이 사용되었는지 여부).

연결 유형의 변경과 같이 세션 과정에서 값의 변경을 추적하려면 대신 이동 경로 와 고유한 사용자 정의 속성을 기록합니다. 세션 과정에서 발생하는 일련의 개별 사용자 작업을 추적하려면 맞춤 이벤트 를 사용하세요.

사용자 정의 속성을 추가하려면 다음을 참조하십시오.

• Android : setAttribute() 및 incrementAttribute() 을(를) 사용합니다.
• iOS : setAttribute() 및 incrementAttribute() 을(를) 사용합니다.

이동 경로 기록

이동 경로는 앱이 실행될 때 앱의 상태를 추적한 다음 앱이 충돌하는 경우 해당 상태의 스냅샷을 보고합니다. 이를 통해 모바일 앱 충돌을 보다 쉽게 디버그할 수 있습니다.

사용자 지정 상호 작용 은 세션 수준에서 생성된 사용자 지정 속성만 상속합니다. 이동 경로는 동일한 세션 수준 맞춤 속성을 상속하지만 선택적으로 각 recordBreadcrumb() API 호출과 관련된 추가 맞춤 속성을 보고할 수도 있습니다.

다음과 같은 여러 가지 방법으로 이동 경로를 사용할 수 있습니다.

• 앱이 HTTP 응답을 수신할 때 이동 경로 이벤트를 기록하고 해당 응답의 값을 사용자 정의 속성으로 기록할 수도 있습니다. 세션). 앱이 충돌하거나 오류가 발생하면 HTTP 응답에서 잘못된 데이터를 볼 수 있습니다.
• 각 단계에 대한 success 또는 failure 키를 기록하는 status 속성을 사용하여 사용자 로그인 프로세스의 각 단계의 성공을 추적할 수 있습니다. 이렇게 하면 문제를 일으키는 단계를 디버그할 수 있습니다.

MobileBreadcrumb 개의 맞춤 이벤트를 생성하는 앱 버전을 출시하면 충돌 세션의 일부로 앱의 코드 경로에 나타날 때마다 충돌 이벤트 추적 에서 해당 이벤트를 볼 수 있습니다. NRQL을 사용하여 쿼리하고 모든 이동 경로를 쿼리하거나 충돌한 세션의 이동 경로만 쿼리할 수도 있습니다. 이를 통해 특정 이동 경로를 포함하는 앱 경로의 빈도를 확인할 수 있습니다.

사용자 지정 이동 경로를 추가하려면 다음을 참조하세요.

• Android : recordBreadcrumb() 을(를) 사용합니다.
• iOS : recordBreadcrumb() 을(를) 사용합니다.

사용자 지정 상호 작용 만들기

모바일 모니터링 에이전트는 화면 로드 또는 부분적인 화면 로드(예: Android용 조각 또는 iOS용 보기 컨트롤러)를 감지하면 상호 작용 계측을 시작합니다. New Relic은 느린 상호 작용을 자동으로 추적하여 호출된 메서드, 수행된 네트워크 요청, 해당 상호 작용이 시작된 후 CPU 및 메모리 사용량을 포함하여 단일 느린 상호 작용에 대한 완전하고 심층적인 그림을 제공합니다.

당사의 모바일 모니터링은 데이터가 풍부한 추적을 자동으로 선택합니다. 에이전트가 찾는 특정 기준은 계측 방법이 전체 상호 작용 시간의 30% 이상을 차지하는 상호 작용입니다.

자동 계측 외에도 사용자 지정 상호 작용을 시작하여 에이전트가 앱 코드의 해당 지점에서 시작하여 후속 메서드 및 네트워크 호출에 걸쳐 계속되는 추적 기록을 시작하도록 강제할 수 있습니다. 사용자 지정 상호 작용 추적은 자세한 정보를 제공합니다. 그러나 상호 작용의 전체 기간 동안 수집되는 데이터의 양이 많기 때문에 다른 사용자 지정 데이터 수집 방법에 비해 에이전트의 오버헤드가 증가합니다.

충돌과 연결되면 사용자 지정 상호 작용이 충돌 이벤트 추적 에 표시됩니다. 유연한 분석을 위해 NRQL을 사용하여 쿼리 할 수도 있습니다.

상호 작용은 추적에 강력하지만 다른 사용자 지정 데이터 유형보다 유연성이 떨어집니다. 사용자 지정 이동 경로 및 사용자 지정 이벤트를 사용하면 사용자 지정 속성 을 특정 이벤트에 최적화할 수 있지만 상호 작용은 세션 수준 속성만 상속할 수 있습니다.

사용자 지정 상호 작용을 수동으로 종료할 수도 있습니다. 그러나 상호 작용에 기록하기에 충분한 메서드 활동이 포함되어 있는지 확인합니다. 에이전트가 0.5초 동안 추적된 활동을 감지하지 않으면 관심 있는 데이터가 남아 있지 않다고 가정하기 때문에 에이전트는 상호 작용 추적을 중지합니다. 또한 에이전트는 한 번에 하나의 상호 작용만 추적할 수 있으므로 새 상호 작용이 트리거되면 현재 추적이 새 추적에 우선하여 자동으로 중지됩니다.

사용자 지정 상호 작용 추적을 추가하려면 다음을 참조하세요.

• Android : startInteraction() 사용 및 endInteraction().
• iOS : 상호 작용을 만들고 완료합니다 .

상호 작용 추적을 전역적으로 구성할 수도 있습니다.

• Android :withInteractionTracing() 으로 완전히 비활성화하거나 withDefaultInteractions() 로 자동 계측 트레이스만 비활성화합니다.
• iOS : NRFeatureFlag_InteractionTracing() 으로 완전히 비활성화하거나 NRFeatureFlag_DefaultInteractions() 로 자동 계측 트레이스만 비활성화합니다.

맞춤 이벤트 기록

사용자 지정 이벤트는 임의의 사용자 활동을 New Relic에 보고하는 강력한 도구입니다. 충돌과 연결되면 맞춤 이벤트가 충돌 이벤트 추적 에 표시됩니다. 유연한 분석을 위해 NRQL을 사용하여 쿼리 할 수도 있습니다. 사용자 지정 상호 작용과 달리 사용자 지정 이벤트를 사용하면 사용자 세션 내의 특정 이벤트에 사용자 지정 속성을 추가할 수 있습니다.

예를 들어 사용자가 버튼을 탭하거나 특정 기능에 액세스할 때마다 사용자 지정 이벤트를 기록한 다음 NRQL을 사용하여 해당 기능이 사용된 빈도를 추적할 수 있습니다. 단순한 계산 외에도 위치, 기기 또는 이동통신사와 같은 기본 모바일 앱 속성 에서 FACET 사용량을 분석할 수 있습니다. 세션 수준 사용자 정의 속성을 추가하면 사용자 구독 수준 또는 기타 사용자 특성과 같은 중요한 기준에 따라 사용량을 더 자세히 조사할 수 있습니다. 해당 사용자 지정 이벤트에 대한 추가 속성을 추가하면 사용자 행동을 보다 면밀히 추적할 수 있습니다. 예를 들어 사용자가 입력한 데이터 또는 선택한 옵션이 무엇입니까?

사용자 정의 이벤트를 추가하려면 다음을 참조하십시오.

• Android : recordCustomEvent() 을(를) 사용합니다.
• iOS : recordCustomEvent() 을(를) 사용합니다.