Participez un webinar de formation
Explorez et inscrivez-vous aux sessions Foundation Enablement sur les métriques personnalisées. Découvrez comment ces métriques vous aident à suivre les KPI de vos applications, comme le nombre de visiteurs, la taille moyenne des paniers, la latence des requêtes ou la répartition des performances d'un algorithme personnalisé.
Section Overview
Les métriques custom vous permettent de suivre les KPI de votre application : nombre de visiteurs, taille moyenne du panier client, latence des requêtes ou répartition des performances pour un algorithme personnalisé. Une métrique custom est identifiée par une combinaison unique du nom de la métrique et des valeurs de tags (y compris le tag de host). Dans l’exemple ci-dessous, la métrique request.Latency comporte quatre combinaisons uniques de valeurs de tags issues de ses deux clés de tag :
endpoint, qui a pour valeur endpoint:X ou endpoint:Y ;status, qui a pour valeur status:200 ou status:400.
Les éléments suivants sont également considérés comme des métriques custom :
Remarque : les utilisateurs ayant le rôle Admin Datadog ou la permission usage_read peuvent consulter le nombre mensuel moyen de métriques custom par heure, ainsi que les 5 000 métriques custom les plus utilisées pour leur compte sur la page des détails sur l’utilisation. Pour en savoir plus, consultez la page sur le mode de comptabilisation des métriques custom.
Propriétés des métriques custom
Les métriques custom Datadog possèdent les propriétés ci-dessous. Consultez la présentation des métriques pour découvrir comment représenter graphiquement des métriques au sein de Datadog.
| Propriété | Rôle |
|---|
<NOM_MÉTRIQUE> | Le nom de votre métrique. |
<VALEUR_MÉTRIQUE> | La valeur de votre métrique. Remarque : les valeurs des métriques respecter un format 32 bits. Elles ne doivent pas représenter des dates ou des timestamps. |
<TIMESTAMP> | Le timestamp associé à la valeur de la métrique. Remarque : les timestamps des métriques ne peuvent pas correspondre à une date plus d’une heure avant l’événement et plus de 10 minutes après celui-ci. |
<TAGS> | L’ensemble des tags associés à votre métrique. |
<TYPE_MÉTRIQUE> | Le type de votre métrique. En savoir plus sur les types de métriques. |
<INTERVALLE> | Si le <TYPE> de la métrique est RATE ou COUNT, cette propriété définit l’intervalle correspondant. |
Nom des métriques custom
La convention de nommage suivante s’applique aux métriques custom :
- Les noms des métriques doivent commencer par une lettre.
- Les noms de métriques doivent contenir uniquement des caractères alphanumériques ASCII, des underscores et des points.
- Les autres caractères, y compris les espaces, sont remplacés par des underscores.
- Le format Unicode n’est pas pris en charge.
- Les noms de métriques ne doivent pas dépasser 200 caractères. Nous vous recommandons d’utiliser moins de 100 caractères pour une meilleure lisibilité sur l’interface.
Remarque : les noms de métrique sont sensibles à la casse dans Datadog.
Unités des métriques
Définissez les unités des métriques via le Résumé des métriques ou définissez des unités personnalisées pour les métriques à l’aide de la fonctionnalité Remplacement des unités dans l’éditeur de graphiques de vos visualisations. Pour plus d’informations, consultez la documentation relative aux unités de métriques.
Envoi de métriques custom
Il existe plusieurs façons d'envoyer des métriques à Datadog :
Vous pouvez également utiliser l’une des bibliothèques client de Datadog et sa communauté pour DogStatsD et les API afin d’envoyer vos métriques custom.
Remarque : aucune limite de débit fixe n’est appliquée lors de l’envoi des métriques custom. Si vous dépassez votre nombre de métriques par défaut, vous serez facturé conformément à la politique de facturation de Datadog pour les métriques custom.
Intégrations standard
Les intégrations standard suivantes peuvent potentiellement générer des métriques custom.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
