Xamarin モバイルアプリを監視する

New Relic Xamarin エージェントは、Xamarin モバイルアプリを監視し、アプリのパフォーマンス、エラー、ユーザーエクスペリエンスに関する深い洞察を提供します。Xamarin エージェントをインストールして構成すると、次のことができるようになります。

C# エラーをキャプチャ: 問題を迅速に特定して修正します。
Track network requests: [ネットワークリクエストを追跡する:] アプリがバックエンドとどのようにやり取りするかを確認します。
Use distributed tracing: [分散トレースを使用する:] 処理された例外をドリルダウンして、根本原因を見つけます。
カスタムイベントとメトリクスを作成する: ユーザーがアプリをどのように操作するかを理解します。

Summary view of a Xamarin app in New Relic

one.newrelic.com > All capabilities > Mobile > (アプリを選択) > Summary: Xamarin データを表示し、HTTP リクエストとエラーを追跡し、アプリの経時的なパフォーマンスを監視します。

(推奨) ガイド付きインストール

Xamarin エージェントをインストールするには、UI に直接あるガイド付きインストールに従ってください。

手動インストール

エージェントを手動でインストールする必要がある場合は、次の手順に従います。

要件を確認する

Xamarin エージェントをインストールする前に、アプリが次のバージョン要件を満たしていることを確認してください。

Xamarin.Android 8.0 以降
Xamarin.iOS 10.14 以降
Android ネイティブアプリの場合は、Android API 24 以降を使用してください
iOS ネイティブアプリの場合は、iOS 10 を使用してください

Xamarin エージェントをプロジェクトに追加する

まず、エージェントである NuGet パッケージを Xamarin プロジェクトに追加する必要があります。

Xamarin ソリューションを開き、エージェントを追加する Xamarin.Forms プロジェクトを選択して、そのコンテキストメニューを開きます。
Add > Add NuGet packagesをクリックし、 NewRelic.Xamarin.Pluginを選択します。また、iOS エージェントバインディングを Xamarin.iOS プロジェクトに追加する必要があります。
エージェントを追加する Xamarin.iOS プロジェクトを選択し、そのコンテキストメニューを開きます。
Add > Add NuGet packages [追加] > [NuGet パッケージの追加] を選択し、 NewRelic.Xamarin.iOS.Bindingを選択します。

UI からアプリケーショントークンをコピーします。

アプリケーショントークンは、New Relic が Xamarin アプリのデータを認証するために使用されます。New Relic UI でアプリケーショントークンを表示およびコピーするには:

one.newrelic.comにアクセスし、 [データを追加]をクリックし、 [モバイル]をクリックします。
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
      // 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);
      }
    }

アプリケーショントークンを上記のコードのappToken = ""に貼り付けてください。ハイブリッドアプリを iOS と Android の両方のプラットフォームにデプロイした場合は、2 つの個別のトークン (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 エージェントでは次のカスタマイズが可能です。

あなたがしたい場合は...	この方法を使用してください
ブレッドクラムを記録して、クラッシュのトラブルシューティングに役立つアプリのアクティビティを追跡します。	パン粉の記録
メソッドをインタラクションとして追跡します。	インタラクションを開始するインタラクションを停止する
カスタムメトリクスの記録	カスタムメトリクスの記録
処理された例外を記録します。	処理された例外を記録する
カスタム属性とイベントを記録します。	カスタム属性とイベントをレポートするには、いくつかの方法があります。カスタム属性を記録するセッション属性数を増やす属性の削除すべての属性を削除カスタムイベントの記録イベントプールの最大サイズを設定するエージェントがイベントをメモリに保存する最大時間を設定する現在のセッションの ID を取得するイベントおよび属性に関連付けるカスタムユーザー ID を設定する使用するのに最適な方法とその理由の詳細については、「モバイル監視のカスタムイベントと属性をレポートする」を参照してください。
カスタムネットワークリクエストと障害を追跡します。	HTTPリクエストを追跡する失敗したHTTPリクエストを追跡する
エージェントをシャットダウンします。	エージェントのシャットダウン
デフォルトのモバイル監視設定を有効/無効にします。	監視機能の有効化/無効化
テストクラッシュレポートを実行します。	テストクラッシュレポート

HTTP エラーのトラブルシューティング

UI に HTTP データがありませんか?

.NET MAUI エージェントをインストールした後、少なくとも 5 分間待ちます。HTTP データが表示されない場合: HTTP エラーおよび HTTP リクエスト UI ページで、 HttpClientで HttpMessageHandler を使用したことを確認してください。

この機械翻訳は参考用に提供されます。

Xamarin モバイル アプリを監視する

(推奨) ガイド付きインストール .css-21sua1{background:none;border:none;width:0;padding:0;}