Présentation
Lorsqu’une métrique n’est pas envoyée depuis l’une des quelque
700 intégrations Datadog, elle est considérée comme une métrique custom(1). Les métriques custom vous permettent de surveiller plus facilement les KPI de vos applications, comme le nombre de visiteurs, la taille moyenne de leur panier, la latence des requêtes ou la distribution des performances pour un algorithme personnalisé.
Une métrique custom est définie par une combinaison unique de nom de métrique et de valeurs de tag (y compris le tag du host). En général, les métriques envoyées par DogStatsD ou via un check d’Agent custom sont des métriques custom.
Remarque : les utilisateurs disposant du rôle Admin de Datadog peuvent consulter le nombre moyen de métriques custom par heure et les 500 principales métriques custom pour leur compte depuis la page des détails d’utilisation. Découvrez comment les métriques custom sont comptabilisées.
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é | Description |
|---|
<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.
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.
Pour aller plus loin
Documentation, liens et articles supplémentaires utiles:
(1) Certaines intégrations génèrent des métriques custom
