agent APM, agent de navigateur et agent mobile rapportent un type de données métriques appelé intervalle de temps métrique data. Ces agents vous permettent de signaler des données d'intervalle de temps métrique personnalisées à partir de votre application et de les voir à côté des données New Relic par défaut. Créez des métriques personnalisées pour enregistrer des données de performances arbitraires via un appel d'API, telles que :
- Données de synchronisation
- Données sur les ressources informatiques
- Abonnement ou achat de données
Après avoir signalé ces données, vous pouvez les explorer et les interroger.
Nommez les métriques personnalisées
Commencez tous les noms de métriques personnalisées par Custom/; par exemple, Custom/MyMetric/My_label. Le préfixe Custom/ est requis pour toutes les métriques personnalisées.
Tous les noms de métriques personnalisées qui ne commencent pas par Custom/ sont soumis à toutes les autres règles de regroupement. Il se peut qu'ils ne soient pas visibles lors de l'interrogation ou qu'ils n'apparaissent pas comme prévu dans l'UI.
Un nom métriques personnalisées se compose du préfixe Custom/, du nom de la catégorie ou de la classe et d'une méthode ou d'une étiquette, chacun séparé par une barre oblique.
Outil métriques personnalisé
La mise en œuvre de métriques personnalisées nécessite un appel d'API. Les détails exacts de l'appel d'API varient selon agent.
Conseil
Si vous testez votre implémentation de métriques personnalisées, exécutez l'agent pendant au moins 10 minutes pour vous assurer que l'appel d'API est signalé à New Relic.
Agent de New Relic | Mise en œuvre |
|---|---|
agent APM |
|
Agent mobile New Relic | |
New Relic de navigation agent | Le navigateur ne prend pas en charge les métriques personnalisées. Pour les options d'ajout de données personnalisées au navigateur, consultez l'instrumentation du navigateur. |
Évitez les problèmes de regroupement
La collecte d'un trop grand nombre de tranches de temps métriques peut avoir un impact sur les performances de votre application et New Relic. Par exemple, si vous avez des milliers d'utilisateurs individuels, évitez de créer des métriques pour suivre les performances de leurs identifiants d'utilisateur uniques. Cela pourrait donner lieu à un nombre de mesures tellement important qu’il deviendrait presque impossible de naviguer ou de donner un sens aux données. Utilisez plutôt un espace réservé, tel qu’un astérisque (*), au lieu d’identifiants d’utilisateur individuels.
Important
Pour éviter d'éventuels problèmes de données, essayez de maintenir le nombre total de tranches de temps métriques uniques introduites par les métriques personnalisées sous 2000.
Lorsque le nombre total de noms de métriques uniques dépasse 5 000, des limites commencent à s'appliquer automatiquement, affectant la manière dont les données s'affichent dans l'interface utilisateur, comme dans les graphiques et les tableaux. Pour plus d'informations, consultez Problèmes de regroupement métrique.