GradleまたはAndroid Studioを使用する場合、次の手順に従ってNew Relicのモバイルモニタリングをインストールします。モバイルモニタリング用のAndroidエージェントSDKを既にインストールしている場合は、GradleとAndroid Studioとともに最新バージョンにアップグレードする前の手順に従ってください。
ヒント
モバイルモニタリング、およびその他のオブザーバビリティプラットフォームを使用するには、New Relicファミリーに参加してください。サインアップして、わずか数秒で無料アカウントを作成できます。次に、毎月最大で100GBのデータを無料で取り込みます。期間無制限です。
Androidアプリケーションをインストールする
モバイルモニタリングのインストレーション プロセスの一環として、New Relicはアプリケーショントークンを自動的に生成します。これはNew Relic でモニタリングする各モバイルアプリケーションを認証するための40文字の16進数の文字列です。
- one.newrelic.com > Mobileに移動します。
- 該当する場合:Mobile appインデックスから、Add a new appを選択します。
- Get startedページから、モバイル監視用のプラットフォームとしてAndroidを選択します。
- ご使用のモバイルアプリに意味のある名前を付けて、Continueを選択します。
GradleとAndroid Studioを使用したモバイルモニタリングの設定手順を続けます。
または
- 新しいモバイルアプリケーションの設定プロセスを後で完了するには: one.newrelic.com > Mobileに移動し、モバイルアプリ名の隣にあるSee instructionsを選択します。
- すでにインストール済みのAndroidをアップグレードするには: one.newrelic.com > Mobileに移動し、アプリを選択して、Settings > Installationに移動します。
GradleおよびAndroid Studioを使用して設定
GradleとAndroid Studioを使用したAndroidアプリの設定手順は、New RelicのGet startedページにも掲載されています。
Gradle & Android StudioタブにあるNew Relicのモバイルモニタリングコードを
build.gradle
ファイルにマージします。ProGuardまたはDexGuard: プロジェクトのルートディレクトリ(
projectname/app
)に、以下の行と共にnewrelic.properties
ファイルを追加します:com.newrelic.application_token=GENERATED_TOKEN
New RelicでProGuardまたはDexGuardを使用するために必要な追加の設定手順に従います。
アプリケーションのアクセス権限を設定:
AndroidManifest.xml
ファイルに以下の行を追加することで、AndroidアプリケーションがINTERNET
およびACCESS_NETWORK_STATE
パーミッションをリクエストすることを確実にします:<uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />New Relicのモバイルモニタリングエージェントを起動するには:Default Activity(Manifestに定義されているもの)に
NewRelic
クラスをインポートします:import com.newrelic.agent.android.NewRelic;重要
想定外の動作や不安定な動作が生じる可能性があるため、他のクラスでのモバイルモニタリングエージェントの起動はサポートされていません。
モバイルモニタリングを初期化するには:
onCreate()
メソッドに、次のコールを追加します:NewRelic.withApplicationToken("GENERATED_TOKEN").start(this.getApplication());
オプション:ロギングレベルを変更します。
アプリケーションを構築して実行するには、プロジェクトをクリーンにし、エミュレーターまたはデバイスでアプリケーションを実行しトラフィックを発生させます。
数分待ち、New Relic MobileのOverviewページからAndroidアプリケーションのデータを表示します。one.newrelic.com > Mobileに移動して、アプリを選択します。
Androidのインストレーションに問題がある場合や、AndroidアプリケーションのNew Relic Mobile UIにデータが表示されない場合は、トラブルシューティング手順に従ってください。
Androidインストレーションの更新
Androidエージェントを最新に保つため、New RelicのAndroidエージェントSDKをアップグレードする手順に従ってください。モバイルアプリケーションの最新のAndroidバージョンをインストールするには、one.newrelic.com > Mobileに移動し、アプリを選択して、Settings > Installationに移動します。
Android 4.x: Multidexサポート
Android 5.0(APIレベル 21)より前のAndroidバージョン用のNew Relicモバイルモニタリングでは、アプリコードの実行にDalvikランタイムを使用します。Dalvikはデフォルトで、アプリケーションをAPK当たり単一のclasses.dex
バイトコードファイルに制限します。この制限を回避するには、Multidexサポートを有効化 しなければなりません。こうすることで、アプリケーションのプライマリDEXファイルとなり追加のDEXファイルとそれらファイル内のコードへのアクセスを管理するMultidexサポートライブラリを使えるようになります。
Multidexアプリケーション用に各DEXファイルを構築する際、ビルドツールはアプリケーションが正常に起動できるよう、プライマリDEXファイルにどのクラスが必要か決めるため複雑な意思決定を行います。スタートアップ中に必要となるクラスがプライマリDEXファイルに提供されてない場合、アプリケーションはエラーjava.lang.NoClassDefFoundError
を伴ってクラッシュします。
java.lang.NoClassDefFoundError
エラーが表示された場合、プライマリDEXファイルに対し、必要に応じてこれらの追加クラスを手動で指定する必要があります:
プロジェクトの
/app
フォルダ内にproguard.multidex.config
ファイルを作成します。パッケージ名を反映するように、mypackage
を更新します。#################### # keep class names # #################### #Keep New Relic in the main dex -keep class com.newrelic.** { *; } -keep class com.mypackage.activities.** { *; }
アプリケーションレベルの
build.gradle
ファイルに、次のコードをマージします:android {defaultConfig{…multiDexKeepProguard file("proguard.multidex.config")}}
詳しくは、プライマリDEXファイルに必要なクラス宣言について、Android Developersドキュメントを参照してください。
New Relic Gradleプラグインの設定
Gradle構築の間のモバイルモニタリングエージェントプラグインの動作の設定方法の詳細は、New Relic Gradleプラグイン拡張ガイドをご覧ください。
その他のヘルプ
さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:
- Explorers Hubを参照して、コミュニティから支援を受け、ディスカッションに参加してください。
- 当社のサイトで回答を見つけ、サポートポータルの使用方法について学びます。
- Linux、Windows、およびmacOSのトラブルシューティングツールであるNew Relic Diagnosticsを実行します。
- New Relicのデータセキュリティとライセンスドキュメントを見直してください。