• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

record_custom_metric (Python API d'agent)

Syntaxe

newrelic.agent.record_custom_metric(name, value, application=None)

Enregistre une seule métrique personnalisée.

Description

Cet appel enregistre une seule métrique personnalisée. Pour enregistrer un ensemble de métriques, voir record_custom_metrics.

Paramètres

paramètres

Description

name

chaîne

Requis. Nom de la métrique.

Il n'y a aucune restriction concernant les formats de dénomination, mais nous vous recommandons d'utiliser un préfixe Custom/ pour vos noms de métriques personnalisées. Cela vous aide à différencier les métriques personnalisées des métriques du moniteur par défaut dans notre UI et vous aide également à résoudre les problèmes si nécessaire.

value

int ou dict

Requis. La valeur numérique de la métrique. Peut être un entier, une virgule flottante ou un dictionnaire de valeurs. Les champs possibles pour un dictionnaire sont :

  • count
  • total
  • min
  • max
  • sum_of_squares

application

objet d'application

Facultatif. L' objet d'application correspondant à l'application à laquelle vous souhaitez associer les métriques. Si l' application a la valeur par défaut None, l' agent enregistre les métriques personnalisées de l'application associée à la transaction en cours. Vous devez donc fournir l' application, sauf si cette méthode est utilisée dans le code d'une tâche Web de transaction ou d'arrière-plan.

Valeurs de retour

Aucun.

Exemples

Enregistrement d'une métrique personnalisée à l'aide de l'objet application

Pour enregistrer des métriques personnalisées à partir d'un thread d'arrière-plan distinct ou d'un autre code, vous devez transmettre l' objetapplication correspondant à l' application à laquelle les métriques personnalisées doivent être signalées.

import newrelic.agent
application = newrelic.agent.application()
newrelic.agent.record_custom_metric('Custom/my_favorite_number', 42, application)

Afficher et utiliser des métriques personnalisées

Pour afficher les métriques personnalisées, utilisez métriques et événement pour rechercher et filtrer les métriques personnalisées, créer des graphiques personnalisables et ajouter ces graphiques au dashboard New Relic . Vous pouvez utiliser notre API REST pour récupérer et utiliser par programmation des données métriques personnalisées en dehors de l' UI. Il est également possible de créer 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.

Droits d'auteur © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.