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 プラグインには、以下のものが必要です。
- Cordova 7.x以上 ノード6.0以上* CordovaのCLIツール
- あなたのプロジェクトのための Android または iOS Cordova プラットフォーム
- モバイル アプリケーション・トークン
ネットワークリクエストは、iOSデバイスではウェブビューとネイティブフレームワークでのみ記録されます。Androidでは、ネイティブのネットワークコールのみが記録されます。
Cordovaは通常、デフォルトで例外を処理します。私たちのCordovaプラグインは、Cordovaが処理できない例外(クラッシュ)を記録します。
Cordovaプラグインのインストール
インストールする前に、Cordova プロジェクトに Android または iOS プラットフォームを追加するための prerequisites を満たしていることを確認してください。その後、以下の手順でCordovaプラグインをインストールします。
まだアカウントをお持ちでない方は、 サインアップ (無料)。
該当する場合は、iOSとAndroidで別々のアプリケーショントークンを使用してください。
New Relic のアプリケーションページから、構築する Cordova プラットフォームのアプリケーショントークンをコピーします。
Cordova プロジェクトのディレクトリに移動し、Cordova コマンドラインツールでプラグインをプロジェクトに追加してください。
--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}"アプリをデプロイします。
モバイルモニタリングUI からパフォーマンスデータを見ることができます 。
プラグインの更新
以下のコマンドで、New Relic Cordova プラグインを最新のリリースバージョンに簡単にアップデートできます。
cordova plugin update
Cordovaのデフォルト属性
Cordovaプラグインは以下の属性を収集します。
属性 | 説明 |
---|---|
| 監視対象のアプリの一意の識別子。例えば、 35091. |
| クラッシュしたバイナリのテクニカルビルド番号を示す。開発者はこの属性を使って、どのビルドのアプリがクラッシュしたかを正確に確認することができます。 |
| 監視対象のアプリの名前。例えば、 New Relic iOS 。 |
| 監視対象のアプリのバージョン番号です。例えば、 2.2.9. |
| 監視対象アプリのNew Relic固有のバージョン番号。 |
| armv7、arm64などのデバイスのプロセッサアーキテクチャ。 |
| データが報告されたときにデバイスが関連付けられていた自律システム番号。 |
| ASNのテレコムオーナーです。 |
| アプリがデータを転送したモバイルネットワーク。 WiFi, Verizon, Sprint, など。 |
| 収集するデータの種類。標準的なカテゴリは、 Session, Interaction, Crash です。API経由でカスタムイベントを追加した場合は、 Custom のカテゴリーを使用します。 |
| ポートランド や シアトル のように、監視対象のアプリが設置されている都市です。 |
| 監視対象のアプリが置かれている国です。たとえば、 GB は United Kingdom です。国コードの一覧については、 ISO 3166-1 alpha-2 を参照してください。 |
| クラッシュに関連する例外がある場合は、それを示します。例えば、 |
| クラッシュに関連するメッセージがある場合は、そのメッセージを表示します。 |
| iPad Air や Galaxy S5 のようなデバイスの名前です。 |
| iPod Touch や iPad のように、デバイスのカテゴリーです。 |
| デバイスのメーカー。例えば、 Motorola や HTC など。 |
| デバイスのモデル番号。例えば、 XT1039 や SM-G900F 。 |
| デバイス上でインタラクションがレンダリングされるまでの合計時間(秒)です。この値には、レンダリング時間の他に、インタラクションに関連するすべての外部呼び出しが含まれます。 |
|
|
| クラッシュイベントが発生する前の最後のインタラクション(存在する場合)。例えば、 App Launch. |
| アプリケーションが使用しているメモリの総量(単位:MB)。60秒ごとに更新されます。 |
| イベントに関連するインタラクションの名前です。例えば、 ApplicationsListFragment や NavigationDrawerFragment などです。 |
| アプリケーション上で動作しているエージェントのバージョン番号です。例えば、 4.232.0. |
| アプリのホストOSの簡略化されたバージョン番号。例えば、 iOS 7 と比較して、 iOS 7.0.4 のようになります。 |
| アプリのホストOSの名前。例えば、 iOS や Android などです。 |
| アプリのホストOSの正確なバージョン番号。例えば、 iOS 7.0.4 、 iOS 7 と比較した場合。 |
| 監視対象のアプリが置かれている国の中の特定の地域。米国では、地域は州です。 |
| ユーザーがアプリケーションを使用した時間の長さを秒単位で表します。セッションがクラッシュした場合、 10分以上のセッションでは、InteractionおよびCustom イベントカテゴリのイベント は、セッションが進行中にInsightsに送信されるため、 |
| 1つのユーザーセッションを表す一意の識別子。 |
| クラッシュイベントの前のインタラクションからの時間(秒)です。 |
| モバイルセッションの開始からイベントが発生するまでの時間(秒)です。イベントには、「セッション」、「インタラクション」、「クラッシュ」のいずれかのビルトインイベントカテゴリのほか、エージェントAPI経由で送信されたカスタムイベントも含まれます。 |
| アップグレードが検出された場合、ユーザーがアップグレードした旧バージョンのバージョン番号を指定します。例えば、 |
| B8B0BC30-0235-11E4-9191-0800200C9A66 のような、特定のデバイスにアプリがインストールされていることを示す固有の識別子です。 |