New Relic .NET MAUI エージェントは、.NET MAUI モバイル アプリを監視し、アプリのパフォーマンス、エラー、ユーザー エクスペリエンスについての深い洞察を提供します。.NET MAUI エージェントをインストールして構成すると、次のことができるようになります。
- C# エラーをキャプチャ: 問題を迅速に特定して修正します。
- Track network requests: [ネットワーク リクエストを追跡する:] アプリがバックエンドとどのようにやり取りするかを確認します。
- Use distributed tracing: [分散トレースを使用する:] 処理された例外をドリルダウンして、根本原因を見つけます。
- カスタム イベントとメトリクスを作成する: ユーザーがアプリをどのように操作するかを理解します。

one.newrelic.com > All capabilities > Mobile > (.NET MAUI アプリを選択) > 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 [追加 >NuGet パッケージの追加]をクリックし、
NewRelic.MAUI.Plugin
を選択します。
UI からアプリケーション トークンをコピーします。
アプリケーション トークンは、New Relic が .NET MAUI アプリのデータを認証するために使用されます。New Relic UI でアプリケーション トークンを表示およびコピーするには:
- one.newrelic.comにアクセスし、 [データを追加]をクリックし、 [モバイル]をクリックします。
- .NET MAUI アプリを選択します。
- Settings > Application に移動し、表示された Application token [アプリケーション トークン]をコピーします。次のステップで、このアプリケーション トークンを追加します。
エージェント構成ファイルを .NET MAUI プロジェクトに追加します。
プロジェクトで App.xaml.cs
を開き、次のコードを追加します。
using NewRelic.MAUI.Plugin;... public App () { InitializeComponent(); MainPage = new AppShell(); CrossNewRelic.Current.HandleUncaughtException(); CrossNewRelic.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 (DeviceInfo.Current.Platform == DevicePlatform.Android) { CrossNewRelic.Current.Start("<YOUR_APP_TOKEN>"); // Start with optional agent configuration // CrossNewRelic.Current.Start("<YOUR_APP_TOKEN>", agentConfig); } else if (DeviceInfo.Current.Platform == DevicePlatform.iOS) { CrossNewRelic.Current.Start("<YOUR_APP_TOKEN>"); // Start with optional agent configuration // CrossNewRelic.Current.Start("<YOUR_APP_TOKEN>", agentConfig); } }
アプリケーション トークンを上記のコードのappToken = ""
に貼り付けてください。ハイブリッド アプリを iOS と Android の両方のプラットフォームにデプロイした場合は、2 つの個別のトークン (iOS 用と Android 用) を追加する必要があります。
エージェントのインストルメンテーションをカスタマイズする
エージェントのインストルメンテーションをカスタマイズする必要がありますか?パブリック モバイル SDK API メソッドを使用すると、カスタム データの収集、デフォルト設定の構成などが可能になります。
.NET MAUI エージェントでは次のカスタマイズが可能です。
あなたがしたい場合は... | この方法を使用してください |
---|---|
ブレッドクラムを記録して、クラッシュのトラブルシューティングに役立つアプリのアクティビティを追跡します。 | |
メソッドをインタラクションとして追跡します。 | |
カスタムメトリクスの記録 | |
処理された例外を記録します。 | |
カスタム属性とイベントを記録します。 | カスタム属性とイベントをレポートするには、いくつかの方法があります。 |
カスタム ネットワーク リクエストと障害を追跡します。 | |
エージェントをシャットダウンします。 | |
デフォルトのモバイル監視設定を有効/無効にします。 | |
テストクラッシュレポートを実行します。 |
HTTP エラーのトラブルシューティング
UI に HTTP データがありませんか?
.NET MAUI エージェントをインストールした後、少なくとも 5 分間待ちます。HTTP エラーおよび HTTP リクエスト UI ページに HTTP データが表示されない場合は、 HttpClient
で HttpMessageHandler
を使用したことを確認してください。