針對特定網路要求新增自訂監控功能 (Apple &;Android 應用程式)


Performance Monitoring 會收集追蹤記錄,協助您監控應用程式的效能。追蹤記錄是指在應用程式中兩個時間點之間擷取的效能資料報表。

Performance Monitoring 自動收集的網路要求追蹤記錄包含應用程式的大部分網路要求。不過,部分要求可能不會回報,或者您可能會使用其他程式庫來提出網路要求。在這些情況下,您可以使用 Performance Monitoring API 手動檢測自訂網路要求追蹤記錄。自訂網路要求追蹤記錄僅支援 Apple 和 Android 應用程式。

自訂網路要求追蹤記錄的預設指標與 Performance Monitoring 自動收集的網路要求追蹤記錄相同,特別是回應時間、回應和要求酬載大小,以及成功率。自訂網路要求追蹤記錄不支援新增自訂指標。

在程式碼中,您可以使用 Performance Monitoring SDK 提供的 API,定義自訂網路要求追蹤記錄的起點和終點。

自訂網路要求追蹤記錄會顯示在 Firebase 主控台中,與 Performance Monitoring 自動擷取的網路要求一併顯示 (在追蹤記錄表的「網路要求」子分頁中)。

新增自訂網路要求追蹤記錄

使用 Performance Monitoring HttpMetric API 新增自訂網路要求追蹤記錄,以便監控特定網路要求。

如要在 Performance Monitoring 中手動檢測自訂網路要求,請新增類似於以下內容的程式碼:

Kotlin+KTX

val url = URL("https://www.google.com")
val metric = Firebase.performance.newHttpMetric(
    "https://www.google.com",
    FirebasePerformance.HttpMethod.GET,
)
metric.trace {
    val conn = url.openConnection() as HttpURLConnection
    conn.doOutput = true
    conn.setRequestProperty("Content-Type", "application/json")
    try {
        val outputStream = DataOutputStream(conn.outputStream)
        outputStream.write(data)
    } catch (ignored: IOException) {
    }

    // Set HttpMetric attributes
    setRequestPayloadSize(data.size.toLong())
    setHttpResponseCode(conn.responseCode)

    printStreamContent(conn.inputStream)

    conn.disconnect()
}

Java

HttpMetric metric =
        FirebasePerformance.getInstance().newHttpMetric("https://www.google.com",
                FirebasePerformance.HttpMethod.GET);
final URL url = new URL("https://www.google.com");
metric.start();
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setDoOutput(true);
conn.setRequestProperty("Content-Type", "application/json");
try {
    DataOutputStream outputStream = new DataOutputStream(conn.getOutputStream());
    outputStream.write(data);
} catch (IOException ignored) {
}
metric.setRequestPayloadSize(data.length);
metric.setHttpResponseCode(conn.getResponseCode());
printStreamContent(conn.getInputStream());

conn.disconnect();
metric.stop();

自訂網路要求追蹤記錄也支援新增自訂屬性,但不支援自訂指標。

後續步驟

  • 設定快訊,針對降低應用程式效能的網路要求發出快訊。舉例來說,如果特定網址模式的回應時間超過您設定的門檻,您可以為團隊設定電子郵件快訊。