Mobile App 監視常見問題 (FAQ)

收集哪些應用程式資料?

除了 Instana 監視之外，行動代理程式還會自動收集下列應用程式特定資訊:

• 軟體組或應用程式 ID。
• 應用程式和建置版本。
• 現行應用程式語言。
• iOS/Android 版本、裝置機型、硬體、裝置及製造商。
• 裝置是越獄或根權限。
• 螢幕大小和解析度。
• 載波名稱及連線類型 (2G、 3G、 4G...)。

如何處理引標報告?

為了避免封鎖主要執行緒 (UI) ，會在背景執行緒中執行報告和佇列處理。

代理程式會在裝置的持續佇列中收集所有送入的引標，因此，如果發生非預期的事件 (例如當機或強制關閉) ，則引標不會遺失。 每一個信標需要大約 600 位元組的儲存體空間。

信標的產生速率限制為每 10 秒插槽中 20 個信標，每 5 分鐘插槽中 500 個信標。

信標產生停止後一秒會清除信標 (如果電池電量不足，則為 10 秒) ，以防止對應用程式網路效能的任何影響。

在清除之前，信標會以 100 個批次的方式結合。 然後會在單一 HTTP 要求中傳輸每一個批次 (如果裝置支援它，則會壓縮; 如果裝置支援它，則會使用相同的 HTTP 連線)。

當代理程式嘗試傳送裝置時，如果裝置離線，則代理程式會等待直到裝置回到線上以傳送引標。

佇列的預設上限為 1000 個引標。 如果在佇列已滿時產生更多信標，則會捨棄新的信標。

如果信標的傳輸收到來自伺服器的錯誤回應，代理程式將使用 10s 指數回復機制自動重試傳輸最多 3 次。 如果此自動重試失敗，信標仍不會被捨棄，當產生新的信標時，它們會留在佇列中與佇列的其餘部分一起重試。

網際網路或網路連線不正確的使用者會發生什麼情況?

從行動應用程式使用者到我們伺服器的資料傳輸要求可能無法運作。 在這些情況下，我們會嘗試在下次監視資料傳輸的過程中 (例如，在下列行動式應用程式啟動時) 遞送信標。

如果報告失敗會發生什麼情況?

由於網路問題，引標報告可能會失敗。 引標會保留在佇列中，供下次嘗試傳輸時使用。

離線時是否收集資料?

不過，請考量這裡說明的 100 個信標的限制。 如果佇列已滿且無法清除 (因為網路問題) ，則會捨棄所有即將出現的引標。

是否可以 Proxy HTTP 端點 (適用於 SaaS)?

建議 不要 嘗試對 HTTP 端點進行 Proxy 處理。 Instana 不 支援任何 Proxy 設定，也不支援因使用 Proxy 而可能產生的任何問題。 如果您仍然想要 (或必須) 執行此動作，您可以找到這些有用的指標:

• 設定適當的 Host HTTP 標頭。
• 尊重 eum.instana.io 與 eum-{region}.instana.io 伺服器之間的差異。
• 請確定我們的伺服器知道使用者 IP。 將 X-FORWARDED-FOR 標頭傳送至具有使用者 IP 的伺服器。 或者，將 X-REALER-IP HTTP 標頭 (是，故意不是 X-REAL-IP) 傳送至包含使用者 IP 的 Instana 伺服器。
• 傳遞 Instana 伺服器包含在回應內文中的所有 HTTP 標頭。
• 不要在 Proxy 中執行任何快取。

我可以在測試階段期間僅在 Android 應用程式除錯建置中啟用 Instana 監視嗎?

目前，您可以使用 Gradle 本身來執行此動作，以取得條件式外掛程式用法:

請參閱 Instana 儲存庫的 instana-example 目錄中的下列範例:

instana-example/app/build.gradle

instana-example/app/src/main/java/com/instana/mobileeum/DemoApp.kt

附註: Instana 提供兩個用於 Android 監視的程式庫: plugin 程式庫及 runtime 程式庫。 下列步驟基於建置類型，如下所示:-完全未載入 Instana plugin 程式庫。 -Instana runtime 程式庫仍包裝在您的應用程式軟體組中，不過它會保留 uninitialized。 如果您不想在應用程式中執行任何 Instana 程式碼，請遵循下列步驟:

1. 取得 gradle 中的現行 BuildType 。

   在 app/build.gradle中，請使用下列程式碼 Snippet 來查詢現行建置類型，並根據建置類型來定義 enableInstana 。

   def buildType = gradle.startParameter.taskRequests.stream()
       .flatMap { it.args.stream() }
       .map { it.contains("Release") ? "Release" : it.contains("Debug") ? "Debug" : null}
       .filter(Objects::nonNull)
       .findFirst()
   
   buildType.ifPresent { println "buildType is ${it}" }
   def enableInstana = buildType.orElse("").matches("Debug")
   

2. 有條件地套用 Instana plugin 。

   if (enableInstana) {
       println "instana> apply instana plugin"
       apply plugin: 'com.instana.android-agent-plugin'
   }
   

3. 有條件地在 gradle 中新增 Instana 金鑰。

   如果 Instana 已停用，則 INSTANA_REPORTING_URL 欄位中會有空字串。

   android {
       defaultConfig {
           def instanaProperties = new Properties()
           instanaProperties.load(new FileInputStream("$project.projectDir/instana.properties"))
           buildConfigField 'String', 'INSTANA_KEY', enableInstana ? "${instanaProperties["instana.key"]}" : '""'
           buildConfigField 'String', 'INSTANA_REPORTING_URL', enableInstana ? "${instanaProperties["instana.reportingURL"]}" : '""'
       }
   }
   

4. 有條件地起始設定 Instana 執行時期。

   現在不會以不想要的建置類型來起始設定 Instana 執行時期。

   if (BuildConfig.INSTANA_REPORTING_URL.isNotBlank()) {
       Instana.setup(this, InstanaConfig(
                   reportingURL = BuildConfig.INSTANA_REPORTING_URL,
                   key = BuildConfig.INSTANA_KEY
               ))
   }
   

階段作業生命週期

1. 每次啟動應用程式時，當設定代理程式時，階段作業即會自動啟動
2. 階段作業會自動產生 sessionID
3. 當應用程式處於作用中狀態 (在背景的前景中) 時， sessionID 保持不變
4. Instana Android 代理程式或 iOS 代理程式所傳送的所有信標都包含相同的 sessionID
5. 當應用程式停止時，會捨棄 sessionID ; 當程序本身停止時，會捨棄
6. 下次啟動應用程式時，將自動產生新的 sessionID

監視哪些 HTTP 資訊?

• 要求的持續時間。
• HTTP 方法 (POST， GET....)。
• 完整 URL 和路徑。
• 狀態碼 (例如 200)。
• 回應大小 (標頭、內文、解碼內文)。
• 任何基礎錯誤。
• 後端相關性的後端追蹤 ID。

自動與手動 HTTP 監視之間有何差異?

iOS: 我可以在啟用自動監視的情況下使用自己的 URLProtocol 嗎?

是，您可以建立自己的 URLProtocol ，以透過自訂 URLSession來 Proxy 您的要求和回應。 Instana HTTP 監視會自動忽略任何以 URLProtocol 作為委派的 URLSession 。 但您也可以明確忽略任何自訂 URLSession ，使其無法透過 Instana.ignore(yourURLSession)進行監視。 如果您在自己的 URLProtocol 內使用 URLSession 而沒有委派，則應該在 Instana iOS 代理程式中忽略此階段作業。 否則，會加倍監視要求及回應。

iOS: 混淆不是很危險嗎?

不一定。 執行時期中的旋轉主要是透過新增方法來完成:

func swizzled_touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) {
  // looks weird, but it calls the original implementation
   swizzled_touchesBegan(touches, with: event)
   print("do some custom magic here")
 }

然後透過下列方式交換新舊方法:

if let originalMethod = class_getInstanceMethod(UIResponder.self, #selector(touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?))),
   let swizzledMethod = class_getInstanceMethod(UIResponder.self, #selector(swizzled_touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?))) {
        method_exchangeImplementations(originalMethod, swizzledMethod)
}

不過，當執行時期在 UIResponder中進行正向呼叫時，它可能會導致非預期的行為。 有時執行時期有時會執行訊息轉遞。 如果訊息 (例如新的 swizzled_touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?)) 轉遞至新方法不存在的另一個接收端，則此混淆技術可能會導致當機。 在 Instana iOS 代理程式中，我們不會將第二個方法新增至類別。 因此，我們將新的實作直接 (透過區塊) 設為原始選取元，並置換原始實作。 然後在新函數內呼叫暫時儲存的原始實作; 因此，混淆不會留下任何追蹤資料。

iOS: 是否可以監視背景階段作業?

否，因為自訂 URLProtocol 子類別無法用於背景階段作業。 (請參閱 URLSession 文件。)

後端相關性如何使用 HTTP 要求?

所有 HTTP 要求都包括自動後端相關性，與 Instana 主機代理程式所監視的後端。 不需要追蹤或設定任何用戶端。

正在使用哪些 HTTP 標頭?

為了達到後端相關性，代理程式會使用下列 HTTP 標頭:

• Response headers:
  • Server-Timing

iOS

Android

Duplicate class com.google.common.util.concurrent.ListenableFuture found in modules guava-25.0-android.jar (com.google.guava:guava:25.0-android) and listenablefuture-1.0.jar (com.google.guava:listenablefuture:1.0)

implementation 'com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava'

abstract class WorkRequest {
    abstract static class Builder<B extends Builder, W extends WorkRequest> {
    }
}

class OneTimeWorkRequest extends WorkRequest {
   static class Builder extends WorkRequest.Builder<Builder, OneTimeWorkRequest> {
       public @NonNull Builder setInitialDelay(long duration, @NonNull TimeUnit timeUnit) {
          ....
       }
  }
}

abstract class WorkRequest {
    abstract static class Builder<B extends Builder, W extends WorkRequest> {
         public @NonNull B setInitialDelay(long duration, @NonNull TimeUnit timeUnit) {
              ...
         }
    }
}

class OneTimeWorkRequest extends WorkRequest {
   static class Builder extends WorkRequest.Builder<Builder, OneTimeWorkRequest> {
  }
}

[...]
Task :app:transformClassesWithRealmTransformerForDevevelopDebug FAILED
[...]

apply plugin: 'com.instana.android-agent-plugin' // Instana agent will be applied before Firebase Performance
apply plugin: 'com.google.firebase.firebase-perf'

implementation 'com.google.guava:listenablefuture:9999.0-empty-to-avoid-conflict-with-guava'

FAILURE: Build failed with an exception.
* What went wrong:
Execution failed for task ':app:transformClassesWithDexBuilderForDevDebug'.
> There were multiple failures while executing work items
   > A failure occurred while executing com.android.build.gradle.internal.transforms.DexArchiveBuilderTransform$DexConversionWorkAction
      > Failed to process /Users/developer/Projects/mobile-app/android/app/build/intermediates/javac/devDebug/classes
[...]

React Native

Instana React Native 代理程式會在 iOS 平台上呼叫 iOS 代理程式，並在 Android 平台上呼叫 Android 代理程式。 可以使用 React Native 代理程式升級來升級 iOS 代理程式或 Android 代理程式。 如需詳細資料，請參閱每一個平台特定的文件。

如何清除快取的 iOS 代理程式及 Android 代理程式?

當 React Native 代理程式從行動式應用程式升級至新版本時，請從終端機執行下列指令，以徹底清除 iOS 代理程式及 Android 代理程式的快取舊版本: {: codeblock} cd android && ./gradlew clean cd .. cd ios && pod cache clean --all && rm -rf build cd .. rm -rf node_modules yarn cache clean --force yarn install cd ios && pod install

您正在收集可唯一識別使用者的資料嗎?

依預設， Instana 代理程式 不 包含可唯一識別使用者的資料。 此外，代理程式也 不 套用 裝置指紋之類的技術。

使用者特定的資料可以透過 iOS 使用者 API 或 Android 使用者 API提供給 Instana。

您對傳輸至 Instana 的使用者資料執行了什麼動作?

客戶可以配置 Instana 代理程式，以將使用者識別資訊傳輸至 Instana。 此資訊僅用來提供 Instana 內您可看見的特性。 Instana 不會以任何其他方式解譯此資料，也不會在客戶之間產生關聯。

在傳輸至 Instana 之後，是否可以刪除使用者資料?

支援不頻繁的刪除要求，例如符合 GDPR。 如果您預期經常或定期刪除要求，請改為將匿名化資料傳輸至 Instana (例如，雜湊化使用者 ID)。

您是否匿名 IP?

是， IP 已匿名化。 依預設， IPv4 位址的最後一個八位元組及 IPv6 位址的最後 80 位元會設為零。 透過 Instana 使用者介面內行動式應用程式儀表板中的配置標籤，可以配置更嚴格的匿名化規則。