New Relic Cordova エージェントは、 Apache Cordova フレームワーク上に構築されたネイティブ アプリケーション (iOS、Android) を監視します。JavaScript で記述された Cordova エージェントには、ネイティブ アプリ用のすべての New Relic モバイル モニタリング機能も含まれています。
特徴
インストールが完了すると、Cordova エージェントは次のことができます。
- Cordova アプリケーションに追加されたプラットフォームを検出し、関連する New Relic AndroidまたはiOSエージェントの最新リリースを適用します
- iOS シンボリケーション ファイルをアップロードするためのビルド後のスクリプトを追加する
- Android Proguard マッピング ファイルをアップロードする
- Cordova を介して構築されたモバイル アプリケーションを自動的に計測する
- JavaScript エラーをキャプチャする
- 分散トレースを生成する
- Promise の拒否を追跡する (JavaScript で未処理の例外)
- コンソール ログで警告とエラーを追跡する
- インタラクションとそのシーケンスをキャプチャ
- ユーザー セッションの追跡
Cordova モニタリングを開始する
ステップ 1: 要件を確認する
インストールする前に、Android または iOS プラットフォームを Cordova プロジェクトに追加するための次の前提条件を満たしていることを確認してください。
- Cordova 7.x以上
- Node.js 6.0 以降
- CordovaのCLIツール
- あなたのプロジェクトのための Android または iOS Cordova プラットフォーム
- モバイル アプリケーション・トークン
ステップ 2: アプリケーション トークンを取得する
New Relic を初めて使用する場合は、アカウントを作成してください - 無料です!
最初に、後でステップ 3で使用するアプリケーション トークンを取得する必要があります。
- one.newrelic.com > Browser & Mobile > (choose Android or iOS)に移動し、UI で計測手順を完了します。
- UI の手順 4から、アプリケーション トークンをコピーします。これは、Cordova エージェントをインストールするときに必要になります。
ステップ 3: Cordova エージェントをインストールする
Cordova プロジェクト ディレクトリで、Cordova コマンド ライン ツールを使用して Cordova エージェントをプロジェクトに追加し、
--variable
引数を使用してステップ 2のアプリケーション トークンを貼り付けます。# 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}"重要
アプリが iOS と Android の両方でビルドされている場合は、iOS と Android のアプリケーション トークンを個別に取得する必要があります。
(オプション)イオン フレームワークを使用している場合は、これを 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次に、アプリをデプロイします。
そして、あなたは完了です!New Relic でデータを表示します (アプリのデプロイ後、数分かかる場合があります)。
ステップ 4: New Relic でデータを表示する
one.newrelic.com > モバイル > (Cordova アプリを選択)に移動して、New Relic モバイル監視 UI でアプリのパフォーマンス データを表示します。
one.newrelic.com > Mobile > (Cordova アプリを選択) : Cordova エージェントはこのデータを収集し、New Relic に送信します。New Relic では、UI で表示および分析できます。
(オプション) ステップ 5: JavaScript エラーを追跡する
プロジェクトにNewRelic.recordError(error);
を追加することで、JavaScript エラーのカスタム イベントを作成し、それらを New Relic に報告するように Cordova エージェントを構成できます。
NewRelic.recordError(error);
その後、UI で、これらの JavaScript エラー イベントをカスタム ダッシュボードで追跡できます。カスタム ダッシュボードを作成するには:
one.newrelic.comにアクセスします。
[クエリ ビルダー]をクリックします。
次のクエリを実行します。
SELECT * FROM `JS Errors`ダッシュボードに追加をクリックします。
one.newrelic.com > Query builder : Query builder を使用して、Cordova アプリから JavaScript エラーを追跡するためのカスタム ダッシュボードを作成します。
ダッシュボードの使用を開始する際にサポートが必要な場合は、ダッシュボードの 概要 を参照してください。
次のステップ
API 呼び出しを使用してカスタム データを追跡する: Cordova エージェントは、iOS および Android SDK エージェントと同じ API 呼び出しを利用します。iOS SDKまたはAndroid SDKを参照してください。
Cordova エージェントのバージョンを更新する: Cordova エージェントを最新バージョンに更新する必要がある場合は、次の簡単なコマンドを実行します。
cordova plugin update