損毀集合 (技術預覽)

Instana 為行動式應用程式開發人員提供損毀分析處理程序,以儘快偵測、瞭解及修正損毀。 此特性有助於將受影響使用者數目減至最少,並減少損毀的負面影響。

支援的技術

Android 及 iOS 原生應用程式支援 Instana 損毀集合。 此特性在下列代理程式版本中受支援:

  • Instana Android 代理程式 6.0.1 或更新版本 (基於 Gradle 7.3.3)
  • Instana Android 代理程式 5.2.6 或更新版本 (基於低於 7.3.3的 Gradle 版本)
  • Instana iOS 代理程式 1.6.0 或更新版本

要注意的事項

  • Android
    • 尚不支援 Android 損毀的符號。
  • iOS
    • 如果可能的話, iOS 代理程式會嘗試執行符號,否則原始資料會顯示在 Instana 使用者介面中。
    • 如果應用程式是在 iOS 模擬器中執行,則不會將損毀資料傳送至 Instana。
    • 下次在損毀之後重新啟動應用程式時,會將損毀資料傳送至 Instana。 如需相關資訊,請參閱 MetricKit
    • App ID 必須是有效的 Apple App ID。 否則,損毀收集功能無法運作。

在 Android 代理程式中啟用損毀收集

請確定 Instana Android 代理程式外掛程式和 SDK 已整合在 Android 應用程式中。 如需相關資訊,請參閱 Android 代理程式指示

然後,當呼叫 Instana.setup() 方法時,將 enableCrashReporting 內容設為 true 。 請參閱下列範例:

class ExampleApp : Application() {
    override fun onCreate() {
        super.onCreate()
        val instanaConfig = InstanaConfig(
            key = "GbYHxegG4gcgta",
            reportingURL = "https://instana-prod.io/mobile",
            enableCrashReporting = true
        )
        Instana.setup(this, instanaConfig)
    }
}

在 iOS 代理程式中啟用損毀收集

若要在 iOS 代理程式中啟用損毀收集,請完成下列步驟:

確定已安裝 Instana iOS 代理程式。 如需相關資訊,請參閱 iOS 代理程式指示

然後,當呼叫 Instana.setup() 方法時,將 enableCrashReporting 內容設為 true 。 請參閱下列範例:

import UIKit
import InstanaAgent

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?

    func application(_ application: UIApplication,
                   didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

        Instana.setup(
            key: "GbYHxegG4gcgta",
            reportingURL: URL(string: "https://instana-prod.io/mobile")!,
            enableCrashReporting: true
        )
        return true
    }
}

在 Instana 使用者介面中分析損毀

啟用應用程式的損毀收集之後,當損毀發生時,損毀資料會傳送至 Instana。 您可以開始分析損毀資料。

  1. 在 Instana 使用者介面中按一下 分析

  2. 在「分析」頁面中,按一下 行動式應用程式 > 損毀

  3. 依下列方式過濾應用程式:

    顯示行動式應用程式損毀分析視圖的擷取畫面

    若要查看損毀詳細資料,請展開 損毀 區段,然後您可以查看堆疊追蹤。 請參閱下列擷取畫面:

    顯示損毀堆疊追蹤的擷取畫面