• 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 Cordova

Nosso agente New Relic Cordova monitora seu aplicativo móvel Cordova e fornece insights profundos sobre o desempenho, os erros e a experiência do usuário do seu aplicativo. O agente inclui todos os recursos de monitoramento de Mobile da New Relic que oferecemos para aplicativos móveis nativos. Depois de instalar e configurar o agente Cordova, 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.

Requisitos de compatibilidade

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

(Recomendado) Instalação guiada

Para instalar o agente Cordova, 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 Cordova

No diretório do projeto Cordova, adicione o agente Cordova ao seu projeto usando a ferramenta de linha de comando e cole o(s) token(s) do aplicativo no argumento --variable:

# Install from github repository
cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="{ios-app-token}" --variable ANDROID_APP_TOKEN="{android-app-token}"

(Opcional) Configurar o agente

Adicione a seguinte configuração opcional ao argumento --variable , que os chamará no início do agente:

  • CRASH_REPORTING_ENABLED: ativa ou desativa o relatório de falhas.

    • Os valores possíveis são true e false. O padrão é true.
  • DISTRIBUTED_TRACING_ENABLED: habilita ou desabilita a adição de cabeçalhos distributed tracing a solicitações de rede.

    • Os valores possíveis são true e false. O padrão é true.
  • INTERACTION_TRACING_ENABLED: habilite ou desabilite o rastreamento de interação. a instrumentação trace ainda ocorre, mas nenhum traço é coletado. Isso desativará a interação padrão e personalizada.

    • Os valores possíveis são true e false. O padrão é true.
  • DEFAULT_INTERACTIONS_ENABLED: habilita ou desabilita a interação padrão. a instrumentação trace ainda ocorre, mas nenhum traço é coletado. Isso ativará ou desativará a interação padrão apenas enquanto a interação personalizada permanecer habilitada.

    • Os valores possíveis são true e false. O padrão é true.
  • LOGGING_ENABLED: habilite ou desabilite o log do agente.

    • Os valores possíveis são true e false. O padrão é true.
  • LOG_LEVEL: especifica o nível de log.

    • Os valores possíveis são ERROR (menos detalhado), WARNING INFO, VERBOSE, DEBUG, AUDIT (mais detalhado).
    • O padrão é INFO no Android e WARNING no iOS.
  • WEB_VIEW_INSTRUMENTATION (SOMENTE iOS): Habilite (padrão) ou desabilite a instrumentação automática do WKWebView.

    • Os valores possíveis são true e false. O padrão é true.
  • COLLECTOR_ADDRESS: especifica o componente de autoridade URI do endpoint de upload de dados de coleta.

  • CRASH_COLLECTOR_ADDRESS: especifica o componente de autoridade do URI de upload de dados de falha.

  • FEDRAMP_ENABLED: habilite ou desabilite dados de relatórios usando endpoints diferentes para clientes do governo dos EUA.

    • Os valores possíveis são true e false. O padrão é false.
  • OFFLINE_STORAGE_ENABLED: ativa ou desativa o armazenamento de dados off-line quando não há conexão com a Internet disponível.

    • Os valores possíveis são true e false. O padrão é true.

    Essas opções estão disponíveis apenas no agente Cordova v6.2.1 e superior.

    Por exemplo, se você quiser desabilitar o relatório de falhas, chame o seguinte:

    cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="{ios-app-token}" --variable ANDROID_APP_TOKEN="{android-app-token}" --variable CRASH_REPORTING_ENABLED="false"

(Somente Ionic Cordova) Configure sua framework Ionic

Se você estiver usando uma framework Ionic, adicione isto ao diretório do projeto Cordova:

bash
$
ionic cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="{ios-app-token}" --variable ANDROID_APP_TOKEN="{android-app-token}"
$
$
npm install @awesome-cordova-plugins/newrelic

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.

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

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

Erros de registro

Erros de registro

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

Atualizar o agente

Para atualizar a versão do seu agente Cordova, execute este comando simples:

cordova plugin update
Copyright © 2024 New Relic Inc.

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