Guide du SDK mobile

Utilisez l'appel d'API New Relic Mobile SDK pour personnaliser et étendre les données que votre application mobile signale à New Relic.

Bien que notre solution offre une puissante collecte de données prête à l'emploi, vous devrez peut-être personnaliser et étendre les données que votre application mobile signale à New Relic. Par exemple, vous pouvez utiliser le SDK public appelé API pour :

Démarrer et arrêter le suivi d'interaction à partir d'un événement dans votre application mobile
Enregistrer des métriques personnalisées
Envoyer l'attribut personnalisé et événement
Le suivi requests réseau de la bibliothèque n'est pas pris en charge automatiquement
Définir des identifiants personnalisés pour les sessions utilisateur

Démarrer

Assurez-vous que le dernier agent mobile est installé.
Sélectionnez une personnalisation dans le tableau ci-dessous et suivez la documentation de la méthode.

Personnalisations disponibles

Le tableau ci-dessous répertorie les méthodes SDK prises en charge pour personnaliser votre instrumentation d'agent mobile. Sélectionnez une méthode pour afficher la syntaxe et les exemples d’utilisation pour chaque type d’agent.

Si vous voulez...	Utilisez cette méthode
Enregistrez le fil d'Ariane pour suivre l'activité de l'application qui peut être utile pour le dépannage des pannes.	Disque fil d'Ariane
Suivre une méthode en tant qu'interaction.	Démarrer les interactions Arrêter les interactions Conseil Si vous utilisez ces méthodes, l'interaction instrumentée n'apparaîtra pas sur la page d'interaction , mais elles peuvent toujours être trouvées avec une requête NRQL , telle que : `SELECT name FROM Mobile SINCE 7 DAYS AGO`
Nommez ou renommez une interaction.	Interaction du nom
Définissez l'ID de build ou la version de votre application à associer à l'interaction.	Définir le numéro de build de l'application Définir le numéro de version de l'application
Créez des métriques personnalisées.	Enregistrer des métriques personnalisées
Rapport attribut personnalisé et événement.	Il existe plusieurs façons de signaler un attribut personnalisé et un événement : Enregistrer l'attribut personnalisé Augmenter le nombre d'attributs de session Supprimer un attribut Supprimer tous les attributs Enregistrer un événement personnalisé Disque fil d'Ariane Définir la taille maximale d'un pool d'événements Définir la durée maximale pendant laquelle l'agent stocke l'événement en mémoire Obtenir l'identifiant d'une session en cours Définir un identifiant utilisateur personnalisé à associer à l'événement et à l'attribut Pour en savoir plus sur la meilleure méthode à utiliser et pourquoi, consultez Rapport monitoring des applications mobiles événement personnalisé et attribut.
Suivez requests et les échecs du réseau personnalisé.	Suivre requestsHTTP Suivre requestsHTTP en échec
Enregistrez une exception traitée en tant qu’événement, y compris le contexte de ce qui s’est passé.	Enregistrer les exceptions traitées
Enregistrer les erreurs.	Enregistrer les erreurs
Nommer l'activité pour l'heure de lancement de l'application.	Définir l'activité cible de l'heure de lancement de l'application
Arrêtez l'agent.	Arrêter l'agent
Activer/désactiver monitoring par défaut des paramètres des applications mobiles.	Activer/désactiver la fonctionnalité monitoring
Exécutez un rapport de crash de test.	Rapport de crash de test

Utilisation de l'API du SDK mobile

(Android) Méthodes instrumentées automatiquement

instrumentation automatique est l'une des fonctionnalités les plus pratiques de l'agent Android . Cependant, si cela interfère avec la méthode en cours de tracing, ajoutez @SkipTrace à la méthode et l'agent l'ignorera pendant instrumentation au moment de la compilation.

Classes	Methods
`Activity`	`onCreate` `onCreateView`
`AsyncTask`	`execute` `executeOnExecutor`
`BitmapFactory`	`decodeFile` `decodeResourceStream` `decodeResource` `decodeByteArray` `decodeStream` `decodeFileDescriptor` `decodeResourceStream`
`SQLiteDatabase`	`query` `queryWithFactory` `rawQuery` `rawQueryWithFactory` `insert` `insertOrThrow` `insertWithOnConflict` `replace` `replaceOrThrow` `delete` `update` `updateWithOnConflict` `execSql`
`GSON`	`toJson` `fromJson`
`JSONObject`	`<init>` `toString`
`JSONArray`	`<init>` `toString`
`Log`	`d // debug` `w // warning` `i // info` `v // verbose` `e // error`

(iOS) Méthodes instrumentées automatiquement

instrumentation automatique est l'une des fonctionnalités les plus pratiques de l'agent iOS. Il est activé par défaut. Pour désactiver, veuillez configurer les indicateurs de fonctionnalité NRFeatureFlag_DefaultInteractions et NRFeatureFlag_InteractionTracing.

Le tableau ci-dessous répertorie les classes et méthodes instrumentées automatiquement dans l'agent iOS.

Classes	Methods
`UIViewController`	`viewDidLoad` `viewWillAppear` `viewDidAppear` `viewWillDisappear` `viewDidDisappear` `viewWillLayoutSubviews` `viewDidLayoutSubviews`
`UIImage`	`imageNamed` `imageWithContentsOfFile` `imageWithData` `imageWithData:scale:` `initWithContentsOfFile:` `initWithData:` `initWithData:scale:`
`NSJSONSerialization`	`JSONObjectWithData:options:error:` `JSONObjectWithStream:options:error:` `dataWithJSONObject:options:error:` `writeJSONObject:toStream:options:error:`
`NSManagedObjectContext`	`executeFetchRequest:error:` `processPendingChanges`

(iOS) Envoi d'attribut personnalisé et événement

Lors de la création de rapports sur les attributs personnalisés et les événements, utilisez les méthodes SDK dans l'objet NewRelic .

Les méthodes qui renvoient BOOL résultats renvoient YES si elles réussissent, ou NO si l'opération n'est pas terminée. Ces méthodes sont disponibles dans les versions 5.0.0 ou supérieures de l'agent New Relic iOS.

Le SDK peut stocker jusqu'à 128 attributs personnalisés définis par l'utilisateur à la fois. Si vous essayez de stocker plus de 128 attributs, le SDK renvoie NO.

Lors de la dénomination d'un attribut personnalisé, nous vous recommandons d'utiliser le format le plus simple nécessaire, comme l'utilisation d'un seul mot d'attribut et aucun espace. Par exemple, My Custom Attribute doit être formaté en myCustomAttribute.

Lors de la dénomination de métriques personnalisées :

Évitez d’utiliser les caractères / ] [ | * lorsque vous nommez des choses.
Évitez les caractères multi-octets.

Cette traduction automatique est fournie pour votre commodité.