Performance Monitoring collecte des traces pour vous aider à surveiller les performances de votre application. Une trace est un rapport sur les données de performances capturées entre deux moments dans votre application.
Les traces de requêtes réseau collectées automatiquement par Performance Monitoring incluent la plupart des requêtes réseau de votre application. Toutefois, certaines requêtes peuvent ne pas être signalées ou vous pouvez utiliser une autre bibliothèque pour effectuer des requêtes réseau. Dans ce cas, vous pouvez utiliser l'API Performance Monitoring pour instrumenter manuellement les traces de requêtes réseau personnalisées. Les traces de requêtes réseau personnalisées ne sont compatibles qu'avec les applications Apple et Android.
Les métriques par défaut d'une trace de requête réseau personnalisée sont les mêmes que celles des traces de requête réseau collectées automatiquement par Performance Monitoring, en particulier le temps de réponse, la taille de la charge utile de la réponse et de la requête, ainsi que le taux de réussite. Les traces de requêtes réseau personnalisées n'acceptent pas l'ajout de métriques personnalisées.
Dans votre code, vous définissez le début et la fin d'une trace de requête réseau personnalisée à l'aide des API fournies par le SDK Performance Monitoring.
Les traces de requêtes réseau personnalisées s'affichent dans la console Firebase, à côté des requêtes réseau que Performance Monitoring capture automatiquement (dans le sous-onglet Requêtes réseau du tableau des traces).
Ajouter des traces de requêtes réseau personnalisées
Utilisez l'API HTTPMetric Performance Monitoring (Swift | Obj-C) pour ajouter des traces de requêtes réseau personnalisées afin de surveiller des requêtes réseau spécifiques.
Pour instrumenter manuellement des requêtes réseau personnalisées dans Performance Monitoring, ajoutez un code semblable à celui-ci :
Swift
guard let metric = HTTPMetric(url: "https://www.google.com", httpMethod: .get) else { return }
metric.start()
guard let url = URL(string: "https://www.google.com") 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
}
metric.stop()
}
dataTask.resume()
Objective-C
@property (nonatomic) FIRHTTPMetric *metric;
- (void)beginManualNetworkInstrumentation {
self.metric =
[[FIRHttpMetric alloc] initWithURL:[NSURL URLWithString:@"https://www.google.com"]
HTTPMethod:FIRHTTPMethodGET];
[self.metric start];
NSURLRequest *request =
[NSURLRequest requestWithURL:[NSURL URLWithString:@"https://www.google.com"]];
NSURLConnection *connection = [[NSURLConnection alloc] initWithRequest:request
delegate:self];
[connection resume];
}
- (void)connection:(NSURLConnection *)connection
didReceiveResponse:(NSURLResponse *) response {
NSHTTPURLResponse* httpResponse = (NSHTTPURLResponse*)response
self.metric.responseCode = httpResponse.statusCode;
[self.metric stop];
}
Les traces de requêtes réseau personnalisées permettent également d'ajouter des attributs personnalisés (Swift | Obj-C), mais pas de métriques personnalisées.
Étapes suivantes
- Configurez des alertes pour les requêtes réseau qui dégradent les performances de votre application. Par exemple, vous pouvez configurer une alerte par e-mail pour votre équipe si le temps de réponse d'un format d'URL spécifique dépasse un seuil que vous définissez.