Monitoring 行動式應用程式

需求

• iOS 11 或更新版本
• swift 5.1 或更新版本

Swift 套件管理程式

1. 開啟 Xcode。
2. 選取檔案-> Swift 套件-> 新增套件相依關係-> 您的 Xcode 專案。
3. 輸入 https://github.com/instana/iOSAgent 儲存庫。

CocoaPods

1. 在 Podfile 規格內，新增下列指令:

   pod 'InstanaAgent'
   

2. 若要下載相依關係，請執行 pod install。

設定

如需設定程序的相關資訊，請參閱 iOS 代理程式 API。

需求

• Android 4.1+ (API 層次 16 +)
• Java 8 +
• Gradle 7.3.3+
• AndroidX
• targetSdk 33 +

附註: 若要在專案中使用低於 7.3.3 的 Gradle 版本，請使用低於 6.0.0的 android-agent 版本。

Instana Android 外掛程式

在專案層次 build.gradle 檔案中，新增下列程式碼:

buildscript {
   repositories {
        google()
        mavenCentral()
    }
   dependencies {
      classpath "com.instana:android-agent-plugin:6.0.0"
    }
}

在您套用 com.android.application 外掛程式之後的模組 (app-level) Gradle 檔案 (通常是 app/build.gradle) 中，新增下列程式碼:

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

Instana Android SDK

在專案層次 build.gradle 檔案中，新增下列程式碼:

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

在模組 (app-level) Gradle 檔案 (通常是 app/build.gradle) 中，新增下列程式碼:

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

Java 1.8 相容性

附註: 如果 minSdkVersion 低於 24 ，請完成此步驟。

在模組 (app-level) Gradle 檔案 (通常是 app/build.gradle) 中，新增下列程式碼:

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

要求 READ_PHONE_STATE 許可權 (選用)

當使用者透過行動網路存取網際網路時， Instana 代理程式可以報告行動網路的特定類型。

若要啟用行動網路類型的報告，您的應用程式需要要求 READ_PHONE_STATE 許可權。 如需要求許可權的相關資訊，請參閱官方 Android 文件中的 Request App Permissions 小節。

如果您的應用程式未要求許可權，或使用者拒絕許可權， Instana 代理程式不會報告行動網路類型。

基本起始設定

在延伸 Application的類別中，將 YOUR_REPORTING_URL 和 YOUR_APP_KEY 取代為您在「Instana 儀表板」中找到的配置值:

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 Agent。

新增相依關係

在專案根目錄中執行下列指令:

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

基本起始設定

在類別 App.js 檔中，將 YOUR_INSTANA_APP_KEY 和 YOUR_INSTANA_REPORTING_URL 取代為您在「Instana 儀表板」中找到的配置值:

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

建議

若要防止 Instana 代理程式與 Metro bundler 進行追蹤通訊，請將 http://localhost:8081 新增至忽略的 URL 清單:

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

iOS

您的專案應該至少包含一個 Swift 檔案 (它可以是空的)。

如果您沒有任何 Swift 檔案，請在 <YourReactNativeProject>/ios 中開啟 Xcode 專案，然後新增空的 Swift 檔案。 讓 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 {
       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'
   

dependencies {
    implementation "com.squareup.okhttp3:okhttp:4.3.1"
    implementation "com.squareup.okhttp3:okhttp-urlconnection:4.3.1"
}

進階用法

如需起始設定選項、視圖追蹤及其他選項的完整清單，請參閱 React Native 代理程式 API。

需求

• Flutter 1.20.0 版或更新版本
• 2.12.0 與 3.0.0 之間的 Dart 版本

將套件新增至應用程式

您可以從 pub.dev取得 Instana 代理程式 Flutter 套件。

若要將套件新增至應用程式，請完成下列步驟:

1. 開啟位於應用程式資料夾內的 pubspec.yaml 檔案，然後在 dependencies下新增 instana_agent: 。

2. 使用下列其中一種方法來安裝套件:

   • 從主控台: 執行 flutter pub get
   • 從 Android Studio 或 IntelliJ: 在 pubspec.yaml 的動作功能區中按一下 套件取得
   • 從 VS 程式碼: 在pubspec.yaml 的動作功能區中按一下 取得套件

起始設定

在 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');

追蹤 HTTP 要求

在起始設定 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);
   }

   [...]
}