.NET MAUI モバイルアプリを監視する

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

Capture C# errors:
問題を迅速に特定して修正します。
Track network requests:
アプリがバックエンドとどのように対話するかを確認します。
Use distributed tracing:
処理された例外をドリルダウンして、根本原因を見つけます。
Create custom events and metrics:
ユーザーがアプリをどのように操作するかを理解します。

Summary view of a .NET MAUI mobile app in New Relic

one.newrelic.com > All capabilities > Mobile > (select your .NET MAUI app) > Summary: .NET MAUI データを表示し、HTTP リクエストとエラーを追跡し、アプリのパフォーマンスを時間の経過とともに監視します。

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

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

手動インストール

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

要件を確認する

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

.NET バージョン 7.0 以降
Android ネイティブアプリの場合: Android 7 (API 24) 以降
iOS ネイティブアプリの場合:
- iOS 11以降
- Xcodeの最新リリース

.NET MAUI エージェントをプロジェクトに追加する

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

.NET MAUI ソリューションを開き、エージェントを追加するプロジェクトを選択して、そのコンテキストメニューを開きます。
Add > Add NuGet packages
をクリックし、 NewRelic.MAUI.Pluginを選択します。

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

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

one.newrelic.com
に移動し、
Integrations & Agents
をクリックしてから、
Mobile
をクリックします。
.NET MAUI アプリを選択します。
Settings > Application
に移動し、表示された
Application token
をコピーします。
このアプリケーショントークンは、次の手順で追加します。

エージェント構成ファイルを .NET MAUI プロジェクトに追加します。

プロジェクトで MauiProgram.cs を開き、次のコードを追加します。

using NewRelic.MAUI.Plugin;
...

    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
                fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
            });

        builder.ConfigureLifecycleEvents(AppLifecycle => {
        #if ANDROID
            AppLifecycle.AddAndroid(android => android
               .OnCreate((activity, savedInstanceState) => StartNewRelic()));
        #endif
        #if IOS

             AppLifecycle.AddiOS(iOS => iOS.WillFinishLaunching((_,__) => {
                StartNewRelic();
                return false;
            }));
        #endif
        });
        return builder.Build();
    }

    private static void StartNewRelic()
    {

      CrossNewRelic.Current.HandleUncaughtException();

      // 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 (DeviceInfo.Current.Platform == DevicePlatform.Android)
      {
        CrossNewRelic.Current.Start("<APP-TOKEN-HERE>");
        // Start with optional agent configuration
        // CrossNewRelic.Current.Start("<APP-TOKEN-HERE>", agentConfig);
      } else if (DeviceInfo.Current.Platform == DevicePlatform.iOS)
      {
        CrossNewRelic.Current.Start("<APP-TOKEN-HERE>");
        // Start with optional agent configuration
        // CrossNewRelic.Current.Start("<APP-TOKEN-HERE>", agentConfig);
      }
    }

アプリケーショントークンを上記のコードのappToken = "<APP-TOKEN-HERE>"に貼り付けてください。ハイブリッドアプリを iOS と Android の両方のプラットフォームにデプロイした場合は、2 つの個別のトークン (iOS 用と Android 用) を追加する必要があります。

画面追跡イベント

.NET MAUI モバイルプラグインを使用すると、.NET MAUI シェル内でナビゲーションイベントを追跡できます。これを行うには、 App.xaml.csで次のものを呼び出すだけです。

public App()
    {
        InitializeComponent();

        MainPage = new AppShell();
        CrossNewRelic.Current.TrackShellNavigatedEvents();

    }

エージェントを起動するときに、このメソッドを呼び出すことをお勧めします。これらのイベントは、ナビゲーションが完了した後にのみ記録されます。このデータは、 MobileBreadcrumbのデータエクスプローラー (名前ShellNavigatedの下) または NRQL クエリによって見つけることができます。

SELECT * FROM MobileBreadcrumb WHERE name = 'ShellNavigated' SINCE 24 HOURS AGO

ブレッドクラムには 3 つの属性が含まれます。

Current: 現在のページの URI。
Source: 発生したナビゲーションのタイプ。
Previous: 前のページの URI。前のページが null の場合、これは存在しません。

(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 メソッドを使用すると、カスタムデータの収集、デフォルト設定の構成などが可能になります。

.NET MAUI エージェントでは次のカスタマイズが可能です。

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

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

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

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