Monitor seu aplicativo móvel Cordova

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="YOUR_IOS_APP_TOKEN" --variable ANDROID_APP_TOKEN="YOUR_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.

• 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 e false. O padrão é true.

• 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 e false. 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:

  bash

  Copiar

  $
  cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="YOUR_IOS_APP_TOKEN" --variable ANDROID_APP_TOKEN="YOUR_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:

$
ionic cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="YOUR_IOS_APP_TOKEN" --variable ANDROID_APP_TOKEN="YOUR_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).