monotonic_count()
Cette fonction est utilisée pour suivre une métrique COUNT brute qui augmente toujours. Le Datadog Agent calcule le delta entre chaque soumission. Les échantillons ayant une valeur inférieure à l’échantillon précédent sont ignorés. Des valeurs inférieures indiquent généralement que la métrique COUNT brute sous-jacente a été réinitialisée. La fonction peut être appelée plusieurs fois pendant l’exécution d’un check.
Par exemple, la soumission des échantillons 2, 3, 6, 7 envoie une valeur de 5 (7-2) lors de la première exécution du check. La soumission des échantillons 10, 11 sur le même monotonic_count envoie une valeur de 4 (11-7) lors de la deuxième exécution du check.
Remarque : les métriques soumises avec cette fonction sont stockées avec un type de métrique COUNT dans Datadog. Chaque valeur dans la série temporelle stockée est un delta de la valeur de la métrique entre les échantillons (non normalisé par le temps).
Modèle de fonction :
self.monotonic_count(name, value, tags=None, hostname=None, device_name=None)
| Paramètre | Type | Requis | Valeur par défaut | Description |
|---|
name | Chaîne | Oui | - | Le nom de la métrique. |
value | Flottant | Oui | - | La valeur de la métrique. |
tags | Liste de chaînes | Non | - | Une liste de tags à associer à cette métrique. |
hostname | Chaîne | Non | Host actuel | Un nom d’hôte à associer à cette métrique. |
device_name | Chaîne | Non | - | Obsolète. Ajoute plutôt un tag sous la forme device:<DEVICE_NAME> à la liste des tags. |
count()
Cette fonction soumet le nombre d’événements survenus pendant l’intervalle du check. Elle peut être appelée plusieurs fois au cours de l’exécution d’un check, chaque échantillon étant ajouté à la valeur envoyée.
Remarque : Les métriques soumises avec cette fonction sont stockées avec un type de métrique COUNT dans Datadog.
Modèle de fonction :
self.count(name, value, tags=None, hostname=None, device_name=None)
| Paramètre | Type | Requis | Valeur par défaut | Description |
|---|
name | Chaîne | Oui | - | Le nom de la métrique. |
value | Flottant | Oui | - | La valeur de la métrique. |
tags | Liste de chaînes | Non | - | Une liste de tags à associer à cette métrique. |
hostname | Chaîne | Non | host actuel | Un nom d’hôte à associer à cette métrique. |
device_name | Chaîne | Non | - | Obsolète. Ajoute plutôt un tag sous la forme device:<DEVICE_NAME> à la liste des tags. |
gauge()
Cette fonction soumet la valeur d’une métrique à un horodatage donné. Si elle est appelée plusieurs fois au cours de l’exécution d’un check pour une métrique, seul le dernier échantillon est utilisé.
Remarque : Les métriques soumises avec cette fonction sont stockées avec un type de métrique GAUGE dans Datadog.
Modèle de fonction :
self.gauge(name, value, tags=None, hostname=None, device_name=None)
| Paramètre | Type | Requis | Valeur par défaut | Description |
|---|
name | Chaîne | Oui | - | Le nom de la métrique. |
value | Flottant | Oui | - | La valeur de la métrique. |
tags | Liste de chaînes | Non | - | Une liste de tags à associer à cette métrique. |
hostname | Chaîne | Non | host actuel | Un nom d’hôte à associer à cette métrique. |
device_name | Chaîne | Non | - | Obsolète. Ajoute plutôt un tag sous la forme device:<DEVICE_NAME> à la liste des tags. |
rate()
Cette fonction soumet la valeur brute échantillonnée de votre métrique RATE. Le Datadog Agent calcule le delta de la valeur de cette métrique entre deux soumissions et le divise par l’intervalle de soumission pour obtenir le taux. Cette fonction ne doit être appelée qu’une seule fois pendant un check, sinon elle rejette toute valeur inférieure à une valeur précédemment soumise.
Remarque : Les métriques soumises avec cette fonction sont stockées en tant que type de métrique GAUGE dans Datadog. Chaque valeur dans la série temporelle stockée est un delta normalisé dans le temps de la valeur de la métrique entre les échantillons.
Modèle de fonction :
self.rate(name, value, tags=None, hostname=None, device_name=None)
| Paramètre | Type | Requis | Valeur par défaut | Description |
|---|
name | Chaîne | Oui | - | Le nom de la métrique. |
value | Flottant | Oui | - | La valeur de la métrique. |
tags | Liste de chaînes | Non | - | Une liste de tags à associer à cette métrique. |
hostname | Chaîne | Non | host actuel | Un nom d’hôte à associer à cette métrique. |
device_name | Chaîne | Non | - | Obsolète. Ajoute plutôt un tag sous la forme device:<DEVICE_NAME> à la liste des tags. |
histogram()
Cette fonction soumet l’échantillon d’une métrique d’histogramme recueilli pendant l’intervalle du check. Elle peut être appelée plusieurs fois pendant l’exécution d’un check. Chaque échantillon est ajouté à la distribution statistique de l’ensemble des valeurs pour cette métrique.
Remarque : Toutes les agrégations de métriques produites sont stockées en tant que type de métrique GAUGE dans Datadog, à l’exception du <METRIC_NAME>.count qui est stocké en tant que type de métrique RATE dans Datadog.
Modèle de fonction :
self.histogram(name, value, tags=None, hostname=None, device_name=None)
| Paramètre | Type | Requis | Valeur par défaut | Description |
|---|
name | Chaîne | Oui | - | Le nom de la métrique. |
value | Flottant | Oui | - | La valeur de la métrique. |
tags | Liste de chaînes | Non | - | Une liste de tags à associer à cette métrique. |
hostname | Chaîne | Non | host actuel | Un nom d’hôte à associer à cette métrique. |
device_name | Chaîne | Non | - | Obsolète. Ajoute plutôt un tag sous la forme device:<DEVICE_NAME> à la liste des tags. |