モバイル・アプリケーションのモニタリング

iOS エージェントをインストールする前に、以下の前提条件が満たされていることを確認してください。

• iOS バージョン12以降
• Swift 5.4 またはそれ以降

Swift パッケージマネージャーを追加するには、以下の手順を実行してください：

1. Xcode を開きます。
2. Xcode プロジェクトを開きます。
3. メニュー 「ファイル」 > 「パッケージ依存関係の追加 ...」を選択します。
4. 表示されるウィンドウで、「 検索またはパッケージ URL を入力」 フィールドに https://github.com/instana/iOSAgent リポジトリを入力します。 次に、検索結果から iosagent を選択し、 をクリックします Add Package 。

CocoaPods, を追加するには、以下の手順を実行してください：

1. Podfile 仕様内に、以下のコマンドを追加します。

   pod 'InstanaAgent', '~> 1.8.9'
    

2. 依存関係をダウンロードし、 pod installを実行します。

このコマンドで、 1.8.9 を、 https://cocoapods.org/pods/InstanaAgentにリストされている最新の iOS エージェント・バージョンに置き換えます。

セットアップ手順の詳細については、 iOS エージェントのドキュメント（ API ）を参照してください。

「 Instana 」Androidプラグインを追加するには、以下の手順に従ってください：

1. プロジェクト・レベルの build.gradle ファイルに、以下のコードを追加します。
   注： 以下のスニペットでは、バージョン 6.3.0 を例として使用しています。 Instana エージェントの最新バージョンを確認するには、 https://mvnrepository.com/artifact/com.instana/android-agent-runtime を参照してください。

   buildscript {
      ext {
           instanaAgentVersion = "6.3.0"
       }
      repositories {
           google()
           mavenCentral()
       }
      dependencies {
         classpath "com.instana:android-agent-plugin:$instanaAgentVersion"
       }
   }
    

2. com.android.application プラグインを適用した後、モジュール (アプリケーション・レベル) の Gradle ファイル (通常は app/build.gradle) に以下のコードを追加します。

apply plugin: 'com.android.application'
apply plugin: 'com.instana.android-agent-plugin'
 

Instana （ Android SDK ）を追加するには、以下の手順を実行してください：

1. プロジェクト・レベルの build.gradle ファイルに、以下のコードを追加します。

   allprojects {
       repositories {
           google()
           mavenCentral()
       }
   }
    

2. モジュール (アプリケーション・レベル) の Gradle ファイル (通常は app/build.gradle) で、以下のコードを追加します。

   dependencies {
       implementation 'com.instana:android-agent-runtime:$instanaAgentVersion'
   }
    

3. minSdkVersion が 24 より前の場合、モジュール (アプリケーション・レベル) の Gradle ファイル (通常は app/build.gradle) に以下のコードを追加します。

   android {
       compileOptions {
           sourceCompatibility JavaVersion.VERSION_1_8
           targetCompatibility JavaVersion.VERSION_1_8
       }
   }
    

4. （任意）：権限を READ_PHONE_STATE リクエストします。 ユーザーが携帯電話ネットワーク経由でインターネットにアクセスすると、 Instana エージェントは、その携帯電話ネットワークの具体的な種類を報告することができます。

携帯電話ネットワーク・タイプのレポートを有効にするには、アプリが READ_PHONE_STATE 権限を要求する必要があります。 権限の申請に関する詳細については、. Request App Permissions Android公式ドキュメントの該当セクションを参照してください。

アプリが権限を要求しない場合、またはユーザーが権限を拒否した場合、 Instana エージェントはモバイルネットワークの種類を報告しません。 ``を拡張するクラス内で、 ApplicationInstana ダッシュボードで確認した設定値で `` YOUR_APP_KEY と `` YOUR_REPORTING_URL を置き換えてください：

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Instana.setup(
            this,
            InstanaConfig(
                key = "YOUR_APP_KEY",
                reportingURL = "YOUR_REPORTING_URL"
            )
        )
    }
}
 

このステップでは、基本的な初期化が完了します。 初期化オプション、トラッキングの表示、その他のオプションの完全な一覧については、 Androidエージェントのドキュメント（ API ）を参照してください。

Instana React Native エージェントを設定するには、以下の手順を実行してください：

1. 依存関係を追加し、プロジェクトのルートで以下のコマンドを実行します。

   npm install @instana/react-native-agent --save
    

2. クラス App.js ファイル内で、 Instana ダッシュボードに表示されている設定値に と YOUR_INSTANA_REPORTING_URL を YOUR_INSTANA_APP_KEY 置き換えてください：

export default class App extends Component {
  componentDidMount() {
    Instana.setup(YOUR_INSTANA_APP_KEY, YOUR_INSTANA_REPORTING_URL, null);
  }
}
 

このステップでは、基本的な初期化が完了します。 初期化オプション、追跡表示、その他のオプションの完全な一覧については、 React Native エージェント（ API ）を参照してください。

• Instana エージェントとMetroバンドラー間の通信を追跡しないようにするには、無視するURLリストに http://localhost:8081 以下を追加してください：

Instana.setIgnoreURLsByRegex(['http://localhost:8081.*']);
 

• iOS アプリをサポートするには、プロジェクトに少なくとも1つの Swift ファイルが含まれている必要があります（内容は空でも構いません）。 Swift ファイルがない場合は、Xcodeプロジェクトを開き、空の <YourReactNativeProject>/iosSwift ファイルを追加してください。 Xcode により、ブリッジング・ヘッダーが作成されます。

• Androidアプリをサポートするには、お使いの React Native のバージョンに適した Instana Androidプラグインのバージョンを使用してください：

  • React Native （ 0.63.3 ）またはそれ以前のバージョンでは、 Instana Androidプラグイン（ 1.5.3 ）をご利用ください
  • React Native （ 0.63.4 以降）の場合は、 Instana Androidプラグイン（ 5.2.2 以降）を使用してください

自動 HTTP モニタリングを有効にするには、以下の手順を実行します。

1. /android/build.gradle ファイルに、以下のコードを追加します。

   buildscript {
       ext {
           INSTANA_ANDROID_PLUGIN_VERSION = "6.2.5"
       }
       dependencies {
           classpath "com.instana:android-agent-plugin:$INSTANA_ANDROID_PLUGIN_VERSION"
       }
   }
    

2. /android/app/build.gradle ファイルに、以下のコードを追加します。

   apply plugin: 'com.android.application'
   apply plugin: 'com.instana.android-agent-plugin'
    

Instana エージェントの Flutter パッケージは、 pub.dev から入手できます。

パッケージをアプリに追加するには、以下の手順を実行します。

1. アプリケーション・フォルダー内にある pubspec.yaml ファイルを開き、 dependenciesに instana_agent: を追加します。

2. 以下のいずれかの方法でパッケージをインストールしてください：

   • コンソールから: flutter pub get を実行します。
   • Android Studio または IntelliJ: から、「パッケージ」 をクリックし、アクションリボンの pubspec.yaml
   • VS Code から:pubspec.yaml のアクション・リボンで 「パッケージの取得 (Get Packages)」 をクリックします。

パッケージを dart ファイルにインポートします。

import 'package:instana_agent/instana_agent.dart';
 

必要に応じて、アプリを停止して再始動します。

できるだけ早く Instana を設定してください。 例えば、 initState()では、以下のコードを追加します。

@override
  void initState() {
    super.initState();
    InstanaAgent.setup(key: 'YOUR-INSTANA-KEY', reportingUrl: 'YOUR-REPORTING_URL');
  }
 

iOS, 向けのアプリを構築したい場合は、プラットフォームバージョンを設定 ${appFolder}/ios/Podspec し、 11.0その最小値を に設定してください。

Instana エージェントの初期化が完了したら、以下を追加してください InstanaAgent.setView('Home');：

import 'package:instana_agent/instana_agent.dart';

[...]

InstanaAgent.setView('Home');
 

Instana エージェントの初期化が完了したら、 HTTP へのリクエストのキャプチャを開始します：

import 'package:instana_agent/instana_agent.dart';

[...]

InstanaAgent.startCapture(url: 'https://example.com/success', method: 'GET').then((marker) => marker
    ..responseStatusCode = 200
    ..responseSizeBody = 1000
    ..responseSizeBodyDecoded = 2400
    ..finish());
 

以下の例に示すように、独自の InstrumentedHttpClient 拡張 http.BaseClient を作成します。

class _InstrumentedHttpClient extends BaseClient {
   _InstrumentedHttpClient(this._inner);

   final Client _inner;

   @override
   Future<StreamedResponse> send(BaseRequest request) async {
      final Marker marker = await InstanaAgent.startCapture(url: request.url.toString(), method: request.method);

      StreamedResponse response;
      try {
         response = await _inner.send(request);
         marker
            ..responseStatusCode = response.statusCode
            ..responseSizeBody = response.contentLength
            ..backendTracingID = BackendTracingIDParser.fromHeadersMap(response.headers);
      } finally {
         await marker.finish();
      }

      return response;
   }
}

class _MyAppState extends State<MyApp> {

   [...]

   Future<void> httpRequest() async {
      final _InstrumentedHttpClient httpClient = _InstrumentedHttpClient(Client());
      final Request request = Request("GET", Uri.parse("https://www.ibm.com/products/instana"));
      httpClient.send(request);
   }

   [...]
}
 

ユーザーがアプリケーションを起動すると、セッション開始イベントが発生します。 「 セッション開始 」タイルには、選択した期間内に Instana エージェントから送信されたセッション開始ビーコンの総数が表示されます。

「 ユニークユーザー 」タイルには、一意のユーザーIDを持つユーザーの総数が表示されます。 一意のユーザーIDが設定されていない場合は、代わりに ( userSessionIdentifier usi) が使用されます。 この場合、アプリケーションがアンインストールされるか、ストレージがクリアされるまで、その後のすべてのセッションで同じusiが使用されます。

usiフィールドは、Androidエージェントのバージョン 6.0.6 および iOS エージェントのバージョン 1.6.5 で導入されました。 古いバージョンのエージェントを使用している場合、「usi」フィールドは空欄となり、各セッションが新しいユーザーとしてカウントされます。

ユーザーがアプリケーション内で異なるビューを切り替える際に、ビュー遷移ビーコンが送信されます。 たとえば、ホーム画面から製品画面に切り替えた場合、「 ビュー遷移 」タイルには、選択した期間内のビュー遷移ビーコンの総数が表示されます。

「 クラッシュの影響を受けたセッション率 」タイルには、選択した期間内にユーザーがクラッシュを経験したセッションの割合が表示されます。 クラッシュの影響を受けたセッション数は、以下の式に示すように、クラッシュが発生したセッション数をユニークセッションの総数で割ることで算出できます：

Crash affected session rate = (Number of sessions with crashes / Total number of unique sessions) * 100
 

「 クラッシュ発生ユーザー率 」タイルには、選択した期間内にセッション中にクラッシュを経験したユニークユーザーの割合が表示されます。 セッションのクラッシュを経験したユーザー数をユニークユーザー総数で割ることで、クラッシュの影響を受けたユーザーの割合を算出できます。計算式は以下の通りです：

Crash affected user rate = (Number of users with crashes / Total number of unique users) * 100
 

「 クラッシュ 」チャートには、選択した期間におけるモバイルアプリのクラッシュ件数が表示されます。 横軸は時間範囲を表し、縦軸はその期間中の事故総数を示しています。 これにより、傾向やピーク時間帯、あるいは事故の発生頻度が高まる特定の時間帯を特定するのに役立ちます。 事故の詳細を確認するには、グラフ上の事故発生箇所をクリックしてください。

表示される事故件数は、選択した期間に応じて変わります。 たとえば、「直近」が選択されている場合、各バーは1秒あたりのクラッシュ数を表し、横軸は秒単位で表示されます。 「過去1時間」を選択すると、各バーは1分あたりのクラッシュ件数を表し、横軸には時間が分単位で表示されます。

「 主なクラッシュグループ 」カードには、デフォルトで最も頻繁に発生するクラッシュグループが表示されます。 クラッシュグループは、クラッシュのエラータイプとエラーメッセージで構成されます。 影響を受けたユーザー数に基づいて、最も頻度の高いクラッシュグループを確認するには、カード内のタブを 「発生回数」 から 「影響を受けたユーザー」 に切り替えてください。

「 トップビュー 」カードには、顧客におけるトップビュー遷移の発生状況が表示されます。

「 HTTP のリクエスト送信元トップ 」カードには、リクエストが送信されている上位のエンドポイントが表示されます。 「 エラー 」タブに切り替えると、エラーが発生した呼び出しの割合を確認できます。