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

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

In the event of any inconsistency between the English version and the translated version, the English versionwill take priority. Please visit this page for more information.

Criar um problema

Monitor seu aplicativo móvel Ionic Capacitor

Nosso agente New Relic Ionic Capacitor monitora seu aplicativo móvel Ionic Capacitor e fornece insights profundos sobre o desempenho, os erros e a experiência do usuário do seu aplicativo. O agente inclui automaticamente os agentes nativos da New Relic para fornecer monitoramento de Mobile e visibilidade de desempenho. Depois de instalar e configurar o agente, você será capaz de:

  • Capture JavaScript 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.

Para obter mais informações, consulte Agente New Relic Ionic Capacitor no Github.

Requisitos de compatibilidade

Antes de instalar o agente, certifique-se de que seu aplicativo atenda a estes requisitos:

(Recomendado) Instalação guiada

Para instalar o agente, siga nossa instalação guiada, localizada diretamente na interface.

Instalação manual

Se precisar instalar o agente manualmente, siga estas etapas:

Crie um(s) token(s) de aplicativo

  1. Acesse

    one.newrelic.com > Browser & Mobile > (choose Android or iOS)

    e conclua as etapas de instrumentação na interface.

  2. Em

    Step 4

    na interface, copie o(s) token(s) do aplicativo (um para iOS e Android, se aplicável).

Adicione o agente Capacitor

No diretório do seu projeto, adicione o agente Capacitor ao seu projeto usando sua ferramenta de linha de comando:

bash
$
npm install @newrelic/newrelic-capacitor-plugin
$
npx cap sync

Configurar o capacitor

  1. Inicie o agente Capacitor na inicialização do seu aplicativo em main.ts (Angular ou Vue) ou index.tsx (React).

  2. Adicione o seguinte código:

    import { NewRelicCapacitorPlugin, NREnums, AgentConfiguration } from '@newrelic/newrelic-capacitor-plugin';
    import { Capacitor } from '@capacitor/core';
    var appToken;
    if(Capacitor.getPlatform() === 'ios') {
    appToken = '<IOS-APP-TOKEN>';
    } else {
    appToken = '<ANDROID-APP-TOKEN>';
    }
    if(Capacitor.getPlatform() === 'ios') {
    appToken = '<IOS-APP-TOKEN>';
    } else {
    appToken = '<ANDROID-APP-TOKEN>';
    }
    let agentConfig : AgentConfiguration = {
    //Android Specific
    // Optional:Enable or disable collection of event data.
    analyticsEventEnabled: 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 reporting successful HTTP requests to the MobileRequest event type.
    networkRequestEnabled: true,
    // Optional:Enable or disable reporting network and HTTP request errors to the MobileRequestError event type.
    networkErrorRequestEnabled: 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,
    // Optional:Specifies the log level. Omit this field for the default log level.
    // Options include: ERROR (least verbose), WARNING, INFO, VERBOSE, AUDIT (most verbose).
    logLevel: NREnums.LogLevel.INFO,
    // iOS Specific
    // Optional:Enable/Disable automatic instrumentation of WebViews
    webViewInstrumentation: true,
    // Optional:Set a specific collector address for sending data. Omit this field for default address.
    // collectorAddress: "",
    // Optional:Set a specific crash collector address for sending crashes. Omit this field for default address.
    // crashCollectorAddress: "",
    // Optional:Enable or disable sending JS console logs to New Relic.
    sendConsoleEvents: 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
    }
    NewRelicCapacitorPlugin.start({appKey:appToken, agentConfiguration: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) Se você estiver monitorando um aplicativo nativo do Android, siga estas etapas:

  1. Instale o agente Android nativo do New Relic.

  2. Atualizar build.gradle:

    buildscript {
    ...
    repositories {
    ...
    mavenCentral()
    }
    dependencies {
    ...
    classpath "com.newrelic.agent.android:agent-gradle-plugin:6.11.1"
    }
    }
  3. Atualizar app/build.gradle:

    apply plugin: "com.android.application"
    apply plugin: 'newrelic' // <-- add this
  4. Certifique-se de que seu aplicativo solicite as permissões INTERNET e ACCESS_NETWORK_STATE adicionando estas linhas ao seu AndroidManifest.xml:

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  5. Para vincular automaticamente o pacote, reconstrua seu projeto:

    bash
    $
    # Android apps
    $
    ionic capacitor run android
    $
    # iOS apps
    $
    ionic capacitor run ios

Implantar seu aplicativo

Em seguida, implante seu aplicativo. Após alguma atividade no aplicativo, você deverá ver os dados no New Relic (pode levar alguns minutos após implantar seu aplicativo).

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

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

Registre erros personalizados.

Registrar erros personalizados

Registro métrico personalizado.

Registro métrico personalizado

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 JavaScript

Copyright © 2024 New Relic Inc.

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