• ログイン

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

New Relic for Cordovaの紹介

iOS および Android 用の公式 New Relic Cordova プラグインにより、開発者はモバイルエージェントを Cordova アプリケーションに簡単に組み込むことができます。 。JavaScript で書かれたこのプラグインは、New Relic のネイティブエージェントを自動的に組み込み、 モバイルモニタリングとパフォーマンスの可視性を提供します。.

機能

New Relic Cordova プラグインは

  • Cordova アプリケーションに追加されたプラットフォームを検出し、適切な New Relic モバイルエージェントの最新リリースを適用します (Android または iOS)。
  • iOSのシンボリックファイルをアップロードするためのポストビルドスクリプトを追加しました。
  • Android Proguardのマッピングファイルをアップロードします。
  • Cordovaで作られたモバイルアプリケーションを自動的にインストルメントします。

詳細については、Github の New Relic Cordova Plugin を参照してください。

互換性と要件 [#prerequisites]

New Relic Cordova プラグインには、以下のものが必要です。

ネットワークリクエストは、iOSデバイスではウェブビューとネイティブフレームワークでのみ記録されます。Androidでは、ネイティブのネットワークコールのみが記録されます。

Cordovaは通常、デフォルトで例外を処理します。私たちのCordovaプラグインは、Cordovaが処理できない例外(クラッシュ)を記録します。

Cordovaプラグインのインストール

インストールする前に、Cordova プロジェクトに Android または iOS プラットフォームを追加するための prerequisites を満たしていることを確認してください。その後、以下の手順でCordovaプラグインをインストールします。

  1. まだアカウントをお持ちでない方は、 サインアップ (無料)。

  2. 該当する場合は、iOSとAndroidで別々のアプリケーショントークンを使用してください。

  3. New Relic のアプリケーションページから、構築する Cordova プラットフォームのアプリケーショントークンをコピーします。

  4. Cordovaプロジェクトディレクトリに移動し、Cordovaコマンドラインツールを使用してプラグインをプロジェクトに追加します。 --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}"
  5. アプリをデプロイします。

  6. モバイルモニタリングUI からパフォーマンスデータを見ることができます

プラグインの更新

以下のコマンドで、New Relic Cordova プラグインを最新のリリースバージョンに簡単にアップデートできます。

cordova plugin update

Cordovaのデフォルト属性

Cordovaプラグインは以下の属性を収集します。

属性

説明

appId

監視対象のアプリの一意の識別子。例えば、 35091.

appBuild

クラッシュしたバイナリのテクニカルビルド番号を示す。開発者はこの属性を使って、どのビルドのアプリがクラッシュしたかを正確に確認することができます。

appName

監視対象のアプリの名前。例えば、 New Relic iOS

appVersion

監視対象のアプリのバージョン番号です。例えば、 2.2.9.

appVersionId

監視対象アプリのNew Relic固有のバージョン番号。

architecture

armv7、arm64などのデバイスのプロセッサアーキテクチャ。

asn

データが報告されたときにデバイスが関連付けられていた自律システム番号。

asnOwner

ASNのテレコムオーナーです。

carrier

アプリがデータを転送したモバイルネットワーク。 WiFi, Verizon, Sprint, など。

category

収集するデータの種類。標準的なカテゴリは、 Session, Interaction, Crash です。API経由でカスタムイベントを追加した場合は、 Custom のカテゴリーを使用します。

city

ポートランドシアトル のように、監視対象のアプリが設置されている都市です。

countryCode

監視対象のアプリが置かれている国です。たとえば、 GB は United Kingdom です。国コードの一覧については、 ISO 3166-1 alpha-2 を参照してください。

crashException

クラッシュに関連する例外(存在する場合)。たとえば、 java.lang.NullPointerException

crashMessage

クラッシュに関連するメッセージがある場合は、そのメッセージを表示します。

device

iPad AirGalaxy S5 のようなデバイスの名前です。

deviceGroup

iPod TouchiPad のように、デバイスのカテゴリーです。

deviceManufacturer

デバイスのメーカー。例えば、 MotorolaHTC など。

deviceModel

デバイスのモデル番号。例えば、 XT1039SM-G900F

interactionDuration

デバイス上でインタラクションがレンダリングされるまでの合計時間(秒)です。この値には、レンダリング時間の他に、インタラクションに関連するすべての外部呼び出しが含まれます。

install

TRUEの場合、このセッションはアプリの新規インストールによるものです。

lastInteraction

クラッシュイベントが発生する前の最後のインタラクション(存在する場合)。例えば、 App Launch.

memUsageMb

アプリケーションが使用しているメモリの総量(単位:MB)。60秒ごとに更新されます。

name

イベントに関連するインタラクションの名前です。例えば、 ApplicationsListFragmentNavigationDrawerFragment などです。

newRelicVersion

アプリケーション上で動作しているエージェントのバージョン番号です。例えば、 4.232.0.

osMajorVersion

アプリのホストOSの簡略化されたバージョン番号。例えば、 iOS 7 と比較して、 iOS 7.0.4 のようになります。

osName

アプリのホストOSの名前。例えば、 iOSAndroid などです。

osVersion

アプリのホストOSの正確なバージョン番号。例えば、 iOS 7.0.4iOS 7 と比較した場合。

regionCode

監視対象のアプリが置かれている国の中の特定の地域。米国では、地域は州です。

sessionDuration

ユーザーがアプリケーションを使用した時間の長さ(秒単位)。セッションがクラッシュした場合、 sessionDurationはキャプチャされません(他のイベントと属性は引き続き記録されます)。

10分を超えるセッションの場合、インタラクションおよびカスタムイベントカテゴリのイベントは、セッションの進行中にNew Relicに送信されるため、 sessionDuration属性はありません。セッションの終わり近くに記録されたイベントには、セッションイベントカテゴリと同様に期間が含まれます。

sessionId

1つのユーザーセッションを表す一意の識別子。

timeSinceLastInteraction

クラッシュイベントの前のインタラクションからの時間(秒)です。

timeSinceLoad

モバイルセッションの開始からイベントが発生するまでの時間(秒)です。イベントには、「セッション」、「インタラクション」、「クラッシュ」のいずれかのビルトインイベントカテゴリのほか、エージェントAPI経由で送信されたカスタムイベントも含まれます。

upgradeFrom

アップグレードが検出された場合、ユーザーがアップグレードした古いバージョンのバージョン番号を指定します。たとえば、 2.2.8 。現在のバージョン番号には、 version属性を使用します。

uuid

B8B0BC30-0235-11E4-9191-0800200C9A66 のような、特定のデバイスにアプリがインストールされていることを示す固有の識別子です。

Copyright © 2022 New Relic株式会社。

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