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:
- Cordova 7.x ou superior
- Node.js 6.0 ou superior
- Ferramentas CLI Cordova
- Uma plataforma Cordova Android ou iOS para o seu projeto
- Tokens de aplicativosmóveis
(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
Acesse
one.newrelic.com > Browser & Mobile > (choose Android or iOS)
e conclua as etapas de instrumentação na interface.
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 repositorycordova 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
efalse
. O padrão étrue
.
- Os valores possíveis são
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
efalse
. O padrão étrue
.
- Os valores possíveis são
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
efalse
. O padrão étrue
.
- Os valores possíveis são
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
efalse
. O padrão étrue
.
- Os valores possíveis são
LOGGING_ENABLED
: habilite ou desabilite o log do agente.- Os valores possíveis são
true
efalse
. O padrão étrue
.
- Os valores possíveis são
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 eWARNING
no iOS.
- Os valores possíveis são
WEB_VIEW_INSTRUMENTATION
(SOMENTE iOS): Habilite (padrão) ou desabilite a instrumentação automática do WKWebView.- Os valores possíveis são
true
efalse
. O padrão étrue
.
- Os valores possíveis são
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
efalse
. O padrão éfalse
.
- Os valores possíveis são
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
efalse
. O padrão étrue
.
- Os valores possíveis são
NEW_EVENT_SYSTEM_ENABLED
: Ative ou desative o uso de nosso novo e mais estável sistema de eventos para agente iOS.- Os valores possíveis são
true
efalse
. O padrão étrue
.
- Os valores possíveis são
BACKGROUND_REPORTING_ENABLED
: Ative ou desative o relatório de eventos em segundo plano quando o aplicativo estiver em segundo plano.- Os valores possíveis são
true
efalse
. O padrão éfalse
.
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"- Os valores possíveis são
(Somente Ionic Cordova) Configure sua framework Ionic
Se você estiver usando uma framework Ionic, adicione isto ao diretório do projeto Cordova:
$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. | |
Acompanhe um método como uma interação. | |
Erros de registro | |
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. | |
Desligue o agente. | |
Habilitar/desabilitar configurações padrão de monitoramento de Mobile. | |
Execute um relatório de falha de teste. |
Atualizar o agente
Para atualizar a versão do seu agente Cordova, execute este comando simples:
cordova plugin update