• /
  • 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 Flutter

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.
Summary view of a flutter app in New Relic

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:

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:

  1. Vá para one.newrelic.com, clique em Integrations & Agents e depois clique em Mobile.

  2. Selecione seu aplicativo Flutter.

  3. 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,
// iOS Specific
// Optional: Enable or disable background reporting functionality.
backgroundReportingEnabled: true,
// iOS Specific
// Optional: Enable or disable to use our new, more stable, event system for iOS agent.
newEventSystemEnabled: true,
// Optional: Enable or disable distributed tracing.
distributedTracingEnabled: 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 nativo para Android, precisará fazer as seguintes alterações:

  1. Adicione as seguintes alterações para aplicar o plug-in Gradle:

    Se o seu projeto estiver usando o plug-in DSL (Flutter 3.16 ou posterior), faça as seguintes alterações:

  2. Em android/settings.gradle:

    plugins {
    id "dev.flutter.flutter-plugin-loader" version "1.0.0"
    id "com.android.application" version "7.4.2" apply false
    id "org.jetbrains.kotlin.android" version "1.7.10" apply false
    id "com.newrelic.agent.android" version "7.5.1" apply false // <-- include this
    }
  3. Em android/app/build.gradle:

    plugins {
    id "com.android.application"
    id "kotlin-android"
    id "dev.flutter.flutter-gradle-plugin"
    id "com.newrelic.agent.android" //<-- include this
    }
  • Ou, se seu projeto estiver usando a maneira tradicional de aplicar o plug-in:

    buildscript {
    ...
    repositories {
    ...
    mavenCentral()
    }
    dependencies {
    ...
    classpath "com.newrelic.agent.android:agent-gradle-plugin:7.5.1"
    }
    }

    Aplique o plug-in NewRelic no topo do arquivo android/app/build.gradle :

    apply plugin: "com.android.application"
    apply plugin: 'newrelic' // <-- include this
    1. No seu arquivo AndroidManifest.xml , adicione as seguintes permissões:

      <uses-permission android:name="android.permission.INTERNET" />
      <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

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.

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

Registre erros.

Erros de registro

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

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.

Copyright © 2024 New Relic Inc.

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