Nosso agente New Relic Xamarin monitora seu aplicativo móvel Xamarin 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 Xamarin, você poderá:
- 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 an app) > Summary: visualize dados do Xamarin, 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 Xamarin, 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 Xamarin, certifique-se de que seu aplicativo atenda a estes requisitos de versão:
- Xamarin.Android 8.0 ou superior
- Xamarin.iOS 10.14 ou superior
- Para aplicativos nativos do Android, use Android API 24 ou superior
- Para aplicativos nativos do iOS, use iOS 10
Adicione o agente Xamarin ao seu projeto
Primeiro, você precisará adicionar nosso agente, um pacote NuGet, ao seu projeto Xamarin:
- Abra sua solução Xamarin, selecione o projeto Xamarin.Forms ao qual deseja adicionar o agente e abra seu menu de contexto.
- Clique em Add > Add NuGet packages e selecione
NewRelic.Xamarin.Plugin
. Você também precisará adicionar nossa ligação de agente iOS ao seu projetoXamarin.iOS
: - Selecione o projeto Xamarin.iOS ao qual deseja adicionar o agente e abra seu menu de contexto.
- Add > Add NuGet packagese selecione
NewRelic.Xamarin.iOS.Binding
.
Copie o token do seu aplicativo da interface
O token do aplicativo é usado pelo New Relic para autenticar os dados do seu aplicativo Xamarin. Para visualizar e copiar o token do seu aplicativo na interface do New Relic:
Vá para one.newrelic.com, clique em Integrations & Agents e depois clique em Mobile.
Selecione seu aplicativo Xamarin.
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 App.xaml.cs
No arquivo App.xaml.cs
do seu projeto, adicione o seguinte código:
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, analyticsEventEnabled, networkErrorRequestEnabled, // networkRequestEnabled, interactionTracingEnabled, webViewInstrumentation, fedRampEnabled, // offlineStorageEnabled, newEventSystemEnabled, backgroundReportingEnabled // AgentStartConfiguration agentConfig = new AgentStartConfiguration(crashReportingEnabled:false);
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); } }
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 Xamarin.
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 No HTTP data appears: estiver nas páginas de interface de erros HTTP e solicitações HTTP, certifique-se de ter usado HttpMessageHandler
em HttpClient
.