Google致力於提高黑人社區的種族平等。 怎麼看。
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

為特定的應用代碼添加自定義監控

您可以創建自定義跟踪,以監視與應用程序中特定代碼關聯的性能數據。使用自定義跟踪,您可以測量應用程序完成特定任務或一組任務所需的時間,例如,加載一組圖像或查詢數據庫。自定義跟踪的默認指標是持續時間 ,但是您也可以添加自定義指標。

在您的代碼中,使用Performance Monitoring SDK提供的API定義自定義跟踪的開始和結束。

跟踪也可以在創建之後啟動,並且它們是線程安全的。

請注意以下幾點:

  • 一個應用程序可以具有多個自定義跟踪。
  • 可以同時運行多個自定義跟踪。
  • 自定義跟踪和自定義度量的名稱必須滿足以下要求:不能包含前導或尾隨空格,不能包含前導下劃線( _ )字符,並且最大長度為100個字符。

默認屬性,自定義屬性和自定義指標

對於自定義跟踪,性能監控會自動記錄為任何跟踪收集的默認屬性 (適用的元數據,例如應用程序版本,國家/地區,設備,瀏覽器等),以便您可以在Firebase控制台中過濾數據。對於自定義跟踪,您還可以添加和監視自定義屬性 (例如游戲級別或用戶屬性)。

您可以進一步配置自定義跟踪,以記錄針對在跟踪範圍內發生的與性能相關的事件的自定義指標 。例如,您可以為緩存的命中和未命中次數或UI在明顯的時間內無響應的次數創建自定義指標。這些自定義指標的數據與跟踪的默認指標一起顯示在Firebase控制台中。每個自定義跟踪最多可以記錄32個指標,包括默認持續時間指標和任何其他自定義指標。

添加自定義跟踪和自定義指標

使用跟踪API( Swift | Obj-C )添加自定義跟踪和自定義指標,以監視特定的應用程序代碼。

  1. 將性能監視模塊添加到標題中:

    迅速

     import FirebasePerformance
     

    目標C

     @import FirebasePerformance;
     
  2. 要啟動和停止自定義跟踪,請使用類似於以下內容的代碼行包裝要跟踪的代碼:

    迅速

    let trace = Performance.startTrace(name: " CUSTOM_TRACE_NAME ")
    
    // code that you want to trace
    
    trace.stop()
    

    了解有關自定義跟踪API的更多信息。

    目標C

    FIRTrace *trace = [FIRPerformance startTraceWithName:@" CUSTOM_TRACE_NAME "];
    
    // code that you want to trace
    
    [trace stop];
    

    了解有關自定義跟踪API的更多信息。

  3. 要添加自定義指標,請在每次事件發生時添加類似於以下內容的代碼行。例如,此自定義指標計算應用程序中發生的與性能相關的事件,例如緩存命中或重試。

    迅速

    let trace = Performance.startTrace(name: " CUSTOM_TRACE_NAME ")
    
    trace.incrementMetric(named:" EVENT_NAME ", by: 1)
    // code that you want to trace (and log custom metrics)
    
    trace.stop()
    

    目標C

    FIRTrace *trace = [FIRPerformance startTraceWithName:@" CUSTOM_TRACE_NAME "];
    
    [trace incrementMetric:@" EVENT_NAME " by:1];
    // code that you want to trace (and log custom metrics)
    
    [trace stop];
    

在控制台中監視自定義跟踪和指標

  1. 在Firebase控制台中,轉到“ 性能”儀表板

  2. 單擊“ 在設備上”選項卡,然後可以:

    • 查看所有跟踪的已收集數據的快速報告。

    • 單擊特定的跟踪以更詳細地查看跟踪的數據。

    • 使用儀表板左上方的“ 過濾器按鈕可以按屬性對數據進行基本過濾。

  3. 如果單擊特定的跟踪,控制台將在度量卡上顯示所收集數據的概述,包括默認的“ 持續時間”度量以及為自定義跟踪配置的任何其他自定義度量。

    • 使用信息中心右上方的選項,可以查看匯總的一段時間內或應用的每個版本的持續時間數據。

    • 使用儀表板左上方的“ 過濾器按鈕可以按屬性對數據進行基本過濾。

  4. 對於任何指標,請單擊“ 查看更多”以查看有關所收集數據的更多深入信息並使用更豐富的分析功能。例如,您可以按屬性過濾和細分數據,並在應用程序使用會話的上下文中查看數據。

    以下部分描述了深入跟踪報告的可用功能。

查看有關跟踪樣本的更多詳細信息

您可以在Firebase控制台中深入了解特定跟踪或網絡請求的各個部分。記錄的會話的隨機採樣顯示以下信息:

Firebase性能監控會話頁面的圖像

  • CPU:您的應用消耗了多少用戶時間和系統時間。

  • 內存:您的應用使用多少堆內存。堆內存是用於動態分配的內存,包括創建的對象,釋放的對像以及應用程序正在使用的對象。

  • 單個信息:有關跟踪或網絡請求的單個實例的詳細信息,包括開始時間,結束時間,持續時間,請求大小和響應大小。

  • 並發實例:有關同時發生的跟踪或網絡請求的信息。

  • 設備屬性:有關設備的信息,包括應用程序版本,型號,操作系統版本,廣播和自定義屬性。

要在Firebase控制台中查看這些詳細的示例,您可以:

  • 打開應用程序的跟踪或網絡請求之一,然後點擊查看會話

  • 單擊特定屬性的屬性會話鏈接。

Firebase Performance Monitoring跟踪的圖像以及指向會話的鏈接

按百分比過濾會話

Performance Monitoring收集的會話將分配給每個指標的百分比。百分比範圍較低的會話的度量值比百分比範圍較高的會話的度量值低。

要按百分比過濾可用會話,請使用會話詳細信息上方的“百分比”下拉列表。

Firebase性能監控會話頁面的圖像

下一步