Androidエージェントをインストールするには、ガイド付きインストールを使用する必要があります。Androidエージェントを設定するには、監視する各モバイルアプリを認証するアプリケーショントークンが必要です。このアプリトークンは、ガイド付きインストールを実行する場合にのみ使用できます。
ガイド付きインストールによるAndroidエージェントのインストール
- one.newrelic.com > Add data > Mobile > Androidに移動します
- ガイド付きインストール手順に従って、Androidエージェントを設定します
- 数分してから、one.newrelic.com > All capabilities > Mobile >（アプリを選択）に移動してデータを表示します
Androidエージェントの手動インストール
これらの手順は、ガイド付きインストールに記載されています。ドキュメントからビルドファイルを更新している場合でも、アプリをNew Relicに追加し、ガイド付きインストールから生成されたアプリトークンを取得する必要があることに注意してください。そうしない場合、Androidアプリに関するデータを取得できません。
[Gradle & Android Studio]タブにある
build.gradleファイルに次のコードを追加します。最上位のビルドスニペットと、インストゥルメントする各サブモジュールを更新する必要があります。アプリケーションのアクセス権限を設定します。
AndroidManifest.xmlファイルに以下の行を追加して、AndroidアプリがINTERNETおよびACCESS_NETWORK_STATE権限を要求するようにします。<uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />Androidエージェントを起動します。マニフェストにあるデフォルトのアクティビティで、
NewRelicクラスをインポートします。import com.newrelic.agent.android.NewRelic;想定外の動作や不安定な動作が生じる可能性があるため、他のクラスでのエージェントの起動はサポートされていません。
NewRelicクラスをインポートした後、ガイド付きインストールで生成されるアプリトークンを含む追加のスニペットをonCreate()メソッドに追加する必要があります。スニペットは次のようになります。NewRelic.withApplicationToken("<GENERATED_TOKEN>").start(this.getApplicationContext());縮小（ProGuardやDexguardなど）を使用している場合は、
newrelic.propertiesファイルをアプリレベルのディレクトリ (projectname/app）に追加する必要があります。この手順は、ProGuardおよびDexGuardユーザーにのみ適用されます。com.newrelic.application_token=<GENERATED_TOKEN>縮小の設定を完了するには、Androidアプリ用のProGuardまたはDexGuardの設定の手順に従います。
プロジェクトをクリーンにし、エミュレーターまたはデバイスでアプリケーションを実行しトラフィックを発生させます。エージェントがそのデータを取得するまで数分間待ちます。
Androidアプリのデータを表示します。one.newrelic.com > All capabilities > Mobile > (アプリを選択)に移動します。
Gradle Plugin Portal用のAndroidエージェントの設定
Androidエージェントはまだコミュニティプラグインとして利用できないため、エージェントがAndroidアプリをインストゥルメントできるように、MavenCentralを通じてクラスパスを指定する必要があります。Gradle Plugin Portalを通じてプラグインを検索するようにアプリを設定した場合は、settings.gradle(.kts)ファイルでこの手順を繰り返す必要があります。
- このスニペットを、
pluginManagement {}ブロックを介してsettings.gradle(.kts)ファイルに追加します
pluginManagement { repositories { mavenCentral() // adds repo for NewRelic artifacts } resolutionStrategy { eachPlugin { if (requested.id.id.startsWith("newrelic")) { useModule("com.newrelic.agent.android:agent-gradle-plugin:${AGENT_VERSION}") } } }
// optional: define as a community plugin here or in root level build file
// for core Gradle plugins or plugins already available to the build script plugins { id("newrelic") version "${<AGENT_VERSION>}" }}- New Relicプラグインを宣言します
plugins { // for binary Gradle plugins that need to be resolved id("newrelic") version "<AGENT_VERSION>" apply false}- プラグインをアプリレベルのビルドファイルに適用します
plugins { id("com.android.application") id("org.jetbrains.kotlin.android") id("newrelic")}上記のスニペットでは、<AGENT_VERSION>はエージェントのバージョン番号を表しています。設定には最新のエージェントを使用することを強くお勧めします。
Android 4.x：Multidexサポート
Android 5.0（APIレベル21）より前のAndroidバージョン用のモバイルモニタリングでは、アプリコードの実行にDalvikランタイムを使用します。デフォルトで、DalvikはアプリをAPK当たり単一のclasses.dexバイトコードファイルに制限します。この制限を回避するには、Multidexサポートを有効化する必要があります。その後、アプリのプライマリDEXファイルの一部となるMultidexサポートライブラリを使用できます。ライブラリは、追加のDEXファイルとそれに含まれるコードへのアクセスを管理します。
次のステップ
Androidエージェントが正常にインストールされました！次の手順にはいくつかのオプションがあります。
- New Relic Gradleプラグインを使用して、Gradleビルド中のエージェントの動作を設定します
- AndroidエージェントSDKをアップグレードして、Androidエージェントを最新の状態に保ちます
- Androidのインストレーションで問題が発生しましたか？トラブルシューティングの手順に従ってください