Créer des métriques personnalisées dans Go

Les métriques personnalisées vous permettent de signaler toute métrique qui passe par votre code. Par exemple, avec le monitoring Go de New Relic , vous pouvez créer des métriques personnalisées pour chronométrer un composant de votre application qui peut ne pas être capturé par défaut. Une fois que vous avez capturé une métrique personnalisée, vous pouvez :

• Unifiez votre monitoring au sein de New Relic grâce à l'explorateur de métriques et d'événements.
• Utilisez notre API REST pour récupérer et utiliser par programmation des données métriques personnalisées en dehors de l'UI.
• Créez des conditions d'alerte de métriques personnalisées pour vous avertir, vous ou votre équipe, lorsque vos métriques personnalisées dépassent des valeurs spécifiques.

Créer une métrique personnalisée

1. Instanciez votre application en exécutant la commande suivante :

   app, err := newrelic.NewApplication(
     newrelic.ConfigAppName("Your Application Name"),
     newrelic.ConfigLicense("NEW_RELIC_LICENSE_KEY"),
     newrelic.ConfigDebugLogger(os.Stdout),
   )

   Copier

2. Après avoir instancié votre application, créez une métrique personnalisée avec le code suivant :

   app.RecordCustomMetric(
       "CustomMetricName",         //name of your metric
       132,                         //time in ms
   );

   Copier
   • RecordCustomMetricLe premier paramètre de est une chaîne qui nomme vos métriques personnalisées.
   • La méthode RecordCustomMetric ajoutera automatiquement la chaîne Custom/ au nom de votre métrique. Cela signifie que le code ci-dessus générera une métrique nommée Custom/CustomMetricName.
   • RecordCustomMetricLe deuxième paramètre est le temps, en millisecondes, que vous souhaitez enregistrer pour votre transaction personnalisée. Cela signifie que le code ci-dessus produira une métrique de 0,132 secondes dans le système de New Relic.
   • Pour utiliser une métrique personnalisée comme compteur, elle peut être incrémentée en effectuant l'appel comme décrit ci-dessus, et la valeur count pour cette métrique sera incrémentée de 1. La valeur que vous utilisez pour le deuxième paramètre (temps en ms) n'a aucune importance si vous utilisez la métrique uniquement comme compteur, et vous pouvez donc utiliser un nombre statique, tel que 0 ou 1.
     • Pour incrémenter un compteur d'un nombre supérieur à 1, appelez app.RecordCustomMetric plusieurs fois - chaque appel n'incrémentera la métrique que de 1, quelle que soit la valeur du deuxième paramètre.

Nommer une métrique personnalisée

Réfléchissez soigneusement à la manière dont vous nommez vos métriques personnalisées. Si votre programme crée trop de métriques portant un nom unique, vous risquez de vous retrouver avec un problème de regroupement de métriques (MGI).

Les MGI se produisent lorsque la granularité des noms métriques est trop fine, ce qui donne lieu à des centaines ou des milliers de noms métriques différents. L'une des causes courantes des MGI est le recours au nom complet de l'URL pour la dénomination métrique dans le Web des transactions. Quelques chemins de code majeurs peuvent générer de nombreux chemins d'URL complets différents vers des documents, articles, pages, etc. uniques.

Si l'élément unique du chemin URL est inclus dans le nom de la métrique, chacun de ces chemins communs aura son propre nom de métrique unique. Si des problèmes de regroupement métrique surviennent, suivez les procédures de dépannage.