L'agent PHP de New Relic fournit une API pour personnaliser le comportement de l'agent. L' agent instrumente automatiquement de nombreux frameworks PHP populaires, mais vous pouvez utiliser l' API PHP pour instrumenter une activité que l' agent instrumente pas déjà par défaut.
Ce guide décrit l'appel d'API PHP pour plusieurs tâches courantes ; par exemple :
- Notez ou ignorez les erreurs spécifiques.
- Nommez une transaction.
- Renommer l' application rapportant les données.
Conseil
Vous pouvez également définir plusieurs de ces options par répertoire ou dans newrelic.ini. En cas de configuration via l'API, l' API a priorité sur les autres méthodes.
Avis ou erreur ignorée
Habituellement, l'agent détecte les erreurs automatiquement. Cependant, vous pouvez marquer manuellement une erreur avec l'agent.
Si vous voulez... | Fais ceci... |
|---|---|
Signaler une erreur que l'agent ne signale pas automatiquement | Voir |
Ignorer une erreur | Modifiez |
Améliorer les métadonnées d'une transaction
Parfois, le code que vous ciblez est visible dans New Relic, mais certains détails de la méthode ne sont pas utiles. Par exemple:
- Le nom par défaut n'est pas utile ou provoque un problème de regroupement métrique.
- Vous souhaitez ajouter des attributs personnalisés à vos transactions ou spans afin de pouvoir les filtrer avec une requête NRQL .
Utilisez ces méthodes lorsque vous souhaitez modifier la manière dont New Relic instrumente une transaction déjà visible dans New Relic:
Si vous voulez... | Fais ceci... |
|---|---|
Changer le nom d'une transaction | |
Ajoutez des métadonnées (comme le nom du compte de vos clients ou le niveau d'abonnement) à vos transactions ou à vos plages | Utilisez l'attribut personnalisé. Pour l'attribut personnalisé qui sera ajouté aux transactions et aux spans (si activé), voir Pour les attributs personnalisés qui seront ajoutés uniquement aux spans, voir |
Marquer une transaction comme tâche d'arrière-plan | |
Empêcher une transaction d'affecter votre score Apdex | Voir |
Voir le log associé
Pour voir le log directement dans le contexte des erreurs et des traces de votre application, utilisez ces appels d'API pour annoter votre log :
Pour plus d'informations sur la corrélation des données log avec d'autres données télémétriques, consultez notre documentation sur les logs en contexte .
Application de signalement de noms
L'UI de New Relic organise les données en fonction de la façon dont vous nommez votre application. Chaque nom apparaît comme une application différente. Vous pouvez renommer l'application de création de rapports pour n'importe quelle partie de votre code pour mieux vous aider :
- Organisez et analysez vos données sur les pages de l'UI de New Relic (par exemple, la page APM Applications index , la page Summary, la page Transactions , etc.).
- Interrogez vos données.
- Créer une règle d'alerte.
Ceci est particulièrement utile si vous avez une application multi-site ou des ensembles distincts de code d'application utilisant la même installation PHP.
Alternativement, vous pouvez définir le nom de l'application à un niveau supérieur via la valeur de configuration newrelic.appname, via Apache ou via PHP-FPM.
Si vous voulez... | Fais ceci... |
|---|---|
Renommer l'application de création de rapports pour une partie spécifique de votre code | Définissez le nom de l'application. Voir |
Instrumenter manquant des sections de votre code avec des transactions
Pour instrumenter votre application, New Relic sépare chaque chemin à travers votre code dans sa propre transaction. New Relic chronomètre (ou « instrumente ») la méthode parent dans ces transactions pour mesurer les performances globales de votre application et collecte la trace des transactions de longue durée pour plus de détails. Pour plus d'informations sur les transactions, voir transaction et trace de transaction.
Utilisez ces méthodes lorsque New Relic n’instrumente pas du tout une partie particulière de votre code :
Si vous voulez... | Fais ceci... |
|---|---|
Démarrer le chronométrage d'une méthode New Relic n'est pas instrumenté automatiquement | Démarrer une transaction. Voir |
Arrêtez de chronométrer une méthode une fois son travail terminé | Arrêter une transaction. Voir |
Empêcher une transaction d'être signalée à New Relic | Ignorer la transaction. Voir |
Méthodes temporelles spécifiques utilisant des segments
Si une transaction est déjà visible dans l'UI New Relic, mais que vous ne disposez pas de suffisamment de données sur une méthode particulière qui a été appelée au cours de cette transaction, vous pouvez créer des segments pour chronométrer ces méthodes individuelles plus en détail. Par exemple, vous souhaiterez peut-être chronométrer une méthode particulièrement critique avec une logique complexe.
Utilisez ces méthodes lorsque vous souhaitez instrumenter une méthode dans une transaction existante :
Si vous voulez... | Fais ceci... |
|---|---|
Chronométrer une méthode particulière |
Travail asynchrone de l'instrument
Le seul travail asynchrone que l' agent PHP instrumente est Guzzle, qui est instrumenté par défaut.
Envoyez des données d'événement personnalisées et métriques depuis votre application
New Relic inclut un certain nombre de façons d'enregistrer des données personnalisées arbitraires. Pour une explication des types de données New Relic, voir Collecte de données.
Si vous voulez... | Fais ceci... |
|---|---|
Envoyez des données sur un événement afin de pouvoir l'analyser dans New Relic | Créer un événement personnalisé. Voir Insérer un événement personnalisé via agent APM (PHP). |
taggez votre événement avec des métadonnées pour les filtrer et les faceter | Ajouter un attribut personnalisé. Voir |
Rapport de données de performances personnalisées | Créez une métrique personnalisée. Voir |
Instrumenter les appels à des services externes
Utilisez ces méthodes pour collecter des données sur les connexions de votre application à d’autres applications ou magasins de données :
Si vous voulez... | Fais ceci... |
|---|---|
Heure d'appel à un datastore non instrumenté par défaut | |
Voir le chemin emprunté par une requête lorsqu'elle traverse un système distribué | Pour les versions d' agent PHP inférieures à 9.8, voir ces appels d'API:
|
pages du navigateur spécifiques au moniteur
Vous pouvez installer l' agent de navigateur en l'ajoutant automatiquement à vos pages ou en le déployant sur des pages spécifiques en copiant et collant notre snippet JavaScript. Vous pouvez également contrôler agent API l' en utilisant lesagent appels d' de. Pour plus d'informations, voir monitoring des navigateurs et l' agent PHP.