그룹 요청 오류: 네트워크 장애 분석

서버 문제나 네트워크 장애로 인해 발생하는 네트워크 요청 오류는 모바일 앱 속도를 저하시키고 사용자 경험에 부정적인 영향을 미칠 수 있습니다. 요청 오류 페이지를 사용하여 HTTP 오류의 원인을 파악하고, 근본적인 문제를 해결하기 위해 팀과 실행 가능한 데이터를 공유하세요.

요청 오류 페이지 보기

요청 오류 페이지를 보려면 one.newrelic.com > All capabilities > Mobile > (select an app) > Request errors 로 이동하세요.

추천 플리우스

HTTP 요청 오류와 네트워크 장애를 조사하기 위해 다음 접근 방식을 권장합니다. 이를 통해 오류를 완전히 이해하고, 기여 요인을 식별하고, 효과적인 디버깅 전략을 구현할 수 있습니다.

1. 단일 오류에 대한 자세한 내용 보기: 요청 오류나 네트워크 장애에 대한 세부 정보를 보려면 오류 그룹 표에서 행을 클릭하세요. 여기에서 요청 정보, 요청 속성, 응답 본문을 볼 수 있고 해당 오류에 대한 자세한 정보도 얻을 수 있습니다.

2. 오류 데이터 쿼리 및 공유: HTTP 오류 페이지의 차트나 목록 뒤에 있는 데이터를 탐색하려면 다음을 수행합니다.

   • 모든 차트에서 … 메뉴를 클릭한 다음 View query 클릭합니다.
   • 쿼리 빌더에서 오류 데이터를 대시보드에 추가하고 영구 링크를 통해 공유할 수 있습니다.

   오류 데이터를 더 자세히 알아보려면 다음 이벤트와 속성에 대한 데이터를 쿼리하세요.

   • MobileRequestError 이벤트 및 속성
   • MobileRequest 이벤트 및 속성

3. 페이지에서 오류 및 네트워크 오류를 그룹화하고 정렬하는 방식을 변경합니다. 페이지 상단의 속성과 필터 막대를 모두 사용하여 선택합니다. 기본적으로 오류는 요청 도메인과 요청 경로별로 그룹화됩니다.

4. 특정 오류 및 네트워크 장애 필터링: 필터 막대에서 여러 필터를 사용하여 오류나 장애를 선택합니다.

5. 어떤 필터를 적용했는지 확인 또는 필터를 제거했는지 확인하세요. 선택한 필터는 필터 막대에 표시됩니다. 필터를 지우려면 지우려는 필터 옆에 있는 X 를 선택하세요.

6. 시간대 변경: 타임 피커 드롭다운 메뉴에서 새로운 시간대를 선택하세요.

7. 특정 앱 버전에 대한 정보 보기: 버전 드롭다운 메뉴에서 차트와 목록을 보려는 버전을 선택하세요. 기본적으로 사용 가능한 모든 버전이 표시됩니다.

아래 섹션에서는 요청 오류 페이지에서 수행할 수 있는 작업을 설명합니다.

트리아지 탭

분류 탭은 해결되지 않은 오류에 대한 개요와 이러한 오류가 오류율과 어떤 관련이 있는지 보여줍니다. 오류 그룹 표는 발생별로 오류 그룹을 나열하고 이를 조사하고 해결할 수 있는 사용자에게 할당할 수 있도록 합니다.

그룹 요청 오류 탭

그룹 오류 탭에서는 다음을 수행할 수 있습니다.

• 전반적인 HTTP 및 네트워크 요청 오류 추세 평가: 여러 요청 도메인과 모바일 앱 유형 및 버전에서 요청 오류와 오류율에 대한 개요를 확인하세요. 이 데이터를 사용하면 API 요청을 빠르게 식별하고 수정하세요.

• 심층 분석을 위한 필터링: 그룹과 필터를 사용하여 요청 유형, 요청 경로, 오류 유형 또는 정의한 사용자 정의 속성과 같은 특정 요청 속성에 초점을 맞춥니다.

• 패턴 식별: 요청 도메인, 요청 경로, 발생 빈도와 관련된 추세를 파악하기 위해 요청 오류 표를 조사합니다.

• 개별 요청 오류 조사: 요청 오류 보고서를 선택하여 효과적인 디버깅에 필요한 통합 트레이스, 이벤트 추적, 응답 본문, 속성 및 기타 관련 세부 정보를 확인하세요.

• 오류 상태 업데이트: 요청 오류를 Resolved [해결됨] 으로 표시하거나 문제를 소유하고 검토할 수 있는 특정 팀 구성원에게 할당한 후 수정 사항을 구현, 배포합니다.

오류 세부 정보 요청

요청 오류 페이지에서 특정 오류를 클릭하면 다음을 확인할 수 있습니다.

• 사용자 journeys: 오류가 발생한 다양한 경로와 작업을 표시합니다.
• 모든 발생 차트: 최초 감지 시점부터 선택한 기간 동안의 요청 오류 빈도를 표시합니다. 모든 발생 사항에 대한 집계된 데이터나 앱 버전별로 세부 정보를 볼 수 있습니다.
• 오류 유형 분석: 다양한 운영 체제 버전이나 영향을 받는 장치에서 이 요청 오류의 분포를 표시합니다.

해결된 오류에는 요청 오류를 해결한 사용자에 대한 세부 정보와 해결 타임스탬프가 포함된 배너가 포함됩니다. 모바일 모니터링 데이터 보존 정책이 적용되므로, 필요한 경우 해결된 오류를 필터링하여 과거 분석에 활용할 수 있습니다.

프로필

특정 오류를 살펴보면 프로필 섹션은 HTTP 오류 이벤트에 대한 다양한 값의 빈도에서 상당한 차이가 있음을 시각적으로 보여줍니다. 각 속성에 대한 오류 프로필에는 다음이 포함됩니다.

• 가장 편차가 큰 값에 대해 오류 속성이 어떻게 분포되어 있는지 보여주는 히트맵
• 오류 속성의 분포를 다른 오류의 분포와 비교하는 레이블

분류

특정 오류를 살펴보면 분류 섹션에서는 보고 있는 특정 오류 발생을 시스템에서 생성한 오류 그룹 과 연관시킵니다. 이러한 시스템에서 생성된 오류 그룹은 고유한 지문으로 식별됩니다. 이 고유한 지문을 통해 오류 그룹을 상태 업데이트 또는 할당별로 분류할 수 있습니다.

오류 그룹이 생성되는 방법에 대한 자세한 내용은 오류 그룹 작동 방식을 참조하고, 상태 및 할당에 대한 자세한 내용은 오류 추적을 참조하세요.

분산 트레이스

특정 오류를 살펴보면 분산 트레이스 섹션은 귀하의 요청이 다양한 서비스를 거쳐 완료될 때까지 귀하의 애플리케이션을 통과하는 과정을 추적하고 관찰합니다. 다양한 서비스에서 전체 요청 경로를 시각화하면 장애나 성능 병목현상, 병목지점을 신속하게 식별할 수 있습니다.

분산 추적의 작동 방식에 대해 자세히 알아보려면 마이크로서비스 전반에서 요청 추적을 참조하세요.

응답

요청에 대한 일반적인 응답은 응답 헤더와 응답 본문으로 구성되며, 이 두 가지가 합쳐져 요청의 성공 또는 실패에 대한 정보를 전달합니다. 응답 헤더에는 서버에 대한 메타데이터가 포함되어 있으며, 응답 본문에는 성공 또는 실패 코드와 해당 메시지를 비롯한 출력에 대한 정보가 포함되어 있습니다.

가능한 경우 요청에 대한 응답 본문을 캡처하여 요청 오류 세부 정보 페이지에 표시하여 디버깅을 신속하게 진행합니다.

이벤트 트레일

특정 오류를 살펴보면 이벤트 추적은 요청 오류에 이르기까지의 모든 이벤트에 대한 연대순 차트를 제공하므로 근본 원인 분석에 도움이 됩니다. 이는 기본적으로 이벤트 큐렐릭 모니터 또는 사용자 정의 대시보드일 수 있습니다. 이벤트 추적은 가장 오래된 이벤트부터 시작하여 시간순으로 정렬됩니다. 이는 일반적으로 앱 출시 이벤트이지만 다음 항목을 수정할 수 있습니다.

• 정렬: 오름차순과 내림차순 사이를 전환합니다.
• 이벤트 필터링: app launch, request, request error 또는 user actions 과 같은 이벤트 유형별로 필터링합니다.
• 이벤트 세부정보: 개별 이벤트를 확장하여 요청 이벤트에 대한 errorType, responseTime 또는 requestUrl 같은 속성을 검사합니다.

이벤트를 정렬하고 필터링한 후 다음을 조사하여 오류로 이어지는 이벤트를 좀 더 자세히 살펴볼 수 있습니다.

• 커스텀 브레드크럼: Record 브레드크럼 SDK를 활용하여 커스텀 MobileBreadcrumb 이벤트를 생성합니다. 이를 통해 오류 조사와 관련이 있을 수 있는 특정 기능을 추가할 수 있습니다.
• 처리된 예외: iOS 및 Android용 Record Handled Exception SDK 메서드를 사용하여 애플리케이션에서 예외가 처리되는 위치를 주석으로 표시합니다. 이러한 주석은 자동으로 충돌 이벤트 추적에 추가됩니다.

사용자 정의 데이터를 사용한 충돌 이벤트 추적 강화에 대한 지침은 레코드 브레드크럼을 참조하세요.

충돌 분석 도구를 최대한 활용하려면 다음을 확인하세요.

1. 모바일 SDK를 사용하여 맞춤 MobileBreadcrumb 또는 MobileHandledException 이벤트를 생성하세요.
2. 네트워크 요청 데이터를 캡처하려면 MobileRequest 이벤트를 활성화하세요.

속성

특정 오류를 살펴보면 각 요청 오류 샘플에는 요청, 응답, 오류를 트리거한 특정 서버에 대한 자세한 정보를 제공하는 포괄적인 속성 세트가 포함되어 있습니다. 이러한 속성은 오류의 맥락에 대한 귀중한 정보를 제공하고 근본 원인을 이해하는 데 도움이 됩니다.

문제점 해결

• 적용된 필터와 일치하는 프로필이 없는 경우 프로필이 비활성화됩니다.
• 요청에 대한 분산 트레이스는 시스템에 기록된 단일 HTTP 이벤트이므로 한 번만 발생할 가능성이 높습니다.
• 네트워크 장애에는 응답 본문이 없습니다.
• 모바일 에이전트는 예외 유형 목록을 유지 관리합니다. 어떤 경우에는 애플리케이션에서 발생하는 사용자 정의 예외가 이 목록 밖에 포함됩니다. 이런 경우, 모바일 오류 인박스(errors inbox) 페이지에 Unknown 나타날 수 있습니다. 오류 목록에서 Unknown 발견하고 누락된 예외 유형을 조사하는 데 도움이 필요한 경우 support.newrelic.com 에서 지원을 받으세요.