• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Monitor seu aplicativo móvel .NET MAUI

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.

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

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:

  1. Abra sua solução .NET MAUI, selecione o projeto ao qual deseja adicionar o agente e abra seu menu de contexto.

  2. 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:

  1. Vá para

    one.newrelic.com

    , clique em

    Integrations & Agents

    e depois clique em

    Mobile

    .

  2. Selecione seu aplicativo .NET MAUI.

  3. 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 MauiProgram.cs e adicione o seguinte código:

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);
}
}

Certifique-se de colar o(s) token(s) do seu aplicativo em appToken = "<APP-TOKEN-HERE>" 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.

Evento de rastreamento de tela

O plug-in móvel .NET MAUI permite rastrear eventos de navegação dentro do .NET MAUI Shell. Para fazer isso, você só precisa chamar o seguinte em App.xaml.cs:

public App()
{
InitializeComponent();
MainPage = new AppShell();
CrossNewRelic.Current.TrackShellNavigatedEvents();
}

Recomenda-se chamar esse método ao iniciar o agente. Estes eventos só serão registrados após a conclusão da navegação. Você pode encontrar esses dados por meio do explorador de dados em MobileBreadcrumb (sob o nome ShellNavigated) ou por meio de uma consulta NRQL:

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

As trilhas conterão três atributos:

  • Current: O URI da página atual.
  • Source: O tipo de navegação que ocorreu.
  • Previous: O URI da página anterior. Isso não existirá se a página anterior for nula.

(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.

Gravar trilhas

Acompanhe um método como uma interação.

Iniciar interação

Pare de interação

Registro métrico personalizado.

Registro métrico personalizado

Registrar exceções tratadas.

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.

Rastrear solicitações HTTP

Rastreie solicitações HTTP com falha

Desligue o agente.

Desligue o agente

Habilitar/desabilitar configurações padrão de monitoramento de Mobile.

Habilitar/desabilitar recurso de monitoramento

Execute um relatório de falha de teste.

Relatório de falhas 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.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.