Syntaxe
newrelic_custom_metric(string $metric_name, float $value)Ajoutez des métriques personnalisées (en millisecondes) pour chronométrer un composant de votre application non capturé par défaut.
Exigences
Compatible avec toutes les versions d'agent.
Description
Enregistrez les métriques personnalisées qui ne sont pas capturées par défaut par l'agent PHP.
Ensuite vous pouvez :
- Utilisez métriques et événement pour rechercher vos métriques personnalisées, créer des graphiques personnalisables et les ajouter au dashboard.
- Utilisez New Relic API l' REST pour récupérer et utiliser par programmation des données métriques personnalisées en dehors de l'UI New Relic.
- Créez des alertes de métriques personnalisées pour vous avertir, vous ou votre équipe, lorsque vos métriques personnalisées dépassent des valeurs spécifiques.
Paramètres
paramètres | Description |
|---|---|
chaîne | Requis. Nommez vos métriques personnalisées avec un préfixe Custom/ (par exemple, Custom/MyMetric). Cela aide l' UI à organiser vos métriques personnalisées en un seul endroit et les rend facilement trouvables via l'explorateur métrique. |
virgule flottante | Requis. Enregistre le temps en millisecondes. Par exemple : une valeur de Si la valeur est NaN, Infinity, denorm ou moins zéro, le comportement de cette fonction est indéfini. New Relic peut supprimer 1 ou plusieurs bits de précision (ULP) de la valeur donnée. |
Valeurs de retour
Renvoie true si la métrique a été ajoutée avec succès.
Exemples
Enregistrer un temps de réponse de 100 millisecondes
function example() { if (extension_loaded('newrelic')) { // Ensure PHP agent is available newrelic_custom_metric("Custom/custom-metric-name", 100.00); }}