Xamarin 애플리케이션 모니터링

요구 사항 검토

Xamarin 에이전트를 설치하기 전에 앱이 다음 버전 요구 사항을 충족하는지 확인하세요.

• Xamarin.Android 8.0 이상
• Xamarin.iOS 10.14 이상
• Android 네이티브 앱의 경우 Android API 24 이상을 사용하세요.
• iOS 네이티브 앱의 경우 iOS 10 사용

프로젝트에 Xamarin 에이전트 추가

먼저, Xamarin 프로젝트에 에이전트인 NuGet 패키지를 추가해야 합니다.

1. Xamarin 솔루션을 열고 에이전트를 추가할 Xamarin.Forms 프로젝트를 선택한 다음 컨텍스트 메뉴를 엽니다.
2. Add > Add NuGet packages 클릭한 다음 NewRelic.Xamarin.Plugin 선택합니다. 또한 Xamarin.iOS 프로젝트에 iOS 에이전트 바인딩을 추가해야 합니다.
3. 에이전트를 추가할 Xamarin.iOS 프로젝트를 선택하고 컨텍스트 메뉴를 엽니다.
4. Add > Add NuGet packages [추가 > NuGet 패키지 추가를 선택한] 다음 NewRelic.Xamarin.iOS.Binding선택합니다.

UI에서 애플리케이션 토큰 복사

애플리케이션 토큰은 New Relic에서 Xamarin 앱의 데이터를 인증하는 데 사용됩니다. New Relic UI에서 애플리케이션 토큰을 보고 복사하려면:

1. one.newrelic.com으로 이동합니다. Add data클릭한 다음 Mobile클릭합니다.
2. Xamarin 앱을 선택합니다.
3. Settings > Application 으로 이동하여 표시된 Application token [애플리케이션 토큰을] 복사하세요. 다음 단계에서 이 애플리케이션 토큰을 추가합니다.

에이전트 구성 파일을 다음에 추가하십시오. App.xaml.cs

1. 프로젝트의 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
         // AgentStartConfiguration agentConfig = new AgentStartConfiguration(true, true, LogLevel.INFO, "mobile-collector.newrelic.com", "mobile-crash.newrelic.com");
         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);
         }
       }

   복사

2. 위의 구성 파일에서 <YOUR_APP_TOKEN> 사용자 지정 애플리케이션 토큰([3단계]에서 복사)으로 바꿉니다. Xamarin Android 및 Xamarin iOS 앱을 모두 모니터링하는 경우 두 개의 서로 다른 애플리케이션 토큰을 추가해야 합니다.

(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" />