Androidエージェントをインストールするには、ガイド付きインストールを使用する必要があります。Androidエージェントを設定するには、監視する各モバイルアプリを認証するアプリケーショントークンが必要です。このアプリトークンは、ガイド付きインストールを実行する場合にのみ使用できます。
ガイド付きインストールによるAndroidエージェントのインストール
one.newrelic.com > Add data > Mobile > Android
に移動します。
ガイド付きインストール手順に従って、Androidエージェントを設定します
数分待ってから、
one.newrelic.com > All capabilities > Mobile > (select your app)
に移動してデータを表示します。
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 > (select an app)に移動します。
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 scriptplugins {id("newrelic") version "${<AGENT_VERSION>}"}}New Relicプラグインを宣言します
plugins {// for binary Gradle plugins that need to be resolvedid("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のインストレーションで問題が発生しましたか?トラブルシューティングの手順に従ってください