Nosso agente New Relic .NET MAUI monitora seu aplicativo móvel .NET MAUI e fornece insights profundos sobre o desempenho, os erros e a experiência do usuário do seu aplicativo. Depois de instalar e configurar o agente .NET MAUI, você será capaz de:
Capture C# errors:
Identifique e corrija problemas rapidamente.
Track network requests:
Veja como seu aplicativo interage com o backend.
Use distributed tracing:
Analise as exceções tratadas e encontre a causa raiz.
Create custom events and metrics:
Entenda como seu usuário interage com seu aplicativo.
one.newrelic.com > All capabilities > Mobile > (select your .NET MAUI app) > Summary: visualize dados do .NET MAUI, rastreie solicitações e erros HTTP e monitor o desempenho do seu aplicativo ao longo do tempo.
(Recomendado) Instalação guiada
Para instalar o agente .NET MAUI, siga nossa instalação guiada, localizada diretamente na interface.
Instalação manual
Se precisar instalar o agente manualmente, siga estas etapas:
Revise os requisitos
Antes de instalar nosso agente .NET MAUI, certifique-se de que seu aplicativo atenda a estes requisitos de versão:
.NET versão 7.0 ou superior
Para aplicativos nativos do Android: Android 7 (API 24) ou superior
Para aplicativos nativos do iOS:
- iOS 11 ou superior
- Versão mais recente do Xcode
Adicione o agente .NET MAUI ao seu projeto
Primeiro, você precisará adicionar nosso agente, um pacote NuGet, ao seu projeto MAUI:
Abra sua solução .NET MAUI, selecione o projeto ao qual deseja adicionar o agente e abra seu menu de contexto.
Clique em
Add > Add NuGet packages
e selecione
NewRelic.MAUI.Plugin
.
Copie o token do seu aplicativo da interface
O token do aplicativo é usado pelo New Relic para autenticar os dados do seu aplicativo .NET MAUI. Para visualizar e copiar o token do seu aplicativo na interface do New Relic:
Vá para
, clique em
Add data
e depois clique em
Mobile
.
Selecione seu aplicativo .NET MAUI.
Vá para
Settings > Application
e copie o
Application token
exibido.
Você adicionará esse token de aplicativo na próxima etapa.
Adicione nosso arquivo de configuração do agente ao seu projeto .NET MAUI
No seu projeto, abra App.xaml.cs
e adicione o seguinte código:
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, analyticsEventEnabled, networkErrorRequestEnabled, networkRequestEnabled, interactionTracingEnabled, webViewInstrumentation, fedRampEnabled, offlineStorageEnabled // AgentStartConfiguration agentConfig = new AgentStartConfiguration(crashReportingEnabled:false);
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); } }
Certifique-se de colar o(s) token(s) do seu aplicativo em appToken = ""
no código acima. Se você implantar seu aplicativo híbrido nas plataformas iOS e Android, precisará adicionar dois tokens separados: um para iOS e outro para Android.
(Somente Android) Adicionar permissões
Se você tiver um aplicativo nativo do Android, precisará adicionar as permissões INTERNET
e ACCESS_NETWORK_STATE
ao arquivo Platforms/Android/AndroidManifest.xml
:
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.INTERNET" />
Personalize a instrumentação do agente
Precisa customizar sua instrumentação de agente? Nossos métodos públicos de API do SDK móvel permitem coletar dados personalizados, definir configurações padrão e muito mais.
As personalizações a seguir estão disponíveis para o agente .NET MAUI.
Se você quiser... | Use este método |
---|---|
Registre trilhas para rastrear a atividade do aplicativo que pode ser útil para a resolução de problemas de travamento. | |
Acompanhe um método como uma interação. | |
Registro métrico personalizado. | |
Registrar exceções tratadas. | |
Grave atributo personalizado e evento. | Existem diversas formas de reportar atributo personalizado e evento:
|
Rastreie solicitações e falhas de rede personalizadas. | |
Desligue o agente. | |
Habilitar/desabilitar configurações padrão de monitoramento de Mobile. | |
Execute um relatório de falha de teste. |
Solucionar erros de HTTP
Faltam dados HTTP na interface?
Após instalar o agente .NET MAUI, aguarde pelo menos 5 minutos. Se nenhum dado HTTP aparecer nas páginas de interface de erros HTTP e solicitações HTTP, certifique-se de ter usado HttpMessageHandler
em HttpClient
.