Add custom monitoring for specific network requests (Apple & Android apps)

Performance Monitoring collects traces to help you monitor the performance of your app. A trace is a report of performance data captured between two points in time in your app.

The network request traces automatically collected by Performance Monitoring include most network requests for your app. However, some requests might not be reported or you might use a different library to make network requests. In these cases, you can use the Performance Monitoring API to manually instrument custom network request traces. Custom network request traces are only supported for Apple and Android apps.

The default metrics for a custom network request trace are the same as those for the network request traces automatically collected by Performance Monitoring, specifically response time, response and request payload size, and success rate. Custom network request traces do not support adding custom metrics.

In your code, you define the beginning and the end of a custom network request trace using the APIs provided by the Performance Monitoring SDK.

Custom network request traces appear in the Firebase console alongside the network requests that Performance Monitoring captures automatically (in the Network requests subtab of the traces table).

Add custom network request traces

Use the Performance Monitoring HTTPMetric API (Swift | Obj-C) to add custom network request traces to monitor specific network requests.

To manually instrument custom network requests in Performance Monitoring, add code similar to the following:


Note: This Firebase product is not available on macOS, Mac Catalyst, watchOS targets.
guard let metric = HTTPMetric(url: "", httpMethod: .get) else { return }

guard let url = URL(string: "") else { return }
let request: URLRequest = URLRequest(url:url)
let session = URLSession(configuration: .default)
let dataTask = session.dataTask(with: request) { (urlData, response, error) in
        if let httpResponse = response as? HTTPURLResponse {
         metric.responseCode = httpResponse.statusCode


Note: This Firebase product is not available on macOS, Mac Catalyst, watchOS targets.
@property (nonatomic) FIRHTTPMetric *metric;

- (void)beginManualNetworkInstrumentation {
  self.metric =
      [[FIRHttpMetric alloc] initWithURL:[NSURL URLWithString:@""]

  [self.metric start];

  NSURLRequest *request =
      [NSURLRequest requestWithURL:[NSURL URLWithString:@""]];
  NSURLConnection *connection = [[NSURLConnection alloc] initWithRequest:request
  [connection resume];

- (void)connection:(NSURLConnection *)connection
    didReceiveResponse:(NSURLResponse *) response {
  NSHTTPURLResponse* httpResponse = (NSHTTPURLResponse*)response
  self.metric.responseCode = httpResponse.statusCode;
  [self.metric stop];

Custom network request traces also support adding custom attributes (Swift | Obj-C) but not custom metrics.

Next steps

  • Set up alerts for network requests that are degrading the performance of your app. For example, you can configure an email alert for your team if the response time for a specific URL pattern exceeds a threshold that you set.