New Relic Xamarin 에이전트는 Xamarin 모바일 앱을 모니터링하고 앱의 성능, 오류 및 사용자 경험에 대한 심층적인 통찰력을 제공합니다. Xamarin 에이전트를 설치하고 구성하면 다음을 수행할 수 있습니다.
- Capture C# errors: 문제를 신속하게 식별하고 해결합니다.
- Track network requests: 앱이 백앤드와 어떻게 상호작용하는지 알아보세요.
- Use distributed tracing: 처리된 예외를 자세히 살펴보고 근본 원인을 찾으세요.
- Create custom events and metrics: 사용자가 앱과 상호 작용하는 방식을 이해합니다.
one.newrelic.com > All capabilities > Mobile > (select an app) > Summary: Xamarin 데이터를 보고, HTTP 요청 및 오류를 추적하고, 시간 경과에 따른 앱 성능을 모니터링합니다.
(권장) 설치 안내
Xamarin 에이전트를 설치하려면 UI에 직접 있는 가이드 설치 를 따르십시오.
수동 설치
에이전트를 수동으로 설치해야 하는 경우 다음 단계를 따르세요.
요구 사항 검토
Xamarin 에이전트를 설치하기 전에 앱이 다음 버전 요구 사항을 충족하는지 확인하세요.
- Xamarin.Android 8.0 이상
- Xamarin.iOS 10.14 이상
- Android 네이티브 앱의 경우 Android API 24 이상을 사용하세요.
- iOS 네이티브 앱의 경우 iOS 10 사용
프로젝트에 Xamarin 에이전트 추가
먼저, Xamarin 프로젝트에 에이전트인 NuGet 패키지를 추가해야 합니다.
- Xamarin 솔루션을 열고 에이전트를 추가할 Xamarin.Forms 프로젝트를 선택한 다음 컨텍스트 메뉴를 엽니다.
- Add > Add NuGet packages 클릭한 다음
NewRelic.Xamarin.Plugin
선택합니다. 또한Xamarin.iOS
프로젝트에 iOS 에이전트 바인딩을 추가해야 합니다. - 에이전트를 추가할 Xamarin.iOS 프로젝트를 선택하고 컨텍스트 메뉴를 엽니다.
- Add > Add NuGet packages을 선택한 다음
NewRelic.Xamarin.iOS.Binding
선택합니다.
UI에서 애플리케이션 토큰 복사
애플리케이션 토큰은 New Relic에서 Xamarin 앱의 데이터를 인증하는 데 사용됩니다. New Relic UI에서 애플리케이션 토큰을 보고 복사하려면:
one.newrelic.com 으로 이동하여 Integrations & Agents 클릭한 다음 Mobile 클릭하세요.
Xamarin 앱을 선택합니다.
Settings > Application 으로 이동하여 표시된 Application token 을 복사합니다.
다음 단계에서 이 애플리케이션 토큰을 추가합니다.
에이전트 구성 파일을 다음에 추가하십시오. App.xaml.cs
프로젝트의 App.xaml.cs
파일에 다음 코드를 추가합니다.
using NewRelic.Xamarin.Plugin;... public App () { InitializeComponent(); MainPage = new MainPage(); Application.Current.PageAppearing += OnPageAppearing; Application.Current.PageDisappearing += PageDisappearing; CrossNewRelicClient.Current.HandleUncaughtException(); CrossNewRelicClient.Current.TrackShellNavigatedEvents(); // Set optional agent configuration // Options are: crashReportingEnabled, loggingEnabled, logLevel, collectorAddress, // crashCollectorAddress, analyticsEventEnabled, networkErrorRequestEnabled, // networkRequestEnabled, interactionTracingEnabled, webViewInstrumentation, fedRampEnabled, // offlineStorageEnabled, newEventSystemEnabled, backgroundReportingEnabled // AgentStartConfiguration agentConfig = new AgentStartConfiguration(crashReportingEnabled:false);
if (Device.RuntimePlatform == Device.Android) { CrossNewRelicClient.Current.Start("YOUR_APP_TOKEN"); // Start with optional agent configuration // CrossNewRelicClient.Current.Start("YOUR_APP_TOKEN", agentConfig); } else if (Device.RuntimePlatform == Device.iOS) { CrossNewRelicClient.Current.Start("YOUR_APP_TOKEN"); // Start with optional agent configuration // CrossNewRelicClient.Current.Start("YOUR_APP_TOKEN", agentConfig); } }
위 코드의 appToken = ""
에 애플리케이션 토큰을 붙여넣었는지 확인하세요. iOS 및 Android 플랫폼 모두에 하이브리드 앱을 배포한 경우 iOS용 토큰과 Android용 토큰 두 개를 추가해야 합니다.
(Android만 해당) 권한 추가
Android 네이티브 앱이 있는 경우 Platforms/Android/AndroidManifest.xml
파일에 INTERNET
및 ACCESS_NETWORK_STATE
권한을 추가해야 합니다.
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><uses-permission android:name="android.permission.INTERNET" />
에이전트 계측 사용자 지정
에이전트 계측을 사용자 정의해야 합니까? 공개 모바일 SDK API 방법을 사용하면 사용자 지정 데이터를 수집하고 기본 설정을 구성하는 등의 작업을 수행할 수 있습니다.
다음 사용자 지정은 Xamarin 에이전트에 사용할 수 있습니다.
원하는 경우... | 이 방법을 사용하십시오 |
---|---|
충돌 문제 해결에 도움이 될 수 있는 앱 활동을 추적하기 위해 이동 경로를 기록합니다. | |
메서드를 상호 작용으로 추적합니다. | |
맞춤 측정항목을 기록합니다. | |
처리된 예외를 기록합니다. | |
사용자 지정 속성 및 이벤트를 기록합니다. | 사용자 정의 속성 및 이벤트를 보고하는 방법에는 여러 가지가 있습니다. |
사용자 지정 네트워크 요청 및 실패를 추적합니다. | |
에이전트를 종료합니다. | |
기본 모바일 모니터링 설정을 활성화/비활성화합니다. | |
테스트 충돌 보고서를 실행합니다. |
HTTP 오류 문제 해결
UI에 HTTP 데이터가 누락되었습니까?
.NET MAUI 에이전트를 설치한 후 5분 이상 기다립니다. HTTP 오류 및 HTTP 요청 UI 페이지에서 No HTTP data appears: 인 경우 HttpClient
에서 HttpMessageHandler
사용했는지 확인하세요.