Nosso agente New Relic Flutter monitora seu aplicativo móvel Flutter 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 Flutter, você será capaz de:
Capture Dart 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 Flutter, 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 Flutter, 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 o agente Flutter, certifique-se de que seu aplicativo Flutter atenda a estes requisitos de versão:
Flutter 2.5.0 ou superior
Versões do Dart 2.16.2 ou superior, até, mas não incluindo, 3.0.0
Para aplicativos nativos do Android:
- API Android 24 ou superior
- Veja os requisitos nativos do Android
Para aplicativos nativos do iOS:
Adicione o agente Flutter ao seu projeto
Primeiro, você precisará adicionar o agente Flutter ao seu projeto Dart. No seu pubspec.yaml
, adicione o seguinte a dependencies
:
dependencies: newrelic_mobile: 0.0.1
Copie o token do seu aplicativo
O token do aplicativo é usado pelo New Relic para autenticar os dados do seu aplicativo Flutter. 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 Flutter.
Vá para
Settings > Application
e copie o
Application token
exibido.
Você adicionará esse token de aplicativo na próxima etapa.
Configure seu projeto Flutter
No seu projeto Flutter, abra main.dart
e adicione o seguinte código:
import 'package:newrelic_mobile/newrelic_mobile.dart'; var appToken = ""; if (Platform.isAndroid) { appToken = "<android app token>"; // Replace with your application token copied from the New Relic UI. } else if (Platform.isIOS) { appToken = "<ios app token>"; // Replace with your application token copied from the New Relic UI. } Config config = Config(accessToken: appToken, //Android Specific // Optional: Enable or disable collection of event data. analyticsEventEnabled: true, // Optional: Enable or disable reporting successful HTTP requests to the MobileRequest event type. networkErrorRequestEnabled: true, // Optional: Enable or disable reporting network and HTTP request errors to the MobileRequestError event type. networkRequestEnabled: true, // Optional: Enable or disable crash reporting. crashReportingEnabled: true, // Optional: Enable or disable interaction tracing. Trace instrumentation still occurs, but no traces are harvested. This will disable default and custom interactions. interactionTracingEnabled: true, // Optional: Enable or disable capture of HTTP response bodies for HTTP error traces and MobileRequestError events. httpResponseBodyCaptureEnabled: true, // Optional: Enable or disable agent logging. loggingEnabled: true, // iOS specific // Optional: Enable or disable automatic instrumentation of WebViews webViewInstrumentation: true, //Optional: Enable or disable Print Statements as Analytics Events printStatementAsEventsEnabled : true, // Optional: Enable or disable automatic instrumentation of HTTP Request httpInstrumentationEnabled:true, // Optional: Enable or disable reporting data using different endpoints for US government clients fedRampEnabled: false, // Optional: Enable or disable offline data storage when no internet connection is available. offlineStorageEnabled: true ); NewrelicMobile.instance.start(config, () { runApp(MyApp()); }); class MyApp extends StatelessWidget { ....
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) Configure seu aplicativo Android
Se você tiver um aplicativo Android nativo, precisará fazer as seguintes alterações em seu aplicativo Android:
Adicione as seguintes alterações ao arquivo
android/build.gradle
do seu aplicativo:buildscript {...repositories {...mavenCentral()}dependencies {...classpath "com.newrelic.agent.android:agent-gradle-plugin:${latest_android_version}"}}Aplique o plug-in
newrelic
na parte superior do arquivoandroid/app/build.gradle
:apply plugin: "com.android.application"apply plugin: 'newrelic' // <-- add thisAdicione as permissões
INTERNET
eACCESS_NETWORK_STATE
ao seu arquivoAndroidManifest.xml
:<uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />E pronto! Você deverá começar a ver os dados no New Relic em 5 minutos.
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 Flutter.
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. | |
Registre erros. | |
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 Flutter, 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 não substituir HttpOverrides.global
dentro do seu aplicativo Flutter.
Consultar dados log do Flutter
O New Relic armazena seu log do Flutter como evento personalizado. Você pode consultar esses logs e construir um painel para eles usando esta consulta NRQL:
SELECT * FROM `Mobile Dart Console Events` SINCE 30 MINUTES AGO
Para obter mais informações sobre consulta NRQL, consulte Introdução ao NRQL.